aws-sdk-costexplorer 1.96.0 → 1.98.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3fdd409a26c89a2394e1f677f2baa41de66ca907d3417a251dd662a05053f1b7
-  data.tar.gz: db264641a62cb382a9b6ab324b335099bb63c25a0ccbeb4c78e66d1da613f0ea
+  metadata.gz: e09ea918c7b05d06c258c5d0ca7e64b0d67cd94a2fb07619f3ec091ca483de81
+  data.tar.gz: d8d92c37af3892842cd23de9de3f06130150bea3c47c0e3b00eb96cc348a11fa
 SHA512:
-  metadata.gz: f0b82b6b18c6d083511abda764d438e8eb3677c5a9d73c18959cae738e975c63aa352a4e99fc2122158fc4c4537343a8c6473bad29b092abb8bd27101ae8783f
-  data.tar.gz: c275f3f46e6a7f9d04104bf3ad523182b48f255ee9da717757acdd34c38bfc664776fac20f94f6b36f91006e209cf6ebdc40e726480daddb440666d80e9241f2
+  metadata.gz: 98937feb9a9be1c7f326b50b06720e5fca2e8026257c4b81608042c4808d9a579d2ffbc3721931d1a922e0e57163d55093aeb2107b22cd88d6554d6f7840b7fb
+  data.tar.gz: 587ed46a54167be712115a4ef85c0ecf9d69d68abfcf2fd7fa637bbc136dfc3632c573a4092a3555579a4ea233f0f400c760d59e0f64a7b39ea7eafaa3deefc3

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.98.0 (2024-04-23)
+------------------
+
+* Feature - Added additional metadata that might be applicable to your reservation recommendations.
+
+1.97.0 (2024-03-26)
+------------------
+
+* Feature - Adds support for backfill of cost allocation tags, with new StartCostAllocationTagBackfill and ListCostAllocationTagBackfillHistory API.
+
 1.96.0 (2024-02-28)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.96.0
+1.98.0

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

@@ -1381,8 +1381,11 @@ module Aws::CostExplorer
     # such as `SERVICE` or `AZ`, in a specific time range. For a complete
     # list of valid dimensions, see the [GetDimensionValues][1] operation.
     # Management account in an organization in Organizations have access to
-    # all member accounts. This API is currently available for the Amazon
-    # Elastic Compute Cloud – Compute service only.
+    # all member accounts.
+    #
+    # Hourly granularity is only available for EC2-Instances (Elastic
+    # Compute Cloud) resource-level data. All other resource-level data is
+    # available at daily granularity.
     #
     # <note markdown="1"> This is an opt-in only feature. You can enable this feature from the
     # Cost Explorer Settings page. For information about how to access the
@@ -2811,6 +2814,7 @@ module Aws::CostExplorer
     #
     #   resp.metadata.recommendation_id #=> String
     #   resp.metadata.generation_timestamp #=> String
+    #   resp.metadata.additional_metadata #=> String
     #   resp.recommendations #=> Array
     #   resp.recommendations[0].account_scope #=> String, one of "PAYER", "LINKED"
     #   resp.recommendations[0].lookback_period_in_days #=> String, one of "SEVEN_DAYS", "THIRTY_DAYS", "SIXTY_DAYS"
@@ -4480,6 +4484,50 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
+    # Retrieves a list of your historical cost allocation tag backfill
+    # requests.
+    #
+    # @option params [String] :next_token
+    #   The token to retrieve the next set of results. Amazon Web Services
+    #   provides the token when the response from a previous call has more
+    #   results than the maximum page size.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of objects that are returned for this request.
+    #
+    # @return [Types::ListCostAllocationTagBackfillHistoryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListCostAllocationTagBackfillHistoryResponse#backfill_requests #backfill_requests} => Array&lt;Types::CostAllocationTagBackfillRequest&gt;
+    #   * {Types::ListCostAllocationTagBackfillHistoryResponse#next_token #next_token} => String
+    #
+    # 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_cost_allocation_tag_backfill_history({
+    #     next_token: "NextPageToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.backfill_requests #=> Array
+    #   resp.backfill_requests[0].backfill_from #=> String
+    #   resp.backfill_requests[0].requested_at #=> String
+    #   resp.backfill_requests[0].completed_at #=> String
+    #   resp.backfill_requests[0].backfill_status #=> String, one of "SUCCEEDED", "PROCESSING", "FAILED"
+    #   resp.backfill_requests[0].last_updated_at #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostAllocationTagBackfillHistory AWS API Documentation
+    #
+    # @overload list_cost_allocation_tag_backfill_history(params = {})
+    # @param [Hash] params ({})
+    def list_cost_allocation_tag_backfill_history(params = {}, options = {})
+      req = build_request(:list_cost_allocation_tag_backfill_history, params)
+      req.send_request(options)
+    end
+
     # Get a list of cost allocation tags. All inputs in the API are optional
     # and serve as filters. By default, all cost allocation tags are
     # returned.
@@ -4723,6 +4771,44 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
+    # Request a cost allocation tag backfill. This will backfill the
+    # activation status (either `active` or `inactive`) for all tag keys
+    # from `para:BackfillFrom` up to the when this request is made.
+    #
+    # You can request a backfill once every 24 hours.
+    #
+    # @option params [required, String] :backfill_from
+    #   The date you want the backfill to start from. The date can only be a
+    #   first day of the month (a billing start date). Dates can't precede
+    #   the previous twelve months, or in the future.
+    #
+    # @return [Types::StartCostAllocationTagBackfillResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartCostAllocationTagBackfillResponse#backfill_request #backfill_request} => Types::CostAllocationTagBackfillRequest
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_cost_allocation_tag_backfill({
+    #     backfill_from: "ZonedDateTime", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.backfill_request.backfill_from #=> String
+    #   resp.backfill_request.requested_at #=> String
+    #   resp.backfill_request.completed_at #=> String
+    #   resp.backfill_request.backfill_status #=> String, one of "SUCCEEDED", "PROCESSING", "FAILED"
+    #   resp.backfill_request.last_updated_at #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/StartCostAllocationTagBackfill AWS API Documentation
+    #
+    # @overload start_cost_allocation_tag_backfill(params = {})
+    # @param [Hash] params ({})
+    def start_cost_allocation_tag_backfill(params = {}, options = {})
+      req = build_request(:start_cost_allocation_tag_backfill, params)
+      req.send_request(options)
+    end
+
     # Requests a Savings Plans recommendation generation. This enables you
     # to calculate a fresh set of Savings Plans recommendations that takes
     # your latest usage data and current Savings Plans inventory into
@@ -5204,7 +5290,7 @@ module Aws::CostExplorer
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-costexplorer'
-      context[:gem_version] = '1.96.0'
+      context[:gem_version] = '1.98.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -32,9 +32,13 @@ module Aws::CostExplorer
     AttributeType = Shapes::StringShape.new(name: 'AttributeType')
     AttributeValue = Shapes::StringShape.new(name: 'AttributeValue')
     Attributes = Shapes::MapShape.new(name: 'Attributes')
+    BackfillLimitExceededException = Shapes::StructureShape.new(name: 'BackfillLimitExceededException')
     BillExpirationException = Shapes::StructureShape.new(name: 'BillExpirationException')
     Context = Shapes::StringShape.new(name: 'Context')
     CostAllocationTag = Shapes::StructureShape.new(name: 'CostAllocationTag')
+    CostAllocationTagBackfillRequest = Shapes::StructureShape.new(name: 'CostAllocationTagBackfillRequest')
+    CostAllocationTagBackfillRequestList = Shapes::ListShape.new(name: 'CostAllocationTagBackfillRequestList')
+    CostAllocationTagBackfillStatus = Shapes::StringShape.new(name: 'CostAllocationTagBackfillStatus')
     CostAllocationTagKeyList = Shapes::ListShape.new(name: 'CostAllocationTagKeyList')
     CostAllocationTagList = Shapes::ListShape.new(name: 'CostAllocationTagList')
     CostAllocationTagStatus = Shapes::StringShape.new(name: 'CostAllocationTagStatus')
@@ -175,6 +179,8 @@ module Aws::CostExplorer
     Key = Shapes::StringShape.new(name: 'Key')
     Keys = Shapes::ListShape.new(name: 'Keys')
     LimitExceededException = Shapes::StructureShape.new(name: 'LimitExceededException')
+    ListCostAllocationTagBackfillHistoryRequest = Shapes::StructureShape.new(name: 'ListCostAllocationTagBackfillHistoryRequest')
+    ListCostAllocationTagBackfillHistoryResponse = Shapes::StructureShape.new(name: 'ListCostAllocationTagBackfillHistoryResponse')
     ListCostAllocationTagsRequest = Shapes::StructureShape.new(name: 'ListCostAllocationTagsRequest')
     ListCostAllocationTagsResponse = Shapes::StructureShape.new(name: 'ListCostAllocationTagsResponse')
     ListCostCategoryDefinitionsRequest = Shapes::StructureShape.new(name: 'ListCostCategoryDefinitionsRequest')
@@ -292,6 +298,8 @@ module Aws::CostExplorer
     SortDefinitionKey = Shapes::StringShape.new(name: 'SortDefinitionKey')
     SortDefinitions = Shapes::ListShape.new(name: 'SortDefinitions')
     SortOrder = Shapes::StringShape.new(name: 'SortOrder')
+    StartCostAllocationTagBackfillRequest = Shapes::StructureShape.new(name: 'StartCostAllocationTagBackfillRequest')
+    StartCostAllocationTagBackfillResponse = Shapes::StructureShape.new(name: 'StartCostAllocationTagBackfillResponse')
     StartSavingsPlansPurchaseRecommendationGenerationRequest = Shapes::StructureShape.new(name: 'StartSavingsPlansPurchaseRecommendationGenerationRequest')
     StartSavingsPlansPurchaseRecommendationGenerationResponse = Shapes::StructureShape.new(name: 'StartSavingsPlansPurchaseRecommendationGenerationResponse')
     Subscriber = Shapes::StructureShape.new(name: 'Subscriber')
@@ -398,6 +406,9 @@ module Aws::CostExplorer
     Attributes.key = Shapes::ShapeRef.new(shape: AttributeType)
     Attributes.value = Shapes::ShapeRef.new(shape: AttributeValue)
 
+    BackfillLimitExceededException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
+    BackfillLimitExceededException.struct_class = Types::BackfillLimitExceededException
+
     BillExpirationException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
     BillExpirationException.struct_class = Types::BillExpirationException
 
@@ -408,6 +419,15 @@ module Aws::CostExplorer
     CostAllocationTag.add_member(:last_used_date, Shapes::ShapeRef.new(shape: ZonedDateTime, location_name: "LastUsedDate"))
     CostAllocationTag.struct_class = Types::CostAllocationTag
 
+    CostAllocationTagBackfillRequest.add_member(:backfill_from, Shapes::ShapeRef.new(shape: ZonedDateTime, location_name: "BackfillFrom"))
+    CostAllocationTagBackfillRequest.add_member(:requested_at, Shapes::ShapeRef.new(shape: ZonedDateTime, location_name: "RequestedAt"))
+    CostAllocationTagBackfillRequest.add_member(:completed_at, Shapes::ShapeRef.new(shape: ZonedDateTime, location_name: "CompletedAt"))
+    CostAllocationTagBackfillRequest.add_member(:backfill_status, Shapes::ShapeRef.new(shape: CostAllocationTagBackfillStatus, location_name: "BackfillStatus"))
+    CostAllocationTagBackfillRequest.add_member(:last_updated_at, Shapes::ShapeRef.new(shape: ZonedDateTime, location_name: "LastUpdatedAt"))
+    CostAllocationTagBackfillRequest.struct_class = Types::CostAllocationTagBackfillRequest
+
+    CostAllocationTagBackfillRequestList.member = Shapes::ShapeRef.new(shape: CostAllocationTagBackfillRequest)
+
     CostAllocationTagKeyList.member = Shapes::ShapeRef.new(shape: TagKey)
 
     CostAllocationTagList.member = Shapes::ShapeRef.new(shape: CostAllocationTag)
@@ -979,6 +999,14 @@ module Aws::CostExplorer
     LimitExceededException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
     LimitExceededException.struct_class = Types::LimitExceededException
 
+    ListCostAllocationTagBackfillHistoryRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextToken"))
+    ListCostAllocationTagBackfillHistoryRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: CostAllocationTagsMaxResults, location_name: "MaxResults", metadata: {"box"=>true}))
+    ListCostAllocationTagBackfillHistoryRequest.struct_class = Types::ListCostAllocationTagBackfillHistoryRequest
+
+    ListCostAllocationTagBackfillHistoryResponse.add_member(:backfill_requests, Shapes::ShapeRef.new(shape: CostAllocationTagBackfillRequestList, location_name: "BackfillRequests"))
+    ListCostAllocationTagBackfillHistoryResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextToken"))
+    ListCostAllocationTagBackfillHistoryResponse.struct_class = Types::ListCostAllocationTagBackfillHistoryResponse
+
     ListCostAllocationTagsRequest.add_member(:status, Shapes::ShapeRef.new(shape: CostAllocationTagStatus, location_name: "Status"))
     ListCostAllocationTagsRequest.add_member(:tag_keys, Shapes::ShapeRef.new(shape: CostAllocationTagKeyList, location_name: "TagKeys"))
     ListCostAllocationTagsRequest.add_member(:type, Shapes::ShapeRef.new(shape: CostAllocationTagType, location_name: "Type"))
@@ -1175,6 +1203,7 @@ module Aws::CostExplorer
 
     ReservationPurchaseRecommendationMetadata.add_member(:recommendation_id, Shapes::ShapeRef.new(shape: GenericString, location_name: "RecommendationId"))
     ReservationPurchaseRecommendationMetadata.add_member(:generation_timestamp, Shapes::ShapeRef.new(shape: GenericString, location_name: "GenerationTimestamp"))
+    ReservationPurchaseRecommendationMetadata.add_member(:additional_metadata, Shapes::ShapeRef.new(shape: GenericString, location_name: "AdditionalMetadata"))
     ReservationPurchaseRecommendationMetadata.struct_class = Types::ReservationPurchaseRecommendationMetadata
 
     ReservationPurchaseRecommendationSummary.add_member(:total_estimated_monthly_savings_amount, Shapes::ShapeRef.new(shape: GenericString, location_name: "TotalEstimatedMonthlySavingsAmount"))
@@ -1370,6 +1399,12 @@ module Aws::CostExplorer
 
     SortDefinitions.member = Shapes::ShapeRef.new(shape: SortDefinition)
 
+    StartCostAllocationTagBackfillRequest.add_member(:backfill_from, Shapes::ShapeRef.new(shape: ZonedDateTime, required: true, location_name: "BackfillFrom"))
+    StartCostAllocationTagBackfillRequest.struct_class = Types::StartCostAllocationTagBackfillRequest
+
+    StartCostAllocationTagBackfillResponse.add_member(:backfill_request, Shapes::ShapeRef.new(shape: CostAllocationTagBackfillRequest, location_name: "BackfillRequest"))
+    StartCostAllocationTagBackfillResponse.struct_class = Types::StartCostAllocationTagBackfillResponse
+
     StartSavingsPlansPurchaseRecommendationGenerationRequest.struct_class = Types::StartSavingsPlansPurchaseRecommendationGenerationRequest
 
     StartSavingsPlansPurchaseRecommendationGenerationResponse.add_member(:recommendation_id, Shapes::ShapeRef.new(shape: RecommendationId, location_name: "RecommendationId"))
@@ -1817,6 +1852,22 @@ module Aws::CostExplorer
         o.errors << Shapes::ShapeRef.new(shape: UnresolvableUsageUnitException)
       end)
 
+      api.add_operation(:list_cost_allocation_tag_backfill_history, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListCostAllocationTagBackfillHistory"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListCostAllocationTagBackfillHistoryRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListCostAllocationTagBackfillHistoryResponse)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:list_cost_allocation_tags, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListCostAllocationTags"
         o.http_method = "POST"
@@ -1878,6 +1929,16 @@ module Aws::CostExplorer
         o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
       end)
 
+      api.add_operation(:start_cost_allocation_tag_backfill, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "StartCostAllocationTagBackfill"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: StartCostAllocationTagBackfillRequest)
+        o.output = Shapes::ShapeRef.new(shape: StartCostAllocationTagBackfillResponse)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: BackfillLimitExceededException)
+      end)
+
       api.add_operation(:start_savings_plans_purchase_recommendation_generation, Seahorse::Model::Operation.new.tap do |o|
         o.name = "StartSavingsPlansPurchaseRecommendationGeneration"
         o.http_method = "POST"

data/lib/aws-sdk-costexplorer/endpoints.rb

@@ -390,6 +390,20 @@ module Aws::CostExplorer
       end
     end
 
+    class ListCostAllocationTagBackfillHistory
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::CostExplorer::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class ListCostAllocationTags
       def self.build(context)
         unless context.config.regional_endpoint
@@ -460,6 +474,20 @@ module Aws::CostExplorer
       end
     end
 
+    class StartCostAllocationTagBackfill
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::CostExplorer::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class StartSavingsPlansPurchaseRecommendationGeneration
       def self.build(context)
         unless context.config.regional_endpoint

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

@@ -27,6 +27,7 @@ module Aws::CostExplorer
   # See {Seahorse::Client::RequestContext} for more information.
   #
   # ## Error Classes
+  # * {BackfillLimitExceededException}
   # * {BillExpirationException}
   # * {DataUnavailableException}
   # * {GenerationExistsException}
@@ -46,6 +47,21 @@ module Aws::CostExplorer
 
     extend Aws::Errors::DynamicErrors
 
+    class BackfillLimitExceededException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::CostExplorer::Types::BackfillLimitExceededException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
     class BillExpirationException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

data/lib/aws-sdk-costexplorer/plugins/endpoints.rb

@@ -112,6 +112,8 @@ module Aws::CostExplorer
             Aws::CostExplorer::Endpoints::GetTags.build(context)
           when :get_usage_forecast
             Aws::CostExplorer::Endpoints::GetUsageForecast.build(context)
+          when :list_cost_allocation_tag_backfill_history
+            Aws::CostExplorer::Endpoints::ListCostAllocationTagBackfillHistory.build(context)
           when :list_cost_allocation_tags
             Aws::CostExplorer::Endpoints::ListCostAllocationTags.build(context)
           when :list_cost_category_definitions
@@ -122,6 +124,8 @@ module Aws::CostExplorer
             Aws::CostExplorer::Endpoints::ListTagsForResource.build(context)
           when :provide_anomaly_feedback
             Aws::CostExplorer::Endpoints::ProvideAnomalyFeedback.build(context)
+          when :start_cost_allocation_tag_backfill
+            Aws::CostExplorer::Endpoints::StartCostAllocationTagBackfill.build(context)
           when :start_savings_plans_purchase_recommendation_generation
             Aws::CostExplorer::Endpoints::StartSavingsPlansPurchaseRecommendationGeneration.build(context)
           when :tag_resource

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

@@ -388,6 +388,20 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # A request to backfill is already in progress. Once the previous
+    # request is complete, you can create another request.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/BackfillLimitExceededException AWS API Documentation
+    #
+    class BackfillLimitExceededException < Struct.new(
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The requested report expired. Update the date interval and try again.
     #
     # @!attribute [rw] message
@@ -441,6 +455,41 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # The cost allocation tag backfill request structure that contains
+    # metadata and details of a certain backfill.
+    #
+    # @!attribute [rw] backfill_from
+    #   The date the backfill starts from.
+    #   @return [String]
+    #
+    # @!attribute [rw] requested_at
+    #   The time when the backfill was requested.
+    #   @return [String]
+    #
+    # @!attribute [rw] completed_at
+    #   The backfill completion time.
+    #   @return [String]
+    #
+    # @!attribute [rw] backfill_status
+    #   The status of the cost allocation tag backfill request.
+    #   @return [String]
+    #
+    # @!attribute [rw] last_updated_at
+    #   The time when the backfill status was last updated.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CostAllocationTagBackfillRequest AWS API Documentation
+    #
+    class CostAllocationTagBackfillRequest < Struct.new(
+      :backfill_from,
+      :requested_at,
+      :completed_at,
+      :backfill_status,
+      :last_updated_at)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The cost allocation tag status. The status of a key can either be
     # active or inactive.
     #
@@ -4774,6 +4823,44 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # @!attribute [rw] next_token
+    #   The token to retrieve the next set of results. Amazon Web Services
+    #   provides the token when the response from a previous call has more
+    #   results than the maximum page size.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of objects that are returned for this request.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostAllocationTagBackfillHistoryRequest AWS API Documentation
+    #
+    class ListCostAllocationTagBackfillHistoryRequest < Struct.new(
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] backfill_requests
+    #   The list of historical cost allocation tag backfill requests.
+    #   @return [Array<Types::CostAllocationTagBackfillRequest>]
+    #
+    # @!attribute [rw] next_token
+    #   The token to retrieve the next set of results. Amazon Web Services
+    #   provides the token when the response from a previous call has more
+    #   results than the maximum page size.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostAllocationTagBackfillHistoryResponse AWS API Documentation
+    #
+    class ListCostAllocationTagBackfillHistoryResponse < Struct.new(
+      :backfill_requests,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] status
     #   The status of cost allocation tag keys that are returned for this
     #   request.
@@ -5716,22 +5803,27 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Information about this specific recommendation, such as the timestamp
-    # for when Amazon Web Services made a specific recommendation.
+    # Information about a recommendation, such as the timestamp for when
+    # Amazon Web Services made a specific recommendation.
     #
     # @!attribute [rw] recommendation_id
-    #   The ID for this specific recommendation.
+    #   The ID for the recommendation.
     #   @return [String]
     #
     # @!attribute [rw] generation_timestamp
-    #   The timestamp for when Amazon Web Services made this recommendation.
+    #   The timestamp for when Amazon Web Services made the recommendation.
+    #   @return [String]
+    #
+    # @!attribute [rw] additional_metadata
+    #   Additional metadata that might be applicable to the recommendation.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ReservationPurchaseRecommendationMetadata AWS API Documentation
     #
     class ReservationPurchaseRecommendationMetadata < Struct.new(
       :recommendation_id,
-      :generation_timestamp)
+      :generation_timestamp,
+      :additional_metadata)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -5968,19 +6060,19 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Metadata for this recommendation set.
+    # Metadata for a recommendation set.
     #
     # @!attribute [rw] recommendation_id
-    #   The ID for this specific recommendation.
+    #   The ID for the recommendation.
     #   @return [String]
     #
     # @!attribute [rw] generation_timestamp
-    #   The timestamp for when Amazon Web Services made this recommendation.
+    #   The timestamp for when Amazon Web Services made the recommendation.
     #   @return [String]
     #
     # @!attribute [rw] lookback_period_in_days
     #   The number of days of previous usage that Amazon Web Services
-    #   considers when making this recommendation.
+    #   considers when making the recommendation.
     #   @return [String]
     #
     # @!attribute [rw] additional_metadata
@@ -6662,6 +6754,32 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # @!attribute [rw] backfill_from
+    #   The date you want the backfill to start from. The date can only be a
+    #   first day of the month (a billing start date). Dates can't precede
+    #   the previous twelve months, or in the future.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/StartCostAllocationTagBackfillRequest AWS API Documentation
+    #
+    class StartCostAllocationTagBackfillRequest < Struct.new(
+      :backfill_from)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] backfill_request
+    #   An object containing detailed metadata of your new backfill request.
+    #   @return [Types::CostAllocationTagBackfillRequest]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/StartCostAllocationTagBackfillResponse AWS API Documentation
+    #
+    class StartCostAllocationTagBackfillResponse < Struct.new(
+      :backfill_request)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @api private
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/StartSavingsPlansPurchaseRecommendationGenerationRequest AWS API Documentation

data/lib/aws-sdk-costexplorer.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-costexplorer/customizations'
 # @!group service
 module Aws::CostExplorer
 
-  GEM_VERSION = '1.96.0'
+  GEM_VERSION = '1.98.0'
 
 end

data/sig/client.rbs

@@ -1071,6 +1071,18 @@ module Aws
                               ) -> _GetUsageForecastResponseSuccess
                             | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetUsageForecastResponseSuccess
 
+      interface _ListCostAllocationTagBackfillHistoryResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::ListCostAllocationTagBackfillHistoryResponse]
+        def backfill_requests: () -> ::Array[Types::CostAllocationTagBackfillRequest]
+        def next_token: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CostExplorer/Client.html#list_cost_allocation_tag_backfill_history-instance_method
+      def list_cost_allocation_tag_backfill_history: (
+                                                       ?next_token: ::String,
+                                                       ?max_results: ::Integer
+                                                     ) -> _ListCostAllocationTagBackfillHistoryResponseSuccess
+                                                   | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListCostAllocationTagBackfillHistoryResponseSuccess
+
       interface _ListCostAllocationTagsResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::ListCostAllocationTagsResponse]
         def cost_allocation_tags: () -> ::Array[Types::CostAllocationTag]
@@ -1134,6 +1146,16 @@ module Aws
                                     ) -> _ProvideAnomalyFeedbackResponseSuccess
                                   | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ProvideAnomalyFeedbackResponseSuccess
 
+      interface _StartCostAllocationTagBackfillResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::StartCostAllocationTagBackfillResponse]
+        def backfill_request: () -> Types::CostAllocationTagBackfillRequest
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CostExplorer/Client.html#start_cost_allocation_tag_backfill-instance_method
+      def start_cost_allocation_tag_backfill: (
+                                                backfill_from: ::String
+                                              ) -> _StartCostAllocationTagBackfillResponseSuccess
+                                            | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _StartCostAllocationTagBackfillResponseSuccess
+
       interface _StartSavingsPlansPurchaseRecommendationGenerationResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::StartSavingsPlansPurchaseRecommendationGenerationResponse]
         def recommendation_id: () -> ::String

data/sig/errors.rbs

@@ -11,6 +11,9 @@ module Aws
       class ServiceError < ::Aws::Errors::ServiceError
       end
 
+      class BackfillLimitExceededException < ::Aws::Errors::ServiceError
+        def message: () -> ::String
+      end
       class BillExpirationException < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end

data/sig/types.rbs

@@ -58,6 +58,11 @@ module Aws::CostExplorer
       SENSITIVE: []
     end
 
+    class BackfillLimitExceededException
+      attr_accessor message: ::String
+      SENSITIVE: []
+    end
+
     class BillExpirationException
       attr_accessor message: ::String
       SENSITIVE: []
@@ -72,6 +77,15 @@ module Aws::CostExplorer
       SENSITIVE: []
     end
 
+    class CostAllocationTagBackfillRequest
+      attr_accessor backfill_from: ::String
+      attr_accessor requested_at: ::String
+      attr_accessor completed_at: ::String
+      attr_accessor backfill_status: ("SUCCEEDED" | "PROCESSING" | "FAILED")
+      attr_accessor last_updated_at: ::String
+      SENSITIVE: []
+    end
+
     class CostAllocationTagStatusEntry
       attr_accessor tag_key: ::String
       attr_accessor status: ("Active" | "Inactive")
@@ -781,6 +795,18 @@ module Aws::CostExplorer
       SENSITIVE: []
     end
 
+    class ListCostAllocationTagBackfillHistoryRequest
+      attr_accessor next_token: ::String
+      attr_accessor max_results: ::Integer
+      SENSITIVE: []
+    end
+
+    class ListCostAllocationTagBackfillHistoryResponse
+      attr_accessor backfill_requests: ::Array[Types::CostAllocationTagBackfillRequest]
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
     class ListCostAllocationTagsRequest
       attr_accessor status: ("Active" | "Inactive")
       attr_accessor tag_keys: ::Array[::String]
@@ -1005,6 +1031,7 @@ module Aws::CostExplorer
     class ReservationPurchaseRecommendationMetadata
       attr_accessor recommendation_id: ::String
       attr_accessor generation_timestamp: ::String
+      attr_accessor additional_metadata: ::String
       SENSITIVE: []
     end
 
@@ -1231,6 +1258,16 @@ module Aws::CostExplorer
       SENSITIVE: []
     end
 
+    class StartCostAllocationTagBackfillRequest
+      attr_accessor backfill_from: ::String
+      SENSITIVE: []
+    end
+
+    class StartCostAllocationTagBackfillResponse
+      attr_accessor backfill_request: Types::CostAllocationTagBackfillRequest
+      SENSITIVE: []
+    end
+
     class StartSavingsPlansPurchaseRecommendationGenerationRequest < Aws::EmptyStructure
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-costexplorer
 version: !ruby/object:Gem::Version
-  version: 1.96.0
+  version: 1.98.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-02-28 00:00:00.000000000 Z
+date: 2024-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core