aws-sdk-marketplacemetering 1.86.0 → 1.87.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f45532da7846a587bf90fa30c8caffde7d70769a065fc03a7ce825e68366e0f4
-  data.tar.gz: 49ba5b8c80bd270009cf87ef0103d3b1057e7f2df4bf4d0949dabc05f998a98d
+  metadata.gz: 921a575921c9ccebc2c9901e8cc6eb30f391e8b0b9a5b5d55b8b498e030eeea4
+  data.tar.gz: 7bdd2f10695d81c3c6fd5b7843277562fed8956b3d0777978860ed4a3417a989
 SHA512:
-  metadata.gz: 406fc1a0a803931eea1d726a2cade5bcdbc9baba53fdb9e296866a14f1adf5d2524a4aab0cc767425ce2e6fa83513db07fd7fc2bb8f8e3bf8062d408ce87751a
-  data.tar.gz: d371245df43723b7760f2215e02e2d8c193051c001253473ddeab1f82c038e4d5651465d215bca399380bda1f57de2b2cf2708e9833eb9eca2694a8ad11f7bf2
+  metadata.gz: 608a43c3ec9502cb7e7fce7cec7e8699a12068c38be786b59d1e52c7f867c62b220874480653ae8f14081d76fed1a4e49a5c77db5b53beacc18b2058da53681f
+  data.tar.gz: 658b41389792e1d895701ee9aad8b67c9bc9c2ffb2bed9b59cb3be842975be96454c347067ac4e8888908a32a4964978ee6dd1f6dcf93989ec7662d9e686d93b

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.87.0 (2025-10-21)
+------------------
+
+* Feature - Added ClientToken parameter to MeterUsage API for specifying idempotent requests.
+
 1.86.0 (2025-08-26)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.86.0
+1.87.0

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

@@ -483,8 +483,8 @@ module Aws::MarketplaceMetering
 
     # @!group API Operations
 
-    # The `CustomerIdentifier` parameter is scheduled for deprecation. Use
-    # `CustomerAWSAccountID` instead.
+    # The `CustomerIdentifier` parameter is scheduled for deprecation on
+    # March 31, 2026. Use `CustomerAWSAccountID` instead.
     #
     #  These parameters are mutually exclusive. You can't specify both
     # `CustomerIdentifier` and `CustomerAWSAccountID` in the same request.
@@ -613,9 +613,15 @@ module Aws::MarketplaceMetering
     # provide customers with usage data split into buckets by tags that you
     # define (or allow the customer to define).
     #
-    # Usage records are expected to be submitted as quickly as possible
-    # after the event that is being recorded, and are not accepted more than
-    # 6 hours after the event.
+    # Submit usage records to report events from the previous hour. If you
+    # submit records that are greater than six hours after events occur, the
+    # records won’t be accepted. The timestamp in your request determines
+    # when an event is recorded. You can only report usage once per hour for
+    # each dimension. For AMI-based products, this is per dimension and per
+    # EC2 instance. For container products, this is per dimension and per
+    # ECS task or EKS pod. You can’t modify values after they’re recorded.
+    # If you report usage before the current hour ends, you will be unable
+    # to report additional usage until the next hour begins.
     #
     # For Amazon Web Services Regions that support `MeterUsage`, see
     # [MeterUsage Region support for Amazon EC2][1] and [MeterUsage Region
@@ -656,6 +662,28 @@ module Aws::MarketplaceMetering
     #   `UsageQuantity` of the `MeterUsage` request, and each
     #   `UsageAllocation` must have a unique set of tags (include no tags).
     #
+    # @option params [String] :client_token
+    #   Specifies a unique, case-sensitive identifier that you provide to
+    #   ensure the idempotency of the request. This lets you safely retry the
+    #   request without accidentally performing the same operation a second
+    #   time. Passing the same value to a later call to an operation requires
+    #   that you also pass the same value for all other parameters. We
+    #   recommend that you use a [UUID type of value][1].
+    #
+    #   If you don't provide this value, then Amazon Web Services generates a
+    #   random one for you.
+    #
+    #   If you retry the operation with the same `ClientToken`, but with
+    #   different parameters, the retry fails with an
+    #   `IdempotencyConflictException` error.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    #
+    #
+    #   [1]: https://wikipedia.org/wiki/Universally_unique_identifier
+    #
     # @return [Types::MeterUsageResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::MeterUsageResult#metering_record_id #metering_record_id} => String
@@ -679,6 +707,7 @@ module Aws::MarketplaceMetering
     #         ],
     #       },
     #     ],
+    #     client_token: "ClientToken",
     #   })
     #
     # @example Response structure
@@ -864,7 +893,7 @@ module Aws::MarketplaceMetering
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-marketplacemetering'
-      context[:gem_version] = '1.86.0'
+      context[:gem_version] = '1.87.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -18,12 +18,14 @@ module Aws::MarketplaceMetering
     BatchMeterUsageRequest = Shapes::StructureShape.new(name: 'BatchMeterUsageRequest')
     BatchMeterUsageResult = Shapes::StructureShape.new(name: 'BatchMeterUsageResult')
     Boolean = Shapes::BooleanShape.new(name: 'Boolean')
+    ClientToken = Shapes::StringShape.new(name: 'ClientToken')
     CustomerAWSAccountId = Shapes::StringShape.new(name: 'CustomerAWSAccountId')
     CustomerIdentifier = Shapes::StringShape.new(name: 'CustomerIdentifier')
     CustomerNotEntitledException = Shapes::StructureShape.new(name: 'CustomerNotEntitledException')
     DisabledApiException = Shapes::StructureShape.new(name: 'DisabledApiException')
     DuplicateRequestException = Shapes::StructureShape.new(name: 'DuplicateRequestException')
     ExpiredTokenException = Shapes::StructureShape.new(name: 'ExpiredTokenException')
+    IdempotencyConflictException = Shapes::StructureShape.new(name: 'IdempotencyConflictException')
     InternalServiceErrorException = Shapes::StructureShape.new(name: 'InternalServiceErrorException')
     InvalidCustomerIdentifierException = Shapes::StructureShape.new(name: 'InvalidCustomerIdentifierException')
     InvalidEndpointRegionException = Shapes::StructureShape.new(name: 'InvalidEndpointRegionException')
@@ -84,6 +86,9 @@ module Aws::MarketplaceMetering
     ExpiredTokenException.add_member(:message, Shapes::ShapeRef.new(shape: errorMessage, location_name: "message"))
     ExpiredTokenException.struct_class = Types::ExpiredTokenException
 
+    IdempotencyConflictException.add_member(:message, Shapes::ShapeRef.new(shape: errorMessage, location_name: "message"))
+    IdempotencyConflictException.struct_class = Types::IdempotencyConflictException
+
     InternalServiceErrorException.add_member(:message, Shapes::ShapeRef.new(shape: errorMessage, location_name: "message"))
     InternalServiceErrorException.struct_class = Types::InternalServiceErrorException
 
@@ -120,6 +125,7 @@ module Aws::MarketplaceMetering
     MeterUsageRequest.add_member(:usage_quantity, Shapes::ShapeRef.new(shape: UsageQuantity, location_name: "UsageQuantity"))
     MeterUsageRequest.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, location_name: "DryRun"))
     MeterUsageRequest.add_member(:usage_allocations, Shapes::ShapeRef.new(shape: UsageAllocations, location_name: "UsageAllocations"))
+    MeterUsageRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "ClientToken", metadata: {"idempotencyToken" => true}))
     MeterUsageRequest.struct_class = Types::MeterUsageRequest
 
     MeterUsageResult.add_member(:metering_record_id, Shapes::ShapeRef.new(shape: String, location_name: "MeteringRecordId"))
@@ -232,6 +238,7 @@ module Aws::MarketplaceMetering
         o.errors << Shapes::ShapeRef.new(shape: InvalidEndpointRegionException)
         o.errors << Shapes::ShapeRef.new(shape: TimestampOutOfBoundsException)
         o.errors << Shapes::ShapeRef.new(shape: DuplicateRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: IdempotencyConflictException)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
         o.errors << Shapes::ShapeRef.new(shape: CustomerNotEntitledException)
       end)

data/lib/aws-sdk-marketplacemetering/customizations.rb

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-# WARNING ABOUT GENERATED CODE
-#
-# This file is generated. See the contributing for info on making contributions:
-# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
-#
-# WARNING ABOUT GENERATED CODE
-

data/lib/aws-sdk-marketplacemetering/endpoint_parameters.rb

@@ -13,22 +13,22 @@ module Aws::MarketplaceMetering
   # @!attribute use_dual_stack
   #   When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
   #
-  #   @return [Boolean]
+  #   @return [boolean]
   #
   # @!attribute use_fips
   #   When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.
   #
-  #   @return [Boolean]
+  #   @return [boolean]
   #
   # @!attribute endpoint
   #   Override the endpoint used to send this request
   #
-  #   @return [String]
+  #   @return [string]
   #
   # @!attribute region
   #   The AWS region used to dispatch the request.
   #
-  #   @return [String]
+  #   @return [string]
   #
   EndpointParameters = Struct.new(
     :use_dual_stack,

data/lib/aws-sdk-marketplacemetering/errors.rb

@@ -31,6 +31,7 @@ module Aws::MarketplaceMetering
   # * {DisabledApiException}
   # * {DuplicateRequestException}
   # * {ExpiredTokenException}
+  # * {IdempotencyConflictException}
   # * {InternalServiceErrorException}
   # * {InvalidCustomerIdentifierException}
   # * {InvalidEndpointRegionException}
@@ -111,6 +112,21 @@ module Aws::MarketplaceMetering
       end
     end
 
+    class IdempotencyConflictException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::MarketplaceMetering::Types::IdempotencyConflictException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
     class InternalServiceErrorException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -119,6 +119,19 @@ module Aws::MarketplaceMetering
       include Aws::Structure
     end
 
+    # The `ClientToken` is being used for multiple requests.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/meteringmarketplace-2016-01-14/IdempotencyConflictException AWS API Documentation
+    #
+    class IdempotencyConflictException < Struct.new(
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # An internal error has occurred. Retry your request. If the problem
     # persists, post a message with details on the Amazon Web Services
     # forums.
@@ -296,6 +309,29 @@ module Aws::MarketplaceMetering
     #   `UsageAllocation` must have a unique set of tags (include no tags).
     #   @return [Array<Types::UsageAllocation>]
     #
+    # @!attribute [rw] client_token
+    #   Specifies a unique, case-sensitive identifier that you provide to
+    #   ensure the idempotency of the request. This lets you safely retry
+    #   the request without accidentally performing the same operation a
+    #   second time. Passing the same value to a later call to an operation
+    #   requires that you also pass the same value for all other parameters.
+    #   We recommend that you use a [UUID type of value][1].
+    #
+    #   If you don't provide this value, then Amazon Web Services generates
+    #   a random one for you.
+    #
+    #   If you retry the operation with the same `ClientToken`, but with
+    #   different parameters, the retry fails with an
+    #   `IdempotencyConflictException` error.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #
+    #
+    #
+    #   [1]: https://wikipedia.org/wiki/Universally_unique_identifier
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/meteringmarketplace-2016-01-14/MeterUsageRequest AWS API Documentation
     #
     class MeterUsageRequest < Struct.new(
@@ -304,7 +340,8 @@ module Aws::MarketplaceMetering
       :usage_dimension,
       :usage_quantity,
       :dry_run,
-      :usage_allocations)
+      :usage_allocations,
+      :client_token)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -513,7 +550,7 @@ module Aws::MarketplaceMetering
     # @!attribute [rw] timestamp
     #   Timestamp, in UTC, for which the usage is being reported.
     #
-    #   Your application can meter usage for up to one hour in the past.
+    #   Your application can meter usage for up to six hours in the past.
     #   Make sure the `timestamp` value is not before the start of the
     #   software usage.
     #   @return [Time]

data/lib/aws-sdk-marketplacemetering.rb

@@ -54,7 +54,7 @@ module Aws::MarketplaceMetering
   autoload :EndpointProvider, 'aws-sdk-marketplacemetering/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-marketplacemetering/endpoints'
 
-  GEM_VERSION = '1.86.0'
+  GEM_VERSION = '1.87.0'
 
 end
 

data/sig/client.rbs

@@ -131,7 +131,8 @@ module Aws
                                },
                              ]?
                            },
-                         ]
+                         ],
+                         ?client_token: ::String
                        ) -> _MeterUsageResponseSuccess
                      | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _MeterUsageResponseSuccess
 

data/sig/errors.rbs

@@ -23,6 +23,9 @@ module Aws
       class ExpiredTokenException < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end
+      class IdempotencyConflictException < ::Aws::Errors::ServiceError
+        def message: () -> ::String
+      end
       class InternalServiceErrorException < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end

data/sig/types.rbs

@@ -40,6 +40,11 @@ module Aws::MarketplaceMetering
       SENSITIVE: []
     end
 
+    class IdempotencyConflictException
+      attr_accessor message: ::String
+      SENSITIVE: []
+    end
+
     class InternalServiceErrorException
       attr_accessor message: ::String
       SENSITIVE: []
@@ -97,6 +102,7 @@ module Aws::MarketplaceMetering
       attr_accessor usage_quantity: ::Integer
       attr_accessor dry_run: bool
       attr_accessor usage_allocations: ::Array[Types::UsageAllocation]
+      attr_accessor client_token: ::String
       SENSITIVE: []
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-marketplacemetering
 version: !ruby/object:Gem::Version
-  version: 1.86.0
+  version: 1.87.0
 platform: ruby
 authors:
 - Amazon Web Services
@@ -18,7 +18,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.231.0
+        version: 3.234.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -28,7 +28,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.231.0
+        version: 3.234.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement