feat(client-cost-explorer): Add support for Cost Category resource associations including filtering by resource type on ListCostCategoryDefinitions and new ListCostCategoryResourceAssociations API.

Author: awstools

clients/client-cost-explorer/README.md

@@ -489,6 +489,14 @@ ListCostCategoryDefinitions
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cost-explorer/command/ListCostCategoryDefinitionsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cost-explorer/Interface/ListCostCategoryDefinitionsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cost-explorer/Interface/ListCostCategoryDefinitionsCommandOutput/)
 
+</details>
+<details>
+<summary>
+ListCostCategoryResourceAssociations
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cost-explorer/command/ListCostCategoryResourceAssociationsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cost-explorer/Interface/ListCostCategoryResourceAssociationsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cost-explorer/Interface/ListCostCategoryResourceAssociationsCommandOutput/)
+
 </details>
 <details>
 <summary>

clients/client-cost-explorer/src/CostExplorer.ts

@@ -168,6 +168,11 @@ import {
   ListCostCategoryDefinitionsCommandInput,
   ListCostCategoryDefinitionsCommandOutput,
 } from "./commands/ListCostCategoryDefinitionsCommand";
+import {
+  ListCostCategoryResourceAssociationsCommand,
+  ListCostCategoryResourceAssociationsCommandInput,
+  ListCostCategoryResourceAssociationsCommandOutput,
+} from "./commands/ListCostCategoryResourceAssociationsCommand";
 import {
   ListSavingsPlansPurchaseRecommendationGenerationCommand,
   ListSavingsPlansPurchaseRecommendationGenerationCommandInput,
@@ -261,6 +266,7 @@ const commands = {
   ListCostAllocationTagBackfillHistoryCommand,
   ListCostAllocationTagsCommand,
   ListCostCategoryDefinitionsCommand,
+  ListCostCategoryResourceAssociationsCommand,
   ListSavingsPlansPurchaseRecommendationGenerationCommand,
   ListTagsForResourceCommand,
   ProvideAnomalyFeedbackCommand,
@@ -842,6 +848,24 @@ export interface CostExplorer {
     cb: (err: any, data?: ListCostCategoryDefinitionsCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link ListCostCategoryResourceAssociationsCommand}
+   */
+  listCostCategoryResourceAssociations(): Promise<ListCostCategoryResourceAssociationsCommandOutput>;
+  listCostCategoryResourceAssociations(
+    args: ListCostCategoryResourceAssociationsCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<ListCostCategoryResourceAssociationsCommandOutput>;
+  listCostCategoryResourceAssociations(
+    args: ListCostCategoryResourceAssociationsCommandInput,
+    cb: (err: any, data?: ListCostCategoryResourceAssociationsCommandOutput) => void
+  ): void;
+  listCostCategoryResourceAssociations(
+    args: ListCostCategoryResourceAssociationsCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ListCostCategoryResourceAssociationsCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link ListSavingsPlansPurchaseRecommendationGenerationCommand}
    */

clients/client-cost-explorer/src/CostExplorerClient.ts

@@ -178,6 +178,10 @@ import {
   ListCostCategoryDefinitionsCommandInput,
   ListCostCategoryDefinitionsCommandOutput,
 } from "./commands/ListCostCategoryDefinitionsCommand";
+import {
+  ListCostCategoryResourceAssociationsCommandInput,
+  ListCostCategoryResourceAssociationsCommandOutput,
+} from "./commands/ListCostCategoryResourceAssociationsCommand";
 import {
   ListSavingsPlansPurchaseRecommendationGenerationCommandInput,
   ListSavingsPlansPurchaseRecommendationGenerationCommandOutput,
@@ -269,6 +273,7 @@ export type ServiceInputTypes =
   | ListCostAllocationTagBackfillHistoryCommandInput
   | ListCostAllocationTagsCommandInput
   | ListCostCategoryDefinitionsCommandInput
+  | ListCostCategoryResourceAssociationsCommandInput
   | ListSavingsPlansPurchaseRecommendationGenerationCommandInput
   | ListTagsForResourceCommandInput
   | ProvideAnomalyFeedbackCommandInput
@@ -320,6 +325,7 @@ export type ServiceOutputTypes =
   | ListCostAllocationTagBackfillHistoryCommandOutput
   | ListCostAllocationTagsCommandOutput
   | ListCostCategoryDefinitionsCommandOutput
+  | ListCostCategoryResourceAssociationsCommandOutput
   | ListSavingsPlansPurchaseRecommendationGenerationCommandOutput
   | ListTagsForResourceCommandOutput
   | ProvideAnomalyFeedbackCommandOutput

clients/client-cost-explorer/src/commands/CreateCostCategoryDefinitionCommand.ts

@@ -29,7 +29,7 @@ export interface CreateCostCategoryDefinitionCommandOutput
     __MetadataBearer {}
 
 /**
- * <p>Creates a new Cost Category with the requested name and rules.</p>
+ * <p>Creates a new cost category with the requested name and rules.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-cost-explorer/src/commands/DeleteCostCategoryDefinitionCommand.ts

@@ -29,8 +29,8 @@ export interface DeleteCostCategoryDefinitionCommandOutput
     __MetadataBearer {}
 
 /**
- * <p>Deletes a Cost Category. Expenses from this month going forward will no longer be
- *       categorized with this Cost Category.</p>
+ * <p>Deletes a cost category. Expenses from this month going forward will no longer be
+ *       categorized with this cost category.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-cost-explorer/src/commands/DescribeCostCategoryDefinitionCommand.ts

@@ -30,10 +30,10 @@ export interface DescribeCostCategoryDefinitionCommandOutput
 
 /**
  * <p>Returns the name, Amazon Resource Name (ARN), rules, definition, and effective dates of a
- *       Cost Category that's defined in the account.</p>
- *          <p>You have the option to use <code>EffectiveOn</code> to return a Cost Category that's
+ *       cost category that's defined in the account.</p>
+ *          <p>You have the option to use <code>EffectiveOn</code> to return a cost category that's
  *       active on a specific date. If there's no <code>EffectiveOn</code> specified, you see a Cost
- *       Category that's effective on the current date. If Cost Category is still effective,
+ *       Category that's effective on the current date. If cost category is still effective,
  *         <code>EffectiveEnd</code> is omitted in the response. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

clients/client-cost-explorer/src/commands/GetCostCategoriesCommand.ts

@@ -27,9 +27,9 @@ export interface GetCostCategoriesCommandInput extends GetCostCategoriesRequest
 export interface GetCostCategoriesCommandOutput extends GetCostCategoriesResponse, __MetadataBearer {}
 
 /**
- * <p>Retrieves an array of Cost Category names and values incurred cost.</p>
+ * <p>Retrieves an array of cost category names and values incurred cost.</p>
  *          <note>
- *             <p>If some Cost Category names and values are not associated with any cost, they will not
+ *             <p>If some cost category names and values are not associated with any cost, they will not
  *         be returned by this API.</p>
  *          </note>
  * @example

clients/client-cost-explorer/src/commands/GetReservationCoverageCommand.ts

@@ -30,7 +30,7 @@ export interface GetReservationCoverageCommandOutput extends GetReservationCover
  * <p>Retrieves the reservation coverage for your account, which you can use to see how much
  *       of your Amazon Elastic Compute Cloud, Amazon 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,
+ *       see the coverage of the associated member accounts. This supports dimensions, cost categories,
  *       and nested expressions. For any time period, you can filter data about reservation usage by
  *       the following dimensions:</p>
  *          <ul>

clients/client-cost-explorer/src/commands/GetSavingsPlansCoverageCommand.ts

@@ -29,7 +29,7 @@ export interface GetSavingsPlansCoverageCommandOutput extends GetSavingsPlansCov
 /**
  * <p>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, and
+ *       coverage of the 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:</p>
  *          <ul>

clients/client-cost-explorer/src/commands/ListCostCategoryDefinitionsCommand.ts

@@ -30,10 +30,10 @@ export interface ListCostCategoryDefinitionsCommandOutput
 
 /**
  * <p>Returns the name, Amazon Resource Name (ARN), <code>NumberOfRules</code> and effective
- *       dates of all Cost Categories defined in the account. You have the option to use
- *         <code>EffectiveOn</code> to return a list of Cost Categories that were active on a specific
- *       date. If there is no <code>EffectiveOn</code> specified, you’ll see Cost Categories that are
- *       effective on the current date. If Cost Category is still effective, <code>EffectiveEnd</code>
+ *       dates of all cost categories defined in the account. You have the option to use
+ *       <code>EffectiveOn</code> and <code>SupportedResourceTypes</code> to return a list of cost categories that were active on a specific
+ *       date. If there is no <code>EffectiveOn</code> specified, you’ll see cost categories that are
+ *       effective on the current date. If cost category is still effective, <code>EffectiveEnd</code>
  *       is omitted in the response. <code>ListCostCategoryDefinitions</code> supports pagination. The
  *       request can have a <code>MaxResults</code> range up to 100.</p>
  * @example
@@ -48,6 +48,9 @@ export interface ListCostCategoryDefinitionsCommandOutput
  *   EffectiveOn: "STRING_VALUE",
  *   NextToken: "STRING_VALUE",
  *   MaxResults: Number("int"),
+ *   SupportedResourceTypes: [ // ResourceTypesFilterInput
+ *     "STRING_VALUE",
+ *   ],
  * };
  * const command = new ListCostCategoryDefinitionsCommand(input);
  * const response = await client.send(command);
@@ -69,6 +72,9 @@ export interface ListCostCategoryDefinitionsCommandOutput
  * //         "STRING_VALUE",
  * //       ],
  * //       DefaultValue: "STRING_VALUE",
+ * //       SupportedResourceTypes: [ // ResourceTypes
+ * //         "STRING_VALUE",
+ * //       ],
  * //     },
  * //   ],
  * //   NextToken: "STRING_VALUE",