aws-sdk-costexplorer 1.141.0 → 1.142.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 924ab94a563f58c9f0da83058d31452b83fa3524f46cd0fa890a68968b604a74
-  data.tar.gz: 60bd07a830b6a821df0c89227b679301855749e586761b1497c10f33b59541fa
+  metadata.gz: c98e8d9f8f27e5f03759956e984802f90b9d2ba9fad9307fc66409fafd8b8a77
+  data.tar.gz: 5577400f9d114c205ea420ee578031d43d8033e30b21c6d2758c0f85d9eaae28
 SHA512:
-  metadata.gz: 896341534a6d38baa13f604ca49f1f0aee0a08380dbe7e191dd07138659265104360a4098f1393319d745e2f1c74585831e5a9f4c18084182899fb2199e68db3
-  data.tar.gz: 5bb54ba4e3b4b780f8fe943b4e6275f4fcbfd41e886157b3f9e4349010e5597ce5c6ffcbafea536d476b8eacf9aea2e7897a2c84f71ebcf66a12d841acfc768c
+  metadata.gz: 879b8ae7c077eb8e8f8b59d29afd5370f93619d3718f8801872a563a545ff0abae2ad96f7b40e9eb7aa86ae04c5536a4fd202a13340b5d79103b9bbad425e6c7
+  data.tar.gz: d5c072f4a6528c99ff514a8c5e2992b6d8903422012664ed2738340ab86b3aa474b3015a2360bc722b2536415966f8057434ccda4a31eb65622f01b3c91fe2b0

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.142.0 (2025-12-08)
+------------------
+
+* Feature - Add support for Cost Category resource associations including filtering by resource type on ListCostCategoryDefinitions and new ListCostCategoryResourceAssociations API.
+
 1.141.0 (2025-12-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.141.0
+1.142.0

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

@@ -698,22 +698,22 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
-    # Creates a new Cost Category with the requested name and rules.
+    # Creates a new cost category with the requested name and rules.
     #
     # @option params [required, String] :name
-    #   The unique name of the Cost Category.
+    #   The unique name of the cost category.
     #
     # @option params [String] :effective_start
-    #   The Cost Category's effective start date. It can only be a billing
+    #   The cost category's effective start date. It can only be a billing
     #   start date (first day of the month). If the date isn't provided,
     #   it's the first day of the current month. Dates can't be before the
     #   previous twelve months, or in the future.
     #
     # @option params [required, String] :rule_version
-    #   The rule schema version in this particular Cost Category.
+    #   The rule schema version in this particular cost category.
     #
     # @option params [required, Array<Types::CostCategoryRule>] :rules
-    #   The Cost Category rules used to categorize costs. For more
+    #   The cost category rules used to categorize costs. For more
     #   information, see [CostCategoryRule][1].
     #
     #
@@ -724,8 +724,8 @@ module Aws::CostExplorer
     #   The default value for the cost category.
     #
     # @option params [Array<Types::CostCategorySplitChargeRule>] :split_charge_rules
-    #   The split charge rules used to allocate your charges between your Cost
-    #   Category values.
+    #   The split charge rules used to allocate your charges between your cost
+    #   category values.
     #
     # @option params [Array<Types::ResourceTag>] :resource_tags
     #   An optional list of tags to associate with the specified [
@@ -890,11 +890,11 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
-    # Deletes a Cost Category. Expenses from this month going forward will
-    # no longer be categorized with this Cost Category.
+    # Deletes a cost category. Expenses from this month going forward will
+    # no longer be categorized with this cost category.
     #
     # @option params [required, String] :cost_category_arn
-    #   The unique identifier for your Cost Category.
+    #   The unique identifier for your cost category.
     #
     # @return [Types::DeleteCostCategoryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -922,19 +922,19 @@ module Aws::CostExplorer
     end
 
     # Returns the name, Amazon Resource Name (ARN), rules, definition, and
-    # effective dates of a Cost Category that's defined in the account.
+    # effective dates of a cost category that's defined in the account.
     #
-    # You have the option to use `EffectiveOn` to return a Cost Category
+    # You have the option to use `EffectiveOn` to return a cost category
     # that's active on a specific date. If there's no `EffectiveOn`
     # specified, you see a Cost Category that's effective on the current
-    # date. If Cost Category is still effective, `EffectiveEnd` is omitted
+    # date. If cost category is still effective, `EffectiveEnd` is omitted
     # in the response.
     #
     # @option params [required, String] :cost_category_arn
-    #   The unique identifier for your Cost Category.
+    #   The unique identifier for your cost category.
     #
     # @option params [String] :effective_on
-    #   The date when the Cost Category was effective.
+    #   The date when the cost category was effective.
     #
     # @return [Types::DescribeCostCategoryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1839,6 +1839,10 @@ module Aws::CostExplorer
     #   You can nest `Expression` objects to define any combination of
     #   dimension filters. For more information, see [Expression][1].
     #
+    #   The `GetCostAndUsageWithResources` operation requires that you either
+    #   group by or filter by a `ResourceId`. It requires the [Expression][1]
+    #   `"SERVICE = Amazon Elastic Compute Cloud - Compute"` in the filter.
+    #
     #   Valid values for `MatchOptions` for `Dimensions` are `EQUALS` and
     #   `CASE_SENSITIVE`.
     #
@@ -1981,9 +1985,9 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
-    # Retrieves an array of Cost Category names and values incurred cost.
+    # Retrieves an array of cost category names and values incurred cost.
     #
-    # <note markdown="1"> If some Cost Category names and values are not associated with any
+    # <note markdown="1"> If some cost category names and values are not associated with any
     # cost, they will not be returned by this API.
     #
     #  </note>
@@ -1992,15 +1996,15 @@ module Aws::CostExplorer
     #   The value that you want to search the filter values for.
     #
     #   If you don't specify a `CostCategoryName`, `SearchString` is used to
-    #   filter Cost Category names that match the `SearchString` pattern. If
+    #   filter cost category names that match the `SearchString` pattern. If
     #   you specify a `CostCategoryName`, `SearchString` is used to filter
-    #   Cost Category values that match the `SearchString` pattern.
+    #   cost category values that match the `SearchString` pattern.
     #
     # @option params [required, Types::DateInterval] :time_period
     #   The time period of the request.
     #
     # @option params [String] :cost_category_name
-    #   The unique name of the Cost Category.
+    #   The unique name of the cost category.
     #
     # @option params [Types::Expression] :filter
     #   Use `Expression` to filter in various Cost Explorer APIs.
@@ -3017,7 +3021,7 @@ module Aws::CostExplorer
     # ElastiCache, Amazon Relational Database Service, or Amazon Redshift
     # usage is covered by a reservation. An organization's management
     # account can see the coverage of the associated member accounts. This
-    # supports dimensions, Cost Categories, and nested expressions. For any
+    # supports dimensions, cost categories, and nested expressions. For any
     # time period, you can filter data about reservation usage by the
     # following dimensions:
     #
@@ -4164,7 +4168,7 @@ module Aws::CostExplorer
     # Retrieves the Savings Plans covered for your account. This enables you
     # to see how much of your cost is covered by a Savings Plan. An
     # organization’s management account can see the coverage of the
-    # associated member accounts. This supports dimensions, Cost Categories,
+    # associated member accounts. This supports dimensions, cost categories,
     # and nested expressions. For any time period, you can filter data for
     # Savings Plans usage with the following dimensions:
     #
@@ -5357,17 +5361,17 @@ module Aws::CostExplorer
     end
 
     # Returns the name, Amazon Resource Name (ARN), `NumberOfRules` and
-    # effective dates of all Cost Categories defined in the account. You
-    # have the option to use `EffectiveOn` to return a list of Cost
-    # Categories that were active on a specific date. If there is no
-    # `EffectiveOn` specified, you’ll see Cost Categories that are effective
-    # on the current date. If Cost Category is still effective,
-    # `EffectiveEnd` is omitted in the response.
+    # effective dates of all cost categories defined in the account. You
+    # have the option to use `EffectiveOn` and `SupportedResourceTypes` to
+    # return a list of cost categories that were active on a specific date.
+    # If there is no `EffectiveOn` specified, you’ll see cost categories
+    # that are effective on the current date. If cost category is still
+    # effective, `EffectiveEnd` is omitted in the response.
     # `ListCostCategoryDefinitions` supports pagination. The request can
     # have a `MaxResults` range up to 100.
     #
     # @option params [String] :effective_on
-    #   The date when the Cost Category was effective.
+    #   The date when the cost category was effective.
     #
     # @option params [String] :next_token
     #   The token to retrieve the next set of results. Amazon Web Services
@@ -5377,6 +5381,13 @@ module Aws::CostExplorer
     # @option params [Integer] :max_results
     #   The number of entries a paginated response contains.
     #
+    # @option params [Array<String>] :supported_resource_types
+    #   Filter cost category definitions that are supported by given resource
+    #   types based on the latest version. If the filter is present, the
+    #   result only includes Cost Categories that supports input resource
+    #   type. If the filter isn't provided, no filtering is applied. The
+    #   valid values are `billing:rispgroupsharing`.
+    #
     # @return [Types::ListCostCategoryDefinitionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListCostCategoryDefinitionsResponse#cost_category_references #cost_category_references} => Array&lt;Types::CostCategoryReference&gt;
@@ -5390,6 +5401,7 @@ module Aws::CostExplorer
     #     effective_on: "ZonedDateTime",
     #     next_token: "NextPageToken",
     #     max_results: 1,
+    #     supported_resource_types: ["ResourceType"],
     #   })
     #
     # @example Response structure
@@ -5406,6 +5418,8 @@ module Aws::CostExplorer
     #   resp.cost_category_references[0].values #=> Array
     #   resp.cost_category_references[0].values[0] #=> String
     #   resp.cost_category_references[0].default_value #=> String
+    #   resp.cost_category_references[0].supported_resource_types #=> Array
+    #   resp.cost_category_references[0].supported_resource_types[0] #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostCategoryDefinitions AWS API Documentation
@@ -5417,6 +5431,55 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
+    # Returns resource associations of all cost categories defined in the
+    # account. You have the option to use `CostCategoryArn` to get the
+    # association for a specific cost category.
+    # `ListCostCategoryResourceAssociations` supports pagination. The
+    # request can have a `MaxResults` range up to 100.
+    #
+    # @option params [String] :cost_category_arn
+    #   The unique identifier for your cost category.
+    #
+    # @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 number of entries a paginated response contains.
+    #
+    # @return [Types::ListCostCategoryResourceAssociationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListCostCategoryResourceAssociationsResponse#cost_category_resource_associations #cost_category_resource_associations} => Array&lt;Types::CostCategoryResourceAssociation&gt;
+    #   * {Types::ListCostCategoryResourceAssociationsResponse#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_category_resource_associations({
+    #     cost_category_arn: "Arn",
+    #     next_token: "NextPageToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.cost_category_resource_associations #=> Array
+    #   resp.cost_category_resource_associations[0].resource_arn #=> String
+    #   resp.cost_category_resource_associations[0].cost_category_name #=> String
+    #   resp.cost_category_resource_associations[0].cost_category_arn #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostCategoryResourceAssociations AWS API Documentation
+    #
+    # @overload list_cost_category_resource_associations(params = {})
+    # @param [Hash] params ({})
+    def list_cost_category_resource_associations(params = {}, options = {})
+      req = build_request(:list_cost_category_resource_associations, params)
+      req.send_request(options)
+    end
+
     # Retrieves a list of your historical recommendation generations within
     # the past 30 days.
     #
@@ -5982,22 +6045,22 @@ module Aws::CostExplorer
       req.send_request(options)
     end
 
-    # Updates an existing Cost Category. Changes made to the Cost Category
+    # Updates an existing cost category. Changes made to the cost category
     # rules will be used to categorize the current month’s expenses and
     # future expenses. This won’t change categorization for the previous
     # months.
     #
     # @option params [required, String] :cost_category_arn
-    #   The unique identifier for your Cost Category.
+    #   The unique identifier for your cost category.
     #
     # @option params [String] :effective_start
-    #   The Cost Category's effective start date. It can only be a billing
+    #   The cost category's effective start date. It can only be a billing
     #   start date (first day of the month). If the date isn't provided,
     #   it's the first day of the current month. Dates can't be before the
     #   previous twelve months, or in the future.
     #
     # @option params [required, String] :rule_version
-    #   The rule schema version in this particular Cost Category.
+    #   The rule schema version in this particular cost category.
     #
     # @option params [required, Array<Types::CostCategoryRule>] :rules
     #   The `Expression` object used to categorize costs. For more
@@ -6011,8 +6074,8 @@ module Aws::CostExplorer
     #   The default value for the cost category.
     #
     # @option params [Array<Types::CostCategorySplitChargeRule>] :split_charge_rules
-    #   The split charge rules used to allocate your charges between your Cost
-    #   Category values.
+    #   The split charge rules used to allocate your charges between your cost
+    #   category values.
     #
     # @return [Types::UpdateCostCategoryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6113,7 +6176,7 @@ module Aws::CostExplorer
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-costexplorer'
-      context[:gem_version] = '1.141.0'
+      context[:gem_version] = '1.142.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -74,6 +74,8 @@ module Aws::CostExplorer
     CostCategoryProcessingStatusList = Shapes::ListShape.new(name: 'CostCategoryProcessingStatusList')
     CostCategoryReference = Shapes::StructureShape.new(name: 'CostCategoryReference')
     CostCategoryReferencesList = Shapes::ListShape.new(name: 'CostCategoryReferencesList')
+    CostCategoryResourceAssociation = Shapes::StructureShape.new(name: 'CostCategoryResourceAssociation')
+    CostCategoryResourceAssociations = Shapes::ListShape.new(name: 'CostCategoryResourceAssociations')
     CostCategoryRule = Shapes::StructureShape.new(name: 'CostCategoryRule')
     CostCategoryRuleType = Shapes::StringShape.new(name: 'CostCategoryRuleType')
     CostCategoryRuleVersion = Shapes::StringShape.new(name: 'CostCategoryRuleVersion')
@@ -148,6 +150,7 @@ module Aws::CostExplorer
     GenerationStatus = Shapes::StringShape.new(name: 'GenerationStatus')
     GenerationSummary = Shapes::StructureShape.new(name: 'GenerationSummary')
     GenerationSummaryList = Shapes::ListShape.new(name: 'GenerationSummaryList')
+    GenericArn = Shapes::StringShape.new(name: 'GenericArn')
     GenericBoolean = Shapes::BooleanShape.new(name: 'GenericBoolean')
     GenericDouble = Shapes::FloatShape.new(name: 'GenericDouble')
     GenericString = Shapes::StringShape.new(name: 'GenericString')
@@ -218,6 +221,8 @@ module Aws::CostExplorer
     ListCostAllocationTagsResponse = Shapes::StructureShape.new(name: 'ListCostAllocationTagsResponse')
     ListCostCategoryDefinitionsRequest = Shapes::StructureShape.new(name: 'ListCostCategoryDefinitionsRequest')
     ListCostCategoryDefinitionsResponse = Shapes::StructureShape.new(name: 'ListCostCategoryDefinitionsResponse')
+    ListCostCategoryResourceAssociationsRequest = Shapes::StructureShape.new(name: 'ListCostCategoryResourceAssociationsRequest')
+    ListCostCategoryResourceAssociationsResponse = Shapes::StructureShape.new(name: 'ListCostCategoryResourceAssociationsResponse')
     ListSavingsPlansPurchaseRecommendationGenerationRequest = Shapes::StructureShape.new(name: 'ListSavingsPlansPurchaseRecommendationGenerationRequest')
     ListSavingsPlansPurchaseRecommendationGenerationResponse = Shapes::StructureShape.new(name: 'ListSavingsPlansPurchaseRecommendationGenerationResponse')
     ListTagsForResourceRequest = Shapes::StructureShape.new(name: 'ListTagsForResourceRequest')
@@ -294,6 +299,9 @@ module Aws::CostExplorer
     ResourceTagKeyList = Shapes::ListShape.new(name: 'ResourceTagKeyList')
     ResourceTagList = Shapes::ListShape.new(name: 'ResourceTagList')
     ResourceTagValue = Shapes::StringShape.new(name: 'ResourceTagValue')
+    ResourceType = Shapes::StringShape.new(name: 'ResourceType')
+    ResourceTypes = Shapes::ListShape.new(name: 'ResourceTypes')
+    ResourceTypesFilterInput = Shapes::ListShape.new(name: 'ResourceTypesFilterInput')
     ResourceUtilization = Shapes::StructureShape.new(name: 'ResourceUtilization')
     ResultByTime = Shapes::StructureShape.new(name: 'ResultByTime')
     ResultsByTime = Shapes::ListShape.new(name: 'ResultsByTime')
@@ -553,10 +561,18 @@ module Aws::CostExplorer
     CostCategoryReference.add_member(:processing_status, Shapes::ShapeRef.new(shape: CostCategoryProcessingStatusList, location_name: "ProcessingStatus"))
     CostCategoryReference.add_member(:values, Shapes::ShapeRef.new(shape: CostCategoryValuesList, location_name: "Values"))
     CostCategoryReference.add_member(:default_value, Shapes::ShapeRef.new(shape: CostCategoryValue, location_name: "DefaultValue"))
+    CostCategoryReference.add_member(:supported_resource_types, Shapes::ShapeRef.new(shape: ResourceTypes, location_name: "SupportedResourceTypes"))
     CostCategoryReference.struct_class = Types::CostCategoryReference
 
     CostCategoryReferencesList.member = Shapes::ShapeRef.new(shape: CostCategoryReference)
 
+    CostCategoryResourceAssociation.add_member(:resource_arn, Shapes::ShapeRef.new(shape: GenericArn, location_name: "ResourceArn"))
+    CostCategoryResourceAssociation.add_member(:cost_category_name, Shapes::ShapeRef.new(shape: CostCategoryName, location_name: "CostCategoryName"))
+    CostCategoryResourceAssociation.add_member(:cost_category_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "CostCategoryArn"))
+    CostCategoryResourceAssociation.struct_class = Types::CostCategoryResourceAssociation
+
+    CostCategoryResourceAssociations.member = Shapes::ShapeRef.new(shape: CostCategoryResourceAssociation)
+
     CostCategoryRule.add_member(:value, Shapes::ShapeRef.new(shape: CostCategoryValue, location_name: "Value"))
     CostCategoryRule.add_member(:rule, Shapes::ShapeRef.new(shape: Expression, location_name: "Rule"))
     CostCategoryRule.add_member(:inherited_value, Shapes::ShapeRef.new(shape: CostCategoryInheritedValueDimension, location_name: "InheritedValue"))
@@ -1182,12 +1198,22 @@ module Aws::CostExplorer
     ListCostCategoryDefinitionsRequest.add_member(:effective_on, Shapes::ShapeRef.new(shape: ZonedDateTime, location_name: "EffectiveOn"))
     ListCostCategoryDefinitionsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextToken"))
     ListCostCategoryDefinitionsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: CostCategoryMaxResults, location_name: "MaxResults", metadata: {"box" => true}))
+    ListCostCategoryDefinitionsRequest.add_member(:supported_resource_types, Shapes::ShapeRef.new(shape: ResourceTypesFilterInput, location_name: "SupportedResourceTypes"))
     ListCostCategoryDefinitionsRequest.struct_class = Types::ListCostCategoryDefinitionsRequest
 
     ListCostCategoryDefinitionsResponse.add_member(:cost_category_references, Shapes::ShapeRef.new(shape: CostCategoryReferencesList, location_name: "CostCategoryReferences"))
     ListCostCategoryDefinitionsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextToken"))
     ListCostCategoryDefinitionsResponse.struct_class = Types::ListCostCategoryDefinitionsResponse
 
+    ListCostCategoryResourceAssociationsRequest.add_member(:cost_category_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "CostCategoryArn"))
+    ListCostCategoryResourceAssociationsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextToken"))
+    ListCostCategoryResourceAssociationsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: CostCategoryMaxResults, location_name: "MaxResults", metadata: {"box" => true}))
+    ListCostCategoryResourceAssociationsRequest.struct_class = Types::ListCostCategoryResourceAssociationsRequest
+
+    ListCostCategoryResourceAssociationsResponse.add_member(:cost_category_resource_associations, Shapes::ShapeRef.new(shape: CostCategoryResourceAssociations, location_name: "CostCategoryResourceAssociations"))
+    ListCostCategoryResourceAssociationsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextToken"))
+    ListCostCategoryResourceAssociationsResponse.struct_class = Types::ListCostCategoryResourceAssociationsResponse
+
     ListSavingsPlansPurchaseRecommendationGenerationRequest.add_member(:generation_status, Shapes::ShapeRef.new(shape: GenerationStatus, location_name: "GenerationStatus"))
     ListSavingsPlansPurchaseRecommendationGenerationRequest.add_member(:recommendation_ids, Shapes::ShapeRef.new(shape: RecommendationIdList, location_name: "RecommendationIds"))
     ListSavingsPlansPurchaseRecommendationGenerationRequest.add_member(:page_size, Shapes::ShapeRef.new(shape: NonNegativeInteger, location_name: "PageSize"))
@@ -1405,6 +1431,10 @@ module Aws::CostExplorer
 
     ResourceTagList.member = Shapes::ShapeRef.new(shape: ResourceTag)
 
+    ResourceTypes.member = Shapes::ShapeRef.new(shape: ResourceType)
+
+    ResourceTypesFilterInput.member = Shapes::ShapeRef.new(shape: ResourceType)
+
     ResourceUtilization.add_member(:ec2_resource_utilization, Shapes::ShapeRef.new(shape: EC2ResourceUtilization, location_name: "EC2ResourceUtilization"))
     ResourceUtilization.struct_class = Types::ResourceUtilization
 
@@ -2219,6 +2249,22 @@ module Aws::CostExplorer
         )
       end)
 
+      api.add_operation(:list_cost_category_resource_associations, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListCostCategoryResourceAssociations"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListCostCategoryResourceAssociationsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListCostCategoryResourceAssociationsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:list_savings_plans_purchase_recommendation_generation, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListSavingsPlansPurchaseRecommendationGeneration"
         o.http_method = "POST"

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

@@ -716,34 +716,34 @@ module Aws::CostExplorer
     # the set of rules for the `CostCategory` object.
     #
     # @!attribute [rw] cost_category_arn
-    #   The unique identifier for your Cost Category.
+    #   The unique identifier for your cost category.
     #   @return [String]
     #
     # @!attribute [rw] effective_start
-    #   The effective start date of your Cost Category.
+    #   The effective start date of your cost category.
     #   @return [String]
     #
     # @!attribute [rw] effective_end
-    #   The effective end date of your Cost Category.
+    #   The effective end date of your cost category.
     #   @return [String]
     #
     # @!attribute [rw] name
-    #   The unique name of the Cost Category.
+    #   The unique name of the cost category.
     #   @return [String]
     #
     # @!attribute [rw] rule_version
-    #   The rule schema version in this particular Cost Category.
+    #   The rule schema version in this particular cost category.
     #   @return [String]
     #
     # @!attribute [rw] rules
     #   The rules are processed in order. If there are multiple rules that
     #   match the line item, then the first rule to match is used to
-    #   determine that Cost Category value.
+    #   determine that cost category value.
     #   @return [Array<Types::CostCategoryRule>]
     #
     # @!attribute [rw] split_charge_rules
     #   The split charge rules that are used to allocate your charges
-    #   between your Cost Category values.
+    #   between your cost category values.
     #   @return [Array<Types::CostCategorySplitChargeRule>]
     #
     # @!attribute [rw] processing_status
@@ -821,31 +821,31 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # A reference to a Cost Category containing only enough information to
+    # A reference to a cost category containing only enough information to
     # identify the Cost Category.
     #
-    # You can use this information to retrieve the full Cost Category
+    # You can use this information to retrieve the full cost category
     # information using `DescribeCostCategory`.
     #
     # @!attribute [rw] cost_category_arn
-    #   The unique identifier for your Cost Category.
+    #   The unique identifier for your cost category.
     #   @return [String]
     #
     # @!attribute [rw] name
-    #   The unique name of the Cost Category.
+    #   The unique name of the cost category.
     #   @return [String]
     #
     # @!attribute [rw] effective_start
-    #   The Cost Category's effective start date.
+    #   The cost category's effective start date.
     #   @return [String]
     #
     # @!attribute [rw] effective_end
-    #   The Cost Category's effective end date.
+    #   The cost category's effective end date.
     #   @return [String]
     #
     # @!attribute [rw] number_of_rules
-    #   The number of rules that are associated with a specific Cost
-    #   Category.
+    #   The number of rules that are associated with a specific cost
+    #   category.
     #   @return [Integer]
     #
     # @!attribute [rw] processing_status
@@ -861,6 +861,10 @@ module Aws::CostExplorer
     #   The default value for the cost category.
     #   @return [String]
     #
+    # @!attribute [rw] supported_resource_types
+    #   The resource types supported by a specific cost category.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CostCategoryReference AWS API Documentation
     #
     class CostCategoryReference < Struct.new(
@@ -871,14 +875,40 @@ module Aws::CostExplorer
       :number_of_rules,
       :processing_status,
       :values,
-      :default_value)
+      :default_value,
+      :supported_resource_types)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # A reference to a cost category association that contains information
+    # on an associated resource.
+    #
+    # @!attribute [rw] resource_arn
+    #   The unique identifier for an associated resource.
+    #   @return [String]
+    #
+    # @!attribute [rw] cost_category_name
+    #   The unique name of the cost category.
+    #   @return [String]
+    #
+    # @!attribute [rw] cost_category_arn
+    #   The unique identifier for your cost category.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CostCategoryResourceAssociation AWS API Documentation
+    #
+    class CostCategoryResourceAssociation < Struct.new(
+      :resource_arn,
+      :cost_category_name,
+      :cost_category_arn)
       SENSITIVE = []
       include Aws::Structure
     end
 
     # Rules are processed in order. If there are multiple rules that match
     # the line item, then the first rule to match is used to determine that
-    # Cost Category value.
+    # cost category value.
     #
     # @!attribute [rw] value
     #   The default value for the cost category.
@@ -891,7 +921,7 @@ module Aws::CostExplorer
     #   `RECORD_TYPE`, `LINKED_ACCOUNT_NAME`, `REGION`, and `USAGE_TYPE`.
     #
     #   `RECORD_TYPE` is a dimension used for Cost Explorer APIs, and is
-    #   also supported for Cost Category expressions. This dimension uses
+    #   also supported for cost category expressions. This dimension uses
     #   different terms, depending on whether you're using the console or
     #   API/JSON editor. For a detailed comparison, see [Term
     #   Comparisons][2] in the *Billing and Cost Management User Guide*.
@@ -930,18 +960,18 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
-    # Use the split charge rule to split the cost of one Cost Category value
+    # Use the split charge rule to split the cost of one cost category value
     # across several other target values.
     #
     # @!attribute [rw] source
-    #   The Cost Category value that you want to split. That value can't be
+    #   The cost category value that you want to split. That value can't be
     #   used as a source or a target in other split charge rules. To
     #   indicate uncategorized costs, you can use an empty string as the
     #   source.
     #   @return [String]
     #
     # @!attribute [rw] targets
-    #   The Cost Category values that you want to split costs across. These
+    #   The cost category values that you want to split costs across. These
     #   values can't be used as a source in other split charge rules.
     #   @return [Array<String>]
     #
@@ -1004,11 +1034,11 @@ module Aws::CostExplorer
     # it filters on resources without the given Cost Categories key.
     #
     # @!attribute [rw] key
-    #   The unique name of the Cost Category.
+    #   The unique name of the cost category.
     #   @return [String]
     #
     # @!attribute [rw] values
-    #   The specific value of the Cost Category.
+    #   The specific value of the cost category.
     #   @return [Array<String>]
     #
     # @!attribute [rw] match_options
@@ -1434,22 +1464,22 @@ module Aws::CostExplorer
     end
 
     # @!attribute [rw] name
-    #   The unique name of the Cost Category.
+    #   The unique name of the cost category.
     #   @return [String]
     #
     # @!attribute [rw] effective_start
-    #   The Cost Category's effective start date. It can only be a billing
+    #   The cost category's effective start date. It can only be a billing
     #   start date (first day of the month). If the date isn't provided,
     #   it's the first day of the current month. Dates can't be before the
     #   previous twelve months, or in the future.
     #   @return [String]
     #
     # @!attribute [rw] rule_version
-    #   The rule schema version in this particular Cost Category.
+    #   The rule schema version in this particular cost category.
     #   @return [String]
     #
     # @!attribute [rw] rules
-    #   The Cost Category rules used to categorize costs. For more
+    #   The cost category rules used to categorize costs. For more
     #   information, see [CostCategoryRule][1].
     #
     #
@@ -1463,7 +1493,7 @@ module Aws::CostExplorer
     #
     # @!attribute [rw] split_charge_rules
     #   The split charge rules used to allocate your charges between your
-    #   Cost Category values.
+    #   cost category values.
     #   @return [Array<Types::CostCategorySplitChargeRule>]
     #
     # @!attribute [rw] resource_tags
@@ -1513,11 +1543,11 @@ module Aws::CostExplorer
     end
 
     # @!attribute [rw] cost_category_arn
-    #   The unique identifier for your newly created Cost Category.
+    #   The unique identifier for your newly created cost category.
     #   @return [String]
     #
     # @!attribute [rw] effective_start
-    #   The Cost Category's effective start date. It can only be a billing
+    #   The cost category's effective start date. It can only be a billing
     #   start date (first day of the month).
     #   @return [String]
     #
@@ -1676,7 +1706,7 @@ module Aws::CostExplorer
     class DeleteAnomalySubscriptionResponse < Aws::EmptyStructure; end
 
     # @!attribute [rw] cost_category_arn
-    #   The unique identifier for your Cost Category.
+    #   The unique identifier for your cost category.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/DeleteCostCategoryDefinitionRequest AWS API Documentation
@@ -1688,13 +1718,13 @@ module Aws::CostExplorer
     end
 
     # @!attribute [rw] cost_category_arn
-    #   The unique identifier for your Cost Category.
+    #   The unique identifier for your cost category.
     #   @return [String]
     #
     # @!attribute [rw] effective_end
-    #   The effective end date of the Cost Category as a result of deleting
-    #   it. No costs after this date is categorized by the deleted Cost
-    #   Category.
+    #   The effective end date of the cost category as a result of deleting
+    #   it. No costs after this date is categorized by the deleted cost
+    #   category.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/DeleteCostCategoryDefinitionResponse AWS API Documentation
@@ -1707,11 +1737,11 @@ module Aws::CostExplorer
     end
 
     # @!attribute [rw] cost_category_arn
-    #   The unique identifier for your Cost Category.
+    #   The unique identifier for your cost category.
     #   @return [String]
     #
     # @!attribute [rw] effective_on
-    #   The date when the Cost Category was effective.
+    #   The date when the cost category was effective.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/DescribeCostCategoryDefinitionRequest AWS API Documentation
@@ -1768,8 +1798,8 @@ module Aws::CostExplorer
     # @!attribute [rw] match_options
     #   The match options that you can use to filter your results.
     #
-    #   `MatchOptions` is only applicable for actions related to Cost
-    #   Category and Anomaly Subscriptions. Refer to the documentation for
+    #   `MatchOptions` is only applicable for actions related to cost
+    #   category and Anomaly Subscriptions. Refer to the documentation for
     #   each specific API to see what is supported.
     #
     #   The default values for `MatchOptions` are `EQUALS` and
@@ -2940,6 +2970,11 @@ module Aws::CostExplorer
     #   service. You can nest `Expression` objects to define any combination
     #   of dimension filters. For more information, see [Expression][1].
     #
+    #   The `GetCostAndUsageWithResources` operation requires that you
+    #   either group by or filter by a `ResourceId`. It requires the
+    #   [Expression][1] `"SERVICE = Amazon Elastic Compute Cloud - Compute"`
+    #   in the filter.
+    #
     #   Valid values for `MatchOptions` for `Dimensions` are `EQUALS` and
     #   `CASE_SENSITIVE`.
     #
@@ -3048,9 +3083,9 @@ module Aws::CostExplorer
     #   The value that you want to search the filter values for.
     #
     #   If you don't specify a `CostCategoryName`, `SearchString` is used
-    #   to filter Cost Category names that match the `SearchString` pattern.
+    #   to filter cost category names that match the `SearchString` pattern.
     #   If you specify a `CostCategoryName`, `SearchString` is used to
-    #   filter Cost Category values that match the `SearchString` pattern.
+    #   filter cost category values that match the `SearchString` pattern.
     #   @return [String]
     #
     # @!attribute [rw] time_period
@@ -3058,7 +3093,7 @@ module Aws::CostExplorer
     #   @return [Types::DateInterval]
     #
     # @!attribute [rw] cost_category_name
-    #   The unique name of the Cost Category.
+    #   The unique name of the cost category.
     #   @return [String]
     #
     # @!attribute [rw] filter
@@ -3230,11 +3265,11 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] cost_category_names
-    #   The names of the Cost Categories.
+    #   The names of the cost categories.
     #   @return [Array<String>]
     #
     # @!attribute [rw] cost_category_values
-    #   The Cost Category values.
+    #   The cost category values.
     #
     #   If the `CostCategoryName` key isn't specified in the request, the
     #   `CostCategoryValues` fields aren't returned.
@@ -5790,7 +5825,7 @@ module Aws::CostExplorer
     end
 
     # @!attribute [rw] effective_on
-    #   The date when the Cost Category was effective.
+    #   The date when the cost category was effective.
     #   @return [String]
     #
     # @!attribute [rw] next_token
@@ -5803,18 +5838,27 @@ module Aws::CostExplorer
     #   The number of entries a paginated response contains.
     #   @return [Integer]
     #
+    # @!attribute [rw] supported_resource_types
+    #   Filter cost category definitions that are supported by given
+    #   resource types based on the latest version. If the filter is
+    #   present, the result only includes Cost Categories that supports
+    #   input resource type. If the filter isn't provided, no filtering is
+    #   applied. The valid values are `billing:rispgroupsharing`.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostCategoryDefinitionsRequest AWS API Documentation
     #
     class ListCostCategoryDefinitionsRequest < Struct.new(
       :effective_on,
       :next_token,
-      :max_results)
+      :max_results,
+      :supported_resource_types)
       SENSITIVE = []
       include Aws::Structure
     end
 
     # @!attribute [rw] cost_category_references
-    #   A reference to a Cost Category that contains enough information to
+    #   A reference to a cost category that contains enough information to
     #   identify the Cost Category.
     #   @return [Array<Types::CostCategoryReference>]
     #
@@ -5833,6 +5877,50 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # @!attribute [rw] cost_category_arn
+    #   The unique identifier for your cost category.
+    #   @return [String]
+    #
+    # @!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 number of entries a paginated response contains.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostCategoryResourceAssociationsRequest AWS API Documentation
+    #
+    class ListCostCategoryResourceAssociationsRequest < Struct.new(
+      :cost_category_arn,
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] cost_category_resource_associations
+    #   A reference to a cost category association that contains information
+    #   on an associated resource.
+    #   @return [Array<Types::CostCategoryResourceAssociation>]
+    #
+    # @!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/ListCostCategoryResourceAssociationsResponse AWS API Documentation
+    #
+    class ListCostCategoryResourceAssociationsResponse < Struct.new(
+      :cost_category_resource_associations,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] generation_status
     #   The status of the recommendation generation.
     #   @return [String]
@@ -8089,8 +8177,8 @@ module Aws::CostExplorer
     #
     # @!attribute [rw] match_options
     #   The match options that you can use to filter your results.
-    #   `MatchOptions` is only applicable for actions related to Cost
-    #   Category. The default values for `MatchOptions` are `EQUALS` and
+    #   `MatchOptions` is only applicable for actions related to cost
+    #   category. The default values for `MatchOptions` are `EQUALS` and
     #   `CASE_SENSITIVE`.
     #   @return [Array<String>]
     #
@@ -8474,18 +8562,18 @@ module Aws::CostExplorer
     end
 
     # @!attribute [rw] cost_category_arn
-    #   The unique identifier for your Cost Category.
+    #   The unique identifier for your cost category.
     #   @return [String]
     #
     # @!attribute [rw] effective_start
-    #   The Cost Category's effective start date. It can only be a billing
+    #   The cost category's effective start date. It can only be a billing
     #   start date (first day of the month). If the date isn't provided,
     #   it's the first day of the current month. Dates can't be before the
     #   previous twelve months, or in the future.
     #   @return [String]
     #
     # @!attribute [rw] rule_version
-    #   The rule schema version in this particular Cost Category.
+    #   The rule schema version in this particular cost category.
     #   @return [String]
     #
     # @!attribute [rw] rules
@@ -8503,7 +8591,7 @@ module Aws::CostExplorer
     #
     # @!attribute [rw] split_charge_rules
     #   The split charge rules used to allocate your charges between your
-    #   Cost Category values.
+    #   cost category values.
     #   @return [Array<Types::CostCategorySplitChargeRule>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateCostCategoryDefinitionRequest AWS API Documentation
@@ -8520,11 +8608,11 @@ module Aws::CostExplorer
     end
 
     # @!attribute [rw] cost_category_arn
-    #   The unique identifier for your Cost Category.
+    #   The unique identifier for your cost category.
     #   @return [String]
     #
     # @!attribute [rw] effective_start
-    #   The Cost Category's effective start date. It can only be a billing
+    #   The cost category's effective start date. It can only be a billing
     #   start date (first day of the month).
     #   @return [String]
     #

data/lib/aws-sdk-costexplorer.rb

@@ -54,7 +54,7 @@ module Aws::CostExplorer
   autoload :EndpointProvider, 'aws-sdk-costexplorer/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-costexplorer/endpoints'
 
-  GEM_VERSION = '1.141.0'
+  GEM_VERSION = '1.142.0'
 
 end
 

data/sig/client.rbs

@@ -1256,10 +1256,24 @@ module Aws
       def list_cost_category_definitions: (
                                             ?effective_on: ::String,
                                             ?next_token: ::String,
-                                            ?max_results: ::Integer
+                                            ?max_results: ::Integer,
+                                            ?supported_resource_types: Array[::String]
                                           ) -> _ListCostCategoryDefinitionsResponseSuccess
                                         | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListCostCategoryDefinitionsResponseSuccess
 
+      interface _ListCostCategoryResourceAssociationsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::ListCostCategoryResourceAssociationsResponse]
+        def cost_category_resource_associations: () -> ::Array[Types::CostCategoryResourceAssociation]
+        def next_token: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CostExplorer/Client.html#list_cost_category_resource_associations-instance_method
+      def list_cost_category_resource_associations: (
+                                                      ?cost_category_arn: ::String,
+                                                      ?next_token: ::String,
+                                                      ?max_results: ::Integer
+                                                    ) -> _ListCostCategoryResourceAssociationsResponseSuccess
+                                                  | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListCostCategoryResourceAssociationsResponseSuccess
+
       interface _ListSavingsPlansPurchaseRecommendationGenerationResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::ListSavingsPlansPurchaseRecommendationGenerationResponse]
         def generation_summary_list: () -> ::Array[Types::GenerationSummary]

data/sig/types.rbs

@@ -171,6 +171,14 @@ module Aws::CostExplorer
       attr_accessor processing_status: ::Array[Types::CostCategoryProcessingStatus]
       attr_accessor values: ::Array[::String]
       attr_accessor default_value: ::String
+      attr_accessor supported_resource_types: ::Array[::String]
+      SENSITIVE: []
+    end
+
+    class CostCategoryResourceAssociation
+      attr_accessor resource_arn: ::String
+      attr_accessor cost_category_name: ::String
+      attr_accessor cost_category_arn: ::String
       SENSITIVE: []
     end
 
@@ -966,6 +974,7 @@ module Aws::CostExplorer
       attr_accessor effective_on: ::String
       attr_accessor next_token: ::String
       attr_accessor max_results: ::Integer
+      attr_accessor supported_resource_types: ::Array[::String]
       SENSITIVE: []
     end
 
@@ -975,6 +984,19 @@ module Aws::CostExplorer
       SENSITIVE: []
     end
 
+    class ListCostCategoryResourceAssociationsRequest
+      attr_accessor cost_category_arn: ::String
+      attr_accessor next_token: ::String
+      attr_accessor max_results: ::Integer
+      SENSITIVE: []
+    end
+
+    class ListCostCategoryResourceAssociationsResponse
+      attr_accessor cost_category_resource_associations: ::Array[Types::CostCategoryResourceAssociation]
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
     class ListSavingsPlansPurchaseRecommendationGenerationRequest
       attr_accessor generation_status: ("SUCCEEDED" | "PROCESSING" | "FAILED")
       attr_accessor recommendation_ids: ::Array[::String]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-costexplorer
 version: !ruby/object:Gem::Version
-  version: 1.141.0
+  version: 1.142.0
 platform: ruby
 authors:
 - Amazon Web Services