Query Responses and Amazon SES
In response to a Query request, Amazon SES returns an XML data structure that contains the results of the request.
Every Amazon SES response includes a request ID in a
The value is a unique string that AWS assigns. If you ever have issues with a particular request,
AWS will ask for the request ID to help troubleshoot the issue.
Successful Amazon SES responses also include one or more message IDs. You can think of a message ID as a receipt for an email message that Amazon SES sends. If a message is rejected or bounced, the message ID will appear in any complaint or bounce notifications that you receive; you can then use the message ID to identify any problematic email messages that you have sent, and take corrective action.
Structure of a Successful Response
If the request succeeded, the main response element is named after the action, but
with "Response" appended. For example,
SendEmailResponse is the response
element returned for a successful
SendEmail request. This element
contains the following child elements:
ResponseMetadata, which contains the
An optional element containing action-specific results. For example, the
SendEmailResponseelement includes an element called
The XML schema describes the XML response message for each Amazon SES action.
The following is an example of a successful response.
<SendEmailResponse xmlns="https://email.amazonaws.com/doc/2010-03-31/"> <SendEmailResult> <MessageId>000001271b15238a-fd3ae762-2563-11df-8cd4-6d4e828a9ae8-000000</MessageId> </SendEmailResult> <ResponseMetadata> <RequestId>fd3ae762-2563-11df-8cd4-6d4e828a9ae8</RequestId> </ResponseMetadata> </SendEmailResponse>
Structure of an Error Response
If a request is unsuccessful, the main response element is called
ErrorResponse regardless of the action that was called. This element
Error element and a
RequestId element. Each
Typeelement that identifies whether the error was a receiver or sender error
Codeelement that identifies the type of error that occurred
Messageelement that describes the error condition in a human-readable form
Detailelement that might give additional details about the error or might be empty
The following is an example of an error response.
<ErrorResponse> <Error> <Type> Sender </Type> <Code> ValidationError </Code> <Message> Value null at 'message.subject' failed to satisfy constraint: Member must not be null </Message> </Error> <RequestId> 42d59b56-7407-4c4a-be0f-4c88daeea257 </RequestId> </ErrorResponse>