strictEntityValidation
Whether to accept valid metric data when an invalid entity is sent.
When set to
true
: Any validation error (for entity or metric data) will fail the entire request, and no data will be ingested. The failed operation will return a 400 result with the error.When set to
false
: Validation errors in the entity will not associate the metric with the entity, but the metric data will still be accepted and ingested. Validation errors in the metric data will fail the entire request, and no data will be ingested.In the case of an invalid entity, the operation will return a200
status, but an additional response header will contain information about the validation errors. The new header,X-Amzn-Failure-Message
is an enumeration of the following values:InvalidEntity
- The provided entity is invalid.InvalidKeyAttributes
- The providedKeyAttributes
of an entity is invalid.InvalidAttributes
- The providedAttributes
of an entity is invalid.InvalidTypeValue
- The providedType
in theKeyAttributes
of an entity is invalid.EntitySizeTooLarge
- The number ofEntityMetricData
objects allowed is 2.MissingRequiredFields
- There are missing required fields in theKeyAttributes
for the providedType
. For details of the requirements for specifying an entity, see How to add related information to telemetry in the CloudWatch User Guide.
This parameter is required when EntityMetricData
is included.