Amazon SQS XML API 응답 해석

작업 요청에 대한 응답으로 Amazon SQS는 요청 결과를 포함하는 XML 데이터 구조를 반환합니다. 자세한 내용은 Amazon Simple Queue Service API 참조의 개별 작업을 참조하세요.

성공적인 XML 응답 구조

요청이 성공하면 주 응답 요소는 작업의 이름을 따서 이름이 지정되고 Response가 추가됩니다(예: ActionNameResponse).

이 요소에는 다음과 같은 하위 요소가 포함되어 있습니다.

• ActionNameResult - 작업별 요소를 포함합니다. 예를 들어 CreateQueueResult 요소는 QueueUrl 요소를 포함하며, 후자는 생성된 대기열의 URL을 포함합니다.

• ResponseMetadata - RequestId를 포함하며, 결과적으로 요청의 Universal Unique Identifier(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>

XML 오류 응답 구조

요청이 실패한 경우 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>