本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
解释响应
在响应操作请求时,Amazon SQS 会返回包含请求结果的 XML 数据结构。有关更多信息,请参阅中的各项操作。Amazon Simple Queue Service API 参考.
成功的响应结构
如果请求成功,则主要响应元素将以请求的操作命名并附加上 Response
(
)。ActionName
Response
此元素包含以下子元素:
-
— 包含一个特定于操作的元素。例如,ActionName
ResultCreateQueueResult
元素包含QueueUrl
元素,后者又包含所创建的队列的 URL。 -
ResponseMetadata
— 包含RequestId
后者又包含请求的 UUID。
以下是 XML 格式的成功响应的示例:
<CreateQueueResponse
xmlns=https://sqs.us-east-2.amazonaws.com/doc/2012-11-05/
xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xsi:type=CreateQueueResponse>
<CreateQueueResult>
<QueueUrl>https://sqs.us-east-2.amazonaws.com/770098461991/queue2</QueueUrl>
</CreateQueueResult>
<ResponseMetadata>
<RequestId>cb919c0a-9bce-4afe-9b48-9bdf2412bb67</RequestId>
</ResponseMetadata>
</CreateQueueResponse>
错误响应结构
如果请求不成功,Amazon SQS 将始终返回主要响应元素。ErrorResponse
. 此元素包含一个 Error
元素和一个 RequestId
元素。
Error
元素包含以下子元素:
-
Type
— 指定错误是创建者错误还是使用者错误。 -
Code
— 指定错误类型。 -
Message
— 以可读格式指定错误条件。 -
Detail
—(可选)指定有关错误的更多详细信息。
RequestId
元素包含请求的 UUID。
下面是 XML 格式的错误响应的示例:
<ErrorResponse>
<Error>
<Type>Sender</Type>
<Code>InvalidParameterValue</Code>
<Message>
Value (quename_nonalpha) for parameter QueueName is invalid.
Must be an alphanumeric String of 1 to 80 in length.
</Message>
</Error>
<RequestId>42d59b56-7407-4c4a-be0f-4c88daeea257</RequestId>
</ErrorResponse>