HTTP API에 대한 VPC 링크 설정 - Amazon API Gateway
AWS CLI를 사용하여 VPC 링크 생성AWS CLI을 사용하여 VPC 링크 삭제리전별 가용성

HTTP API에 대한 VPC 링크 설정

VPC 링크를 사용하여 HTTP API 라우팅을 VPC의 프라이빗 리소스(예: Application Load Balancer 또는 Amazon ECS 컨테이너 기반 애플리케이션)에 연결하는 프라이빗 통합을 생성할 수 있습니다. 프라이빗 통합 생성에 대한 자세한 내용은 HTTP API에 대한 프라이빗 프록시 통합 생성 단원을 참조하세요.

프라이빗 통합은 VPC 링크를 사용하여 API Gateway와 대상 VPC 리소스 간의 연결을 캡슐화합니다. 서로 다른 라우팅 및 API에서 VPC 링크를 재사용할 수 있습니다.

VPC 링크를 생성할 때 API Gateway는 계정에서 VPC 링크에 대한 탄력적 네트워크 인터페이스를 생성 및 관리합니다. 이 프로세스는 몇 분 정도 걸릴 수 있습니다. VPC 링크를 사용할 준비가 되면 상태가 PENDING에서 AVAILABLE로 바뀝니다.

참고

60일 동안 VPC 링크를 통해 전송되는 트래픽이 없으면 이것이 INACTIVE이 됩니다. VPC 링크가 INACTIVE 상태에 있으면 API Gateway는 VPC 링크의 네트워크 인터페이스를 모두 삭제합니다. 이로 인해 VPC 링크를 사용하는 API 요청이 실패하게 됩니다. API 요청이 재개되면 API Gateway는 네트워크 인터페이스를 다시 프로비저닝합니다. 네트워크 인터페이스를 생성하고 VPC 링크를 다시 활성화하는 데 몇 분 정도 걸릴 수 있습니다. VPC 링크 상태를 사용하여 VPC 링크의 상태를 모니터링할 수 있습니다.

다음 명령을 사용하여 VPC 링크를 생성합니다. VPC 링크를 생성하려면 관련된 모든 리소스를 동일한 AWS 계정이 소유해야 합니다.

aws apigatewayv2 create-vpc-link --name MyVpcLink \
    --subnet-ids subnet-aaaa subnet-bbbb \
    --security-group-ids sg1234 sg5678
참고

VPC 링크는 변경할 수 없습니다. VPC 링크를 생성한 후에는 해당 서브넷이나 보안 그룹을 변경할 수 없습니다.

다음 명령을 사용하여 VPC 링크를 삭제합니다.

aws apigatewayv2 delete-vpc-link --vpc-link-id abcd123

HTTP API에 대한 VPC 링크는 다음 리전 및 가용 영역에서 지원됩니다.

지역명 지역 지원되는 가용 영역
미국 동부(오하이오) us-east-2

use2-az1, use2-az2, use2-az3
미국 동부(버지니아 북부) us-east-1

use1-az1, use1-az2, use1-az4, use1-az5, use1-az6
미국 서부(캘리포니아 북부) us-west-1

usw1-az1, usw1-az3
미국 서부(오레곤) us-west-2

usw2-az1, usw2-az2, usw2-az3, usw2-az4
아시아 태평양(홍콩) ap-east-1

ape1-az2, ape1-az3
아시아 태평양(뭄바이) ap-south-1

aps1-az1, aps1-az2, aps1-az3
아시아 태평양(서울) ap-northeast-2

apne2-az1, apne2-az2, apne2-az3
아시아 태평양(싱가포르) ap-southeast-1

apse1-az1, apse1-az2, apse1-az3
아시아 태평양(시드니) ap-southeast-2

apse2-az1, apse2-az2, apse2-az3
아시아 태평양(도쿄) ap-northeast-1

apne1-az1, apne1-az2, apne1-az4
캐나다(중부) ca-central-1

cac1-az1, cac1-az2
유럽(프랑크푸르트) eu-central-1

euc1-az1, euc1-az2, euc1-az3

유럽(아일랜드) eu-west-1

euw1-az1, euw1-az2, euw1-az3
유럽(런던) eu-west-2

euw2-az1, euw2-az2, euw2-az3
유럽(파리) eu-west-3

euw3-az1, euw3-az3
유럽(스톡홀름) eu-north-1

eun1-az1, eun1-az2, eun1-az3
중동(바레인) me-south-1

mes1-az1, mes1-az2, mes1-az3
남아메리카(상파울루) sa-east-1

sae1-az1, sae1-az2, sae1-az3
AWS GovCloud(미국 서부) us-gov-west-1

usgw1-az1, usgw1-az2, usgw1-az3