fastly 17.2.0 → 18.0.0

data/lib/fastly/api/bot_requests_metrics_api.rb

@@ -0,0 +1,137 @@
+=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://www.fastly.com/documentation/reference/api/) 
+
+The version of the OpenAPI document: 1.0.0
+Contact: oss@fastly.com
+
+=end
+
+require 'cgi'
+
+module Fastly
+  class BotRequestsMetricsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get per-service historical time series metrics for bot requests broken down by bot-type.
+    # Return historical time series metrics for bot requests broken down by bot-type.
+    # @option opts [String] :granularity Duration of sample windows. (required)
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @option opts [String] :from A valid RFC-8339-formatted date and time indicating the inclusive start of the query time range. If not provided, a default is chosen based on the provided `granularity` value.
+    # @option opts [String] :to A valid RFC-8339-formatted date and time indicating the exclusive end of the query time range. If not provided, a default is chosen based on the provided `granularity` value.
+    # @option opts [String] :group_by Field to group by in the query. For example, `group_by=bot_id` will return entries grouped by `timestamp` and `bot_id`. 
+    # @option opts [String] :datacenter Limit query to one or more specific POPs. Values should be comma-separated.
+    # @option opts [String] :bot Filter results based by Bot ID.
+    # @option opts [String] :region Limit query to one or more specific geographic regions. Values should be comma-separated. 
+    # @option opts [String] :cursor Cursor value from the `next_cursor` field of a previous response, used to retrieve the next page. To request the first page, this should be empty.
+    # @option opts [String] :metric One or more metrics to retrieve. Multiple values should be comma-separated.
+    # @option opts [String] :metric_set The metric set to retrieve.
+    # @option opts [String] :limit Number of results per page. The maximum is 10000. (default to '1000')
+    # @return [BotRequestMetricsResponse]
+    def get_bot_request_metrics_service_historical(opts = {})
+      data, _status_code, _headers = get_bot_request_metrics_service_historical_with_http_info(opts)
+      data
+    end
+
+    # Get per-service historical time series metrics for bot requests broken down by bot-type.
+    # Return historical time series metrics for bot requests broken down by bot-type.
+    # @option opts [String] :granularity Duration of sample windows. (required)
+    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # @option opts [String] :from A valid RFC-8339-formatted date and time indicating the inclusive start of the query time range. If not provided, a default is chosen based on the provided `granularity` value.
+    # @option opts [String] :to A valid RFC-8339-formatted date and time indicating the exclusive end of the query time range. If not provided, a default is chosen based on the provided `granularity` value.
+    # @option opts [String] :group_by Field to group by in the query. For example, `group_by=bot_id` will return entries grouped by `timestamp` and `bot_id`. 
+    # @option opts [String] :datacenter Limit query to one or more specific POPs. Values should be comma-separated.
+    # @option opts [String] :bot Filter results based by Bot ID.
+    # @option opts [String] :region Limit query to one or more specific geographic regions. Values should be comma-separated. 
+    # @option opts [String] :cursor Cursor value from the `next_cursor` field of a previous response, used to retrieve the next page. To request the first page, this should be empty.
+    # @option opts [String] :metric One or more metrics to retrieve. Multiple values should be comma-separated.
+    # @option opts [String] :metric_set The metric set to retrieve.
+    # @option opts [String] :limit Number of results per page. The maximum is 10000. (default to '1000')
+    # @return [Array<(BotRequestMetricsResponse, Integer, Hash)>] BotRequestMetricsResponse data, response status code and response headers
+    def get_bot_request_metrics_service_historical_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BotRequestsMetricsApi.get_bot_request_metrics_service_historical ...'
+      end
+      # unbox the parameters from the hash
+      granularity = opts[:'granularity']
+      service_id = opts[:'service_id']
+      # verify the required parameter 'granularity' is set
+      if @api_client.config.client_side_validation && granularity.nil?
+        fail ArgumentError, "Missing the required parameter 'granularity' when calling BotRequestsMetricsApi.get_bot_request_metrics_service_historical"
+      end
+      # verify enum value
+      allowable_values = ["minutely", "hourly", "daily"]
+      if @api_client.config.client_side_validation && !allowable_values.include?(granularity)
+        fail ArgumentError, "invalid value for \"granularity\", must be one of #{allowable_values}"
+      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 BotRequestsMetricsApi.get_bot_request_metrics_service_historical"
+      end
+      allowable_values = ["datacenter", "bot_id"]
+      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 = ["africa_std", "anzac", "asia", "asia_india", "asia_southkorea", "europe", "mexico", "southamerica_std", "usa"]
+      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
+      allowable_values = ["content_guard"]
+      if @api_client.config.client_side_validation && opts[:'metric_set'] && !allowable_values.include?(opts[:'metric_set'])
+        fail ArgumentError, "invalid value for \"metric_set\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/metrics/bots/entities/{service_id}/{granularity}'.sub('{' + 'granularity' + '}', CGI.escape(granularity.to_s)).sub('{' + 'service_id' + '}', CGI.escape(service_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'from'] = opts[:'from'] if !opts[:'from'].nil?
+      query_params[:'to'] = opts[:'to'] if !opts[:'to'].nil?
+      query_params[:'group_by'] = opts[:'group_by'] if !opts[:'group_by'].nil?
+      query_params[:'datacenter'] = opts[:'datacenter'] if !opts[:'datacenter'].nil?
+      query_params[:'bot'] = opts[:'bot'] if !opts[:'bot'].nil?
+      query_params[:'region'] = opts[:'region'] if !opts[:'region'].nil?
+      query_params[:'cursor'] = opts[:'cursor'] if !opts[:'cursor'].nil?
+      query_params[:'metric'] = opts[:'metric'] if !opts[:'metric'].nil?
+      query_params[:'metric_set'] = opts[:'metric_set'] if !opts[:'metric_set'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].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] || 'BotRequestMetricsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['token']
+
+      new_options = opts.merge(
+        :operation => :"BotRequestsMetricsApi.get_bot_request_metrics_service_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: BotRequestsMetricsApi#get_bot_request_metrics_service_historical\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/fastly/api/dictionary_item_api.rb

@@ -98,7 +98,7 @@ module Fastly
     # Create DictionaryItem given service, dictionary ID, item key, and item value.
     # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
     # @option opts [String] :dictionary_id Alphanumeric string identifying a Dictionary. (required)
-    # @option opts [String] :item_key Item key, maximum 256 characters.
+    # @option opts [String] :item_key Item key, maximum 255 characters.
     # @option opts [String] :item_value Item value, maximum 8000 characters.
     # @return [DictionaryItemResponse]
     def create_dictionary_item(opts = {})
@@ -110,7 +110,7 @@ module Fastly
     # Create DictionaryItem given service, dictionary ID, item key, and item value.
     # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
     # @option opts [String] :dictionary_id Alphanumeric string identifying a Dictionary. (required)
-    # @option opts [String] :item_key Item key, maximum 256 characters.
+    # @option opts [String] :item_key Item key, maximum 255 characters.
     # @option opts [String] :item_value Item value, maximum 8000 characters.
     # @return [Array<(DictionaryItemResponse, Integer, Hash)>] DictionaryItemResponse data, response status code and response headers
     def create_dictionary_item_with_http_info(opts = {})
@@ -179,7 +179,7 @@ module Fastly
     # Delete DictionaryItem given service, dictionary ID, and item key.
     # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
     # @option opts [String] :dictionary_id Alphanumeric string identifying a Dictionary. (required)
-    # @option opts [String] :dictionary_item_key Item key, maximum 256 characters. (required)
+    # @option opts [String] :dictionary_item_key Item key, maximum 255 characters. (required)
     # @return [InlineResponse200]
     def delete_dictionary_item(opts = {})
       data, _status_code, _headers = delete_dictionary_item_with_http_info(opts)
@@ -190,7 +190,7 @@ module Fastly
     # Delete DictionaryItem given service, dictionary ID, and item key.
     # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
     # @option opts [String] :dictionary_id Alphanumeric string identifying a Dictionary. (required)
-    # @option opts [String] :dictionary_item_key Item key, maximum 256 characters. (required)
+    # @option opts [String] :dictionary_item_key Item key, maximum 255 characters. (required)
     # @return [Array<(InlineResponse200, Integer, Hash)>] InlineResponse200 data, response status code and response headers
     def delete_dictionary_item_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -256,7 +256,7 @@ module Fastly
     # Retrieve a single DictionaryItem given service, dictionary ID and item key.
     # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
     # @option opts [String] :dictionary_id Alphanumeric string identifying a Dictionary. (required)
-    # @option opts [String] :dictionary_item_key Item key, maximum 256 characters. (required)
+    # @option opts [String] :dictionary_item_key Item key, maximum 255 characters. (required)
     # @return [DictionaryItemResponse]
     def get_dictionary_item(opts = {})
       data, _status_code, _headers = get_dictionary_item_with_http_info(opts)
@@ -267,7 +267,7 @@ module Fastly
     # Retrieve a single DictionaryItem given service, dictionary ID and item key.
     # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
     # @option opts [String] :dictionary_id Alphanumeric string identifying a Dictionary. (required)
-    # @option opts [String] :dictionary_item_key Item key, maximum 256 characters. (required)
+    # @option opts [String] :dictionary_item_key Item key, maximum 255 characters. (required)
     # @return [Array<(DictionaryItemResponse, Integer, Hash)>] DictionaryItemResponse data, response status code and response headers
     def get_dictionary_item_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -427,8 +427,8 @@ module Fastly
     # Update DictionaryItem given service, dictionary ID, item key, and item value.
     # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
     # @option opts [String] :dictionary_id Alphanumeric string identifying a Dictionary. (required)
-    # @option opts [String] :dictionary_item_key Item key, maximum 256 characters. (required)
-    # @option opts [String] :item_key Item key, maximum 256 characters.
+    # @option opts [String] :dictionary_item_key Item key, maximum 255 characters. (required)
+    # @option opts [String] :item_key Item key, maximum 255 characters.
     # @option opts [String] :item_value Item value, maximum 8000 characters.
     # @return [DictionaryItemResponse]
     def update_dictionary_item(opts = {})
@@ -440,8 +440,8 @@ module Fastly
     # Update DictionaryItem given service, dictionary ID, item key, and item value.
     # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
     # @option opts [String] :dictionary_id Alphanumeric string identifying a Dictionary. (required)
-    # @option opts [String] :dictionary_item_key Item key, maximum 256 characters. (required)
-    # @option opts [String] :item_key Item key, maximum 256 characters.
+    # @option opts [String] :dictionary_item_key Item key, maximum 255 characters. (required)
+    # @option opts [String] :item_key Item key, maximum 255 characters.
     # @option opts [String] :item_value Item value, maximum 8000 characters.
     # @return [Array<(DictionaryItemResponse, Integer, Hash)>] DictionaryItemResponse data, response status code and response headers
     def update_dictionary_item_with_http_info(opts = {})
@@ -515,8 +515,8 @@ module Fastly
     # Upsert DictionaryItem given service, dictionary ID, item key, and item value.
     # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
     # @option opts [String] :dictionary_id Alphanumeric string identifying a Dictionary. (required)
-    # @option opts [String] :dictionary_item_key Item key, maximum 256 characters. (required)
-    # @option opts [String] :item_key Item key, maximum 256 characters.
+    # @option opts [String] :dictionary_item_key Item key, maximum 255 characters. (required)
+    # @option opts [String] :item_key Item key, maximum 255 characters.
     # @option opts [String] :item_value Item value, maximum 8000 characters.
     # @return [DictionaryItemResponse]
     def upsert_dictionary_item(opts = {})
@@ -528,8 +528,8 @@ module Fastly
     # Upsert DictionaryItem given service, dictionary ID, item key, and item value.
     # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
     # @option opts [String] :dictionary_id Alphanumeric string identifying a Dictionary. (required)
-    # @option opts [String] :dictionary_item_key Item key, maximum 256 characters. (required)
-    # @option opts [String] :item_key Item key, maximum 256 characters.
+    # @option opts [String] :dictionary_item_key Item key, maximum 255 characters. (required)
+    # @option opts [String] :item_key Item key, maximum 255 characters.
     # @option opts [String] :item_value Item value, maximum 8000 characters.
     # @return [Array<(DictionaryItemResponse, Integer, Hash)>] DictionaryItemResponse data, response status code and response headers
     def upsert_dictionary_item_with_http_info(opts = {})

data/lib/fastly/api/metrics_platform_api.rb

@@ -17,60 +17,167 @@ module Fastly
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Get historical time series metrics for a single service
-    # Fetches historical metrics for a single service for a given granularity.
-    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # Get aggregated historical time series metrics for all entities
+    # Fetches historical metrics for all entities for a customer for a given granularity. Entity in this context refers to an instance of a Fastly resource, such as a VCL service, Compute service, or NGWAF workspace.
     # @option opts [String] :granularity Duration of sample windows. (required)
     # @option opts [String] :from A valid RFC-8339-formatted date and time indicating the inclusive start of the query time range. If not provided, a default is chosen based on the provided `granularity` value.
     # @option opts [String] :to A valid RFC-8339-formatted date and time indicating the exclusive end of the query time range. If not provided, a default is chosen based on the provided `granularity` value.
-    # @option opts [String] :metric The metric(s) to retrieve. Multiple values should be comma-separated.
-    # @option opts [String] :metric_set The metric set(s) to retrieve. Multiple values should be comma-separated.
+    # @option opts [String] :metric One or more metrics to retrieve. Multiple values should be comma-separated.
+    # @option opts [String] :metric_set One or more metric sets to retrieve. Multiple values should be comma-separated. A metric set expands to a list of metrics; see the Metric Sets section above for the metrics in each set. A metric that appears in more than one requested set is returned once. 
     # @option opts [String] :group_by Field to group_by in the query. For example, `group_by=region` will return entries for grouped by timestamp and region. 
     # @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] :cursor Cursor value from the `next_cursor` field of a previous response, used to retrieve the next page. To request the first page, this should be empty.
     # @option opts [String] :limit Number of results per page. The maximum is 10000. (default to '1000')
     # @return [PlatformMetricsResponse]
-    def get_platform_metrics_service_historical(opts = {})
-      data, _status_code, _headers = get_platform_metrics_service_historical_with_http_info(opts)
+    def get_platform_metrics_aggregate_historical(opts = {})
+      data, _status_code, _headers = get_platform_metrics_aggregate_historical_with_http_info(opts)
       data
     end
 
-    # Get historical time series metrics for a single service
-    # Fetches historical metrics for a single service for a given granularity.
-    # @option opts [String] :service_id Alphanumeric string identifying the service. (required)
+    # Get aggregated historical time series metrics for all entities
+    # Fetches historical metrics for all entities for a customer for a given granularity. Entity in this context refers to an instance of a Fastly resource, such as a VCL service, Compute service, or NGWAF workspace.
     # @option opts [String] :granularity Duration of sample windows. (required)
     # @option opts [String] :from A valid RFC-8339-formatted date and time indicating the inclusive start of the query time range. If not provided, a default is chosen based on the provided `granularity` value.
     # @option opts [String] :to A valid RFC-8339-formatted date and time indicating the exclusive end of the query time range. If not provided, a default is chosen based on the provided `granularity` value.
-    # @option opts [String] :metric The metric(s) to retrieve. Multiple values should be comma-separated.
-    # @option opts [String] :metric_set The metric set(s) to retrieve. Multiple values should be comma-separated.
+    # @option opts [String] :metric One or more metrics to retrieve. Multiple values should be comma-separated.
+    # @option opts [String] :metric_set One or more metric sets to retrieve. Multiple values should be comma-separated. A metric set expands to a list of metrics; see the Metric Sets section above for the metrics in each set. A metric that appears in more than one requested set is returned once. 
     # @option opts [String] :group_by Field to group_by in the query. For example, `group_by=region` will return entries for grouped by timestamp and region. 
     # @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] :cursor Cursor value from the `next_cursor` field of a previous response, used to retrieve the next page. To request the first page, this should be empty.
     # @option opts [String] :limit Number of results per page. The maximum is 10000. (default to '1000')
     # @return [Array<(PlatformMetricsResponse, Integer, Hash)>] PlatformMetricsResponse data, response status code and response headers
-    def get_platform_metrics_service_historical_with_http_info(opts = {})
+    def get_platform_metrics_aggregate_historical_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: MetricsPlatformApi.get_platform_metrics_service_historical ...'
+        @api_client.config.logger.debug 'Calling API: MetricsPlatformApi.get_platform_metrics_aggregate_historical ...'
       end
       # unbox the parameters from the hash
-      service_id = opts[:'service_id']
       granularity = opts[:'granularity']
-      # 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 MetricsPlatformApi.get_platform_metrics_service_historical"
+      # verify the required parameter 'granularity' is set
+      if @api_client.config.client_side_validation && granularity.nil?
+        fail ArgumentError, "Missing the required parameter 'granularity' when calling MetricsPlatformApi.get_platform_metrics_aggregate_historical"
+      end
+      # verify enum value
+      allowable_values = ["minutely", "hourly", "daily"]
+      if @api_client.config.client_side_validation && !allowable_values.include?(granularity)
+        fail ArgumentError, "invalid value for \"granularity\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["delivery_traffic_flow", "delivery_cache_performance", "delivery_errors", "compute_traffic_flow", "compute_performance", "compute_errors", "content_guard", "content_security", "ddos", "domain_api", "fanout", "image_opto", "ngwaf", "object_storage", "websockets"]
+      if @api_client.config.client_side_validation && opts[:'metric_set'] && !allowable_values.include?(opts[:'metric_set'])
+        fail ArgumentError, "invalid value for \"metric_set\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["datacenter", "region"]
+      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 = ["africa_std", "anzac", "asia", "asia_india", "asia_southkorea", "europe", "mexico", "southamerica_std", "usa"]
+      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/v2/platform/aggregate/{granularity}'.sub('{' + 'granularity' + '}', CGI.escape(granularity.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'from'] = opts[:'from'] if !opts[:'from'].nil?
+      query_params[:'to'] = opts[:'to'] if !opts[:'to'].nil?
+      query_params[:'metric'] = opts[:'metric'] if !opts[:'metric'].nil?
+      query_params[:'metric_set'] = opts[:'metric_set'] if !opts[:'metric_set'].nil?
+      query_params[:'group_by'] = opts[:'group_by'] if !opts[:'group_by'].nil?
+      query_params[:'region'] = opts[:'region'] if !opts[:'region'].nil?
+      query_params[:'datacenter'] = opts[:'datacenter'] if !opts[:'datacenter'].nil?
+      query_params[:'cursor'] = opts[:'cursor'] if !opts[:'cursor'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].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] || 'PlatformMetricsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['token']
+
+      new_options = opts.merge(
+        :operation => :"MetricsPlatformApi.get_platform_metrics_aggregate_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: MetricsPlatformApi#get_platform_metrics_aggregate_historical\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get historical time series metrics for a single entity.
+    # Fetches historical metrics for a single entity for a given granularity. Entity in this context refers to an instance of a Fastly resource, such as a VCL service, Compute service, or NGWAF workspace.
+    # @option opts [String] :entity_id Alphanumeric string identifying the entity. (required)
+    # @option opts [String] :granularity Duration of sample windows. (required)
+    # @option opts [String] :from A valid RFC-8339-formatted date and time indicating the inclusive start of the query time range. If not provided, a default is chosen based on the provided &#x60;granularity&#x60; value.
+    # @option opts [String] :to A valid RFC-8339-formatted date and time indicating the exclusive end of the query time range. If not provided, a default is chosen based on the provided &#x60;granularity&#x60; value.
+    # @option opts [String] :metric One or more metrics to retrieve. Multiple values should be comma-separated.
+    # @option opts [String] :metric_set One or more metric sets to retrieve. Multiple values should be comma-separated. A metric set expands to a list of metrics; see the Metric Sets section above for the metrics in each set. A metric that appears in more than one requested set is returned once. 
+    # @option opts [String] :group_by Field to group_by in the query. For example, &#x60;group_by&#x3D;region&#x60; will return entries for grouped by timestamp and region. 
+    # @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] :cursor Cursor value from the &#x60;next_cursor&#x60; field of a previous response, used to retrieve the next page. To request the first page, this should be empty.
+    # @option opts [String] :limit Number of results per page. The maximum is 10000. (default to '1000')
+    # @return [PlatformMetricsResponse]
+    def get_platform_metrics_entity_historical(opts = {})
+      data, _status_code, _headers = get_platform_metrics_entity_historical_with_http_info(opts)
+      data
+    end
+
+    # Get historical time series metrics for a single entity.
+    # Fetches historical metrics for a single entity for a given granularity. Entity in this context refers to an instance of a Fastly resource, such as a VCL service, Compute service, or NGWAF workspace.
+    # @option opts [String] :entity_id Alphanumeric string identifying the entity. (required)
+    # @option opts [String] :granularity Duration of sample windows. (required)
+    # @option opts [String] :from A valid RFC-8339-formatted date and time indicating the inclusive start of the query time range. If not provided, a default is chosen based on the provided &#x60;granularity&#x60; value.
+    # @option opts [String] :to A valid RFC-8339-formatted date and time indicating the exclusive end of the query time range. If not provided, a default is chosen based on the provided &#x60;granularity&#x60; value.
+    # @option opts [String] :metric One or more metrics to retrieve. Multiple values should be comma-separated.
+    # @option opts [String] :metric_set One or more metric sets to retrieve. Multiple values should be comma-separated. A metric set expands to a list of metrics; see the Metric Sets section above for the metrics in each set. A metric that appears in more than one requested set is returned once. 
+    # @option opts [String] :group_by Field to group_by in the query. For example, &#x60;group_by&#x3D;region&#x60; will return entries for grouped by timestamp and region. 
+    # @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] :cursor Cursor value from the &#x60;next_cursor&#x60; field of a previous response, used to retrieve the next page. To request the first page, this should be empty.
+    # @option opts [String] :limit Number of results per page. The maximum is 10000. (default to '1000')
+    # @return [Array<(PlatformMetricsResponse, Integer, Hash)>] PlatformMetricsResponse data, response status code and response headers
+    def get_platform_metrics_entity_historical_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MetricsPlatformApi.get_platform_metrics_entity_historical ...'
+      end
+      # unbox the parameters from the hash
+      entity_id = opts[:'entity_id']
+      granularity = opts[:'granularity']
+      # verify the required parameter 'entity_id' is set
+      if @api_client.config.client_side_validation && entity_id.nil?
+        fail ArgumentError, "Missing the required parameter 'entity_id' when calling MetricsPlatformApi.get_platform_metrics_entity_historical"
       end
       # verify the required parameter 'granularity' is set
       if @api_client.config.client_side_validation && granularity.nil?
-        fail ArgumentError, "Missing the required parameter 'granularity' when calling MetricsPlatformApi.get_platform_metrics_service_historical"
+        fail ArgumentError, "Missing the required parameter 'granularity' when calling MetricsPlatformApi.get_platform_metrics_entity_historical"
       end
       # verify enum value
       allowable_values = ["minutely", "hourly", "daily"]
       if @api_client.config.client_side_validation && !allowable_values.include?(granularity)
         fail ArgumentError, "invalid value for \"granularity\", must be one of #{allowable_values}"
       end
-      allowable_values = ["ttfb"]
+      allowable_values = ["delivery_traffic_flow", "delivery_cache_performance", "delivery_errors", "compute_traffic_flow", "compute_performance", "compute_errors", "content_guard", "content_security", "ddos", "domain_api", "fanout", "image_opto", "ngwaf", "object_storage", "websockets"]
       if @api_client.config.client_side_validation && opts[:'metric_set'] && !allowable_values.include?(opts[:'metric_set'])
         fail ArgumentError, "invalid value for \"metric_set\", must be one of #{allowable_values}"
       end
@@ -83,7 +190,7 @@ module Fastly
         fail ArgumentError, "invalid value for \"region\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/metrics/platform/services/{service_id}/{granularity}'.sub('{' + 'service_id' + '}', CGI.escape(service_id.to_s)).sub('{' + 'granularity' + '}', CGI.escape(granularity.to_s))
+      local_var_path = '/metrics/v2/platform/entities/{entity_id}/{granularity}'.sub('{' + 'entity_id' + '}', CGI.escape(entity_id.to_s)).sub('{' + 'granularity' + '}', CGI.escape(granularity.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -115,7 +222,7 @@ module Fastly
       auth_names = opts[:debug_auth_names] || ['token']
 
       new_options = opts.merge(
-        :operation => :"MetricsPlatformApi.get_platform_metrics_service_historical",
+        :operation => :"MetricsPlatformApi.get_platform_metrics_entity_historical",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -126,7 +233,7 @@ module Fastly
 
       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: MetricsPlatformApi#get_platform_metrics_service_historical\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: MetricsPlatformApi#get_platform_metrics_entity_historical\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end