# 在 API Gateway 中设置 VPC 链接 V2
<a name="apigateway-vpc-links-v2"></a>

通过 VPC 链接，您可以创建私有集成，将 API 路由连接到 VPC 中的私有资源，例如应用程序负载均衡器或基于 Amazon ECS 容器的应用程序。私有集成使用 VPC 链接 V2 来封装 API Gateway 与目标 VPC 资源之间的连接。您可以跨不同的资源和 API 重用 VPC 链接。

创建 VPC 链接时，API Gateway 在您的账户中为 VPC 链接 V2 创建和管理[弹性网络接口](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html)。此过程可能耗时数分钟。当 VPC 链接 V2 可供使用时，其状态将从 `PENDING` 转换为 `AVAILABLE`。

**注意**  
如果 60 天内未通过 VPC 链接发送任何流量，其状态会变为 `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/zh_cn/apigateway/latest/developerguide/apigateway-vpc-links-v2.html)