aws-sdk-prometheusservice 1.43.0 → 1.44.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18ae2a19dd4f200102102e99b630476acfd5b552716dae2d93628e7e6eb8582d
-  data.tar.gz: 5b445d0b1c6b29e84a1f243e3bd0b2c1e976df2390523ff073b4fdba73fe112a
+  metadata.gz: 8929049020ac28c4578c52c6e7452516c31358a68fc218f5ba67a92fef058ee8
+  data.tar.gz: bd86945887c0dbfdcc6d49d67e4ee4c7176c2316bb53d6ad4e45392cf9c372e2
 SHA512:
-  metadata.gz: 9d88764cb68ef2b5f2bb3813e56a0adf79fdbd4aaff0769e292c66a7d962d1c6f43725e91feb1cfe3bfb81b45282225139188ca66552f97777653e884e159a35
-  data.tar.gz: a6db4f9cdb016aec986035f32506412a112c6bb468aef9bde3acf22a44c2070fdb0129415c929468e72979f21fdd0b8d474f082ea40838abe459196fe5b53e02
+  metadata.gz: bd1b5f7fa89e8851d22aabd5c10f7633823b26d56855821eec8fd8d64c6402c9c95d6162b176036e0be9b53f8ad223da4117faf396c67563b09404ed2310a3d2
+  data.tar.gz: bb60f4cb6fe959c104c588bae7cd0c72c99ca9ab6f0053d61e689ea23da9fd8b4f44af6d9c72b69fe6b59677f4547682f37da1be90692b8fd7469830f66a2316

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.44.0 (2024-10-31)
+------------------
+
+* Feature - Added support for UpdateScraper API, to enable updating collector configuration in-place
+
 1.43.0 (2024-10-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.43.0
+1.44.0

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

@@ -512,7 +512,8 @@ module Aws::PrometheusService
     #
     # @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.
+    #   be published. This log group must exist prior to calling this
+    #   operation.
     #
     # @option params [required, String] :workspace_id
     #   The ID of the workspace to create the logging configuration for.
@@ -621,36 +622,35 @@ module Aws::PrometheusService
     # 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.
+    # Prometheus workspace. Scrapers are flexible, and can be configured to
+    # control what metrics are collected, the frequency of collection, what
+    # transformations are applied to the metrics, and more.
     #
-    # 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*.
+    # An IAM role will be created for you that Amazon Managed Service for
+    # Prometheus uses to access the metrics in your cluster. You must
+    # configure this role with a policy that allows it to scrape metrics
+    # from your cluster. For more information, see [Configuring your Amazon
+    # EKS cluster][1] in the *Amazon Managed Service for Prometheus User
+    # Guide*.
     #
-    # 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.
+    # The `scrapeConfiguration` parameter contains the base-64 encoded YAML
+    # configuration for the scraper.
     #
     # <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*.
+    # collected, and how to configure the scraper, see [Using an Amazon Web
+    # Services managed collector][2] in the *Amazon Managed Service for
+    # Prometheus User Guide*.
     #
     #  </note>
     #
     #
     #
-    # [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
+    # [1]: https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-collector-how-to.html#AMP-collector-eks-setup
+    # [2]: https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-collector-how-to.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.
+    #   (optional) An alias to associate with the scraper. This is for your
+    #   use, and does not need to be unique.
     #
     # @option params [String] :client_token
     #   (Optional) A unique, case-sensitive identifier that you can provide to
@@ -665,9 +665,12 @@ module Aws::PrometheusService
     #
     # @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*.
+    #   information, see [Scraper configuration][1] in the *Amazon Managed
+    #   Service for Prometheus User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-collector-how-to.html#AMP-collector-configuration
     #
     # @option params [required, Types::Source] :source
     #   The Amazon EKS cluster from which the scraper will collect metrics.
@@ -712,7 +715,7 @@ module Aws::PrometheusService
     #
     #   resp.arn #=> String
     #   resp.scraper_id #=> String
-    #   resp.status.status_code #=> String, one of "CREATING", "ACTIVE", "DELETING", "CREATION_FAILED", "DELETION_FAILED"
+    #   resp.status.status_code #=> String, one of "CREATING", "UPDATING", "ACTIVE", "DELETING", "CREATION_FAILED", "UPDATE_FAILED", "DELETION_FAILED"
     #   resp.tags #=> Hash
     #   resp.tags["TagKey"] #=> String
     #
@@ -918,7 +921,7 @@ module Aws::PrometheusService
     # @example Response structure
     #
     #   resp.scraper_id #=> String
-    #   resp.status.status_code #=> String, one of "CREATING", "ACTIVE", "DELETING", "CREATION_FAILED", "DELETION_FAILED"
+    #   resp.status.status_code #=> String, one of "CREATING", "UPDATING", "ACTIVE", "DELETING", "CREATION_FAILED", "UPDATE_FAILED", "DELETION_FAILED"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/DeleteScraper AWS API Documentation
     #
@@ -1105,7 +1108,7 @@ module Aws::PrometheusService
     #   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.status.status_code #=> String, one of "CREATING", "ACTIVE", "DELETING", "CREATION_FAILED", "DELETION_FAILED"
+    #   resp.scraper.status.status_code #=> String, one of "CREATING", "UPDATING", "ACTIVE", "DELETING", "CREATION_FAILED", "UPDATE_FAILED", "DELETION_FAILED"
     #   resp.scraper.status_reason #=> String
     #   resp.scraper.tags #=> Hash
     #   resp.scraper.tags["TagKey"] #=> String
@@ -1314,7 +1317,7 @@ module Aws::PrometheusService
     #   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].status.status_code #=> String, one of "CREATING", "ACTIVE", "DELETING", "CREATION_FAILED", "DELETION_FAILED"
+    #   resp.scrapers[0].status.status_code #=> String, one of "CREATING", "UPDATING", "ACTIVE", "DELETING", "CREATION_FAILED", "UPDATE_FAILED", "DELETION_FAILED"
     #   resp.scrapers[0].status_reason #=> String
     #   resp.scrapers[0].tags #=> Hash
     #   resp.scrapers[0].tags["TagKey"] #=> String
@@ -1330,12 +1333,12 @@ module Aws::PrometheusService
 
     # 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.
+    # Currently, the only resources that can be tagged are scrapers,
+    # workspaces, and rule groups namespaces.
     #
     # @option params [required, String] :resource_arn
-    #   The ARN of the resource to list tages for. Must be a workspace or rule
-    #   groups namespace resource.
+    #   The ARN of the resource to list tages for. Must be a workspace,
+    #   scraper, or rule groups namespace resource.
     #
     # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1545,20 +1548,21 @@ module Aws::PrometheusService
 
     # 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.
+    # are rule groups namespaces, scrapers, and workspaces.
     #
     # 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.
+    # that you specify replaces the previous value for that tag. To remove a
+    # tag, use `UntagResource`.
     #
     # @option params [required, String] :resource_arn
-    #   The ARN of the workspace or rule groups namespace to apply tags to.
+    #   The ARN of the resource to apply tags to.
     #
     # @option params [required, Hash<String,String>] :tags
     #   The list of tag keys and values to associate with the resource.
     #
-    #   Keys may not begin with `aws:`.
+    #   Keys must not begin with `aws:`.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1581,11 +1585,11 @@ module Aws::PrometheusService
     end
 
     # 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.
+    # Prometheus resource. The only resources that can be tagged are rule
+    # groups namespaces, scrapers, and workspaces.
     #
     # @option params [required, String] :resource_arn
-    #   The ARN of the workspace or rule groups namespace.
+    #   The ARN of the resource from which to remove a tag.
     #
     # @option params [required, Array<String>] :tag_keys
     #   The keys of the tags to remove.
@@ -1651,6 +1655,82 @@ module Aws::PrometheusService
       req.send_request(options)
     end
 
+    # Updates an existing scraper.
+    #
+    # You can't use this function to update the source from which the
+    # scraper is collecting metrics. To change the source, delete the
+    # scraper and create a new one.
+    #
+    # @option params [String] :alias
+    #   The new alias of the scraper.
+    #
+    # @option params [String] :client_token
+    #   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 [Types::Destination] :destination
+    #   The new Amazon Managed Service for Prometheus workspace to send
+    #   metrics to.
+    #
+    # @option params [Types::ScrapeConfiguration] :scrape_configuration
+    #   Contains the base-64 encoded YAML configuration for the scraper.
+    #
+    #   <note markdown="1"> For more information about configuring a scraper, see [Using an Amazon
+    #   Web Services managed collector][1] in the *Amazon Managed Service for
+    #   Prometheus User Guide*.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-collector-how-to.html
+    #
+    # @option params [required, String] :scraper_id
+    #   The ID of the scraper to update.
+    #
+    # @return [Types::UpdateScraperResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateScraperResponse#arn #arn} => String
+    #   * {Types::UpdateScraperResponse#scraper_id #scraper_id} => String
+    #   * {Types::UpdateScraperResponse#status #status} => Types::ScraperStatus
+    #   * {Types::UpdateScraperResponse#tags #tags} => Hash&lt;String,String&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_scraper({
+    #     alias: "ScraperAlias",
+    #     client_token: "IdempotencyToken",
+    #     destination: {
+    #       amp_configuration: {
+    #         workspace_arn: "WorkspaceArn", # required
+    #       },
+    #     },
+    #     scrape_configuration: {
+    #       configuration_blob: "data",
+    #     },
+    #     scraper_id: "ScraperId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.arn #=> String
+    #   resp.scraper_id #=> String
+    #   resp.status.status_code #=> String, one of "CREATING", "UPDATING", "ACTIVE", "DELETING", "CREATION_FAILED", "UPDATE_FAILED", "DELETION_FAILED"
+    #   resp.tags #=> Hash
+    #   resp.tags["TagKey"] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/UpdateScraper AWS API Documentation
+    #
+    # @overload update_scraper(params = {})
+    # @param [Hash] params ({})
+    def update_scraper(params = {}, options = {})
+      req = build_request(:update_scraper, params)
+      req.send_request(options)
+    end
+
     # Updates the alias of an existing workspace.
     #
     # @option params [String] :alias
@@ -1706,7 +1786,7 @@ module Aws::PrometheusService
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-prometheusservice'
-      context[:gem_version] = '1.43.0'
+      context[:gem_version] = '1.44.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -120,6 +120,8 @@ module Aws::PrometheusService
     UntagResourceResponse = Shapes::StructureShape.new(name: 'UntagResourceResponse')
     UpdateLoggingConfigurationRequest = Shapes::StructureShape.new(name: 'UpdateLoggingConfigurationRequest')
     UpdateLoggingConfigurationResponse = Shapes::StructureShape.new(name: 'UpdateLoggingConfigurationResponse')
+    UpdateScraperRequest = Shapes::StructureShape.new(name: 'UpdateScraperRequest')
+    UpdateScraperResponse = Shapes::StructureShape.new(name: 'UpdateScraperResponse')
     UpdateWorkspaceAliasRequest = Shapes::StructureShape.new(name: 'UpdateWorkspaceAliasRequest')
     Uri = Shapes::StringShape.new(name: 'Uri')
     ValidationException = Shapes::StructureShape.new(name: 'ValidationException')
@@ -472,6 +474,19 @@ module Aws::PrometheusService
     UpdateLoggingConfigurationResponse.add_member(:status, Shapes::ShapeRef.new(shape: LoggingConfigurationStatus, required: true, location_name: "status"))
     UpdateLoggingConfigurationResponse.struct_class = Types::UpdateLoggingConfigurationResponse
 
+    UpdateScraperRequest.add_member(:alias, Shapes::ShapeRef.new(shape: ScraperAlias, location_name: "alias"))
+    UpdateScraperRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: IdempotencyToken, location_name: "clientToken", metadata: {"idempotencyToken"=>true}))
+    UpdateScraperRequest.add_member(:destination, Shapes::ShapeRef.new(shape: Destination, location_name: "destination"))
+    UpdateScraperRequest.add_member(:scrape_configuration, Shapes::ShapeRef.new(shape: ScrapeConfiguration, location_name: "scrapeConfiguration"))
+    UpdateScraperRequest.add_member(:scraper_id, Shapes::ShapeRef.new(shape: ScraperId, required: true, location: "uri", location_name: "scraperId"))
+    UpdateScraperRequest.struct_class = Types::UpdateScraperRequest
+
+    UpdateScraperResponse.add_member(:arn, Shapes::ShapeRef.new(shape: ScraperArn, required: true, location_name: "arn"))
+    UpdateScraperResponse.add_member(:scraper_id, Shapes::ShapeRef.new(shape: ScraperId, required: true, location_name: "scraperId"))
+    UpdateScraperResponse.add_member(:status, Shapes::ShapeRef.new(shape: ScraperStatus, required: true, location_name: "status"))
+    UpdateScraperResponse.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "tags"))
+    UpdateScraperResponse.struct_class = Types::UpdateScraperResponse
+
     UpdateWorkspaceAliasRequest.add_member(:alias, Shapes::ShapeRef.new(shape: WorkspaceAlias, location_name: "alias"))
     UpdateWorkspaceAliasRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: IdempotencyToken, location_name: "clientToken", metadata: {"idempotencyToken"=>true}))
     UpdateWorkspaceAliasRequest.add_member(:workspace_id, Shapes::ShapeRef.new(shape: WorkspaceId, required: true, location: "uri", location_name: "workspaceId"))
@@ -520,9 +535,11 @@ module Aws::PrometheusService
 
       api.metadata = {
         "apiVersion" => "2020-08-01",
+        "auth" => ["aws.auth#sigv4"],
         "endpointPrefix" => "aps",
         "jsonVersion" => "1.1",
         "protocol" => "rest-json",
+        "protocols" => ["rest-json"],
         "serviceFullName" => "Amazon Prometheus Service",
         "serviceId" => "amp",
         "signatureVersion" => "v4",
@@ -882,6 +899,21 @@ module Aws::PrometheusService
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 
+      api.add_operation(:update_scraper, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "UpdateScraper"
+        o.http_method = "PUT"
+        o.http_request_uri = "/scrapers/{scraperId}"
+        o.input = Shapes::ShapeRef.new(shape: UpdateScraperRequest)
+        o.output = Shapes::ShapeRef.new(shape: UpdateScraperResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
+      end)
+
       api.add_operation(:update_workspace_alias, Seahorse::Model::Operation.new.tap do |o|
         o.name = "UpdateWorkspaceAlias"
         o.http_method = "POST"

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

@@ -24,7 +24,9 @@ module Aws::PrometheusService
       include Aws::Structure
     end
 
-    # The details of an alert manager definition.
+    # The details of an alert manager definition. It is the configuration
+    # for the alert manager, including information about receivers for
+    # routing alerts.
     #
     # @!attribute [rw] created_at
     #   The date and time that the alert manager definition was created.
@@ -184,7 +186,7 @@ module Aws::PrometheusService
     # @!attribute [rw] 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.
+    #   operation.
     #   @return [String]
     #
     # @!attribute [rw] workspace_id
@@ -298,7 +300,7 @@ module Aws::PrometheusService
     # Represents the input of a `CreateScraper` operation.
     #
     # @!attribute [rw] alias
-    #   (optional) a name to associate with the scraper. This is for your
+    #   (optional) An alias to associate with the scraper. This is for your
     #   use, and does not need to be unique.
     #   @return [String]
     #
@@ -317,9 +319,12 @@ module Aws::PrometheusService
     #
     # @!attribute [rw] 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*.
+    #   information, see [Scraper configuration][1] in the *Amazon Managed
+    #   Service for Prometheus User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-collector-how-to.html#AMP-collector-configuration
     #   @return [Types::ScrapeConfiguration]
     #
     # @!attribute [rw] source
@@ -750,7 +755,7 @@ module Aws::PrometheusService
     # @note Destination is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of Destination corresponding to the set member.
     #
     # @!attribute [rw] amp_configuration
-    #   The Amazon Managed Service for Prometheusworkspace to send metrics
+    #   The Amazon Managed Service for Prometheus workspace to send metrics
     #   to.
     #   @return [Types::AmpConfiguration]
     #
@@ -967,8 +972,8 @@ module Aws::PrometheusService
     end
 
     # @!attribute [rw] resource_arn
-    #   The ARN of the resource to list tages for. Must be a workspace or
-    #   rule groups namespace resource.
+    #   The ARN of the resource to list tages for. Must be a workspace,
+    #   scraper, or rule groups namespace resource.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/ListTagsForResourceRequest AWS API Documentation
@@ -1050,7 +1055,8 @@ module Aws::PrometheusService
       include Aws::Structure
     end
 
-    # Contains information about the logging configuration.
+    # Contains information about the logging configuration for the
+    # workspace.
     #
     # @!attribute [rw] created_at
     #   The date and time that the logging configuration was created.
@@ -1256,7 +1262,8 @@ module Aws::PrometheusService
     # The details about one rule groups namespace.
     #
     # @!attribute [rw] arn
-    #   The ARN of the rule groups namespace.
+    #   The ARN of the rule groups namespace. For example,
+    #   `arn:aws:aps:<region>:123456789012:rulegroupsnamespace/ws-example1-1234-abcd-5678-ef90abcd1234/rulesfile1`.
     #   @return [String]
     #
     # @!attribute [rw] created_at
@@ -1369,9 +1376,12 @@ module Aws::PrometheusService
     end
 
     # A scrape configuration for a scraper, base 64 encoded. 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*.
+    # information, see [Scraper configuration][1] in the *Amazon Managed
+    # Service for Prometheus User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-collector-how-to.html#AMP-collector-configuration
     #
     # @note ScrapeConfiguration is a union - when making an API calls you must set exactly one of the members.
     #
@@ -1402,7 +1412,8 @@ module Aws::PrometheusService
     #   @return [String]
     #
     # @!attribute [rw] arn
-    #   The Amazon Resource Name (ARN) of the scraper.
+    #   The Amazon Resource Name (ARN) of the scraper. For example,
+    #   `arn:aws:aps:<region>:123456798012:scraper/s-example1-1234-abcd-5678-ef9012abcd34`.
     #   @return [String]
     #
     # @!attribute [rw] created_at
@@ -1422,14 +1433,18 @@ module Aws::PrometheusService
     #   The Amazon Resource Name (ARN) of the IAM role that provides
     #   permissions for the scraper to discover and collect metrics on your
     #   behalf.
+    #
+    #   For example,
+    #   `arn:aws:iam::123456789012:role/service-role/AmazonGrafanaServiceRole-12example`.
     #   @return [String]
     #
     # @!attribute [rw] scrape_configuration
-    #   The configuration file in use by the scraper.
+    #   The configuration in use by the scraper.
     #   @return [Types::ScrapeConfiguration]
     #
     # @!attribute [rw] scraper_id
-    #   The ID of the scraper.
+    #   The ID of the scraper. For example,
+    #   `s-example1-1234-abcd-5678-ef9012abcd34`.
     #   @return [String]
     #
     # @!attribute [rw] source
@@ -1610,13 +1625,13 @@ module Aws::PrometheusService
     end
 
     # @!attribute [rw] resource_arn
-    #   The ARN of the workspace or rule groups namespace to apply tags to.
+    #   The ARN of the resource to apply tags to.
     #   @return [String]
     #
     # @!attribute [rw] tags
     #   The list of tag keys and values to associate with the resource.
     #
-    #   Keys may not begin with `aws:`.
+    #   Keys must not begin with `aws:`.
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/TagResourceRequest AWS API Documentation
@@ -1662,7 +1677,7 @@ module Aws::PrometheusService
     end
 
     # @!attribute [rw] resource_arn
-    #   The ARN of the workspace or rule groups namespace.
+    #   The ARN of the resource from which to remove a tag.
     #   @return [String]
     #
     # @!attribute [rw] tag_keys
@@ -1726,6 +1741,81 @@ module Aws::PrometheusService
       include Aws::Structure
     end
 
+    # @!attribute [rw] alias
+    #   The new alias of the scraper.
+    #   @return [String]
+    #
+    # @!attribute [rw] client_token
+    #   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.
+    #   @return [String]
+    #
+    # @!attribute [rw] destination
+    #   The new Amazon Managed Service for Prometheus workspace to send
+    #   metrics to.
+    #   @return [Types::Destination]
+    #
+    # @!attribute [rw] scrape_configuration
+    #   Contains the base-64 encoded YAML configuration for the scraper.
+    #
+    #   <note markdown="1"> For more information about configuring a scraper, see [Using an
+    #   Amazon Web Services managed collector][1] in the *Amazon Managed
+    #   Service for Prometheus User Guide*.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-collector-how-to.html
+    #   @return [Types::ScrapeConfiguration]
+    #
+    # @!attribute [rw] scraper_id
+    #   The ID of the scraper to update.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/UpdateScraperRequest AWS API Documentation
+    #
+    class UpdateScraperRequest < Struct.new(
+      :alias,
+      :client_token,
+      :destination,
+      :scrape_configuration,
+      :scraper_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] arn
+    #   The Amazon Resource Name (ARN) of the updated scraper.
+    #   @return [String]
+    #
+    # @!attribute [rw] scraper_id
+    #   The ID of the updated scraper.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   A structure that displays the current status of the scraper.
+    #   @return [Types::ScraperStatus]
+    #
+    # @!attribute [rw] tags
+    #   The list of tag keys and values that are associated with the
+    #   scraper.
+    #   @return [Hash<String,String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/UpdateScraperResponse AWS API Documentation
+    #
+    class UpdateScraperResponse < Struct.new(
+      :arn,
+      :scraper_id,
+      :status,
+      :tags)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Represents the input of an `UpdateWorkspaceAlias` operation.
     #
     # @!attribute [rw] alias
@@ -1808,11 +1898,12 @@ module Aws::PrometheusService
     #
     # @!attribute [rw] alias
     #   The alias that is assigned to this workspace to help identify it. It
-    #   may not be unique.
+    #   does not need to be unique.
     #   @return [String]
     #
     # @!attribute [rw] arn
-    #   The ARN of the workspace.
+    #   The ARN of the workspace. For example,
+    #   `arn:aws:aps:<region>:123456789012:workspace/ws-example1-1234-abcd-5678-ef90abcd1234`.
     #   @return [String]
     #
     # @!attribute [rw] created_at
@@ -1825,7 +1916,8 @@ module Aws::PrometheusService
     #   @return [String]
     #
     # @!attribute [rw] prometheus_endpoint
-    #   The Prometheus endpoint available for this workspace.
+    #   The Prometheus endpoint available for this workspace. For example,
+    #   `https://aps-workspaces.<region>.amazonaws.com/workspaces/ws-example1-1234-abcd-5678-ef90abcd1234/api/v1/`.
     #   @return [String]
     #
     # @!attribute [rw] status
@@ -1838,7 +1930,8 @@ module Aws::PrometheusService
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] workspace_id
-    #   The unique ID for the workspace.
+    #   The unique ID for the workspace. For example,
+    #   `ws-example1-1234-abcd-5678-ef90abcd1234`.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/amp-2020-08-01/WorkspaceDescription AWS API Documentation
@@ -1875,7 +1968,7 @@ module Aws::PrometheusService
     #
     # @!attribute [rw] alias
     #   The alias that is assigned to this workspace to help identify it. It
-    #   may not be unique.
+    #   does not need to be unique.
     #   @return [String]
     #
     # @!attribute [rw] arn

data/lib/aws-sdk-prometheusservice.rb

@@ -55,7 +55,7 @@ module Aws::PrometheusService
   autoload :EndpointProvider, 'aws-sdk-prometheusservice/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-prometheusservice/endpoints'
 
-  GEM_VERSION = '1.43.0'
+  GEM_VERSION = '1.44.0'
 
 end
 

data/sig/client.rbs

@@ -374,6 +374,29 @@ module Aws
                                         ) -> _UpdateLoggingConfigurationResponseSuccess
                                       | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateLoggingConfigurationResponseSuccess
 
+      interface _UpdateScraperResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::UpdateScraperResponse]
+        def arn: () -> ::String
+        def scraper_id: () -> ::String
+        def status: () -> Types::ScraperStatus
+        def tags: () -> ::Hash[::String, ::String]
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/PrometheusService/Client.html#update_scraper-instance_method
+      def update_scraper: (
+                            ?alias: ::String,
+                            ?client_token: ::String,
+                            ?destination: {
+                              amp_configuration: {
+                                workspace_arn: ::String
+                              }?
+                            },
+                            ?scrape_configuration: {
+                              configuration_blob: ::String?
+                            },
+                            scraper_id: ::String
+                          ) -> _UpdateScraperResponseSuccess
+                        | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateScraperResponseSuccess
+
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/PrometheusService/Client.html#update_workspace_alias-instance_method
       def update_workspace_alias: (
                                     ?alias: ::String,

data/sig/types.rbs

@@ -390,7 +390,7 @@ module Aws::PrometheusService
     end
 
     class ScraperStatus
-      attr_accessor status_code: ("CREATING" | "ACTIVE" | "DELETING" | "CREATION_FAILED" | "DELETION_FAILED")
+      attr_accessor status_code: ("CREATING" | "UPDATING" | "ACTIVE" | "DELETING" | "CREATION_FAILED" | "UPDATE_FAILED" | "DELETION_FAILED")
       SENSITIVE: []
     end
 
@@ -467,6 +467,23 @@ module Aws::PrometheusService
       SENSITIVE: []
     end
 
+    class UpdateScraperRequest
+      attr_accessor alias: ::String
+      attr_accessor client_token: ::String
+      attr_accessor destination: Types::Destination
+      attr_accessor scrape_configuration: Types::ScrapeConfiguration
+      attr_accessor scraper_id: ::String
+      SENSITIVE: []
+    end
+
+    class UpdateScraperResponse
+      attr_accessor arn: ::String
+      attr_accessor scraper_id: ::String
+      attr_accessor status: Types::ScraperStatus
+      attr_accessor tags: ::Hash[::String, ::String]
+      SENSITIVE: []
+    end
+
     class UpdateWorkspaceAliasRequest
       attr_accessor alias: ::String
       attr_accessor client_token: ::String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-prometheusservice
 version: !ruby/object:Gem::Version
-  version: 1.43.0
+  version: 1.44.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-10-18 00:00:00.000000000 Z
+date: 2024-10-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -36,14 +36,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.5'
 description: Official AWS Ruby gem for Amazon Prometheus Service. This gem is part
   of the AWS SDK for Ruby.
 email: