Skip to content

Commit 980d541

Browse files
author
awstools
committed
docs(client-marketplace-metering): The usage reporting window for the BatchMeterUsage API has been extended from 6 hours to 24 hours. Sellers can now submit usage records for up to 24 hours after a metered event occurs.
1 parent 8927c3a commit 980d541

3 files changed

Lines changed: 4 additions & 4 deletions

File tree

clients/client-marketplace-metering/src/commands/BatchMeterUsageCommand.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ export interface BatchMeterUsageCommandOutput extends BatchMeterUsageResult, __M
3434
* want to meter usage for multiple products, you must make multiple
3535
* <code>BatchMeterUsage</code> calls.</p>
3636
* <p>Usage records should be submitted in quick succession following a
37-
* recorded event. Usage records aren't accepted 6 hours or more after an
37+
* recorded event. Usage records aren't accepted 24 hours or more after an
3838
* event.</p>
3939
* <p>
4040
* <code>BatchMeterUsage</code> can process up to 25

clients/client-marketplace-metering/src/models/models_0.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ export interface UsageAllocation {
5353
export interface UsageRecord {
5454
/**
5555
* <p>Timestamp, in UTC, for which the usage is being reported.</p>
56-
* <p>Your application can meter usage for up to six hours in the past. Make sure the
56+
* <p>Your application can meter usage for up to 24 hours in the past. Make sure the
5757
* <code>timestamp</code> value is not before the start of the software usage.</p>
5858
* @public
5959
*/

codegen/sdk-codegen/aws-models/marketplace-metering.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1225,7 +1225,7 @@
12251225
}
12261226
],
12271227
"traits": {
1228-
"smithy.api#documentation": "<important>\n <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. Existing integrations will 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>\n </important>\n <p>To post metering records for customers, SaaS applications call\n <code>BatchMeterUsage</code>, which is used for metering SaaS flexible\n consumption pricing (FCP). Identical requests are idempotent and can be\n retried with the same records or a subset of records. Each\n <code>BatchMeterUsage</code> request is for only one product. If you\n want to meter usage for multiple products, you must make multiple\n <code>BatchMeterUsage</code> calls.</p>\n <p>Usage records should be submitted in quick succession following a\n recorded event. Usage records aren't accepted 6 hours or more after an\n event.</p>\n <p>\n <code>BatchMeterUsage</code> can process up to 25\n <code>UsageRecords</code> at a time, and each request must be less than\n 1 MB in size. Optionally, you can have multiple usage allocations for\n usage data that's split into buckets according to predefined tags.</p>\n <p>\n <code>BatchMeterUsage</code> returns a list of\n <code>UsageRecordResult</code> objects, which have each\n <code>UsageRecord</code>. It also returns a list of\n <code>UnprocessedRecords</code>, which indicate errors on the service\n side that should be retried.</p>\n <p>For Amazon Web Services Regions that support <code>BatchMeterUsage</code>, see <a href=\"https://docs.aws.amazon.com/marketplace/latest/APIReference/metering-regions.html#batchmeterusage-region-support\">BatchMeterUsage Region support</a>.\n </p>\n <note>\n <p>For an example of <code>BatchMeterUsage</code>, see <a href=\"https://docs.aws.amazon.com/marketplace/latest/userguide/saas-code-examples.html#saas-batchmeterusage-example\"> BatchMeterUsage code example</a> in the <i>Amazon Web Services Marketplace Seller\n Guide</i>.</p>\n </note>"
1228+
"smithy.api#documentation": "<important>\n <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. Existing integrations will 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>\n </important>\n <p>To post metering records for customers, SaaS applications call\n <code>BatchMeterUsage</code>, which is used for metering SaaS flexible\n consumption pricing (FCP). Identical requests are idempotent and can be\n retried with the same records or a subset of records. Each\n <code>BatchMeterUsage</code> request is for only one product. If you\n want to meter usage for multiple products, you must make multiple\n <code>BatchMeterUsage</code> calls.</p>\n <p>Usage records should be submitted in quick succession following a\n recorded event. Usage records aren't accepted 24 hours or more after an\n event.</p>\n <p>\n <code>BatchMeterUsage</code> can process up to 25\n <code>UsageRecords</code> at a time, and each request must be less than\n 1 MB in size. Optionally, you can have multiple usage allocations for\n usage data that's split into buckets according to predefined tags.</p>\n <p>\n <code>BatchMeterUsage</code> returns a list of\n <code>UsageRecordResult</code> objects, which have each\n <code>UsageRecord</code>. It also returns a list of\n <code>UnprocessedRecords</code>, which indicate errors on the service\n side that should be retried.</p>\n <p>For Amazon Web Services Regions that support <code>BatchMeterUsage</code>, see <a href=\"https://docs.aws.amazon.com/marketplace/latest/APIReference/metering-regions.html#batchmeterusage-region-support\">BatchMeterUsage Region support</a>.\n </p>\n <note>\n <p>For an example of <code>BatchMeterUsage</code>, see <a href=\"https://docs.aws.amazon.com/marketplace/latest/userguide/saas-code-examples.html#saas-batchmeterusage-example\"> BatchMeterUsage code example</a> in the <i>Amazon Web Services Marketplace Seller\n Guide</i>.</p>\n </note>"
12291229
}
12301230
},
12311231
"com.amazonaws.marketplacemetering#BatchMeterUsageRequest": {
@@ -1963,7 +1963,7 @@
19631963
"Timestamp": {
19641964
"target": "com.amazonaws.marketplacemetering#Timestamp",
19651965
"traits": {
1966-
"smithy.api#documentation": "<p>Timestamp, in UTC, for which the usage is being reported.</p>\n <p>Your application can meter usage for up to six hours in the past. Make sure the\n <code>timestamp</code> value is not before the start of the software usage.</p>",
1966+
"smithy.api#documentation": "<p>Timestamp, in UTC, for which the usage is being reported.</p>\n <p>Your application can meter usage for up to 24 hours in the past. Make sure the\n <code>timestamp</code> value is not before the start of the software usage.</p>",
19671967
"smithy.api#required": {}
19681968
}
19691969
},

0 commit comments

Comments
 (0)