Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Références d’API
Amazon API Gateway permet APIs de créer et de déployer votre propre protocole HTTP et WebSocket APIs. En outre, les API Gateway APIs sont disponibles en standard AWS SDKs.
Si vous utilisez un langage pour lequel un AWS SDK existe, vous préférerez peut-être utiliser le SDK plutôt que d'utiliser directement le REST API APIs Gateway. Ils SDKs simplifient l'authentification, s'intègrent facilement à votre environnement de développement et fournissent un accès facile aux commandes API Gateway.
Voici où se trouve la documentation AWS SDKs de référence de l'API REST API Gateway :
+ [Outils pour Amazon Web Services](https://aws.amazon.com/developer/tools/)
+ [Référence d'API REST Amazon API Gateway](https://docs.aws.amazon.com/apigateway/latest/api/API_Operations.html)
+ [Amazon API Gateway WebSocket et référence d'API HTTP](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/api-reference.html)
## Points de terminaison de service API Gateway
Un point de terminaison est une URL qui sert de point d'entrée à un service AWS Web. API Gateway prend en charge les types de point de terminaison suivants :
+ [IPv4 points de terminaison](#api-reference-service-endpoints-ipv4)
+ [Points de terminaison Dualstack (compatibles](#api-reference-service-endpoints-ipv6) avec et) IPv4 IPv6
+ [points de terminaison FIPS](https://docs.aws.amazon.com/general/latest/gr/rande.html#FIPS-endpoints).
Lorsque vous soumettez une demande, vous pouvez spécifier le point de terminaison et la région à utiliser. Si vous ne spécifiez aucun point de IPv4 terminaison, celui-ci est utilisé par défaut. Pour utiliser un autre type de point de terminaison, vous devez le spécifier dans votre demande. Pour obtenir un exemple de la façon de procéder, consultez [Spécification des points de terminaison](#api-reference-service-endpoints-specify-endpoints). Pour obtenir un tableau des points de terminaison disponibles, consultez [Points de terminaison Amazon API Gateway](https://docs.aws.amazon.com/general/latest/gr/apigateway.html).
### IPv4 points de terminaison
IPv4 les terminaux ne prennent en charge que IPv4 le trafic. IPv4 les points de terminaison sont disponibles pour toutes les régions.
Si vous spécifiez le point de terminaison général, `apigateway.amazonaws.com`, nous utilisons le point de terminaison pour `us-east-1`. Pour utiliser une autre région, spécifiez son point de terminaison associé. Par exemple, si vous le spécifiez `apigateway.us-east-2.amazonaws.com` comme point de terminaison, nous dirigeons votre demande vers le point de terminaison `us-east-2`.
IPv4 les noms des points de terminaison utilisent la convention de dénomination suivante :
+ `apigateway.region.amazonaws.com`
Par exemple, le nom du IPv4 point de terminaison de la `eu-west-1` région est`apigateway.eu-west-1.amazonaws.com`.
### Points de terminaison à double pile (IPv4 et IPv6)
Les points de terminaison Dualstack prennent en charge à la fois IPv4 le trafic et le trafic. IPv6 Lorsque vous envoyez une demande à un point de terminaison à double pile, l'URL du point de terminaison correspond à une adresse IPv6 ou à une IPv4 adresse, selon le protocole utilisé par votre réseau et votre client.
Les noms des points de terminaison à double pile utilisent la convention d’affectation de noms suivante :
+ `apigateway.region.api.aws`
Par exemple, le nom du point de terminaison à double pile de la région `eu-west-1` est `apigateway.eu-west-1.api.aws`.
### Spécification des points de terminaison
Les exemples suivants montrent comment spécifier un point de terminaison pour la `us-east-2` région à l'aide du AWS CLI for`apigateway`.
+ **Double pile**
```
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
```
Les exemples suivants montrent comment spécifier un point de terminaison pour la `us-east-2` région à l'aide du AWS CLI for`apigatewayv2`.
+ **Double pile**
```
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
```
## Utilisation des IPv6 adresses dans les politiques IAM
Si vous utilisez des politiques utilisateur IAM ou des politiques de ressources API Gateway pour contrôler l'accès à API Gateway ou à toute autre API Gateway APIs, vérifiez que vos politiques sont mises à jour pour inclure les plages d' IPv6 adresses. Les politiques qui ne sont pas mises à jour pour gérer IPv6 les adresses peuvent avoir un impact sur l'accès du client à API Gateway lorsqu'il commence à utiliser le point de terminaison dualstack. Pour plus d’informations sur la gestion des autorisations d’accès avec IAM, consultez [Identity and Access Management pour Amazon API Gateway](security-iam.md).
Les stratégies IAM qui permettent de filtrer les adresses IP utilisent des [opérateurs de condition d'adresse IP](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html#Conditions_IPAddress). La politique d'identité suivante permet aux adresses IP de la `54.240.143.*` plage d'obtenir des informations sur toutes les ressources d'un HTTP ou d'une WebSocket API avec l'identifiant de`a123456789`. Toute adresse IP située en dehors de cette plage se verra refuser l’accès aux informations sur toutes les ressources de l’API. Comme toutes les IPv6 adresses se situent en dehors de la plage autorisée, cette politique empêche IPv6 les adresses d'accéder aux informations relatives à l'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"}
}
}
]
}
```
------
Vous pouvez modifier l'`Condition`élément de la politique d'API pour autoriser à la fois les plages d'adresses IPv4 IPv6 (`54.240.143.0/24``2001:DB8:1234:5678::/64`) et (), comme indiqué dans l'exemple suivant. Vous pouvez utiliser le même type de bloc `Condition` que celui indiqué dans l’exemple pour mettre à jour vos stratégies d’utilisateur IAM et stratégies de ressources API Gateway.
```
1. "Condition": {
2. "IpAddress": {
3. "aws:SourceIp": [
4. "54.240.143.0/24",
5. "2001:DB8:1234:5678::/64"
6. ]
7. }
8. }
```