VPC 링크를 사용하여 HTTP API 라우팅을 VPC의 프라이빗 리소스(예: Application Load Balancer 또는 Amazon ECS 컨테이너 기반 애플리케이션)에 연결하는 프라이빗 통합을 생성할 수 있습니다. 프라이빗 통합 생성에 대한 자세한 내용은 API Gateway에서 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 링크의 상태를 모니터링할 수 있습니다.
AWS CLI를 사용하여 VPC 링크 생성
VPC 링크를 생성하려면 관련된 모든 리소스를 동일한 AWS 계정이 소유해야 합니다. 다음 create-vpc-link 명령은 VPC 링크를 생성합니다.
aws apigatewayv2 create-vpc-link --nameMyVpcLink\ --subnet-idssubnet-aaaasubnet-bbbb\ --security-group-idssg1234sg5678
참고
VPC 링크는 변경할 수 없습니다. VPC 링크를 생성한 후에는 해당 서브넷이나 보안 그룹을 변경할 수 없습니다.
AWS CLI을 사용하여 VPC 링크 삭제
다음 delete-vpc-link 명령은 VPC 링크를 삭제합니다.
aws apigatewayv2 delete-vpc-link --vpc-link-idabcd123
리전별 가용성
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-south-2 | eus2-az1, eus2-az2, eus2-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 |
