AWS cli documentation change
Summary
Updated CLI version reference, expanded usage record submission rules, and added --client-token parameter for idempotency.
Security assessment
The --client-token addition improves operational reliability but does not directly address a security vulnerability. Usage record time constraints are operational, not security-related.
Diff
diff --git a/cli/latest/reference/meteringmarketplace/meter-usage.md b/cli/latest/reference/meteringmarketplace/meter-usage.md index f0bde08c8..7127d99f0 100644 --- a//cli/latest/reference/meteringmarketplace/meter-usage.md +++ b//cli/latest/reference/meteringmarketplace/meter-usage.md @@ -15 +15 @@ - * [AWS CLI 2.31.18 Command Reference](../../index.html) » + * [AWS CLI 2.31.19 Command Reference](../../index.html) » @@ -65 +65 @@ API to emit metering records. For identical requests, the API is idempotent and -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. +Submit usage records to report events from the previous hour. If you submit records that are greater than six hours after events occur, the records won’t be accepted. The timestamp in your request determines when an event is recorded. You can only report usage once per hour for each dimension. For AMI-based products, this is per dimension and per EC2 instance. For container products, this is per dimension and per ECS task or EKS pod. You can’t modify values after they’re recorded. If you report usage before the current hour ends, you will be unable to report additional usage until the next hour begins. @@ -80,0 +81 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/meteri + [--client-token <value>] @@ -240,0 +242,15 @@ JSON Syntax: +`--client-token` (string) + +> Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a [UUID type of value](https://wikipedia.org/wiki/Universally_unique_identifier) . +> +> If you don’t provide this value, then Amazon Web Services generates a random one for you. +> +> If you retry the operation with the same `ClientToken` , but with different parameters, the retry fails with an `IdempotencyConflictException` error. +> +> Constraints: +> +> * min: `1` +> * max: `64` +> + + @@ -354 +370 @@ MeteringRecordId -> (string) - * [AWS CLI 2.31.18 Command Reference](../../index.html) » + * [AWS CLI 2.31.19 Command Reference](../../index.html) »