aws-sdk-costexplorer 1.95.0 → 1.97.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 787b6f57e5c4098bab9035a26bdca1c467f3336385bf26bb7b19c126f613d046
-  data.tar.gz: af884acc5a6364d6a95f7fbedd3b2b44c260c3128abfa1f2181e405525896726
+  metadata.gz: fa401a291a4cb06b7610b0a680387854d703d0acd9f0c8de5148797d6683ac99
+  data.tar.gz: d3a51e31510606319d1923fc9bdd4fa9e3146e00e002417cdf003750c0f2217d
 SHA512:
-  metadata.gz: b6df2e47c530b982b54feaccb5b505f7a49830a53e8f64c8f556ec284646b475ffa6b1a8e6548a97d49c01c31738f0f88f16157f62cf4237ab12af5b6551c5c0
-  data.tar.gz: 9c95a6f271219d50060cd4d5b5a00a7e04b1cec11cce6364eb37bce7790f20ff688be57fc5970fe85066ce79f5b228ae24cc8e426b86b88067dd165e8982c258
+  metadata.gz: 45bccfa686ba9221a27e93d282919e567331d6bccf21ce2e510a223bfe1b25498f2df38b2e18525c397b7dd4799dfa9eba1c50fb74a1214a4ff734c56ba446e3
+  data.tar.gz: f51426d95c19e7ba45f29a24007ff735358c2e45770767e6096631892a582aca3a605acdad93681c0ac56bc057a38a6e01dceb0b108a7123370094a532cd7389

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+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)
+------------------
+
+* Feature - This release introduces the new API 'GetApproximateUsageRecords', which retrieves estimated usage records for hourly granularity or resource-level data at daily granularity.
+
 1.95.0 (2024-01-26)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.95.0
+1.97.0

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

@@ -1149,6 +1149,53 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
+    # Retrieves estimated usage records for hourly granularity or
+    # resource-level data at daily granularity.
+    #
+    # @option params [required, String] :granularity
+    #   How granular you want the data to be. You can enable data at hourly or
+    #   daily granularity.
+    #
+    # @option params [Array<String>] :services
+    #   The service metadata for the service or services you want to query. If
+    #   not specified, all elements are returned.
+    #
+    # @option params [required, String] :approximation_dimension
+    #   The service to evaluate for the usage records. You can choose
+    #   resource-level data at daily granularity, or hourly granularity with
+    #   or without resource-level data.
+    #
+    # @return [Types::GetApproximateUsageRecordsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetApproximateUsageRecordsResponse#services #services} => Hash&lt;String,Integer&gt;
+    #   * {Types::GetApproximateUsageRecordsResponse#total_records #total_records} => Integer
+    #   * {Types::GetApproximateUsageRecordsResponse#lookback_period #lookback_period} => Types::DateInterval
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_approximate_usage_records({
+    #     granularity: "DAILY", # required, accepts DAILY, MONTHLY, HOURLY
+    #     services: ["GenericString"],
+    #     approximation_dimension: "SERVICE", # required, accepts SERVICE, RESOURCE
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.services #=> Hash
+    #   resp.services["GenericString"] #=> Integer
+    #   resp.total_records #=> Integer
+    #   resp.lookback_period.start #=> String
+    #   resp.lookback_period.end #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetApproximateUsageRecords AWS API Documentation
+    #
+    # @overload get_approximate_usage_records(params = {})
+    # @param [Hash] params ({})
+    def get_approximate_usage_records(params = {}, options = {})
+      req = build_request(:get_approximate_usage_records, params)
+      req.send_request(options)
+    end
+
     # Retrieves cost and usage metrics for your account. You can specify
     # which cost and usage-related metric that you want the request to
     # return. For example, you can specify `BlendedCosts` or
@@ -4433,6 +4480,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.
@@ -4676,6 +4767,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
@@ -5157,7 +5286,7 @@ module Aws::CostExplorer
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-costexplorer'
-      context[:gem_version] = '1.95.0'
+      context[:gem_version] = '1.97.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -26,13 +26,19 @@ module Aws::CostExplorer
     AnomalySubscription = Shapes::StructureShape.new(name: 'AnomalySubscription')
     AnomalySubscriptionFrequency = Shapes::StringShape.new(name: 'AnomalySubscriptionFrequency')
     AnomalySubscriptions = Shapes::ListShape.new(name: 'AnomalySubscriptions')
+    ApproximateUsageRecordsPerService = Shapes::MapShape.new(name: 'ApproximateUsageRecordsPerService')
+    ApproximationDimension = Shapes::StringShape.new(name: 'ApproximationDimension')
     Arn = Shapes::StringShape.new(name: 'Arn')
     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')
@@ -126,6 +132,8 @@ module Aws::CostExplorer
     GetAnomalyMonitorsResponse = Shapes::StructureShape.new(name: 'GetAnomalyMonitorsResponse')
     GetAnomalySubscriptionsRequest = Shapes::StructureShape.new(name: 'GetAnomalySubscriptionsRequest')
     GetAnomalySubscriptionsResponse = Shapes::StructureShape.new(name: 'GetAnomalySubscriptionsResponse')
+    GetApproximateUsageRecordsRequest = Shapes::StructureShape.new(name: 'GetApproximateUsageRecordsRequest')
+    GetApproximateUsageRecordsResponse = Shapes::StructureShape.new(name: 'GetApproximateUsageRecordsResponse')
     GetCostAndUsageRequest = Shapes::StructureShape.new(name: 'GetCostAndUsageRequest')
     GetCostAndUsageResponse = Shapes::StructureShape.new(name: 'GetCostAndUsageResponse')
     GetCostAndUsageWithResourcesRequest = Shapes::StructureShape.new(name: 'GetCostAndUsageWithResourcesRequest')
@@ -171,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')
@@ -200,6 +210,7 @@ module Aws::CostExplorer
     NetworkResourceUtilization = Shapes::StructureShape.new(name: 'NetworkResourceUtilization')
     NextPageToken = Shapes::StringShape.new(name: 'NextPageToken')
     NonNegativeInteger = Shapes::IntegerShape.new(name: 'NonNegativeInteger')
+    NonNegativeLong = Shapes::IntegerShape.new(name: 'NonNegativeLong')
     NullableNonNegativeDouble = Shapes::FloatShape.new(name: 'NullableNonNegativeDouble')
     NumericOperator = Shapes::StringShape.new(name: 'NumericOperator')
     OfferingClass = Shapes::StringShape.new(name: 'OfferingClass')
@@ -287,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')
@@ -331,6 +344,7 @@ module Aws::CostExplorer
     UpdateCostAllocationTagsStatusResponse = Shapes::StructureShape.new(name: 'UpdateCostAllocationTagsStatusResponse')
     UpdateCostCategoryDefinitionRequest = Shapes::StructureShape.new(name: 'UpdateCostCategoryDefinitionRequest')
     UpdateCostCategoryDefinitionResponse = Shapes::StructureShape.new(name: 'UpdateCostCategoryDefinitionResponse')
+    UsageServices = Shapes::ListShape.new(name: 'UsageServices')
     UtilizationByTime = Shapes::StructureShape.new(name: 'UtilizationByTime')
     UtilizationPercentage = Shapes::StringShape.new(name: 'UtilizationPercentage')
     UtilizationPercentageInUnits = Shapes::StringShape.new(name: 'UtilizationPercentageInUnits')
@@ -386,9 +400,15 @@ module Aws::CostExplorer
 
     AnomalySubscriptions.member = Shapes::ShapeRef.new(shape: AnomalySubscription)
 
+    ApproximateUsageRecordsPerService.key = Shapes::ShapeRef.new(shape: GenericString)
+    ApproximateUsageRecordsPerService.value = Shapes::ShapeRef.new(shape: NonNegativeLong)
+
     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
 
@@ -399,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)
@@ -708,6 +737,16 @@ module Aws::CostExplorer
     GetAnomalySubscriptionsResponse.add_member(:next_page_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextPageToken"))
     GetAnomalySubscriptionsResponse.struct_class = Types::GetAnomalySubscriptionsResponse
 
+    GetApproximateUsageRecordsRequest.add_member(:granularity, Shapes::ShapeRef.new(shape: Granularity, required: true, location_name: "Granularity"))
+    GetApproximateUsageRecordsRequest.add_member(:services, Shapes::ShapeRef.new(shape: UsageServices, location_name: "Services"))
+    GetApproximateUsageRecordsRequest.add_member(:approximation_dimension, Shapes::ShapeRef.new(shape: ApproximationDimension, required: true, location_name: "ApproximationDimension"))
+    GetApproximateUsageRecordsRequest.struct_class = Types::GetApproximateUsageRecordsRequest
+
+    GetApproximateUsageRecordsResponse.add_member(:services, Shapes::ShapeRef.new(shape: ApproximateUsageRecordsPerService, location_name: "Services"))
+    GetApproximateUsageRecordsResponse.add_member(:total_records, Shapes::ShapeRef.new(shape: NonNegativeLong, location_name: "TotalRecords"))
+    GetApproximateUsageRecordsResponse.add_member(:lookback_period, Shapes::ShapeRef.new(shape: DateInterval, location_name: "LookbackPeriod"))
+    GetApproximateUsageRecordsResponse.struct_class = Types::GetApproximateUsageRecordsResponse
+
     GetCostAndUsageRequest.add_member(:time_period, Shapes::ShapeRef.new(shape: DateInterval, required: true, location_name: "TimePeriod"))
     GetCostAndUsageRequest.add_member(:granularity, Shapes::ShapeRef.new(shape: Granularity, required: true, location_name: "Granularity"))
     GetCostAndUsageRequest.add_member(:filter, Shapes::ShapeRef.new(shape: Expression, location_name: "Filter"))
@@ -960,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"))
@@ -1351,6 +1398,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"))
@@ -1463,6 +1516,8 @@ module Aws::CostExplorer
     UpdateCostCategoryDefinitionResponse.add_member(:effective_start, Shapes::ShapeRef.new(shape: ZonedDateTime, location_name: "EffectiveStart"))
     UpdateCostCategoryDefinitionResponse.struct_class = Types::UpdateCostCategoryDefinitionResponse
 
+    UsageServices.member = Shapes::ShapeRef.new(shape: GenericString)
+
     UtilizationByTime.add_member(:time_period, Shapes::ShapeRef.new(shape: DateInterval, location_name: "TimePeriod"))
     UtilizationByTime.add_member(:groups, Shapes::ShapeRef.new(shape: ReservationUtilizationGroups, location_name: "Groups"))
     UtilizationByTime.add_member(:total, Shapes::ShapeRef.new(shape: ReservationAggregates, location_name: "Total"))
@@ -1593,6 +1648,16 @@ module Aws::CostExplorer
         o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
       end)
 
+      api.add_operation(:get_approximate_usage_records, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetApproximateUsageRecords"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetApproximateUsageRecordsRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetApproximateUsageRecordsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: DataUnavailableException)
+      end)
+
       api.add_operation(:get_cost_and_usage, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetCostAndUsage"
         o.http_method = "POST"
@@ -1786,6 +1851,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"
@@ -1847,6 +1928,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

@@ -152,6 +152,20 @@ module Aws::CostExplorer
       end
     end
 
+    class GetApproximateUsageRecords
+      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 GetCostAndUsage
       def self.build(context)
         unless context.config.regional_endpoint
@@ -376,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
@@ -446,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

@@ -78,6 +78,8 @@ module Aws::CostExplorer
             Aws::CostExplorer::Endpoints::GetAnomalyMonitors.build(context)
           when :get_anomaly_subscriptions
             Aws::CostExplorer::Endpoints::GetAnomalySubscriptions.build(context)
+          when :get_approximate_usage_records
+            Aws::CostExplorer::Endpoints::GetApproximateUsageRecords.build(context)
           when :get_cost_and_usage
             Aws::CostExplorer::Endpoints::GetCostAndUsage.build(context)
           when :get_cost_and_usage_with_resources
@@ -110,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
@@ -120,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.
     #
@@ -2079,6 +2128,55 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # @!attribute [rw] granularity
+    #   How granular you want the data to be. You can enable data at hourly
+    #   or daily granularity.
+    #   @return [String]
+    #
+    # @!attribute [rw] services
+    #   The service metadata for the service or services you want to query.
+    #   If not specified, all elements are returned.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] approximation_dimension
+    #   The service to evaluate for the usage records. You can choose
+    #   resource-level data at daily granularity, or hourly granularity with
+    #   or without resource-level data.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetApproximateUsageRecordsRequest AWS API Documentation
+    #
+    class GetApproximateUsageRecordsRequest < Struct.new(
+      :granularity,
+      :services,
+      :approximation_dimension)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] services
+    #   The service metadata for the service or services in the response.
+    #   @return [Hash<String,Integer>]
+    #
+    # @!attribute [rw] total_records
+    #   The total number of usage records for all services in the services
+    #   list.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] lookback_period
+    #   The lookback period that's used for the estimation.
+    #   @return [Types::DateInterval]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetApproximateUsageRecordsResponse AWS API Documentation
+    #
+    class GetApproximateUsageRecordsResponse < Struct.new(
+      :services,
+      :total_records,
+      :lookback_period)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] time_period
     #   Sets the start date and end date for retrieving Amazon Web Services
     #   costs. The start date is inclusive, but the end date is exclusive.
@@ -4725,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.
@@ -6613,6 +6749,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.95.0'
+  GEM_VERSION = '1.97.0'
 
 end

data/sig/client.rbs

@@ -333,6 +333,20 @@ module Aws
                                      ) -> _GetAnomalySubscriptionsResponseSuccess
                                    | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetAnomalySubscriptionsResponseSuccess
 
+      interface _GetApproximateUsageRecordsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::GetApproximateUsageRecordsResponse]
+        def services: () -> ::Hash[::String, ::Integer]
+        def total_records: () -> ::Integer
+        def lookback_period: () -> Types::DateInterval
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CostExplorer/Client.html#get_approximate_usage_records-instance_method
+      def get_approximate_usage_records: (
+                                           granularity: ("DAILY" | "MONTHLY" | "HOURLY"),
+                                           ?services: Array[::String],
+                                           approximation_dimension: ("SERVICE" | "RESOURCE")
+                                         ) -> _GetApproximateUsageRecordsResponseSuccess
+                                       | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetApproximateUsageRecordsResponseSuccess
+
       interface _GetCostAndUsageResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::GetCostAndUsageResponse]
         def next_page_token: () -> ::String
@@ -1057,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]
@@ -1120,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")
@@ -445,6 +459,20 @@ module Aws::CostExplorer
       SENSITIVE: []
     end
 
+    class GetApproximateUsageRecordsRequest
+      attr_accessor granularity: ("DAILY" | "MONTHLY" | "HOURLY")
+      attr_accessor services: ::Array[::String]
+      attr_accessor approximation_dimension: ("SERVICE" | "RESOURCE")
+      SENSITIVE: []
+    end
+
+    class GetApproximateUsageRecordsResponse
+      attr_accessor services: ::Hash[::String, ::Integer]
+      attr_accessor total_records: ::Integer
+      attr_accessor lookback_period: Types::DateInterval
+      SENSITIVE: []
+    end
+
     class GetCostAndUsageRequest
       attr_accessor time_period: Types::DateInterval
       attr_accessor granularity: ("DAILY" | "MONTHLY" | "HOURLY")
@@ -767,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]
@@ -1217,6 +1257,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.95.0
+  version: 1.97.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-26 00:00:00.000000000 Z
+date: 2024-03-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core