UsageRecord
A UsageRecord indicates a quantity of usage for a given product,
customer, dimension and time.
Multiple requests with the same UsageRecords as input will be
de-duplicated to prevent double charges.
Contents
Note
In the following list, the required parameters are described first.
- Dimension
-
During the process of registering a product on AWS Marketplace, dimensions are specified. These represent different units of value in your application.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
[\s\S]+Required: Yes
- Timestamp
-
Timestamp, in UTC, for which the usage is being reported.
Your application can meter usage for up to six hours in the past. Make sure the
timestampvalue is not before the start of the software usage.Type: Timestamp
Required: Yes
- CustomerAWSAccountId
-
The
CustomerAWSAccountIDparameter specifies the AWS account ID of the buyer.Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
^[0-9]+$Required: No
- CustomerIdentifier
-
The
CustomerIdentifieris obtained through theResolveCustomeroperation and represents an individual buyer in your application.Type: String
Length Constraints: Minimum length of 0. Maximum length of 255.
Pattern:
[\s\S]*Required: No
- Quantity
-
The quantity of usage consumed by the customer for the given dimension and time. Defaults to
0if not specified.Type: Integer
Valid Range: Minimum value of 0. Maximum value of 2147483647.
Required: No
- UsageAllocations
-
The set of
UsageAllocationsto submit. The sum of allUsageAllocationquantities must equal the Quantity of theUsageRecord.Type: Array of UsageAllocation objects
Array Members: Minimum number of 1 item. Maximum number of 2500 items.
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: