本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# API 參考
Amazon API Gateway 提供的 API 可用來建立並部署您自己的 HTTP 和 WebSocket API。此外，API Gateway APIs可在 AWS SDKs中使用。
如果您使用的是 AWS SDK 存在的語言，您可能偏好使用 SDK，而不是直接使用 API Gateway REST APIs。軟體開發套件可簡化身分驗證、與您的開發環境輕鬆整合，並可輕鬆存取 API Gateway 命令。
以下是可找到 AWS SDKs和 API Gateway REST API 參考文件的位置：
+ [適用於 Amazon Web Services 的工具](https://aws.amazon.com/developer/tools/)
+ [Amazon API Gateway REST API 參考](https://docs.aws.amazon.com/apigateway/latest/api/API_Operations.html)
+ [Amazon API Gateway WebSocket 和 HTTP API 參考](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/api-reference.html)
## API Gateway 服務端點
端點是做為 AWS Web 服務進入點的 URL。API Gateway 支援下列端點類型：
+ [IPv4 端點](#api-reference-service-endpoints-ipv4)
+ [雙堆疊端點](#api-reference-service-endpoints-ipv6) (同時支援 IPv4 和 IPv6)
+ [FIPS 端點](https://docs.aws.amazon.com/general/latest/gr/rande.html#FIPS-endpoints)
當您提出請求時，您可以指定要使用的端點。如果您沒有指定端點，則預設使用 IPv4 端點。若要使用不同的端點類型，您必須在請求中將其指定。如需如何執行此作業的範例，請參閱 [指定端點](#api-reference-service-endpoints-specify-endpoints)。如需可用端點的列表，請參閱 [Amazon API Gateway 端點](https://docs.aws.amazon.com/general/latest/gr/apigateway.html)。
### IPv4 端點
IPv4 端點僅支援 IPv4 流量。IPv4 端點適用於所有區域。
如果您指定一般端點、`apigateway.amazonaws.com`，我們會使用 `us-east-1` 的端點。若要使用不同的區域，請指定其相關聯的端點。例如，如果您指定 `apigateway.us-east-2.amazonaws.com` 做為端點，我們會將您的請求導向 `us-east-2` 端點。
IPv4 端點名稱使用以下命名慣例：
+ `apigateway.region.amazonaws.com`
例如，`eu-west-1` 區域的 IPv4 端點名稱是 `apigateway.eu-west-1.amazonaws.com`。
### 雙堆疊 (IPv4 和 IPv6) 端點
雙堆疊端點同時支援 IPv4 和 IPv6 流量。當您請求雙堆疊端點時，端點 URL 會解析為 IPv6 或 IPv4 位址，這點取決於您的網路和用戶端使用的通訊協定。
雙堆疊端點名稱使用以下命名慣例：
+ `apigateway.region.api.aws`
例如，`eu-west-1` 區域的雙堆疊端點名稱是 `apigateway.eu-west-1.api.aws`。
### 指定端點
下列範例示範如何使用適用於 的 AWS CLI 指定 `us-east-2`區域的端點`apigateway`。
+ **雙堆疊**
```
aws apigateway get-rest-apis --region us-east-2 --endpoint-url https://apigateway.us-east-2.api.aws
```
+ **IPv4**
```
aws apigateway get-rest-apis --region us-east-2 --endpoint-url https://apigateway.us-east-2.amazonaws.com
```
下列範例示範如何使用適用於 的 AWS CLI 指定 `us-east-2`區域的端點`apigatewayv2`。
+ **雙堆疊**
```
aws apigatewayv2 get-apis --region us-east-2 --endpoint-url https://apigateway.us-east-2.api.aws
```
+ **IPv4**
```
aws apigatewayv2 get-apis --region us-east-2 --endpoint-url https://apigateway.us-east-2.amazonaws.com
```
## 在 IAM 原則中使用 IPv6 地址
如果您使用任何 IAM 使用者政策或 API Gateway 資源政策來控制 API Gateway 或任何 API Gateway API 的存取權，請確認您的政策已更新並包含 IPv6 位址範圍。若政策未更新，因而無法處理 IPv6 位址，則可能在用戶端開始使用雙堆疊端點時，影響用戶端對 API Gateway 的存取。如需使用 IAM 管理存取許可的詳細資訊，請參閱 [適用於 Amazon API Gateway 的 Identity and Access Management](security-iam.md)
篩選 IP 地址的 IAM 原則使用[IP 地址條件運算子](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html#Conditions_IPAddress)。下列身分政策允許 `54.240.143.*` 範圍內的 IP 位址取得識別碼為 `a123456789` 的所有 HTTP 或 WebSocket API 資源的相關資訊。超出此範圍的任何 IP 位址都將遭拒，而無法存取 API 中所有資源的相關資訊。因為所有 IPv6 位址都在允許的範圍外，所以此政策會阻止 IPv6 位址存取有關 API 的資訊。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "IPAllow",
"Effect": "Allow",
"Principal": "*",
"Action": "apigateway:GET",
"Resource": "arn:aws:apigateway:us-east-1::/apis/a123456789/*",
"Condition": {
"IpAddress": {"aws:SourceIp": "54.240.143.0/24"}
}
}
]
}
```
------
您可以修改 API 政策的 `Condition` 元素，以允許 IPv4 (`54.240.143.0/24`) 與 IPv6 (`2001:DB8:1234:5678::/64`) 位址範圍，如以下範例所示。您可以使用範例中所示的相同類型 `Condition` 區塊，來更新您的 IAM 使用者政策和 API Gateway 資源政策。
```
1. "Condition": {
2. "IpAddress": {
3. "aws:SourceIp": [
4. "54.240.143.0/24",
5. "2001:DB8:1234:5678::/64"
6. ]
7. }
8. }
```