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.
# Types de points de terminaison d'API pour REST APIs dans API Gateway
Un type de *[point de terminaison d'API](api-gateway-basic-concept.md#apigateway-definition-api-endpoints) * fait référence au nom d'hôte de l'API. Le type de point de terminaison de l’API peut être *optimisé pour la périphérie*, *régional* ou *privé*, selon la provenance de la majorité du trafic de votre API.
## Points de terminaison d’API optimisés pour la périphérie
Un point de *[terminaison d'API optimisé](api-gateway-basic-concept.md#apigateway-definition-edge-optimized-api-endpoint)* pour les périphériques achemine généralement les demandes vers le CloudFront point de présence (POP) le plus proche, ce qui peut être utile dans les cas où vos clients sont répartis géographiquement. Il s'agit du type de point de terminaison par défaut pour API Gateway REST APIs.
Optimisé pour les bords, mettez en APIs majuscule les noms des [en-têtes HTTP](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers) (par exemple,). `Cookie`
CloudFront trie les cookies HTTP dans l'ordre naturel par nom de cookie avant de transmettre la demande à votre source. Pour plus d'informations sur la manière dont les cookies CloudFront sont traités, consultez la section [Mise en cache du contenu basé sur les cookies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Cookies.html).
Un nom de domaine personnalisé que vous utilisez pour une API optimisée pour la périphérie s’applique à toutes les régions.
## Points de terminaison d’API régional
Un *[point de terminaison d’API régional](api-gateway-basic-concept.md#apigateway-definition-regional-api-endpoint)* est destiné aux clients situés dans la même région. Lorsqu’un client s’exécutant sur une instance EC2 appelle une API de la même région, ou lorsqu’une API est destinée à servir un petit nombre de clients aux demandes très exigeantes, une API régionale réduit la charge de connexion.
Pour une API régionale, le nom de domaine personnalisé que vous utilisez est spécifique à la région de déploiement de l’API. Si vous déployez une API régionale dans plusieurs régions, elle peut avoir le même nom de domaine personnalisé dans toutes les régions. Vous pouvez utiliser des domaines personnalisés avec Amazon Route 53 pour effectuer des tâches telles que le [routage basé sur la latence](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-latency). Pour de plus amples informations, veuillez consulter [Configuration d’un nom de domaine personnalisé régional dans API Gateway](apigateway-regional-api-custom-domain-create.md) et [Configuration d’un nom de domaine personnalisé optimisé pour la périphérie dans API Gateway](how-to-edge-optimized-custom-domain-name.md).
Les points de terminaison d’API régionale transmettent tous les noms d’en-tête en l’état.
**Note**
Dans les cas où les clients d'API sont géographiquement dispersés, il peut toujours être judicieux d'utiliser un point de terminaison d'API régional, associé à votre propre CloudFront distribution Amazon, afin de garantir qu'API Gateway n'associe pas l'API à des distributions contrôlées par les services CloudFront . Pour plus d'informations sur ce cas d'utilisation, consultez [Comment configurer API Gateway avec ma propre CloudFront distribution ?](https://repost.aws/knowledge-center/api-gateway-cloudfront-distribution) .
## Point de terminaison d’API privée
Un *[point de terminaison d’API privée](api-gateway-basic-concept.md#apigateway-definition-private-api-endpoint)* est un point de terminaison d’API qui est uniquement accessible à partir de votre Amazon Virtual Private Cloud (VPC) à l’aide d’un point de terminaison d’un VPC d’interface, qui est une interface réseau de point de terminaison (ENI) créée dans votre VPC. Pour de plus amples informations, veuillez consulter [REST privé APIs dans API Gateway](apigateway-private-apis.md).
Les points de terminaison d’API privée transmettent tous les noms d’en-tête à travers en l’état.
# Modification d’un type de point de terminaison d’API publique ou privée dans API Gateway
La modification d’un type de point de terminaison d’API nécessite que vous mettiez à jour la configuration de l’API. Vous pouvez modifier un type d'API existant à l'aide de la console API Gateway AWS CLI, du ou d'un AWS SDK pour API Gateway. Le type de point de terminaison ne peut pas être modifié de nouveau tant que la modification en cours n’est pas terminée, mais votre API sera disponible.
Les modifications de types de points de terminaison suivantes sont prises en charge :
+ De « optimisés pour la périphérie » à « régionaux » ou « privés ».
+ De « régionaux » à « optimisés pour la périphérie » ou « privés ».
+ De « privés » à « régionaux »
Vous ne pouvez pas modifier une API privée en une API optimisée pour la périphérie.
Si vous modifiez une API publique « optimisée pour la périphérie » en API publique « régionale » et inversement, notez qu’une API optimisée pour la périphérie peut présenter des comportements différents de ceux d’une API régionale. Par exemple, une API optimisée pour la périphérie supprime l’en-tête `Content-MD5`. Toute valeur de MD5 hachage transmise au backend peut être exprimée dans un paramètre de chaîne de requête ou dans une propriété de corps. Toutefois, l’API régionale transmet cet en-tête, même si cela peut remplacer le nom de l’en-tête par un autre nom. Comprendre les différences vous aide à décider comment mettre à jour une API optimisée pour la périphérie en API régionale ou inversement.
**Topics**
+ [Utilisation de la console API Gateway pour modifier un type de point de terminaison d’API](#migrate-api-using-console)
+ [Utilisez le AWS CLI pour modifier le type de point de terminaison d'une API](#migrate-api-using-aws-cli)
## Utilisation de la console API Gateway pour modifier un type de point de terminaison d’API
Pour modifier le type de point de terminaison d’API de votre API, effectuez l’une des étapes suivantes :
**Pour convertir un point de terminaison public de « régional » ou « optimisé pour la périphérie » et vice-versa**
1. Connectez-vous à la console API Gateway à l'adresse [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)
1. Choisissez une API REST.
1. Choisissez **Paramètres de l’API**.
1. Dans la section **Détails de l’API**, choisissez **Modifier**.
1. Pour **Type de point de terminaison d’API**, sélectionnez **Optimisé pour la périphérie** ou **Régional**.
1. Sélectionnez **Enregistrer les modifications**.
1. Redéployez votre API afin que les modifications prennent effet.
**Pour convertir un point de terminaison privé en un point de terminaison régional**
1. Connectez-vous à la console API Gateway à l'adresse [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)
1. Choisissez une API REST.
1. Modifiez la politique de ressources de votre API afin de supprimer toute mention des points de terminaison VPC afin que les appels d'API provenant de l'extérieur VPCs ou de l'intérieur de votre VPC aboutissent.
1. Choisissez **Paramètres de l’API**.
1. Dans la section **Détails de l’API**, choisissez **Modifier**.
1. Pour **Type de point de terminaison d’API**, sélectionnez **Régional**.
1. Sélectionnez **Enregistrer les modifications**.
1. Supprimez la politique de ressources de votre API.
1. Redéployez votre API afin que les modifications prennent effet.
Comme vous migrez le type de point de terminaison de privé vers régional, API Gateway remplace le type d'adresse IP par. IPv4 Pour de plus amples informations, veuillez consulter [Types d’adresses IP pour les API REST dans API Gateway](api-gateway-ip-address-type.md).
**Pour convertir un point de terminaison régional en un point de terminaison privé**
1. Connectez-vous à la console API Gateway à l'adresse [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)
1. Choisissez une API REST.
1. Créez une politique de ressources qui accorde l’accès à votre VPC ou votre point de terminaison de VPC. Pour de plus amples informations, veuillez consulter [Étape 3 : configurer une politique de ressources pour une API privée](apigateway-private-api-create.md#apigateway-private-api-set-up-resource-policy).
1. Choisissez **Paramètres de l’API**.
1. Dans la section **Détails de l’API**, choisissez **Modifier**.
1. Pour **Type de point de terminaison d’API**, sélectionnez **Privé**.
1. (Facultatif) Pour le point de **terminaison VPC IDs**, sélectionnez le point de terminaison VPC IDs que vous souhaitez associer à votre API privée.
1. Sélectionnez **Enregistrer les modifications**.
1. Redéployez votre API afin que les modifications prennent effet.
Étant donné que vous migrez le type de point de terminaison d’une API régionale vers une API privée, API Gateway remplace le type d’adresse IP par Double pile. Pour de plus amples informations, veuillez consulter [Types d’adresses IP pour les API REST dans API Gateway](api-gateway-ip-address-type.md).
## Utilisez le AWS CLI pour modifier le type de point de terminaison d'une API
La [update-rest-api](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-rest-api.html)commande suivante met à jour une API optimisée pour les périphériques vers une API régionale :
```
aws apigateway update-rest-api \
--rest-api-id a1b2c3 \
--patch-operations op=replace,path=/endpointConfiguration/types/EDGE,value=REGIONAL
```
La réponse positive contient un code de statut `200 OK` et une charge utile similaire à ce qui suit :
```
{
"createdDate": "2017-10-16T04:09:31Z",
"description": "Your first API with Amazon API Gateway. This is a sample API that integrates via HTTP with our demo Pet Store endpoints",
"endpointConfiguration": {
"types": "REGIONAL"
},
"id": "a1b2c3",
"name": "PetStore imported as edge-optimized"
}
```
La [update-rest-api](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-rest-api.html)commande suivante met à jour une API régionale vers une API optimisée pour les périphériques :
```
aws apigateway update-rest-api \
--rest-api-id a1b2c3 \
--patch-operations op=replace,path=/endpointConfiguration/types/REGIONAL,value=EDGE
```
Comme il [put-rest-api](https://docs.aws.amazon.com/cli/latest/reference/apigateway/put-rest-api.html)s'agit de mettre à jour les définitions d'API, il ne s'applique pas à la mise à jour d'un type de point de terminaison d'API.