기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon SQS XML API 응답 해석
<a name="sqs-xml-api-responses"></a>

Amazon SQS에 요청을 보내면 요청 결과가 포함된 XML 응답이 반환됩니다. 이러한 응답의 구조와 세부 정보를 이해하려면 *Amazon Simple Queue Service API 참조*의 특정 [API 작업](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_Operations.html)을 참조하세요.

## 성공적인 XML 응답 구조
<a name="sqs-api-successful-response-structure"></a>

요청이 성공하면 주 응답 요소는 작업의 이름을 따서 이름이 지정되고 `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 오류 응답 구조
<a name="sqs-api-error-response-structure"></a>

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