# API Gateway で VPC リンク V2 を設定する
<a name="apigateway-vpc-links-v2"></a>

VPC リンクを使用すると、Application Load Balancer または Amazon ECS コンテナベースのアプリケーションなどの、API ルートを VPC 内のプライベートリソースに接続するプライベート統合を作成できます。プライベート統合は、VPC リンク V2 を使用して、API Gateway と、対象となる VPC リソース間の接続をカプセル化します。異なるリソースと API 間で VPC リンクを再利用できます。

VPC リンクを作成すると、API Gateway はアカウントの VPC リンク V2 用の [Elastic Network Interface](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html) を作成および管理します。このプロセスには数分かかることがあります。VPC リンク V2 を使用する準備ができたら、状態は `PENDING` から `AVAILABLE` に移行します。

**注記**  
VPC リンク経由で 60 日間トラフィックが送信されない場合は、`INACTIVE` になります。VPC リンクが `INACTIVE` 状態の場合、API Gateway は VPC リンクのネットワークインターフェイスをすべて削除します。これにより、VPC リンクに依存する API リクエストが失敗します。API リクエストが再開すると、API Gateway はネットワークインターフェイスを再プロビジョニングします。ネットワークインターフェイスを作成し、VPC リンクを再度アクティブ化するには、数分かかることがあります。VPC リンクステータスを使用して、VPC リンクの状態を監視できます。

## AWS CLI を使用して VPC リンク V2 を作成する
<a name="apigateway-vpc-links-v2-create"></a>

VPC リンク V2 を作成するには、関連するすべてのリソースが同じ AWS アカウントによって所有されている必要があります。次の [create-vpc-link](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-vpc-link.html) コマンドは、VPC リンクを作成します。

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

**注記**  
VPC リンク V2 は変更できません。VPC リンク V2 を作成した後は、そのサブネットやセキュリティグループを変更することはできません。

## AWS CLI を使用して VPC リンク V2 を削除する
<a name="apigateway-vpc-links-v2-delete"></a>

次の [delete-vpc-link](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/delete-vpc-link.html) コマンドは、VPC リンクを削除します。

```
aws apigatewayv2 delete-vpc-link --vpc-link-id {{abcd123}}
```

## リージョン別の利用可能性
<a name="apigateway-vpc-links-v2-availability"></a>

VPC リンク V2 は、次のリージョンとアベイラビリティーゾーンでサポートされています。


| リージョン名 | リージョン | サポートされているアベイラビリティーゾーン | 
| --- | --- | --- | 
| 米国東部 (オハイオ) | 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-3 | apne3-az1、apne3-az2、apne3-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-az3、apse2-az2 | 
| アジアパシフィック (東京) | 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 |