feat(client-marketplace-entitlement-service): This release enhances the GetEntitlements API to support new filter CUSTOMER_AWS_ACCOUNT_ID in request and CustomerAWSAccountId field in response.

Author: awstools

clients/client-marketplace-entitlement-service/src/commands/GetEntitlementsCommand.ts

@@ -33,7 +33,13 @@ export interface GetEntitlementsCommandOutput extends GetEntitlementsResult, __M
 
 /**
  * <p>GetEntitlements retrieves entitlement values for a given product. The results can be
- *       filtered based on customer identifier or product dimensions.</p>
+ *       filtered based on customer identifier, AWS account ID, or product dimensions.</p>
+ *          <important>
+ *             <p>
+ *        The <code>CustomerIdentifier</code> parameter is on path for deprecation. Use <code>CustomerAWSAccountID</code> instead.</p>
+ *             <p>These parameters are mutually exclusive. You can't specify both <code>CustomerIdentifier</code> and <code>CustomerAWSAccountID</code> in the same request.
+ *      </p>
+ *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -58,6 +64,7 @@ export interface GetEntitlementsCommandOutput extends GetEntitlementsResult, __M
  * //       ProductCode: "STRING_VALUE",
  * //       Dimension: "STRING_VALUE",
  * //       CustomerIdentifier: "STRING_VALUE",
+ * //       CustomerAWSAccountId: "STRING_VALUE",
  * //       Value: { // EntitlementValue
  * //         IntegerValue: Number("int"),
  * //         DoubleValue: Number("double"),

clients/client-marketplace-entitlement-service/src/models/models_0.ts

@@ -8,6 +8,7 @@ import { MarketplaceEntitlementServiceServiceException as __BaseException } from
  * @enum
  */
 export const GetEntitlementFilterName = {
+  CUSTOMER_AWS_ACCOUNT_ID: "CUSTOMER_AWS_ACCOUNT_ID",
   CUSTOMER_IDENTIFIER: "CUSTOMER_IDENTIFIER",
   DIMENSION: "DIMENSION",
 } as const;
@@ -35,6 +36,9 @@ export interface GetEntitlementsRequest {
    *       dimension. Filters are described as keys mapped to a lists of values. Filtered requests are
    *         <i>unioned</i> for each value in the value list, and then
    *         <i>intersected</i> for each filter key.</p>
+   *          <p>
+   *             <code>CustomerIdentifier</code> and <code>CustomerAWSAccountID</code> are mutually exclusive. You can't specify both in the same request.
+   *    </p>
    * @public
    */
   Filter?: Partial<Record<GetEntitlementFilterName, string[]>> | undefined;
@@ -119,6 +123,14 @@ export interface Entitlement {
    */
   CustomerIdentifier?: string | undefined;
 
+  /**
+   * <p>
+   *       The <code>CustomerAWSAccountID</code> parameter specifies the AWS account ID of the buyer.
+   *     </p>
+   * @public
+   */
+  CustomerAWSAccountId?: string | undefined;
+
   /**
    * <p>The EntitlementValue represents the amount of capacity that the customer is entitled to
    *    for the product.</p>

clients/client-marketplace-entitlement-service/src/protocols/Aws_json1_1.ts

@@ -153,6 +153,7 @@ const de_ThrottlingExceptionRes = async (parsedOutput: any, context: __SerdeCont
  */
 const de_Entitlement = (output: any, context: __SerdeContext): Entitlement => {
   return take(output, {
+    CustomerAWSAccountId: __expectString,
     CustomerIdentifier: __expectString,
     Dimension: __expectString,
     ExpirationDate: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),

codegen/sdk-codegen/aws-models/marketplace-entitlement-service.json

@@ -766,6 +766,12 @@
             "smithy.api#documentation": "<p>The customer identifier is a handle to each unique customer in an application. Customer\n   identifiers are obtained through the ResolveCustomer operation in AWS Marketplace Metering\n   Service.</p>"
           }
         },
+        "CustomerAWSAccountId": {
+          "target": "com.amazonaws.marketplaceentitlementservice#NonEmptyString",
+          "traits": {
+            "smithy.api#documentation": "<p>\n      The <code>CustomerAWSAccountID</code> parameter specifies the AWS account ID of the buyer.\n    </p>"
+          }
+        },
         "Value": {
           "target": "com.amazonaws.marketplaceentitlementservice#EntitlementValue",
           "traits": {
@@ -857,6 +863,12 @@
           "traits": {
             "smithy.api#enumValue": "DIMENSION"
           }
+        },
+        "CUSTOMER_AWS_ACCOUNT_ID": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "CUSTOMER_AWS_ACCOUNT_ID"
+          }
         }
       }
     },
@@ -889,7 +901,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>GetEntitlements retrieves entitlement values for a given product. The results can be\n      filtered based on customer identifier or product dimensions.</p>",
+        "smithy.api#documentation": "<p>GetEntitlements retrieves entitlement values for a given product. The results can be\n      filtered based on customer identifier, AWS account ID, or product dimensions.</p>\n         <important>\n            <p>\n       The <code>CustomerIdentifier</code> parameter is on path for deprecation. Use <code>CustomerAWSAccountID</code> instead.</p>\n            <p>These parameters are mutually exclusive. You can't specify both <code>CustomerIdentifier</code> and <code>CustomerAWSAccountID</code> in the same request.\n     </p>\n         </important>",
         "smithy.api#paginated": {
           "inputToken": "NextToken",
           "outputToken": "NextToken",
@@ -910,7 +922,7 @@
         "Filter": {
           "target": "com.amazonaws.marketplaceentitlementservice#GetEntitlementFilters",
           "traits": {
-            "smithy.api#documentation": "<p>Filter is used to return entitlements for a specific customer or for a specific\n      dimension. Filters are described as keys mapped to a lists of values. Filtered requests are\n        <i>unioned</i> for each value in the value list, and then\n        <i>intersected</i> for each filter key.</p>"
+            "smithy.api#documentation": "<p>Filter is used to return entitlements for a specific customer or for a specific\n      dimension. Filters are described as keys mapped to a lists of values. Filtered requests are\n        <i>unioned</i> for each value in the value list, and then\n        <i>intersected</i> for each filter key.</p>\n         <p>\n            <code>CustomerIdentifier</code> and <code>CustomerAWSAccountID</code> are mutually exclusive. You can't specify both in the same request.\n   </p>"
           }
         },
         "NextToken": {