本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 API Gateway 中設定 VPC 連結 V2
<a name="apigateway-vpc-links-v2"></a>

VPC 連結可讓您建立私有整合，將 API 路由連線至 VPC 中的私有資源，例如 Application Load Balancer 或 Amazon ECS 容器型應用程式。私有整合使用 VPC 連結 V2 封裝 API Gateway 與目標 VPC 資源之間的連線。您可以重複使用不同資源和 APIs 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 連結的狀態。

## 使用 建立 VPC 連結 V2 AWS CLI
<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 之後，您無法變更其子網路或安全群組。

## 使用 刪除 VPC 連結 V2 AWS CLI
<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-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 | 
| Europe (Paris) | eu-west-3 | euw3-az1、euw3-az3 | 
| 歐洲 (西班牙) | eu-south-2 | eus2-az1、eus2-az2、eus2-az3 | 
| Europe (Stockholm) | eu-north-1 | eun1-az1、eun1-az2、eun1-az3 | 
| Middle East (Bahrain) | 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 |