I have contacted AWS Support to help resolve an issue with Amazon Simple Storage Service (Amazon S3). I want to provide information to help them troubleshoot the issue.
Short description
Amazon S3 generates a pair of request IDs for each request that it processes. When you contact AWS Support for help troubleshooting Amazon S3, you must provide the values of the S3 request ID pair associated with failed actions. This information helps AWS Support identify and troubleshoot your issue as quickly as possible.
Resolution
Amazon S3 request ID pairs are accessible from HTTP headers and verbose logs by using several methods. This includes using AWS CloudTrail to log S3 API calls. For more information about how to retrieve Amazon S3 request ID pairs, see Getting Amazon S3 request IDs for AWS Support. The names used to describe each half of an S3 request ID pair can vary, depending on how the S3 request ID pairs are retrieved. This table lists three commonly used methods for retrieving S3 request ID pairs and the corresponding names used for each half:
Access method | First name in pair | Second name in pair |
---|
HTTP response header | x-amz-request-id | x-amz-id-2 |
HTTP response body (returned on errors only) | RequestId | HostId |
AWS SDK request | AWS Request ID | S3 Extended Request ID |
For example, an S3 request ID pair returned in an HTTP request header resembles the following:
x-amz-request-id: 79104EXAMPLEB723
x-amz-id-2: IOWQ4fDEXAMPLEQM+ey7N9WgVhSnQ6JEXAMPLEZb7hSQDASK+Jd1vEXAMPLEa3Km=
Important: Make sure to provide both values of an S3 request ID pair when requested by AWS Support.
For more information about using CloudTrail data event logging to retrieve request ID pairs, see Logging Amazon S3 API calls using AWS CloudTrail. CloudTrail data event logging for S3 objects retrieves both Request ID and Extended request ID data.
Related information
Response logging in AWS Tools for Windows PowerShell
Troubleshooting
Tutorial: Log Amazon S3 object-level operations using CloudWatch Events