fastly 5.3.0 → 6.0.0

data/lib/fastly/api/director_api.rb

@@ -351,5 +351,87 @@ module Fastly
       end
       return data, status_code, headers
     end
+
+    # Update a director
+    # Update the director for a particular service and version.
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @option opts [Integer] :version_id Integer identifying a service version. (required)
+    # @option opts [String] :director_name Name for the Director. (required)
+    # @return [DirectorResponse]
+    def update_director(opts = {})
+      data, _status_code, _headers = update_director_with_http_info(opts)
+      data
+    end
+
+    # Update a director
+    # Update the director for a particular service and version.
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @option opts [Integer] :version_id Integer identifying a service version. (required)
+    # @option opts [String] :director_name Name for the Director. (required)
+    # @return [Array<(DirectorResponse, Integer, Hash)>] DirectorResponse data, response status code and response headers
+    def update_director_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DirectorApi.update_director ...'
+      end
+      # unbox the parameters from the hash
+      service_id = opts[:'service_id']
+      version_id = opts[:'version_id']
+      director_name = opts[:'director_name']
+      # verify the required parameter 'service_id' is set
+      if @api_client.config.client_side_validation && service_id.nil?
+        fail ArgumentError, "Missing the required parameter 'service_id' when calling DirectorApi.update_director"
+      end
+      # verify the required parameter 'version_id' is set
+      if @api_client.config.client_side_validation && version_id.nil?
+        fail ArgumentError, "Missing the required parameter 'version_id' when calling DirectorApi.update_director"
+      end
+      # verify the required parameter 'director_name' is set
+      if @api_client.config.client_side_validation && director_name.nil?
+        fail ArgumentError, "Missing the required parameter 'director_name' when calling DirectorApi.update_director"
+      end
+      # resource path
+      local_var_path = '/service/{service_id}/version/{version_id}/director/{director_name}'.sub('{' + 'service_id' + '}', CGI.escape(service_id.to_s)).sub('{' + 'version_id' + '}', CGI.escape(version_id.to_s)).sub('{' + 'director_name' + '}', CGI.escape(director_name.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/x-www-form-urlencoded'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DirectorResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['token']
+
+      new_options = opts.merge(
+        :operation => :"DirectorApi.update_director",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DirectorApi#update_director\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
   end
 end

data/lib/fastly/api/domain_inspector_historical_api.rb

@@ -0,0 +1,125 @@
+=begin
+#Fastly API
+
+#Via the Fastly API you can perform any of the operations that are possible within the management console,  including creating services, domains, and backends, configuring rules or uploading your own application code, as well as account operations such as user administration and billing reports. The API is organized into collections of endpoints that allow manipulation of objects related to Fastly services and accounts. For the most accurate and up-to-date API reference content, visit our [Developer Hub](https://developer.fastly.com/reference/api/) 
+
+The version of the OpenAPI document: 1.0.0
+Contact: oss@fastly.com
+
+=end
+
+require 'cgi'
+
+module Fastly
+  class DomainInspectorHistoricalApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get historical domain data for a service
+    # Fetches historical domain metrics for a given Fastly service, optionally filtering and grouping the results by domain, region, or POP. 
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @option opts [String] :start A valid ISO-8601-formatted date and time, or UNIX timestamp, indicating the inclusive start of the query time range. If not provided, a default is chosen based on the provided `downsample` value.
+    # @option opts [String] :_end A valid ISO-8601-formatted date and time, or UNIX timestamp, indicating the exclusive end of the query time range. If not provided, a default is chosen based on the provided `downsample` value.
+    # @option opts [String] :downsample Duration of sample windows. (default to 'hour')
+    # @option opts [String] :metric The metric to retrieve. Up to ten comma-separated metrics are accepted. (default to 'edge_requests')
+    # @option opts [String] :group_by Dimensions to return in the query. Multiple dimensions may be separated by commas. For example, `group_by=domain` will return one timeseries for every domain, as a total across all datacenters (POPs). 
+    # @option opts [String] :limit Number of results per page. The maximum is 200. (default to '100')
+    # @option opts [String] :cursor Cursor value from a previous response to retrieve the next page. To request the first page, this should be empty.
+    # @option opts [String] :region Limit query to one or more specific geographic regions. Values should be comma-separated. 
+    # @option opts [String] :datacenter Limit query to one or more specific POPs. Values should be comma-separated.
+    # @option opts [String] :domain Limit query to one or more specific domains. Values should be comma-separated.
+    # @return [HistoricalDomainsResponse]
+    def get_domain_inspector_historical(opts = {})
+      data, _status_code, _headers = get_domain_inspector_historical_with_http_info(opts)
+      data
+    end
+
+    # Get historical domain data for a service
+    # Fetches historical domain metrics for a given Fastly service, optionally filtering and grouping the results by domain, region, or POP. 
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @option opts [String] :start A valid ISO-8601-formatted date and time, or UNIX timestamp, indicating the inclusive start of the query time range. If not provided, a default is chosen based on the provided `downsample` value.
+    # @option opts [String] :_end A valid ISO-8601-formatted date and time, or UNIX timestamp, indicating the exclusive end of the query time range. If not provided, a default is chosen based on the provided `downsample` value.
+    # @option opts [String] :downsample Duration of sample windows. (default to 'hour')
+    # @option opts [String] :metric The metric to retrieve. Up to ten comma-separated metrics are accepted. (default to 'edge_requests')
+    # @option opts [String] :group_by Dimensions to return in the query. Multiple dimensions may be separated by commas. For example, `group_by=domain` will return one timeseries for every domain, as a total across all datacenters (POPs). 
+    # @option opts [String] :limit Number of results per page. The maximum is 200. (default to '100')
+    # @option opts [String] :cursor Cursor value from a previous response to retrieve the next page. To request the first page, this should be empty.
+    # @option opts [String] :region Limit query to one or more specific geographic regions. Values should be comma-separated. 
+    # @option opts [String] :datacenter Limit query to one or more specific POPs. Values should be comma-separated.
+    # @option opts [String] :domain Limit query to one or more specific domains. Values should be comma-separated.
+    # @return [Array<(HistoricalDomainsResponse, Integer, Hash)>] HistoricalDomainsResponse data, response status code and response headers
+    def get_domain_inspector_historical_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DomainInspectorHistoricalApi.get_domain_inspector_historical ...'
+      end
+      # unbox the parameters from the hash
+      service_id = opts[:'service_id']
+      # verify the required parameter 'service_id' is set
+      if @api_client.config.client_side_validation && service_id.nil?
+        fail ArgumentError, "Missing the required parameter 'service_id' when calling DomainInspectorHistoricalApi.get_domain_inspector_historical"
+      end
+      allowable_values = ["hour", "minute", "day"]
+      if @api_client.config.client_side_validation && opts[:'downsample'] && !allowable_values.include?(opts[:'downsample'])
+        fail ArgumentError, "invalid value for \"downsample\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["domain", "datacenter", "region", "none"]
+      if @api_client.config.client_side_validation && opts[:'group_by'] && !allowable_values.include?(opts[:'group_by'])
+        fail ArgumentError, "invalid value for \"group_by\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["usa", "europe", "asia", "asia_india", "asia_southkorea", "africa_std", "southamerica_std"]
+      if @api_client.config.client_side_validation && opts[:'region'] && !allowable_values.include?(opts[:'region'])
+        fail ArgumentError, "invalid value for \"region\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/metrics/domains/services/{service_id}'.sub('{' + 'service_id' + '}', CGI.escape(service_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'start'] = opts[:'start'] if !opts[:'start'].nil?
+      query_params[:'end'] = opts[:'_end'] if !opts[:'_end'].nil?
+      query_params[:'downsample'] = opts[:'downsample'] if !opts[:'downsample'].nil?
+      query_params[:'metric'] = opts[:'metric'] if !opts[:'metric'].nil?
+      query_params[:'group_by'] = opts[:'group_by'] if !opts[:'group_by'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'cursor'] = opts[:'cursor'] if !opts[:'cursor'].nil?
+      query_params[:'region'] = opts[:'region'] if !opts[:'region'].nil?
+      query_params[:'datacenter'] = opts[:'datacenter'] if !opts[:'datacenter'].nil?
+      query_params[:'domain'] = opts[:'domain'] if !opts[:'domain'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'HistoricalDomainsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['token']
+
+      new_options = opts.merge(
+        :operation => :"DomainInspectorHistoricalApi.get_domain_inspector_historical",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DomainInspectorHistoricalApi#get_domain_inspector_historical\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/fastly/api/domain_inspector_realtime_api.rb

@@ -0,0 +1,223 @@
+=begin
+#Fastly API
+
+#Via the Fastly API you can perform any of the operations that are possible within the management console,  including creating services, domains, and backends, configuring rules or uploading your own application code, as well as account operations such as user administration and billing reports. The API is organized into collections of endpoints that allow manipulation of objects related to Fastly services and accounts. For the most accurate and up-to-date API reference content, visit our [Developer Hub](https://developer.fastly.com/reference/api/) 
+
+The version of the OpenAPI document: 1.0.0
+Contact: oss@fastly.com
+
+=end
+
+require 'cgi'
+
+module Fastly
+  class DomainInspectorRealtimeApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get real-time domain data for the last 120 seconds
+    # Get data for the 120 seconds preceding the latest timestamp available for a service.
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @return [DomainInspector]
+    def get_domain_inspector_last120_seconds(opts = {})
+      data, _status_code, _headers = get_domain_inspector_last120_seconds_with_http_info(opts)
+      data
+    end
+
+    # Get real-time domain data for the last 120 seconds
+    # Get data for the 120 seconds preceding the latest timestamp available for a service.
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @return [Array<(DomainInspector, Integer, Hash)>] DomainInspector data, response status code and response headers
+    def get_domain_inspector_last120_seconds_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DomainInspectorRealtimeApi.get_domain_inspector_last120_seconds ...'
+      end
+      # unbox the parameters from the hash
+      service_id = opts[:'service_id']
+      # verify the required parameter 'service_id' is set
+      if @api_client.config.client_side_validation && service_id.nil?
+        fail ArgumentError, "Missing the required parameter 'service_id' when calling DomainInspectorRealtimeApi.get_domain_inspector_last120_seconds"
+      end
+      # resource path
+      local_var_path = '/v1/domains/{service_id}/ts/h'.sub('{' + 'service_id' + '}', CGI.escape(service_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DomainInspector'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['token']
+
+      new_options = opts.merge(
+        :operation => :"DomainInspectorRealtimeApi.get_domain_inspector_last120_seconds",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DomainInspectorRealtimeApi#get_domain_inspector_last120_seconds\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get a limited number of real-time domain data entries
+    # Get data for the `max_entries` seconds preceding the latest timestamp available for a service, up to a maximum of 120 entries.
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @option opts [Integer] :max_entries Maximum number of results to show. (required)
+    # @return [DomainInspector]
+    def get_domain_inspector_last_max_entries(opts = {})
+      data, _status_code, _headers = get_domain_inspector_last_max_entries_with_http_info(opts)
+      data
+    end
+
+    # Get a limited number of real-time domain data entries
+    # Get data for the &#x60;max_entries&#x60; seconds preceding the latest timestamp available for a service, up to a maximum of 120 entries.
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @option opts [Integer] :max_entries Maximum number of results to show. (required)
+    # @return [Array<(DomainInspector, Integer, Hash)>] DomainInspector data, response status code and response headers
+    def get_domain_inspector_last_max_entries_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DomainInspectorRealtimeApi.get_domain_inspector_last_max_entries ...'
+      end
+      # unbox the parameters from the hash
+      service_id = opts[:'service_id']
+      max_entries = opts[:'max_entries']
+      # verify the required parameter 'service_id' is set
+      if @api_client.config.client_side_validation && service_id.nil?
+        fail ArgumentError, "Missing the required parameter 'service_id' when calling DomainInspectorRealtimeApi.get_domain_inspector_last_max_entries"
+      end
+      # verify the required parameter 'max_entries' is set
+      if @api_client.config.client_side_validation && max_entries.nil?
+        fail ArgumentError, "Missing the required parameter 'max_entries' when calling DomainInspectorRealtimeApi.get_domain_inspector_last_max_entries"
+      end
+      # resource path
+      local_var_path = '/v1/domains/{service_id}/ts/h/limit/{max_entries}'.sub('{' + 'service_id' + '}', CGI.escape(service_id.to_s)).sub('{' + 'max_entries' + '}', CGI.escape(max_entries.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DomainInspector'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['token']
+
+      new_options = opts.merge(
+        :operation => :"DomainInspectorRealtimeApi.get_domain_inspector_last_max_entries",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DomainInspectorRealtimeApi#get_domain_inspector_last_max_entries\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get real-time domain data from a specified time
+    # Get real-time domain data for the specified reporting period. Specify `0` to get a single entry for the last complete second. The `Timestamp` field included in the response provides the time index of the latest entry in the dataset and can be provided as the `start_timestamp` of the next request for a seamless continuation of the dataset from one request to the next. Due to processing latency, the earliest entry in the response dataset may be earlier than `start_timestamp` by the value of `AggregateDelay`. 
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @option opts [Integer] :start_timestamp Timestamp in seconds (Unix epoch time). (required)
+    # @return [DomainInspector]
+    def get_domain_inspector_last_second(opts = {})
+      data, _status_code, _headers = get_domain_inspector_last_second_with_http_info(opts)
+      data
+    end
+
+    # Get real-time domain data from a specified time
+    # Get real-time domain data for the specified reporting period. Specify &#x60;0&#x60; to get a single entry for the last complete second. The &#x60;Timestamp&#x60; field included in the response provides the time index of the latest entry in the dataset and can be provided as the &#x60;start_timestamp&#x60; of the next request for a seamless continuation of the dataset from one request to the next. Due to processing latency, the earliest entry in the response dataset may be earlier than &#x60;start_timestamp&#x60; by the value of &#x60;AggregateDelay&#x60;. 
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @option opts [Integer] :start_timestamp Timestamp in seconds (Unix epoch time). (required)
+    # @return [Array<(DomainInspector, Integer, Hash)>] DomainInspector data, response status code and response headers
+    def get_domain_inspector_last_second_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DomainInspectorRealtimeApi.get_domain_inspector_last_second ...'
+      end
+      # unbox the parameters from the hash
+      service_id = opts[:'service_id']
+      start_timestamp = opts[:'start_timestamp']
+      # verify the required parameter 'service_id' is set
+      if @api_client.config.client_side_validation && service_id.nil?
+        fail ArgumentError, "Missing the required parameter 'service_id' when calling DomainInspectorRealtimeApi.get_domain_inspector_last_second"
+      end
+      # verify the required parameter 'start_timestamp' is set
+      if @api_client.config.client_side_validation && start_timestamp.nil?
+        fail ArgumentError, "Missing the required parameter 'start_timestamp' when calling DomainInspectorRealtimeApi.get_domain_inspector_last_second"
+      end
+      # resource path
+      local_var_path = '/v1/domains/{service_id}/ts/{start_timestamp}'.sub('{' + 'service_id' + '}', CGI.escape(service_id.to_s)).sub('{' + 'start_timestamp' + '}', CGI.escape(start_timestamp.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DomainInspector'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['token']
+
+      new_options = opts.merge(
+        :operation => :"DomainInspectorRealtimeApi.get_domain_inspector_last_second",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DomainInspectorRealtimeApi#get_domain_inspector_last_second\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end