@aws-sdk/client-marketplace-metering 3.1116.0 → 3.1118.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -41,7 +41,7 @@ Amazon Elastic Kubernetes Service (Amazon EKS) or Amazon Elastic Container Servi
41
41
  <li>
42
42
  <p>Submits the metering record for a set of customers.
43
43
  <code>BatchMeterUsage</code> API calls are captured by CloudTrail. You can use
44
- CloudTrail to verify that the software as a subscription (SaaS) metering records that
44
+ CloudTrail to verify that the software as a service (SaaS) metering records that
45
45
  you sent are accurate by searching for records with the <code>eventName</code>
46
46
  of <code>BatchMeterUsage</code>. You can also use CloudTrail to audit records over
47
47
  time. For more information, see the <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html">CloudTrail User
@@ -84,7 +84,7 @@ with the <code>CustomerAWSAccountId</code>, <code>ProductCode</code>, and <code>
84
84
  products</b>
85
85
  </p>
86
86
  <p>
87
- <i>RegisteredUsage</i>
87
+ <i>RegisterUsage</i>
88
88
  </p>
89
89
  <ul>
90
90
  <li>
package/dist-cjs/index.js CHANGED
@@ -69,7 +69,7 @@ const commonParams = {
69
69
  UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
70
70
  };
71
71
 
72
- var version = "3.1115.0";
72
+ var version = "3.1117.0";
73
73
  var packageInfo = {
74
74
  version: version};
75
75
 
@@ -66,7 +66,7 @@ export interface MarketplaceMetering {
66
66
  * <li>
67
67
  * <p>Submits the metering record for a set of customers.
68
68
  * <code>BatchMeterUsage</code> API calls are captured by CloudTrail. You can use
69
- * CloudTrail to verify that the software as a subscription (SaaS) metering records that
69
+ * CloudTrail to verify that the software as a service (SaaS) metering records that
70
70
  * you sent are accurate by searching for records with the <code>eventName</code>
71
71
  * of <code>BatchMeterUsage</code>. You can also use CloudTrail to audit records over
72
72
  * time. For more information, see the <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html">CloudTrail User
@@ -109,7 +109,7 @@ export interface MarketplaceMetering {
109
109
  * products</b>
110
110
  * </p>
111
111
  * <p>
112
- * <i>RegisteredUsage</i>
112
+ * <i>RegisterUsage</i>
113
113
  * </p>
114
114
  * <ul>
115
115
  * <li>
@@ -207,7 +207,7 @@ export interface MarketplaceMeteringClientResolvedConfig extends MarketplaceMete
207
207
  * <li>
208
208
  * <p>Submits the metering record for a set of customers.
209
209
  * <code>BatchMeterUsage</code> API calls are captured by CloudTrail. You can use
210
- * CloudTrail to verify that the software as a subscription (SaaS) metering records that
210
+ * CloudTrail to verify that the software as a service (SaaS) metering records that
211
211
  * you sent are accurate by searching for records with the <code>eventName</code>
212
212
  * of <code>BatchMeterUsage</code>. You can also use CloudTrail to audit records over
213
213
  * time. For more information, see the <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html">CloudTrail User
@@ -250,7 +250,7 @@ export interface MarketplaceMeteringClientResolvedConfig extends MarketplaceMete
250
250
  * products</b>
251
251
  * </p>
252
252
  * <p>
253
- * <i>RegisteredUsage</i>
253
+ * <i>RegisterUsage</i>
254
254
  * </p>
255
255
  * <ul>
256
256
  * <li>
@@ -25,7 +25,7 @@ declare const BatchMeterUsageCommand_base: {
25
25
  };
26
26
  /**
27
27
  * <important>
28
- * <p>Amazon Web Services Marketplace is introducing Concurrent Agreements, enabling buyers to make multiple purchases per Amazon Web Services account. Starting June 1, 2026, new SaaS products must use <code>CustomerAWSAccountId</code> (instead of <code>CustomerIdentifier</code>), <code>LicenseArn</code> (instead of <code>ProductCode</code>) to support this feature. <code>BatchMeterUsage</code> does not support <code>CustomerIdentifier</code> for new integrations. Existing integrations continue to work. Review the new integration for Concurrent Agreements <a href="https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements">here</a>.</p>
28
+ * <p>Amazon Web Services Marketplace is introducing Concurrent Agreements, enabling buyers to make multiple purchases per Amazon Web Services account. Starting June 1, 2026, new SaaS products must use <code>CustomerAWSAccountId</code> (instead of <code>CustomerIdentifier</code>), <code>LicenseArn</code> (instead of <code>ProductCode</code>) to support this feature. <code>BatchMeterUsage</code> does not support <code>CustomerIdentifier</code> for new integrations. Existing integrations continue to work. Review the new integration for Concurrent Agreements <a href="https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements">here</a>. For additional implementation details, see <a href="https://docs.aws.amazon.com/marketplace/latest/userguide/saas-code-examples.html#saas-batchmeterusage-licensearn-example">BatchMeterUsage code example with LicenseArn</a> in the <i>Amazon Web Services Marketplace Seller Guide</i>.</p>
29
29
  * </important>
30
30
  * <p>To post metering records for customers, SaaS applications call
31
31
  * <code>BatchMeterUsage</code>, which is used for metering SaaS flexible
@@ -39,7 +39,7 @@ declare const BatchMeterUsageCommand_base: {
39
39
  * event. At the end of each billing cycle, a 6-hour grace period applies. We accept
40
40
  * usage records for the previous billing month until 06:00 UTC on the first day of the
41
41
  * next month. For example, you must submit March usage records before 06:00 UTC on
42
- * April 1. After this grace period, we return a
42
+ * April 1. On April 1 at 05:00 UTC, you can still submit records for March 31 (within the 6-hour grace period). After 06:00 UTC on April 1, March records are rejected regardless of the normal 24-hour submission window. After this grace period, we return a
43
43
  * <code>TimestampOutOfBoundsException</code> error.</p>
44
44
  * <p>
45
45
  * <code>BatchMeterUsage</code> can process up to 25
@@ -34,7 +34,7 @@
34
34
  * <li>
35
35
  * <p>Submits the metering record for a set of customers.
36
36
  * <code>BatchMeterUsage</code> API calls are captured by CloudTrail. You can use
37
- * CloudTrail to verify that the software as a subscription (SaaS) metering records that
37
+ * CloudTrail to verify that the software as a service (SaaS) metering records that
38
38
  * you sent are accurate by searching for records with the <code>eventName</code>
39
39
  * of <code>BatchMeterUsage</code>. You can also use CloudTrail to audit records over
40
40
  * time. For more information, see the <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html">CloudTrail User
@@ -77,7 +77,7 @@
77
77
  * products</b>
78
78
  * </p>
79
79
  * <p>
80
- * <i>RegisteredUsage</i>
80
+ * <i>RegisterUsage</i>
81
81
  * </p>
82
82
  * <ul>
83
83
  * <li>
@@ -86,9 +86,9 @@ export interface UsageRecord {
86
86
  UsageAllocations?: UsageAllocation[] | undefined;
87
87
  /**
88
88
  * <p>The <code>CustomerAWSAccountId</code> parameter specifies the AWS account ID of the buyer.</p>
89
- * <note>
90
- * <p>For existing integrations, to access your <code>CustomerIdentifier</code> to <code>CustomerAWSAccountId</code> mapping, see <a href="https://docs.aws.amazon.com/marketplace/latest/userguide/data-feed-account.html">Account Feeds</a>.</p>
91
- * </note>
89
+ * <important>
90
+ * <p>If you have an existing integration and need the <code>CustomerAWSAccountId</code> that corresponds to a <code>CustomerIdentifier</code>, contact <a href="https://aws.amazon.com/marketplace/management/contact-us/">AWS Marketplace Seller Operations</a> to obtain the mapping. Do not request the <code>CustomerAWSAccountId</code> directly from buyers. We cannot verify that a buyer-provided account ID is authentic, which can result in incorrect metering or billing.</p>
91
+ * </important>
92
92
  * @public
93
93
  */
94
94
  CustomerAWSAccountId?: string | undefined;
@@ -116,6 +116,11 @@ export interface BatchMeterUsageRequest {
116
116
  /**
117
117
  * <p>Product code is used to uniquely identify a product in Amazon Web Services Marketplace. The product code should
118
118
  * be the same as the one used during the publishing of a new product.</p>
119
+ * <important>
120
+ * <p>
121
+ * <code>ProductCode</code> is required only for legacy integrations that use <code>CustomerIdentifier</code>. For new integrations using <code>LicenseArn</code> (Concurrent Agreements), do NOT include <code>ProductCode</code> at the request level. The <code>LicenseArn</code> in each <code>UsageRecord</code> identifies both the product and the specific agreement.</p>
122
+ * <p>Sending metering records with both <code>ProductCode</code> and <code>LicenseArn</code> for the same customer within the same hour will result in duplicate billing. If you are migrating from product-based metering to license-based metering, stop sending <code>ProductCode</code> before you start sending <code>LicenseArn</code>.</p>
123
+ * </important>
119
124
  * @public
120
125
  */
121
126
  ProductCode?: string | undefined;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-marketplace-metering",
3
- "version": "3.1116.0",
3
+ "version": "3.1118.0",
4
4
  "description": "AWS SDK for JavaScript Marketplace Metering Client for Node.js, Browser and React Native",
5
5
  "homepage": "https://github.com/aws/aws-sdk-js-v3/tree/main/clients/client-marketplace-metering",
6
6
  "license": "Apache-2.0",