Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1444832.6 KB

API to emit metering records. For identical requests, the API is idempotent. It simply returns the metering record ID.

MeterUsage is authenticated on the buyer's AWS account using credentials from the EC2 instance, ECS task, or EKS pod.

MeterUsage can optionally include multiple usage allocations, to provide customers with usage data split into buckets by tags that you define (or allow the customer to define).

Usage records are expected to be submitted as quickly as possible after the event that is being recorded, and are not accepted more than 6 hours after the event.

post/#X-Amz-Target=AWSMPMeteringService.MeterUsage

Headers

X-Amz-Target'AWSMPMeteringService.MeterUsage' required

Request body

ProductCodestring required

Product code is used to uniquely identify a product in AWS Marketplace. The product code should be the same as the one used during the publishing of a new product.

Timestampstring date-time required

Timestamp, in UTC, for which the usage is being reported. Your application can meter usage for up to one hour in the past. Make sure the <code>timestamp</code> value is not before the start of the software usage.

UsageDimensionstring required

It will be one of the fcp dimension name provided during the publishing of the product.

UsageQuantityinteger

Consumption value for the hour. Defaults to <code>0</code> if not specified.

DryRunboolean

Checks whether you have the permissions required for the action, but does not make the request. If you have the permissions, the request returns <code>DryRunOperation</code>; otherwise, it returns <code>UnauthorizedException</code>. Defaults to <code>false</code> if not specified.

Response

Success

MeteringRecordIdstring

Metering record id.