fastly 5.3.0 → 6.0.0

data/lib/fastly/api/legacy_waf_tag_api.rb

@@ -0,0 +1,96 @@
+=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 LegacyWafTagApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # List WAF tags
+    # List all tags.
+    # @option opts [String] :filter_name Limit the returned tags to a specific name.
+    # @option opts [Integer] :page_number Current page.
+    # @option opts [Integer] :page_size Number of records per page. (default to 20)
+    # @option opts [String] :include Include relationships. Optional, comma separated values. Permitted values: `rules`. 
+    # @return [Object]
+    def list_legacy_waf_tags(opts = {})
+      data, _status_code, _headers = list_legacy_waf_tags_with_http_info(opts)
+      data
+    end
+
+    # List WAF tags
+    # List all tags.
+    # @option opts [String] :filter_name Limit the returned tags to a specific name.
+    # @option opts [Integer] :page_number Current page.
+    # @option opts [Integer] :page_size Number of records per page. (default to 20)
+    # @option opts [String] :include Include relationships. Optional, comma separated values. Permitted values: `rules`. 
+    # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
+    def list_legacy_waf_tags_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LegacyWafTagApi.list_legacy_waf_tags ...'
+      end
+      # unbox the parameters from the hash
+      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling LegacyWafTagApi.list_legacy_waf_tags, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling LegacyWafTagApi.list_legacy_waf_tags, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/wafs/tags'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'filter[name]'] = opts[:'filter_name'] if !opts[:'filter_name'].nil?
+      query_params[:'page[number]'] = opts[:'page_number'] if !opts[:'page_number'].nil?
+      query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'include'] = opts[:'include'] if !opts[:'include'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.api+json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Object'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['token']
+
+      new_options = opts.merge(
+        :operation => :"LegacyWafTagApi.list_legacy_waf_tags",
+        :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: LegacyWafTagApi#list_legacy_waf_tags\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/fastly/api/legacy_waf_update_status_api.rb

@@ -0,0 +1,184 @@
+=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 LegacyWafUpdateStatusApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get the status of a WAF update
+    # Get a specific update status object for a particular service and firewall object.
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @option opts [String] :firewall_id Alphanumeric string identifying a Firewall. (required)
+    # @option opts [String] :update_status_id Alphanumeric string identifying a WAF update status. (required)
+    # @return [Object]
+    def get_waf_update_status(opts = {})
+      data, _status_code, _headers = get_waf_update_status_with_http_info(opts)
+      data
+    end
+
+    # Get the status of a WAF update
+    # Get a specific update status object for a particular service and firewall object.
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @option opts [String] :firewall_id Alphanumeric string identifying a Firewall. (required)
+    # @option opts [String] :update_status_id Alphanumeric string identifying a WAF update status. (required)
+    # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
+    def get_waf_update_status_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LegacyWafUpdateStatusApi.get_waf_update_status ...'
+      end
+      # unbox the parameters from the hash
+      service_id = opts[:'service_id']
+      firewall_id = opts[:'firewall_id']
+      update_status_id = opts[:'update_status_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 LegacyWafUpdateStatusApi.get_waf_update_status"
+      end
+      # verify the required parameter 'firewall_id' is set
+      if @api_client.config.client_side_validation && firewall_id.nil?
+        fail ArgumentError, "Missing the required parameter 'firewall_id' when calling LegacyWafUpdateStatusApi.get_waf_update_status"
+      end
+      # verify the required parameter 'update_status_id' is set
+      if @api_client.config.client_side_validation && update_status_id.nil?
+        fail ArgumentError, "Missing the required parameter 'update_status_id' when calling LegacyWafUpdateStatusApi.get_waf_update_status"
+      end
+      # resource path
+      local_var_path = '/service/{service_id}/wafs/{firewall_id}/update_statuses/{update_status_id}'.sub('{' + 'service_id' + '}', CGI.escape(service_id.to_s)).sub('{' + 'firewall_id' + '}', CGI.escape(firewall_id.to_s)).sub('{' + 'update_status_id' + '}', CGI.escape(update_status_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/vnd.api+json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Object'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['token']
+
+      new_options = opts.merge(
+        :operation => :"LegacyWafUpdateStatusApi.get_waf_update_status",
+        :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: LegacyWafUpdateStatusApi#get_waf_update_status\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List update statuses
+    # List all update statuses for a particular service and firewall object.
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @option opts [String] :firewall_id Alphanumeric string identifying a Firewall. (required)
+    # @option opts [Integer] :page_number Current page.
+    # @option opts [Integer] :page_size Number of records per page. (default to 20)
+    # @option opts [String] :include Include relationships. Optional, comma separated values. Permitted values: &#x60;waf&#x60;. 
+    # @return [Object]
+    def list_waf_update_statuses(opts = {})
+      data, _status_code, _headers = list_waf_update_statuses_with_http_info(opts)
+      data
+    end
+
+    # List update statuses
+    # List all update statuses for a particular service and firewall object.
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @option opts [String] :firewall_id Alphanumeric string identifying a Firewall. (required)
+    # @option opts [Integer] :page_number Current page.
+    # @option opts [Integer] :page_size Number of records per page. (default to 20)
+    # @option opts [String] :include Include relationships. Optional, comma separated values. Permitted values: &#x60;waf&#x60;. 
+    # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
+    def list_waf_update_statuses_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LegacyWafUpdateStatusApi.list_waf_update_statuses ...'
+      end
+      # unbox the parameters from the hash
+      service_id = opts[:'service_id']
+      firewall_id = opts[:'firewall_id']
+      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling LegacyWafUpdateStatusApi.list_waf_update_statuses, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'page_size'].nil? && opts[:'page_size'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling LegacyWafUpdateStatusApi.list_waf_update_statuses, must be greater than or equal to 1.'
+      end
+
+      # 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 LegacyWafUpdateStatusApi.list_waf_update_statuses"
+      end
+      # verify the required parameter 'firewall_id' is set
+      if @api_client.config.client_side_validation && firewall_id.nil?
+        fail ArgumentError, "Missing the required parameter 'firewall_id' when calling LegacyWafUpdateStatusApi.list_waf_update_statuses"
+      end
+      # resource path
+      local_var_path = '/service/{service_id}/wafs/{firewall_id}/update_statuses'.sub('{' + 'service_id' + '}', CGI.escape(service_id.to_s)).sub('{' + 'firewall_id' + '}', CGI.escape(firewall_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page[number]'] = opts[:'page_number'] if !opts[:'page_number'].nil?
+      query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'include'] = opts[:'include'] if !opts[:'include'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.api+json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Object'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['token']
+
+      new_options = opts.merge(
+        :operation => :"LegacyWafUpdateStatusApi.list_waf_update_statuses",
+        :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: LegacyWafUpdateStatusApi#list_waf_update_statuses\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/fastly/api/logging_kafka_api.rb

@@ -392,5 +392,87 @@ module Fastly
       end
       return data, status_code, headers
     end
+
+    # Update the Kafka log endpoint
+    # Update the Kafka logging endpoint 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] :logging_kafka_name The name for the real-time logging configuration. (required)
+    # @return [LoggingKafkaResponse]
+    def update_log_kafka(opts = {})
+      data, _status_code, _headers = update_log_kafka_with_http_info(opts)
+      data
+    end
+
+    # Update the Kafka log endpoint
+    # Update the Kafka logging endpoint 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] :logging_kafka_name The name for the real-time logging configuration. (required)
+    # @return [Array<(LoggingKafkaResponse, Integer, Hash)>] LoggingKafkaResponse data, response status code and response headers
+    def update_log_kafka_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LoggingKafkaApi.update_log_kafka ...'
+      end
+      # unbox the parameters from the hash
+      service_id = opts[:'service_id']
+      version_id = opts[:'version_id']
+      logging_kafka_name = opts[:'logging_kafka_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 LoggingKafkaApi.update_log_kafka"
+      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 LoggingKafkaApi.update_log_kafka"
+      end
+      # verify the required parameter 'logging_kafka_name' is set
+      if @api_client.config.client_side_validation && logging_kafka_name.nil?
+        fail ArgumentError, "Missing the required parameter 'logging_kafka_name' when calling LoggingKafkaApi.update_log_kafka"
+      end
+      # resource path
+      local_var_path = '/service/{service_id}/version/{version_id}/logging/kafka/{logging_kafka_name}'.sub('{' + 'service_id' + '}', CGI.escape(service_id.to_s)).sub('{' + 'version_id' + '}', CGI.escape(version_id.to_s)).sub('{' + 'logging_kafka_name' + '}', CGI.escape(logging_kafka_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] || 'LoggingKafkaResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['token']
+
+      new_options = opts.merge(
+        :operation => :"LoggingKafkaApi.update_log_kafka",
+        :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: LoggingKafkaApi#update_log_kafka\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
   end
 end

data/lib/fastly/api/logging_kinesis_api.rb

@@ -342,5 +342,87 @@ module Fastly
       end
       return data, status_code, headers
     end
+
+    # Update the Amazon Kinesis log endpoint
+    # Update an Amazon Kinesis Data Streams logging object 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] :logging_kinesis_name The name for the real-time logging configuration. (required)
+    # @return [LoggingKinesisResponse]
+    def update_log_kinesis(opts = {})
+      data, _status_code, _headers = update_log_kinesis_with_http_info(opts)
+      data
+    end
+
+    # Update the Amazon Kinesis log endpoint
+    # Update an Amazon Kinesis Data Streams logging object 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] :logging_kinesis_name The name for the real-time logging configuration. (required)
+    # @return [Array<(LoggingKinesisResponse, Integer, Hash)>] LoggingKinesisResponse data, response status code and response headers
+    def update_log_kinesis_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LoggingKinesisApi.update_log_kinesis ...'
+      end
+      # unbox the parameters from the hash
+      service_id = opts[:'service_id']
+      version_id = opts[:'version_id']
+      logging_kinesis_name = opts[:'logging_kinesis_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 LoggingKinesisApi.update_log_kinesis"
+      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 LoggingKinesisApi.update_log_kinesis"
+      end
+      # verify the required parameter 'logging_kinesis_name' is set
+      if @api_client.config.client_side_validation && logging_kinesis_name.nil?
+        fail ArgumentError, "Missing the required parameter 'logging_kinesis_name' when calling LoggingKinesisApi.update_log_kinesis"
+      end
+      # resource path
+      local_var_path = '/service/{service_id}/version/{version_id}/logging/kinesis/{logging_kinesis_name}'.sub('{' + 'service_id' + '}', CGI.escape(service_id.to_s)).sub('{' + 'version_id' + '}', CGI.escape(version_id.to_s)).sub('{' + 'logging_kinesis_name' + '}', CGI.escape(logging_kinesis_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] || 'LoggingKinesisResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['token']
+
+      new_options = opts.merge(
+        :operation => :"LoggingKinesisApi.update_log_kinesis",
+        :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: LoggingKinesisApi#update_log_kinesis\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
   end
 end

data/lib/fastly/api/origin_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 OriginInspectorHistoricalApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get historical origin data for a service
+    # Fetches historical origin metrics for a given Fastly service, optionally filtering and grouping the results by origin host, 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 'responses')
+    # @option opts [String] :group_by Dimensions to return in the query. Multiple dimensions may be separated by commas. For example, `group_by=host` will return one timeseries for every origin host, as a total across all 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] :host Limit query to one or more specific origin hosts. Values should be comma-separated.
+    # @return [HistoricalOriginsResponse]
+    def get_origin_inspector_historical(opts = {})
+      data, _status_code, _headers = get_origin_inspector_historical_with_http_info(opts)
+      data
+    end
+
+    # Get historical origin data for a service
+    # Fetches historical origin metrics for a given Fastly service, optionally filtering and grouping the results by origin host, 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 'responses')
+    # @option opts [String] :group_by Dimensions to return in the query. Multiple dimensions may be separated by commas. For example, `group_by=host` will return one timeseries for every origin host, as a total across all 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] :host Limit query to one or more specific origin hosts. Values should be comma-separated.
+    # @return [Array<(HistoricalOriginsResponse, Integer, Hash)>] HistoricalOriginsResponse data, response status code and response headers
+    def get_origin_inspector_historical_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: OriginInspectorHistoricalApi.get_origin_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 OriginInspectorHistoricalApi.get_origin_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 = ["host", "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/origins/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[:'host'] = opts[:'host'] if !opts[:'host'].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] || 'HistoricalOriginsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['token']
+
+      new_options = opts.merge(
+        :operation => :"OriginInspectorHistoricalApi.get_origin_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: OriginInspectorHistoricalApi#get_origin_inspector_historical\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end