

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

# 아마존 SQS JSON API 응답 해석
<a name="sqs-json-api-responses"></a>

Amazon SQS에 요청을 보내면 결과와 함께 JSON 응답을 반환합니다. 응답 구조는 사용한 API 작업에 따라 달라집니다.

이러한 응답의 세부 정보를 이해하려면 다음을 참조하세요.
+ *Amazon Simple Queue Service API 참조*의 [API 작업](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_Operations.html)에 있는 특정 API 작업
+ [Amazon SQS AWS JSON 프로토콜 FAQs](sqs-json-faqs.md)은

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

요청이 성공하면 기본 응답 요소는 요청의 범용 고유 식별자(UUID)와 기타 추가된 응답 필드를 포함하는 `x-amzn-RequestId`입니다. 예를 들어 다음 [`CreateQueue`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_CreateQueue.html) 응답에는 생성된 대기열의 URL이 포함된 `QueueUrl` 필드가 포함되어 있습니다.

```
HTTP/1.1 200 OK
x-amzn-RequestId: <requestId>
Content-Length: <PayloadSizeBytes>
Date: <Date>
Content-Type: application/x-amz-json-1.0
{
    "QueueUrl":"https://sqs.us-east-1.amazonaws.com/111122223333/MyQueue"
}
```

## JSON 오류 응답 구조
<a name="sqs-api-error-response-structure"></a>

요청이 실패하면 Amazon SQS는 HTTP 헤더와 본문을 포함한 기본 응답을 반환합니다.

HTTP 헤더에서 `x-amzn-RequestId`에는 요청의 UUID가 포함됩니다. `x-amzn-query-error`에는 오류 유형, 오류가 생산자 오류인지 소비자 오류인지 여부라는 두 가지 정보가 포함되어 있습니다.

응답 본문에서 `"__type"`은 기타 오류 세부 정보를 나타내고, `Message`는 오류 조건을 읽을 수 있는 형식으로 나타냅니다.

다음은 JSON 형식의 오류 응답 예제입니다.

```
HTTP/1.1 400 Bad Request
x-amzn-RequestId: 66916324-67ca-54bb-a410-3f567a7a0571
x-amzn-query-error: AWS.SimpleQueueService.NonExistentQueue;Sender
Content-Length: <PayloadSizeBytes>
Date: <Date>
Content-Type: application/x-amz-json-1.0
{
    "__type": "com.amazonaws.sqs#QueueDoesNotExist",
    "message": "The specified queue does not exist."
}
```