aws-sdk-prometheusservice 1.29.0 → 1.31.0

data/lib/aws-sdk-prometheusservice/client.rb

@@ -22,6 +22,7 @@ require 'aws-sdk-core/plugins/endpoint_pattern.rb'
 require 'aws-sdk-core/plugins/response_paging.rb'
 require 'aws-sdk-core/plugins/stub_responses.rb'
 require 'aws-sdk-core/plugins/idempotency_token.rb'
+require 'aws-sdk-core/plugins/invocation_id.rb'
 require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
@@ -72,6 +73,7 @@ module Aws::PrometheusService
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
+    add_plugin(Aws::Plugins::InvocationId)
     add_plugin(Aws::Plugins::JsonvalueConverter)
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
@@ -196,10 +198,17 @@ module Aws::PrometheusService
     #     When set to 'true' the request body will not be compressed
     #     for supported operations.
     #
-    #   @option options [String] :endpoint
-    #     The client endpoint is normally constructed from the `:region`
-    #     option. You should only configure an `:endpoint` when connecting
-    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
+    #   @option options [String, URI::HTTPS, URI::HTTP] :endpoint
+    #     Normally you should not configure the `:endpoint` option
+    #     directly. This is normally constructed from the `:region`
+    #     option. Configuring `:endpoint` is normally reserved for
+    #     connecting to test or custom endpoints. The endpoint should
+    #     be a URI formatted like:
+    #
+    #         'http://example.com'
+    #         'https://example.com'
+    #         'http://example.com:123'
+    #
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -337,50 +346,65 @@ module Aws::PrometheusService
     #   @option options [Aws::PrometheusService::EndpointProvider] :endpoint_provider
     #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::PrometheusService::EndpointParameters`
     #
-    #   @option options [URI::HTTP,String] :http_proxy A proxy to send
-    #     requests through.  Formatted like 'http://proxy.com:123'.
-    #
-    #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before raising a
-    #     `Timeout::Error`.
-    #
-    #   @option options [Float] :http_read_timeout (60) The default
-    #     number of seconds to wait for response data.  This value can
-    #     safely be set per-request on the session.
-    #
-    #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idle before it is
-    #     considered stale.  Stale connections are closed and removed
-    #     from the pool before making a request.
-    #
-    #   @option options [Float] :http_continue_timeout (1) The number of
-    #     seconds to wait for a 100-continue response before sending the
-    #     request body.  This option has no effect unless the request has
-    #     "Expect" header set to "100-continue".  Defaults to `nil` which
-    #     disables this behaviour.  This value can safely be set per
-    #     request on the session.
-    #
-    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
-    #     in seconds.
+    #   @option options [Float] :http_continue_timeout (1)
+    #     The number of seconds to wait for a 100-continue response before sending the
+    #     request body.  This option has no effect unless the request has "Expect"
+    #     header set to "100-continue".  Defaults to `nil` which  disables this
+    #     behaviour.  This value can safely be set per request on the session.
+    #
+    #   @option options [Float] :http_idle_timeout (5)
+    #     The number of seconds a connection is allowed to sit idle before it
+    #     is considered stale.  Stale connections are closed and removed from the
+    #     pool before making a request.
+    #
+    #   @option options [Float] :http_open_timeout (15)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [URI::HTTP,String] :http_proxy
+    #     A proxy to send requests through.  Formatted like 'http://proxy.com:123'.
+    #
+    #   @option options [Float] :http_read_timeout (60)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [Boolean] :http_wire_trace (false)
+    #     When `true`,  HTTP debug output will be sent to the `:logger`.
+    #
+    #   @option options [Proc] :on_chunk_received
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the response body is received. It provides three arguments: the chunk,
+    #     the number of bytes received, and the total number of
+    #     bytes in the response (or nil if the server did not send a `content-length`).
+    #
+    #   @option options [Proc] :on_chunk_sent
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the request body is sent. It provides three arguments: the chunk,
+    #     the number of bytes read from the body, and the total number of
+    #     bytes in the body.
+    #
+    #   @option options [Boolean] :raise_response_errors (true)
+    #     When `true`, response errors are raised.
+    #
+    #   @option options [String] :ssl_ca_bundle
+    #     Full path to the SSL certificate authority bundle file that should be used when
+    #     verifying peer certificates.  If you do not pass `:ssl_ca_bundle` or
+    #     `:ssl_ca_directory` the the system default will be used if available.
+    #
+    #   @option options [String] :ssl_ca_directory
+    #     Full path of the directory that contains the unbundled SSL certificate
+    #     authority files for verifying peer certificates.  If you do
+    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system
+    #     default will be used if available.
     #
-    #   @option options [Boolean] :http_wire_trace (false) When `true`,
-    #     HTTP debug output will be sent to the `:logger`.
+    #   @option options [String] :ssl_ca_store
+    #     Sets the X509::Store to verify peer certificate.
     #
-    #   @option options [Boolean] :ssl_verify_peer (true) When `true`,
-    #     SSL peer certificates are verified when establishing a
-    #     connection.
+    #   @option options [Float] :ssl_timeout
+    #     Sets the SSL timeout in seconds
     #
-    #   @option options [String] :ssl_ca_bundle Full path to the SSL
-    #     certificate authority bundle file that should be used when
-    #     verifying peer certificates.  If you do not pass
-    #     `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
-    #     will be used if available.
-    #
-    #   @option options [String] :ssl_ca_directory Full path of the
-    #     directory that contains the unbundled SSL certificate
-    #     authority files for verifying peer certificates.  If you do
-    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
-    #     system default will be used if available.
+    #   @option options [Boolean] :ssl_verify_peer (true)
+    #     When `true`, SSL peer certificates are verified when establishing a connection.
     #
     def initialize(*args)
       super
@@ -388,22 +412,32 @@ module Aws::PrometheusService
 
     # @!group API Operations
 
-    # Create an alert manager definition.
-    #
-    # @option params [required, String] :workspace_id
-    #   The ID of the workspace in which to create the alert manager
-    #   definition.
-    #
-    # @option params [required, String, StringIO, File] :data
-    #   The alert manager definition data.
+    # The `CreateAlertManagerDefinition` operation creates the alert manager
+    # definition in a workspace. If a workspace already has an alert manager
+    # definition, don't use this operation to update it. Instead, use
+    # `PutAlertManagerDefinition`.
     #
     # @option params [String] :client_token
-    #   Optional, unique, case-sensitive, user-provided identifier to ensure
-    #   the idempotency of the request.
+    #   A unique identifier that you can provide to ensure the idempotency of
+    #   the request. Case-sensitive.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [required, String, StringIO, File] :data
+    #   The alert manager definition to add. A base64-encoded version of the
+    #   YAML alert manager definition file.
+    #
+    #   For details about the alert manager definition, see
+    #   [AlertManagedDefinitionData][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/prometheus/latest/APIReference/yaml-AlertManagerDefinitionData.html
+    #
+    # @option params [required, String] :workspace_id
+    #   The ID of the workspace to add the alert manager definition to.
+    #
     # @return [Types::CreateAlertManagerDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateAlertManagerDefinitionResponse#status #status} => Types::AlertManagerDefinitionStatus
@@ -411,9 +445,9 @@ module Aws::PrometheusService
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_alert_manager_definition({
-    #     workspace_id: "WorkspaceId", # required
-    #     data: "data", # required
     #     client_token: "IdempotencyToken",
+    #     data: "data", # required
+    #     workspace_id: "WorkspaceId", # required
     #   })
     #
     # @example Response structure
@@ -430,22 +464,24 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Create logging configuration.
-    #
-    # @option params [required, String] :workspace_id
-    #   The ID of the workspace to vend logs to.
-    #
-    # @option params [required, String] :log_group_arn
-    #   The ARN of the CW log group to which the vended log data will be
-    #   published.
+    # The `CreateLoggingConfiguration` operation creates a logging
+    # configuration for the workspace. Use this operation to set the
+    # CloudWatch log group to which the logs will be published to.
     #
     # @option params [String] :client_token
-    #   Optional, unique, case-sensitive, user-provided identifier to ensure
-    #   the idempotency of the request.
+    #   A unique identifier that you can provide to ensure the idempotency of
+    #   the request. Case-sensitive.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [required, String] :log_group_arn
+    #   The ARN of the CloudWatch log group to which the vended log data will
+    #   be published. This log group must exist prior to calling this API.
+    #
+    # @option params [required, String] :workspace_id
+    #   The ID of the workspace to create the logging configuration for.
+    #
     # @return [Types::CreateLoggingConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateLoggingConfigurationResponse#status #status} => Types::LoggingConfigurationStatus
@@ -453,9 +489,9 @@ module Aws::PrometheusService
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_logging_configuration({
-    #     workspace_id: "WorkspaceId", # required
-    #     log_group_arn: "LogGroupArn", # required
     #     client_token: "IdempotencyToken",
+    #     log_group_arn: "LogGroupArn", # required
+    #     workspace_id: "WorkspaceId", # required
     #   })
     #
     # @example Response structure
@@ -472,50 +508,67 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Create a rule group namespace.
-    #
-    # @option params [required, String] :workspace_id
-    #   The ID of the workspace in which to create the rule group namespace.
+    # The `CreateRuleGroupsNamespace` operation creates a rule groups
+    # namespace within a workspace. A rule groups namespace is associated
+    # with exactly one rules file. A workspace can have multiple rule groups
+    # namespaces.
     #
-    # @option params [required, String] :name
-    #   The rule groups namespace name.
-    #
-    # @option params [required, String, StringIO, File] :data
-    #   The namespace data that define the rule groups.
+    # Use this operation only to create new rule groups namespaces. To
+    # update an existing rule groups namespace, use
+    # `PutRuleGroupsNamespace`.
     #
     # @option params [String] :client_token
-    #   Optional, unique, case-sensitive, user-provided identifier to ensure
-    #   the idempotency of the request.
+    #   A unique identifier that you can provide to ensure the idempotency of
+    #   the request. Case-sensitive.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [required, String, StringIO, File] :data
+    #   The rules file to use in the new namespace.
+    #
+    #   Contains the base64-encoded version of the YAML rules file.
+    #
+    #   For details about the rule groups namespace structure, see
+    #   [RuleGroupsNamespaceData][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/prometheus/latest/APIReference/yaml-RuleGroupsNamespaceData.html
+    #
+    # @option params [required, String] :name
+    #   The name for the new rule groups namespace.
+    #
     # @option params [Hash<String,String>] :tags
-    #   Optional, user-provided tags for this rule groups namespace.
+    #   The list of tag keys and values to associate with the rule groups
+    #   namespace.
+    #
+    # @option params [required, String] :workspace_id
+    #   The ID of the workspace to add the rule groups namespace.
     #
     # @return [Types::CreateRuleGroupsNamespaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
-    #   * {Types::CreateRuleGroupsNamespaceResponse#name #name} => String
     #   * {Types::CreateRuleGroupsNamespaceResponse#arn #arn} => String
+    #   * {Types::CreateRuleGroupsNamespaceResponse#name #name} => String
     #   * {Types::CreateRuleGroupsNamespaceResponse#status #status} => Types::RuleGroupsNamespaceStatus
     #   * {Types::CreateRuleGroupsNamespaceResponse#tags #tags} => Hash&lt;String,String&gt;
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_rule_groups_namespace({
-    #     workspace_id: "WorkspaceId", # required
-    #     name: "RuleGroupsNamespaceName", # required
-    #     data: "data", # required
     #     client_token: "IdempotencyToken",
+    #     data: "data", # required
+    #     name: "RuleGroupsNamespaceName", # required
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
+    #     workspace_id: "WorkspaceId", # required
     #   })
     #
     # @example Response structure
     #
-    #   resp.name #=> String
     #   resp.arn #=> String
+    #   resp.name #=> String
     #   resp.status.status_code #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATION_FAILED", "UPDATE_FAILED"
     #   resp.status.status_reason #=> String
     #   resp.tags #=> Hash
@@ -530,36 +583,68 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Create a scraper.
+    # The `CreateScraper` operation creates a scraper to collect metrics. A
+    # scraper pulls metrics from Prometheus-compatible sources within an
+    # Amazon EKS cluster, and sends them to your Amazon Managed Service for
+    # Prometheus workspace. You can configure the scraper to control what
+    # metrics are collected, and what transformations are applied prior to
+    # sending them to your workspace.
     #
-    # @option params [String] :alias
-    #   An optional user-assigned alias for this scraper. This alias is for
-    #   user reference and does not need to be unique.
+    # If needed, an IAM role will be created for you that gives Amazon
+    # Managed Service for Prometheus access to the metrics in your cluster.
+    # For more information, see [Using roles for scraping metrics from
+    # EKS][1] in the *Amazon Managed Service for Prometheus User Guide*.
     #
-    # @option params [required, Types::ScrapeConfiguration] :scrape_configuration
-    #   The configuration used to create the scraper.
+    # You cannot update a scraper. If you want to change the configuration
+    # of the scraper, create a new scraper and delete the old one.
+    #
+    # The `scrapeConfiguration` parameter contains the base64-encoded
+    # version of the YAML configuration file.
+    #
+    # <note markdown="1"> For more information about collectors, including what metrics are
+    # collected, and how to configure the scraper, see [Amazon Web Services
+    # managed collectors][2] in the *Amazon Managed Service for Prometheus
+    # User Guide*.
+    #
+    #  </note>
     #
-    # @option params [required, Types::Source] :source
-    #   The source that the scraper will be discovering and collecting metrics
-    #   from.
     #
-    # @option params [required, Types::Destination] :destination
-    #   The destination that the scraper will be producing metrics to.
+    #
+    # [1]: https://docs.aws.amazon.com/prometheus/latest/userguide/using-service-linked-roles.html#using-service-linked-roles-prom-scraper
+    # [2]: https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-collector.html
+    #
+    # @option params [String] :alias
+    #   (optional) a name to associate with the scraper. This is for your use,
+    #   and does not need to be unique.
     #
     # @option params [String] :client_token
-    #   Optional, unique, case-sensitive, user-provided identifier to ensure
-    #   the idempotency of the request.
+    #   (Optional) A unique, case-sensitive identifier that you can provide to
+    #   ensure the idempotency of the request.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [required, Types::Destination] :destination
+    #   The Amazon Managed Service for Prometheus workspace to send metrics
+    #   to.
+    #
+    # @option params [required, Types::ScrapeConfiguration] :scrape_configuration
+    #   The configuration file to use in the new scraper. For more
+    #   information, see [Scraper
+    #   configuration](prometheus/latest/userguide/AMP-collector-how-to.html#AMP-collector-configuration)
+    #   in the *Amazon Managed Service for Prometheus User Guide*.
+    #
+    # @option params [required, Types::Source] :source
+    #   The Amazon EKS cluster from which the scraper will collect metrics.
+    #
     # @option params [Hash<String,String>] :tags
-    #   Optional, user-provided tags for this scraper.
+    #   (Optional) The list of tag keys and values to associate with the
+    #   scraper.
     #
     # @return [Types::CreateScraperResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
-    #   * {Types::CreateScraperResponse#scraper_id #scraper_id} => String
     #   * {Types::CreateScraperResponse#arn #arn} => String
+    #   * {Types::CreateScraperResponse#scraper_id #scraper_id} => String
     #   * {Types::CreateScraperResponse#status #status} => Types::ScraperStatus
     #   * {Types::CreateScraperResponse#tags #tags} => Hash&lt;String,String&gt;
     #
@@ -567,6 +652,12 @@ module Aws::PrometheusService
     #
     #   resp = client.create_scraper({
     #     alias: "ScraperAlias",
+    #     client_token: "IdempotencyToken",
+    #     destination: { # required
+    #       amp_configuration: {
+    #         workspace_arn: "WorkspaceArn", # required
+    #       },
+    #     },
     #     scrape_configuration: { # required
     #       configuration_blob: "data",
     #     },
@@ -577,12 +668,6 @@ module Aws::PrometheusService
     #         subnet_ids: ["SubnetId"], # required
     #       },
     #     },
-    #     destination: { # required
-    #       amp_configuration: {
-    #         workspace_arn: "WorkspaceArn", # required
-    #       },
-    #     },
-    #     client_token: "IdempotencyToken",
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
@@ -590,8 +675,8 @@ module Aws::PrometheusService
     #
     # @example Response structure
     #
-    #   resp.scraper_id #=> String
     #   resp.arn #=> String
+    #   resp.scraper_id #=> String
     #   resp.status.status_code #=> String, one of "CREATING", "ACTIVE", "DELETING", "CREATION_FAILED", "DELETION_FAILED"
     #   resp.tags #=> Hash
     #   resp.tags["TagKey"] #=> String
@@ -605,53 +690,64 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Creates a new AMP workspace.
+    # Creates a Prometheus workspace. A workspace is a logical space
+    # dedicated to the storage and querying of Prometheus metrics. You can
+    # have one or more workspaces in each Region in your account.
     #
     # @option params [String] :alias
-    #   An optional user-assigned alias for this workspace. This alias is for
-    #   user reference and does not need to be unique.
+    #   An alias that you assign to this workspace to help you identify it. It
+    #   does not need to be unique.
+    #
+    #   Blank spaces at the beginning or end of the alias that you specify
+    #   will be trimmed from the value used.
     #
     # @option params [String] :client_token
-    #   Optional, unique, case-sensitive, user-provided identifier to ensure
-    #   the idempotency of the request.
+    #   A unique identifier that you can provide to ensure the idempotency of
+    #   the request. Case-sensitive.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
-    # @option params [Hash<String,String>] :tags
-    #   Optional, user-provided tags for this workspace.
-    #
     # @option params [String] :kms_key_arn
-    #   Optional, customer managed KMS key used to encrypt data for this
-    #   workspace
+    #   (optional) The ARN for a customer managed KMS key to use for
+    #   encrypting data within your workspace. For more information about
+    #   using your own key in your workspace, see [Encryption at rest][1] in
+    #   the *Amazon Managed Service for Prometheus User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/prometheus/latest/userguide/encryption-at-rest-Amazon-Service-Prometheus.html
+    #
+    # @option params [Hash<String,String>] :tags
+    #   The list of tag keys and values to associate with the workspace.
     #
     # @return [Types::CreateWorkspaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
-    #   * {Types::CreateWorkspaceResponse#workspace_id #workspace_id} => String
     #   * {Types::CreateWorkspaceResponse#arn #arn} => String
+    #   * {Types::CreateWorkspaceResponse#kms_key_arn #kms_key_arn} => String
     #   * {Types::CreateWorkspaceResponse#status #status} => Types::WorkspaceStatus
     #   * {Types::CreateWorkspaceResponse#tags #tags} => Hash&lt;String,String&gt;
-    #   * {Types::CreateWorkspaceResponse#kms_key_arn #kms_key_arn} => String
+    #   * {Types::CreateWorkspaceResponse#workspace_id #workspace_id} => String
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_workspace({
     #     alias: "WorkspaceAlias",
     #     client_token: "IdempotencyToken",
+    #     kms_key_arn: "KmsKeyArn",
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
-    #     kms_key_arn: "KmsKeyArn",
     #   })
     #
     # @example Response structure
     #
-    #   resp.workspace_id #=> String
     #   resp.arn #=> String
+    #   resp.kms_key_arn #=> String
     #   resp.status.status_code #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATION_FAILED"
     #   resp.tags #=> Hash
     #   resp.tags["TagKey"] #=> String
-    #   resp.kms_key_arn #=> String
+    #   resp.workspace_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/CreateWorkspace AWS API Documentation
     #
@@ -662,26 +758,25 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Deletes an alert manager definition.
-    #
-    # @option params [required, String] :workspace_id
-    #   The ID of the workspace in which to delete the alert manager
-    #   definition.
+    # Deletes the alert manager definition from a workspace.
     #
     # @option params [String] :client_token
-    #   Optional, unique, case-sensitive, user-provided identifier to ensure
-    #   the idempotency of the request.
+    #   A unique identifier that you can provide to ensure the idempotency of
+    #   the request. Case-sensitive.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [required, String] :workspace_id
+    #   The ID of the workspace to delete the alert manager definition from.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_alert_manager_definition({
-    #     workspace_id: "WorkspaceId", # required
     #     client_token: "IdempotencyToken",
+    #     workspace_id: "WorkspaceId", # required
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/DeleteAlertManagerDefinition AWS API Documentation
@@ -693,25 +788,26 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Delete logging configuration.
-    #
-    # @option params [required, String] :workspace_id
-    #   The ID of the workspace to vend logs to.
+    # Deletes the logging configuration for a workspace.
     #
     # @option params [String] :client_token
-    #   Optional, unique, case-sensitive, user-provided identifier to ensure
-    #   the idempotency of the request.
+    #   A unique identifier that you can provide to ensure the idempotency of
+    #   the request. Case-sensitive.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [required, String] :workspace_id
+    #   The ID of the workspace containing the logging configuration to
+    #   delete.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_logging_configuration({
-    #     workspace_id: "WorkspaceId", # required
     #     client_token: "IdempotencyToken",
+    #     workspace_id: "WorkspaceId", # required
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/DeleteLoggingConfiguration AWS API Documentation
@@ -723,29 +819,31 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Delete a rule groups namespace.
-    #
-    # @option params [required, String] :workspace_id
-    #   The ID of the workspace to delete rule group definition.
-    #
-    # @option params [required, String] :name
-    #   The rule groups namespace name.
+    # Deletes one rule groups namespace and its associated rule groups
+    # definition.
     #
     # @option params [String] :client_token
-    #   Optional, unique, case-sensitive, user-provided identifier to ensure
-    #   the idempotency of the request.
+    #   A unique identifier that you can provide to ensure the idempotency of
+    #   the request. Case-sensitive.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [required, String] :name
+    #   The name of the rule groups namespace to delete.
+    #
+    # @option params [required, String] :workspace_id
+    #   The ID of the workspace containing the rule groups namespace and
+    #   definition to delete.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_rule_groups_namespace({
-    #     workspace_id: "WorkspaceId", # required
-    #     name: "RuleGroupsNamespaceName", # required
     #     client_token: "IdempotencyToken",
+    #     name: "RuleGroupsNamespaceName", # required
+    #     workspace_id: "WorkspaceId", # required
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/DeleteRuleGroupsNamespace AWS API Documentation
@@ -757,18 +855,19 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Deletes a scraper.
-    #
-    # @option params [required, String] :scraper_id
-    #   The ID of the scraper to delete.
+    # The `DeleteScraper` operation deletes one scraper, and stops any
+    # metrics collection that the scraper performs.
     #
     # @option params [String] :client_token
-    #   Optional, unique, case-sensitive, user-provided identifier to ensure
-    #   the idempotency of the request.
+    #   (Optional) A unique, case-sensitive identifier that you can provide to
+    #   ensure the idempotency of the request.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [required, String] :scraper_id
+    #   The ID of the scraper to delete.
+    #
     # @return [Types::DeleteScraperResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DeleteScraperResponse#scraper_id #scraper_id} => String
@@ -777,8 +876,8 @@ module Aws::PrometheusService
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_scraper({
-    #     scraper_id: "ScraperId", # required
     #     client_token: "IdempotencyToken",
+    #     scraper_id: "ScraperId", # required
     #   })
     #
     # @example Response structure
@@ -795,25 +894,31 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Deletes an AMP workspace.
+    # Deletes an existing workspace.
     #
-    # @option params [required, String] :workspace_id
-    #   The ID of the workspace to delete.
+    # <note markdown="1"> When you delete a workspace, the data that has been ingested into it
+    # is not immediately deleted. It will be permanently deleted within one
+    # month.
+    #
+    #  </note>
     #
     # @option params [String] :client_token
-    #   Optional, unique, case-sensitive, user-provided identifier to ensure
-    #   the idempotency of the request.
+    #   A unique identifier that you can provide to ensure the idempotency of
+    #   the request. Case-sensitive.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [required, String] :workspace_id
+    #   The ID of the workspace to delete.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_workspace({
-    #     workspace_id: "WorkspaceId", # required
     #     client_token: "IdempotencyToken",
+    #     workspace_id: "WorkspaceId", # required
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/DeleteWorkspace AWS API Documentation
@@ -825,10 +930,11 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Describes an alert manager definition.
+    # Retrieves the full information about the alert manager definition for
+    # a workspace.
     #
     # @option params [required, String] :workspace_id
-    #   The ID of the workspace to describe.
+    #   The ID of the workspace to retrieve the alert manager definition from.
     #
     # @return [Types::DescribeAlertManagerDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -842,11 +948,11 @@ module Aws::PrometheusService
     #
     # @example Response structure
     #
-    #   resp.alert_manager_definition.status.status_code #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATION_FAILED", "UPDATE_FAILED"
-    #   resp.alert_manager_definition.status.status_reason #=> String
-    #   resp.alert_manager_definition.data #=> String
     #   resp.alert_manager_definition.created_at #=> Time
+    #   resp.alert_manager_definition.data #=> String
     #   resp.alert_manager_definition.modified_at #=> Time
+    #   resp.alert_manager_definition.status.status_code #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATION_FAILED", "UPDATE_FAILED"
+    #   resp.alert_manager_definition.status.status_reason #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/DescribeAlertManagerDefinition AWS API Documentation
     #
@@ -857,10 +963,11 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Describes logging configuration.
+    # Returns complete information about the current logging configuration
+    # of the workspace.
     #
     # @option params [required, String] :workspace_id
-    #   The ID of the workspace to vend logs to.
+    #   The ID of the workspace to describe the logging configuration for.
     #
     # @return [Types::DescribeLoggingConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -874,12 +981,12 @@ module Aws::PrometheusService
     #
     # @example Response structure
     #
+    #   resp.logging_configuration.created_at #=> Time
+    #   resp.logging_configuration.log_group_arn #=> String
+    #   resp.logging_configuration.modified_at #=> Time
     #   resp.logging_configuration.status.status_code #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATION_FAILED", "UPDATE_FAILED"
     #   resp.logging_configuration.status.status_reason #=> String
     #   resp.logging_configuration.workspace #=> String
-    #   resp.logging_configuration.log_group_arn #=> String
-    #   resp.logging_configuration.created_at #=> Time
-    #   resp.logging_configuration.modified_at #=> Time
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/DescribeLoggingConfiguration AWS API Documentation
     #
@@ -890,13 +997,15 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Describe a rule groups namespace.
-    #
-    # @option params [required, String] :workspace_id
-    #   The ID of the workspace to describe.
+    # Returns complete information about one rule groups namespace. To
+    # retrieve a list of rule groups namespaces, use
+    # `ListRuleGroupsNamespaces`.
     #
     # @option params [required, String] :name
-    #   The rule groups namespace.
+    #   The name of the rule groups namespace that you want information for.
+    #
+    # @option params [required, String] :workspace_id
+    #   The ID of the workspace containing the rule groups namespace.
     #
     # @return [Types::DescribeRuleGroupsNamespaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -905,19 +1014,19 @@ module Aws::PrometheusService
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_rule_groups_namespace({
-    #     workspace_id: "WorkspaceId", # required
     #     name: "RuleGroupsNamespaceName", # required
+    #     workspace_id: "WorkspaceId", # required
     #   })
     #
     # @example Response structure
     #
     #   resp.rule_groups_namespace.arn #=> String
+    #   resp.rule_groups_namespace.created_at #=> Time
+    #   resp.rule_groups_namespace.data #=> String
+    #   resp.rule_groups_namespace.modified_at #=> Time
     #   resp.rule_groups_namespace.name #=> String
     #   resp.rule_groups_namespace.status.status_code #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATION_FAILED", "UPDATE_FAILED"
     #   resp.rule_groups_namespace.status.status_reason #=> String
-    #   resp.rule_groups_namespace.data #=> String
-    #   resp.rule_groups_namespace.created_at #=> Time
-    #   resp.rule_groups_namespace.modified_at #=> Time
     #   resp.rule_groups_namespace.tags #=> Hash
     #   resp.rule_groups_namespace.tags["TagKey"] #=> String
     #
@@ -930,10 +1039,11 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Describe an existing scraper.
+    # The `DescribeScraper` operation displays information about an existing
+    # scraper.
     #
     # @option params [required, String] :scraper_id
-    #   The IDs of the scraper to describe.
+    #   The ID of the scraper to describe.
     #
     # @return [Types::DescribeScraperResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -948,22 +1058,22 @@ module Aws::PrometheusService
     # @example Response structure
     #
     #   resp.scraper.alias #=> String
-    #   resp.scraper.scraper_id #=> String
     #   resp.scraper.arn #=> String
-    #   resp.scraper.role_arn #=> String
-    #   resp.scraper.status.status_code #=> String, one of "CREATING", "ACTIVE", "DELETING", "CREATION_FAILED", "DELETION_FAILED"
     #   resp.scraper.created_at #=> Time
+    #   resp.scraper.destination.amp_configuration.workspace_arn #=> String
     #   resp.scraper.last_modified_at #=> Time
-    #   resp.scraper.tags #=> Hash
-    #   resp.scraper.tags["TagKey"] #=> String
-    #   resp.scraper.status_reason #=> String
+    #   resp.scraper.role_arn #=> String
     #   resp.scraper.scrape_configuration.configuration_blob #=> String
+    #   resp.scraper.scraper_id #=> String
     #   resp.scraper.source.eks_configuration.cluster_arn #=> String
     #   resp.scraper.source.eks_configuration.security_group_ids #=> Array
     #   resp.scraper.source.eks_configuration.security_group_ids[0] #=> String
     #   resp.scraper.source.eks_configuration.subnet_ids #=> Array
     #   resp.scraper.source.eks_configuration.subnet_ids[0] #=> String
-    #   resp.scraper.destination.amp_configuration.workspace_arn #=> String
+    #   resp.scraper.status.status_code #=> String, one of "CREATING", "ACTIVE", "DELETING", "CREATION_FAILED", "DELETION_FAILED"
+    #   resp.scraper.status_reason #=> String
+    #   resp.scraper.tags #=> Hash
+    #   resp.scraper.tags["TagKey"] #=> String
     #
     #
     # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -980,7 +1090,7 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Describes an existing AMP workspace.
+    # Returns information about an existing workspace.
     #
     # @option params [required, String] :workspace_id
     #   The ID of the workspace to describe.
@@ -997,15 +1107,15 @@ module Aws::PrometheusService
     #
     # @example Response structure
     #
-    #   resp.workspace.workspace_id #=> String
     #   resp.workspace.alias #=> String
     #   resp.workspace.arn #=> String
-    #   resp.workspace.status.status_code #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATION_FAILED"
-    #   resp.workspace.prometheus_endpoint #=> String
     #   resp.workspace.created_at #=> Time
+    #   resp.workspace.kms_key_arn #=> String
+    #   resp.workspace.prometheus_endpoint #=> String
+    #   resp.workspace.status.status_code #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATION_FAILED"
     #   resp.workspace.tags #=> Hash
     #   resp.workspace.tags["TagKey"] #=> String
-    #   resp.workspace.kms_key_arn #=> String
+    #   resp.workspace.workspace_id #=> String
     #
     #
     # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -1022,7 +1132,8 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Gets a default configuration.
+    # The `GetDefaultScraperConfiguration` operation returns the default
+    # scraper configuration used when Amazon EKS creates a scraper for you.
     #
     # @return [Types::GetDefaultScraperConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1041,51 +1152,57 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Lists rule groups namespaces.
+    # Returns a list of rule groups namespaces in a workspace.
     #
-    # @option params [required, String] :workspace_id
-    #   The ID of the workspace.
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return. The default is 100.
     #
     # @option params [String] :name
-    #   Optional filter for rule groups namespace name. Only the rule groups
-    #   namespace that begin with this value will be returned.
+    #   Use this parameter to filter the rule groups namespaces that are
+    #   returned. Only the namespaces with names that begin with the value
+    #   that you specify are returned.
     #
     # @option params [String] :next_token
-    #   Pagination token to request the next page in a paginated list. This
-    #   token is obtained from the output of the previous
-    #   ListRuleGroupsNamespaces request.
+    #   The token for the next set of items to return. You receive this token
+    #   from a previous call, and use it to get the next page of results. The
+    #   other parameters must be the same as the initial call.
     #
-    # @option params [Integer] :max_results
-    #   Maximum results to return in response (default=100, maximum=1000).
+    #   For example, if your initial request has `maxResults` of 10, and there
+    #   are 12 rule groups namespaces to return, then your initial request
+    #   will return 10 and a `nextToken`. Using the next token in a subsequent
+    #   call will return the remaining 2 namespaces.
+    #
+    # @option params [required, String] :workspace_id
+    #   The ID of the workspace containing the rule groups namespaces.
     #
     # @return [Types::ListRuleGroupsNamespacesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
-    #   * {Types::ListRuleGroupsNamespacesResponse#rule_groups_namespaces #rule_groups_namespaces} => Array&lt;Types::RuleGroupsNamespaceSummary&gt;
     #   * {Types::ListRuleGroupsNamespacesResponse#next_token #next_token} => String
+    #   * {Types::ListRuleGroupsNamespacesResponse#rule_groups_namespaces #rule_groups_namespaces} => Array&lt;Types::RuleGroupsNamespaceSummary&gt;
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_rule_groups_namespaces({
-    #     workspace_id: "WorkspaceId", # required
+    #     max_results: 1,
     #     name: "RuleGroupsNamespaceName",
     #     next_token: "PaginationToken",
-    #     max_results: 1,
+    #     workspace_id: "WorkspaceId", # required
     #   })
     #
     # @example Response structure
     #
+    #   resp.next_token #=> String
     #   resp.rule_groups_namespaces #=> Array
     #   resp.rule_groups_namespaces[0].arn #=> String
+    #   resp.rule_groups_namespaces[0].created_at #=> Time
+    #   resp.rule_groups_namespaces[0].modified_at #=> Time
     #   resp.rule_groups_namespaces[0].name #=> String
     #   resp.rule_groups_namespaces[0].status.status_code #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATION_FAILED", "UPDATE_FAILED"
     #   resp.rule_groups_namespaces[0].status.status_reason #=> String
-    #   resp.rule_groups_namespaces[0].created_at #=> Time
-    #   resp.rule_groups_namespaces[0].modified_at #=> Time
     #   resp.rule_groups_namespaces[0].tags #=> Hash
     #   resp.rule_groups_namespaces[0].tags["TagKey"] #=> String
-    #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/ListRuleGroupsNamespaces AWS API Documentation
     #
@@ -1096,25 +1213,43 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Lists all scrapers in a customer account, including scrapers being
-    # created or deleted. You may provide filters to return a more specific
-    # list of results.
+    # The `ListScrapers` operation lists all of the scrapers in your
+    # account. This includes scrapers being created or deleted. You can
+    # optionally filter the returned list.
     #
     # @option params [Hash<String,Array>] :filters
-    #   A list of scraper filters.
+    #   (Optional) A list of key-value pairs to filter the list of scrapers
+    #   returned. Keys include `status`, `sourceArn`, `destinationArn`, and
+    #   `alias`.
     #
-    # @option params [String] :next_token
-    #   Pagination token to request the next page in a paginated list. This
-    #   token is obtained from the output of the previous ListScrapers
-    #   request.
+    #   Filters on the same key are `OR`'d together, and filters on different
+    #   keys are `AND`'d together. For example,
+    #   `status=ACTIVE&status=CREATING&alias=Test`, will return all scrapers
+    #   that have the alias Test, and are either in status ACTIVE or CREATING.
+    #
+    #   To find all active scrapers that are sending metrics to a specific
+    #   Amazon Managed Service for Prometheus workspace, you would use the ARN
+    #   of the workspace in a query:
+    #
+    #   `status=ACTIVE&destinationArn=arn:aws:aps:us-east-1:123456789012:workspace/ws-example1-1234-abcd-56ef-123456789012`
+    #
+    #   If this is included, it filters the results to only the scrapers that
+    #   match the filter.
     #
     # @option params [Integer] :max_results
-    #   Maximum results to return in response (default=100, maximum=1000).
+    #   Optional) The maximum number of scrapers to return in one
+    #   `ListScrapers` operation. The range is 1-1000.
+    #
+    #   If you omit this parameter, the default of 100 is used.
+    #
+    # @option params [String] :next_token
+    #   (Optional) The token for the next set of items to return. (You
+    #   received this token from a previous call.)
     #
     # @return [Types::ListScrapersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
-    #   * {Types::ListScrapersResponse#scrapers #scrapers} => Array&lt;Types::ScraperSummary&gt;
     #   * {Types::ListScrapersResponse#next_token #next_token} => String
+    #   * {Types::ListScrapersResponse#scrapers #scrapers} => Array&lt;Types::ScraperSummary&gt;
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
@@ -1124,30 +1259,30 @@ module Aws::PrometheusService
     #     filters: {
     #       "FilterKey" => ["FilterValue"],
     #     },
-    #     next_token: "PaginationToken",
     #     max_results: 1,
+    #     next_token: "PaginationToken",
     #   })
     #
     # @example Response structure
     #
+    #   resp.next_token #=> String
     #   resp.scrapers #=> Array
     #   resp.scrapers[0].alias #=> String
-    #   resp.scrapers[0].scraper_id #=> String
     #   resp.scrapers[0].arn #=> String
-    #   resp.scrapers[0].role_arn #=> String
-    #   resp.scrapers[0].status.status_code #=> String, one of "CREATING", "ACTIVE", "DELETING", "CREATION_FAILED", "DELETION_FAILED"
     #   resp.scrapers[0].created_at #=> Time
+    #   resp.scrapers[0].destination.amp_configuration.workspace_arn #=> String
     #   resp.scrapers[0].last_modified_at #=> Time
-    #   resp.scrapers[0].tags #=> Hash
-    #   resp.scrapers[0].tags["TagKey"] #=> String
-    #   resp.scrapers[0].status_reason #=> String
+    #   resp.scrapers[0].role_arn #=> String
+    #   resp.scrapers[0].scraper_id #=> String
     #   resp.scrapers[0].source.eks_configuration.cluster_arn #=> String
     #   resp.scrapers[0].source.eks_configuration.security_group_ids #=> Array
     #   resp.scrapers[0].source.eks_configuration.security_group_ids[0] #=> String
     #   resp.scrapers[0].source.eks_configuration.subnet_ids #=> Array
     #   resp.scrapers[0].source.eks_configuration.subnet_ids[0] #=> String
-    #   resp.scrapers[0].destination.amp_configuration.workspace_arn #=> String
-    #   resp.next_token #=> String
+    #   resp.scrapers[0].status.status_code #=> String, one of "CREATING", "ACTIVE", "DELETING", "CREATION_FAILED", "DELETION_FAILED"
+    #   resp.scrapers[0].status_reason #=> String
+    #   resp.scrapers[0].tags #=> Hash
+    #   resp.scrapers[0].tags["TagKey"] #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/ListScrapers AWS API Documentation
     #
@@ -1158,10 +1293,14 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Lists the tags you have assigned to the resource.
+    # The `ListTagsForResource` operation returns the tags that are
+    # associated with an Amazon Managed Service for Prometheus resource.
+    # Currently, the only resources that can be tagged are workspaces and
+    # rule groups namespaces.
     #
     # @option params [required, String] :resource_arn
-    #   The ARN of the resource.
+    #   The ARN of the resource to list tages for. Must be a workspace or rule
+    #   groups namespace resource.
     #
     # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1187,48 +1326,57 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Lists all AMP workspaces, including workspaces being created or
-    # deleted.
-    #
-    # @option params [String] :next_token
-    #   Pagination token to request the next page in a paginated list. This
-    #   token is obtained from the output of the previous ListWorkspaces
-    #   request.
+    # Lists all of the Amazon Managed Service for Prometheus workspaces in
+    # your account. This includes workspaces being created or deleted.
     #
     # @option params [String] :alias
-    #   Optional filter for workspace alias. Only the workspaces with aliases
-    #   that begin with this value will be returned.
+    #   If this is included, it filters the results to only the workspaces
+    #   with names that start with the value that you specify here.
+    #
+    #   Amazon Managed Service for Prometheus will automatically strip any
+    #   blank spaces from the beginning and end of the alias that you specify.
     #
     # @option params [Integer] :max_results
-    #   Maximum results to return in response (default=100, maximum=1000).
+    #   The maximum number of workspaces to return per request. The default is
+    #   100.
+    #
+    # @option params [String] :next_token
+    #   The token for the next set of items to return. You receive this token
+    #   from a previous call, and use it to get the next page of results. The
+    #   other parameters must be the same as the initial call.
+    #
+    #   For example, if your initial request has `maxResults` of 10, and there
+    #   are 12 workspaces to return, then your initial request will return 10
+    #   and a `nextToken`. Using the next token in a subsequent call will
+    #   return the remaining 2 workspaces.
     #
     # @return [Types::ListWorkspacesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
-    #   * {Types::ListWorkspacesResponse#workspaces #workspaces} => Array&lt;Types::WorkspaceSummary&gt;
     #   * {Types::ListWorkspacesResponse#next_token #next_token} => String
+    #   * {Types::ListWorkspacesResponse#workspaces #workspaces} => Array&lt;Types::WorkspaceSummary&gt;
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_workspaces({
-    #     next_token: "PaginationToken",
     #     alias: "WorkspaceAlias",
     #     max_results: 1,
+    #     next_token: "PaginationToken",
     #   })
     #
     # @example Response structure
     #
+    #   resp.next_token #=> String
     #   resp.workspaces #=> Array
-    #   resp.workspaces[0].workspace_id #=> String
     #   resp.workspaces[0].alias #=> String
     #   resp.workspaces[0].arn #=> String
-    #   resp.workspaces[0].status.status_code #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATION_FAILED"
     #   resp.workspaces[0].created_at #=> Time
+    #   resp.workspaces[0].kms_key_arn #=> String
+    #   resp.workspaces[0].status.status_code #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATION_FAILED"
     #   resp.workspaces[0].tags #=> Hash
     #   resp.workspaces[0].tags["TagKey"] #=> String
-    #   resp.workspaces[0].kms_key_arn #=> String
-    #   resp.next_token #=> String
+    #   resp.workspaces[0].workspace_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/ListWorkspaces AWS API Documentation
     #
@@ -1239,22 +1387,32 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Update an alert manager definition.
-    #
-    # @option params [required, String] :workspace_id
-    #   The ID of the workspace in which to update the alert manager
-    #   definition.
-    #
-    # @option params [required, String, StringIO, File] :data
-    #   The alert manager definition data.
+    # Updates an existing alert manager definition in a workspace. If the
+    # workspace does not already have an alert manager definition, don't
+    # use this operation to create it. Instead, use
+    # `CreateAlertManagerDefinition`.
     #
     # @option params [String] :client_token
-    #   Optional, unique, case-sensitive, user-provided identifier to ensure
-    #   the idempotency of the request.
+    #   A unique identifier that you can provide to ensure the idempotency of
+    #   the request. Case-sensitive.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [required, String, StringIO, File] :data
+    #   The alert manager definition to use. A base64-encoded version of the
+    #   YAML alert manager definition file.
+    #
+    #   For details about the alert manager definition, see
+    #   [AlertManagedDefinitionData][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/prometheus/latest/APIReference/yaml-AlertManagerDefinitionData.html
+    #
+    # @option params [required, String] :workspace_id
+    #   The ID of the workspace to update the alert manager definition in.
+    #
     # @return [Types::PutAlertManagerDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::PutAlertManagerDefinitionResponse#status #status} => Types::AlertManagerDefinitionStatus
@@ -1262,9 +1420,9 @@ module Aws::PrometheusService
     # @example Request syntax with placeholder values
     #
     #   resp = client.put_alert_manager_definition({
-    #     workspace_id: "WorkspaceId", # required
-    #     data: "data", # required
     #     client_token: "IdempotencyToken",
+    #     data: "data", # required
+    #     workspace_id: "WorkspaceId", # required
     #   })
     #
     # @example Response structure
@@ -1281,44 +1439,61 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Update a rule groups namespace.
+    # Updates an existing rule groups namespace within a workspace. A rule
+    # groups namespace is associated with exactly one rules file. A
+    # workspace can have multiple rule groups namespaces.
     #
-    # @option params [required, String] :workspace_id
-    #   The ID of the workspace in which to update the rule group namespace.
+    # Use this operation only to update existing rule groups namespaces. To
+    # create a new rule groups namespace, use `CreateRuleGroupsNamespace`.
     #
-    # @option params [required, String] :name
-    #   The rule groups namespace name.
-    #
-    # @option params [required, String, StringIO, File] :data
-    #   The namespace data that define the rule groups.
+    # You can't use this operation to add tags to an existing rule groups
+    # namespace. Instead, use `TagResource`.
     #
     # @option params [String] :client_token
-    #   Optional, unique, case-sensitive, user-provided identifier to ensure
-    #   the idempotency of the request.
+    #   A unique identifier that you can provide to ensure the idempotency of
+    #   the request. Case-sensitive.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [required, String, StringIO, File] :data
+    #   The new rules file to use in the namespace. A base64-encoded version
+    #   of the YAML rule groups file.
+    #
+    #   For details about the rule groups namespace structure, see
+    #   [RuleGroupsNamespaceData][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/prometheus/latest/APIReference/yaml-RuleGroupsNamespaceData.html
+    #
+    # @option params [required, String] :name
+    #   The name of the rule groups namespace that you are updating.
+    #
+    # @option params [required, String] :workspace_id
+    #   The ID of the workspace where you are updating the rule groups
+    #   namespace.
+    #
     # @return [Types::PutRuleGroupsNamespaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
-    #   * {Types::PutRuleGroupsNamespaceResponse#name #name} => String
     #   * {Types::PutRuleGroupsNamespaceResponse#arn #arn} => String
+    #   * {Types::PutRuleGroupsNamespaceResponse#name #name} => String
     #   * {Types::PutRuleGroupsNamespaceResponse#status #status} => Types::RuleGroupsNamespaceStatus
     #   * {Types::PutRuleGroupsNamespaceResponse#tags #tags} => Hash&lt;String,String&gt;
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.put_rule_groups_namespace({
-    #     workspace_id: "WorkspaceId", # required
-    #     name: "RuleGroupsNamespaceName", # required
-    #     data: "data", # required
     #     client_token: "IdempotencyToken",
+    #     data: "data", # required
+    #     name: "RuleGroupsNamespaceName", # required
+    #     workspace_id: "WorkspaceId", # required
     #   })
     #
     # @example Response structure
     #
-    #   resp.name #=> String
     #   resp.arn #=> String
+    #   resp.name #=> String
     #   resp.status.status_code #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATION_FAILED", "UPDATE_FAILED"
     #   resp.status.status_reason #=> String
     #   resp.tags #=> Hash
@@ -1333,13 +1508,22 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Creates tags for the specified resource.
+    # The `TagResource` operation associates tags with an Amazon Managed
+    # Service for Prometheus resource. The only resources that can be tagged
+    # are workspaces and rule groups namespaces.
+    #
+    # If you specify a new tag key for the resource, this tag is appended to
+    # the list of tags associated with the resource. If you specify a tag
+    # key that is already associated with the resource, the new tag value
+    # that you specify replaces the previous value for that tag.
     #
     # @option params [required, String] :resource_arn
-    #   The ARN of the resource.
+    #   The ARN of the workspace or rule groups namespace to apply tags to.
     #
     # @option params [required, Hash<String,String>] :tags
-    #   The list of tags assigned to the resource.
+    #   The list of tag keys and values to associate with the resource.
+    #
+    #   Keys may not begin with `aws:`.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1361,13 +1545,15 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Deletes tags from the specified resource.
+    # Removes the specified tags from an Amazon Managed Service for
+    # Prometheus resource. The only resources that can be tagged are
+    # workspaces and rule groups namespaces.
     #
     # @option params [required, String] :resource_arn
-    #   The ARN of the resource.
+    #   The ARN of the workspace or rule groups namespace.
     #
     # @option params [required, Array<String>] :tag_keys
-    #   One or more tag keys
+    #   The keys of the tags to remove.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1387,22 +1573,23 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Update logging configuration.
-    #
-    # @option params [required, String] :workspace_id
-    #   The ID of the workspace to vend logs to.
-    #
-    # @option params [required, String] :log_group_arn
-    #   The ARN of the CW log group to which the vended log data will be
-    #   published.
+    # Updates the log group ARN or the workspace ID of the current logging
+    # configuration.
     #
     # @option params [String] :client_token
-    #   Optional, unique, case-sensitive, user-provided identifier to ensure
-    #   the idempotency of the request.
+    #   A unique identifier that you can provide to ensure the idempotency of
+    #   the request. Case-sensitive.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [required, String] :log_group_arn
+    #   The ARN of the CloudWatch log group to which the vended log data will
+    #   be published.
+    #
+    # @option params [required, String] :workspace_id
+    #   The ID of the workspace to update the logging configuration for.
+    #
     # @return [Types::UpdateLoggingConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateLoggingConfigurationResponse#status #status} => Types::LoggingConfigurationStatus
@@ -1410,9 +1597,9 @@ module Aws::PrometheusService
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_logging_configuration({
-    #     workspace_id: "WorkspaceId", # required
-    #     log_group_arn: "LogGroupArn", # required
     #     client_token: "IdempotencyToken",
+    #     log_group_arn: "LogGroupArn", # required
+    #     workspace_id: "WorkspaceId", # required
     #   })
     #
     # @example Response structure
@@ -1429,29 +1616,32 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
-    # Updates an AMP workspace alias.
-    #
-    # @option params [required, String] :workspace_id
-    #   The ID of the workspace being updated.
+    # Updates the alias of an existing workspace.
     #
     # @option params [String] :alias
-    #   The new alias of the workspace.
+    #   The new alias for the workspace. It does not need to be unique.
+    #
+    #   Amazon Managed Service for Prometheus will automatically strip any
+    #   blank spaces from the beginning and end of the alias that you specify.
     #
     # @option params [String] :client_token
-    #   Optional, unique, case-sensitive, user-provided identifier to ensure
-    #   the idempotency of the request.
+    #   A unique identifier that you can provide to ensure the idempotency of
+    #   the request. Case-sensitive.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [required, String] :workspace_id
+    #   The ID of the workspace to update.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_workspace_alias({
-    #     workspace_id: "WorkspaceId", # required
     #     alias: "WorkspaceAlias",
     #     client_token: "IdempotencyToken",
+    #     workspace_id: "WorkspaceId", # required
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/UpdateWorkspaceAlias AWS API Documentation
@@ -1476,7 +1666,7 @@ module Aws::PrometheusService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-prometheusservice'
-      context[:gem_version] = '1.29.0'
+      context[:gem_version] = '1.31.0'
       Seahorse::Client::Request.new(handlers, context)
     end