Amazon SQS API 오류 문제 해결

PDF

RSS

포커스 모드

Amazon SQS API 오류 문제 해결 - Amazon Simple Queue Service

QueueDoesNotExist 오류 InvalidAttributeValue 오류 ReceiptHandle 오류

다음 주제에서는 Amazon SQS API 직접 호출 시 반환되는 가장 일반적인 오류와 문제를 해결하는 방법을 다룹니다.

QueueDoesNotExist 오류

이 오류는 Amazon SQS 서비스가 Amazon SQS 작업에 대해 언급된 대기열을 찾을 수 없을 때 반환됩니다.

가능한 원인 및 완화 조치:

잘못된 리전: Amazon SQS 클라이언트 구성을 검토하여 클라이언트에서 올바른 리전을 구성했는지 확인합니다. 클라이언트에서 리전을 구성하지 않으면 SDK 또는가 구성 파일 또는 환경 변수에서 리전을 AWS CLI 선택합니다. SDK가 구성 파일에서 리전을 찾지 못하면 SDK는 기본적으로 리전을 us-east-1로 설정합니다.
대기열이 최근에 삭제되었을 수 있음: API 직접 호출이 이루어지기 전에 대기열이 삭제된 경우 API 직접 호출이 이 오류를 반환합니다. 오류가 발생하기 전에 CloudTrail에서 DeleteQueue 작업을 확인합니다.
권한 문제: 요청하는 AWS Identity and Access Management (IAM) 사용자 또는 역할에 필요한 권한이 없는 경우 다음 오류가 발생할 수 있습니다.
```
The specified queue does not exist or you do not have access to it.
```
권한을 확인하고 올바른 권한으로 API를 직접 호출합니다.

QueueDoesNotExist 오류 문제 해결에 대한 자세한 내용은 AWS 지식 센터 안내서의 Amazon SQS 대기열에 대한 API 직접 호출 시 QueueDoesNotExist 오류를 해결하려면 어떻게 해야 하나요?를 참조하세요.

InvalidAttributeValue 오류

이 오류는 Amazon SQS 대기열 리소스 정책 또는 정책이나 보안 주체가 잘못된 속성을 업데이트하면 반환됩니다.

가능한 원인 및 완화 조치:

잘못된 리소스 정책: 리소스 정책에 모든 필수 필드가 있는지 확인합니다. 자세한 내용은 IAM JSON 정책 요소 참조 및 IAM 정책 검증을 참조하세요. IAM 정책 생성기를 사용하여 Amazon SQS 리소스 정책을 생성하고 테스트할 수도 있습니다. 정책이 JSON 형식인지 확인합니다.
잘못된 보안 주체: Principal 요소가 리소스 정책에 존재하고 값이 유효한지 확인합니다. Amazon SQS 리소스 정책 Principal 요소에 IAM 엔터티가 포함된 경우 정책을 사용하기 전에 엔터티가 존재하는지 확인합니다. Amazon SQS는 리소스 정책을 검증하고 IAM 엔터티를 확인합니다. IAM 엔터티가 없으면 오류가 발생합니다. IAM 엔터티를 확인하려면 GetRole 및 GetUser API를 사용합니다.

InvalidAttributeValue 오류 해결 방법에 대한 자세한 내용은 AWS 지식 센터 안내서의 Amazon SQS 대기열에 대한 API 직접 호출 시 QueueDoesNotExist 오류를 해결하려면 어떻게 해야 하나요?를 참조하세요.

ReceiptHandle 오류

DeleteMessage API를 직접 호출하면 수신 핸들이 잘못되었거나 만료된 경우 ReceiptHandleIsInvalid 또는 InvalidParameterValue 오류가 반환될 수 있습니다.

ReceiptHandleIsInvalid 오류: 수신 핸들이 잘못된 경우 이 예와 유사한 오류가 발생합니다.

An error occurred (ReceiptHandleIsInvalid) when calling the DeleteMessage operation: The input receipt handle <YOUR RECEIPT HANDLE> is not a valid receipt handle.

InvalidParameterValue 오류: 수신 핸들이 만료되면 이 예와 유사한 오류가 발생합니다.

An error occurred (InvalidParameterValue) when calling the DeleteMessage operation: Value <YOUR RECEIPT HANDLE> for parameter ReceiptHandle is invalid. Reason: The receipt handle has expired.

가능한 원인 및 완화 조치:

수신 핸들은 수신된 모든 메시지에 대해 생성되며 표시 제한 시간에만 유효합니다. 표시 제한 시간이 만료되면 메시지가 소비자 대기열에 표시됩니다. 소비자로부터 메시지를 다시 받으면 새 수신 핸들이 수신됩니다. 잘못되거나 만료된 수신 핸들 오류를 방지하려면 올바른 수신 핸들을 사용하여 Amazon SQS 대기열 표시 제한 시간 내에 메시지를 삭제합니다.

ReceiptHandle 오류 해결 방법에 대한 자세한 내용은 AWS 지식 센터 안내서의 Amazon SQS DeleteMessage API 직접 호출을 사용할 때 'ReceiptHandleIsInvalid' 및 'InvalidParameterValue' 오류를 해결하려면 어떻게 해야 하나요?를 참조하세요.