# 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 は、次のリージョンとアベイラビリティーゾーンでサポートされています。

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/apigateway/latest/developerguide/apigateway-vpc-links-v2.html)