ElastiCache용 CloudFormation을 사용할 때 발생하는 "Status Code: 400; Error Code" 오류를 해결하려면 어떻게 해야 하나요?

4분 분량

AWS CloudFormation 스택을 호출하거나 Amazon ElastiCache용 AWS API 호출을 사용할 때 요청이 실패하고 다음과 비슷한 오류가 표시됩니다. "Status Code: 400; Error Code: ###" 이 문제를 해결하려면 어떻게 해야 하나요?

간략한 설명

직접 AWS API 요청을 시작하거나 CloudFormation 스택을 사용해 시작할 때 AWS에서는 초기 구문 검사를 실행합니다. 이 검사에서 요청이 완전하며 필수 파라미터를 모두 갖췄는지 확인합니다. Amazon ElastiCache에 API 요청을 보낼 때 400 오류가 발생하는 일반적인 이유는 다음과 같습니다.

API 요청 제한 때문에 요청이 거부되었습니다.
AWS에 요청을 완료할 만한 가용 용량이 없습니다.
요청에 지정된 지역이나 가용 영역에 캐시 노드가 지원되지 않습니다.
잘못된 파라미터 조합을 사용했습니다.
입력 매개변수에 유효하지 않거나 범위를 벗어난 값이 있습니다.
API에 필수 파라미터나 작업이 없습니다.
현재 다른 ElastiCache 리소스나 AWS 서비스에서 사용 중인 리소스를 제거하려고 합니다.

해결 방법

수신한 ElastiCache 호출 API의 오류를 구체적으로 파악합니다. 그 후 해당 오류를 설명하는 문제 해결 단계를 따릅니다.

참고: 가능한 오류 목록과 설명은 ElastiCache 호출 API 참조에서 일반적인 오류를 참고하세요.

오류 코드: Throttling

오류: "Rate exceeded (Service: AmazonElastiCache; Status Code: 400; Error Code: Throttling; Request ID: ###)"

이 오류는 API 요청 제한으로 인해 요청이 거부되었다는 뜻입니다. 이 계정 수준 API 호출 제한은 특정 서비스에만 국한되지 않습니다.

참고: 특정 호출의 한도를 늘리거나 수정할 수 없습니다. AWS에서는 API 호출이 최대 허용 API 요청 속도를 초과하지 않도록 합니다. 여기에는 애플리케이션에서 오는 API 호출, 즉 명령줄 인터페이스나 AWS Management Console 호출이 포함됩니다.

다음 방법을 사용해 이 오류를 예방할 수 있습니다.

지수 백오프 및 지터를 사용해 호출을 다시 시도합니다.
짧은 시간에 API를 여러 번 호출하는 대신 시간을 두고 API 호출을 균등하게 배분하세요.

오류 코드: InsufficientCacheClusterCapacity

Error: "cache.### (VPC) is not currently supported in the availability zone ###. Retry the launch with no availability zone or target: ###. (Service: AmazonElastiCache; Status Code: 400; Error Code: InsufficientCacheClusterCapacity; Request ID: ###)".

이 오류는 AWS에 현재 요청을 완료할 수 있는 온디맨드 가용 용량이 충분하지 않음을 나타냅니다. 자세한 내용은 오류 메시지: InsufficidentCacheClusterCapacity를 참고하세요.

이 오류가 발생하면 다음을 따르세요.

몇 분 기다린 후 요청을 다시 제출합니다. 용량이 자주 바뀝니다.
다른 캐시 노드 유형을 사용해 요청을 다시 제출합니다.
다른 서브넷과 가용 영역을 사용해 요청을 다시 제출합니다.

오류 코드: SubnetInUse

오류: "The subnet ID subnet-### is in use (Service: AmazonElastiCache; Status Code: 400; Error Code: SubnetInUse; Request ID: ###)".

이 오류는 현재 인스턴스가 연결되어 있는 Elasticache 서브넷 그룹에서 서브넷을 제거하려고 할 때 발생합니다. 서브넷에서 관련 리소스를 모두 제거하고 요청을 다시 제출해야 합니다. 자세한 내용은 DeleteCacheSubnetGroup를 참고하세요.

오류 코드: InvalidParameterValue

이 오류는 파라미터 값이 유효하지 않거나, 지원되지 않거나, 요청에 사용될 수 없음을 나타냅니다. 요청 호출의 각 파라미터를 확인하세요. 예를 들어 지원되지 않는 파라미터 값을 사용한 경우 다음 오류 메시지 중 하나가 표시될 수 있습니다.

"Invalid AuthToken provided. (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterValue"; Request ID: ###)".
이 오류는 Redis용 ElastiCache와 함께 AUTH를 사용할 때 auth-token 설정이 제약 조건을 충족하지 않음을 나타냅니다. 자세한 내용은 Redis AUTH 명령을 사용한 사용자 인증을 참고하세요.
"The snapshot window and maintenance window must not overlap. (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterValue; Request ID: ###)".
스냅샷 기간과 유지 관리 기간을 동시에 설정할 수 없습니다. 이 오류를 방지하려면 다른 작업 기간으로 조정하세요.
"The number of replicas per node group must be within 0 and 5. (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterValue; Request ID: ###)".
ElastiCache Redis에서는 샤드당 프라이머리 1개와 0~5개의 복제본을 지원합니다. 복제본 노드를 5개 이상 추가하면 이 오류가 발생합니다. 자세한 내용은 Redis 복제 이해를 참고하세요.

오류 코드: InvalidParameterCombination

이 오류는 요청 호출에 잘못된 파라미터 조합이나 누락된 파라미터가 포함되어 있음을 의미합니다. 이 경우 다음 오류 메시지 중 하나가 표시될 수 있습니다.

"Cannot find version 5.0.0 for redis (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterCombination; Request ID: ###)".
이 오류는 요청 호출에 표시된 Redis 버전이 지원되지 않음을 나타냅니다. 자세한 내용은 Redis용 ElastiCache 지원 버전 및 Memcached용 ElastiCache 지원 버전을 참고하세요.
"Cannot restore redis from 6.0.5 to 5.0.6. (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterCombination; Request ID: ###)".
Redis용 ElastiCached의 경우 백업을 사용해 새 Redis 클러스터를 생성할 때 다운그레이드된 Redis 엔진 버전을 지원하지 않습니다. 또한 실행 중인 Redis 클러스터에서 Redis 엔진을 다운그레이드하는 것도 지원하지 않습니다. 백업을 사용해 새 Redis 클러스터를 생성할 때는 Redis 엔진 버전이 현재 엔진 버전보다 높거나 같아야 합니다.
"When using automatic failover, there must be at least 2 cache clusters in the replication group. (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidParameterCombination; Request ID: ###)".
사용 가능한 읽기 전용 복제본이 최소 1개 이상 있는 Redis 클러스터에서 자동 장애조치 옵션을 켤 수 있습니다. Redis 복제 그룹에 복제 노드가 1개 이상 있는지 확인한 후 요청을 다시 제출합니다. 자세한 내용은 Multi-AZ로 Redis용 ElastiCache의 가동 중지 시간 최소화를 참고하세요.