Cloudwatch PutMetricData API wrongly states the format of Timestamp

[nikith1997]

Describe the issue

As per the documentation:
Timestamp: The time the metric data was received, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.
Error when supplying milliseconds:

Invalid type for parameter MetricData[3].Timestamp, value: 1710802853708, type: <class 'int'>, valid types: <class 'datetime.datetime'>, timestamp-string

Please fix the documentation.

Links

https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/cloudwatch/client/put_metric_data.html

[RyanFitzSimmonsAK]

Hi @nikith1997, thanks for reaching out. Updating this documentation is a request we've had in the past (aws/aws-sdk#54), but it's a bit tricky because that docstring is shared across all SDKs. The operation isn't expecting an integer (Timestamp (datetime)), but is instead expecting you to use the datetime module in the case of Boto3. Other SDKs use different libraries to accomplish the same thing. Updating the docstring to reflect the specificities of one SDK would make the documentation confusing for the others. Do you have a suggestion on how the documentation could be improved with that in mind?