Amazon ElastiCache Serverless 클러스터를 생성할 때 발생하는 문제를 해결하려고 합니다.
간략한 설명
다음과 같은 이유로 ElastiCache Serverless 클러스터가 실패할 수 있습니다.
- AWS Identity and Access Management(IAM) 권한 문제
- IP 주소 소진
- 가상 프라이빗 클라우드(VPC) 엔드포인트 할당량
- 네트워크 인터페이스(NIC) 또는 보안 그룹 할당량
- AWS Key Management Service(AWS KMS) 키 액세스 문제
- 서브넷 부족
해결 방법
IAM 권한 문제
VPC 엔드포인트를 생성하는 데 필요한 권한이 없는 경우 다음 오류 메시지 중 하나가 표시될 수 있습니다.
- 클러스터 이벤트의 경우: "Failed to create cache [cluster-name]. You do not have permissions to create a VPC endpoint."
- AWS CloudTrail의 경우: "errorCode": "Client.UnauthorizedOperation" 및 "errorMessage": "You are not authorized to perform this operation. User: [ARN] is not authorized to perform: ec2:CreateVpcEndpoint on resource: [resource-ARN] with an explicit deny in an identity-based policy."를 찾습니다.
VPC 엔드포인트를 생성하려면 IAM 역할 또는 사용자에게 필요한 권한이 있어야 합니다. VPC 엔드포인트를 생성하는 데 필요한 권한이 있는지 확인하려면 CreateVpcEndpoint API를 실행할 때 DryRun 파라미터를 사용하십시오.
IP 주소 소진
VPC 엔드포인트를 생성할 수 있는 충분한 IP 주소가 없는 경우 다음과 유사한 오류 메시지가 표시될 수 있습니다.
"Failed to create cache [cluster-name]. Insufficient free IP addresses to create vpc endpoint."
이 문제를 해결하려면 다음 작업 중 하나를 수행하십시오.
- 클러스터를 다른 서브넷에 배포합니다.
- IP 주소를 차지할 수 있는 NIC 등의 사용하지 않는 리소스를 삭제합니다.
VPC 엔드포인트 할당량
VPC 엔드포인트 생성 할당량에 도달한 경우 다음 오류 메시지 중 하나가 표시될 수 있습니다.
- 클러스터 이벤트의 경우: "Failed to create cache [cluster-name]. Quota limit reached for creating VPC endpoint."
- AWS CloudTrail의 경우: "errorCode": "Client.VpcEndpointLimitExceeded" 및 "errorMessage": "Limit of [current quota] VPC endpoints per VPC exceeded."를 찾습니다.
이 문제를 해결하려면 다음 단계를 완료하여 할당량 증가를 요청하십시오.
- AWS 리전에서 Service Quotas 콘솔을 엽니다.
- AWS 서비스에서 **Amazon Virtual Private Cloud(Amazon VPC)**를 선택합니다.
- VPC당 인터페이스 VPC 엔드포인트를 선택한 다음, 증가를 요청합니다.
NIC 또는 보안 그룹 할당량
NIC 또는 보안 그룹 할당량에 도달한 경우 AWS CloudTrail에 다음과 같은 오류 메시지가 표시될 수 있습니다.
"errorCode": "Client.NetworkInterfaceLimitExceeded" 및 "errorMessage": "Limit on network interfaces or security groups has been reached!"
이 문제를 해결하려면 사용하지 않는 NIC 또는 보안 그룹을 삭제하십시오. 또한 보안 그룹을 여러 VPC와 연결하십시오.
또는 다음 단계를 완료하여 할당량 증가를 요청하십시오.
- 해당 리전에서 Service Quotas 콘솔을 엽니다.
- AWS 서비스에서 **Amazon Virtual Private Cloud(Amazon VPC)**를 선택합니다.
- 리전별 네트워크 인터페이스 또는 리전별 VPC 보안 그룹을 선택한 다음, 증가를 요청합니다.
AWS KMS 키 액세스 문제
서버리스 캐시를 생성할 때 AWS KMS 키 액세스를 사용하려고 하면 키 액세스가 거부됩니다.
다음과 같은 오류 메시지가 표시됩니다.
"An error occurred (InvalidParameterValue) when calling the CreateServerlessCache operation: KMS key access is denied with key id: [kms-key-arn]"
이 문제를 해결하려면 IAM 역할 또는 사용자 권한을 업데이트하십시오. 역할 또는 사용자에게는 지정된 AWS KMS 키를 사용할 권한이 있어야 합니다.
서브넷 부족
서버리스 캐시를 생성할 때 다음과 같은 오류 메시지가 표시될 수 있습니다.
"An error occurred (InvalidParameterValue) when calling the CreateServerlessCache operation: Customer account VPC should have a minimum of <number> default subnets."
ElastiCache Serverless 서브넷을 선택하는 방법은 리전에 따라 다릅니다. 특정 서브넷 ID를 제공하지 않으면 기본적으로 VPC 내 여러 가용 영역에서 서브넷이 선택됩니다. 예를 들어 미국 서부(캘리포니아 북부) us-west-1 리전에 기본 서브넷 2개를 사용하고 기타 모든 리전에는 기본 서브넷 3개를 사용할 수 있습니다.
이 문제를 해결하려면 VPC에 서브넷을 추가하십시오.
관련 정보
Elasticache 작동 방식
액세스 거부 오류 메시지 문제 해결