Sélectionner vos préférences de cookies

Nous utilisons des cookies essentiels et des outils similaires qui sont nécessaires au fonctionnement de notre site et à la fourniture de nos services. Nous utilisons des cookies de performance pour collecter des statistiques anonymes afin de comprendre comment les clients utilisent notre site et d’apporter des améliorations. Les cookies essentiels ne peuvent pas être désactivés, mais vous pouvez cliquer sur « Personnaliser » ou « Refuser » pour refuser les cookies de performance.

Si vous êtes d’accord, AWS et les tiers approuvés utiliseront également des cookies pour fournir des fonctionnalités utiles au site, mémoriser vos préférences et afficher du contenu pertinent, y compris des publicités pertinentes. Pour accepter ou refuser tous les cookies non essentiels, cliquez sur « Accepter » ou « Refuser ». Pour effectuer des choix plus détaillés, cliquez sur « Personnaliser ».

Associez les étapes de l'API à un nom de domaine personnalisé pour WebSocket APIs

Mode de mise au point
Associez les étapes de l'API à un nom de domaine personnalisé pour WebSocket APIs - Amazon API Gateway

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.

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.

Les mappages d’API vous permettent de connecter des étapes d’API à un nom de domaine personnalisé. Après avoir créé un nom de domaine et configuré les enregistrements DNS, vous utilisez les mappages d'API pour envoyer du trafic vers vous APIs via votre nom de domaine personnalisé.

Un mappage d’API spécifie une API, une étape et éventuellement un chemin à utiliser pour le mappage. Par exemple, vous pouvez mapper l’étape production d’une API à wss://api.example.com/orders.

Avant de créer un mappage d’API, vous devez disposer d’une API, d’une étape et d’un nom de domaine personnalisé. Pour plus d’informations sur la création d’un nom de domaine personnalisé, consultez Configuration d’un nom de domaine personnalisé régional dans API Gateway.

Restrictions

  • Dans un mappage d'API, le nom de domaine personnalisé et le nom de domaine mappé APIs doivent se trouver dans le même AWS compte.

  • Les mappages d’API ne doivent contenir que des lettres, des chiffres et les caractères suivants : $-_.+!*'().

  • La longueur maximale du chemin d’un mappage d’API est de 300 caractères.

  • Vous ne pouvez pas WebSocket APIs mapper vers le même nom de domaine personnalisé qu'une API HTTP ou une API REST.

  • Si vous créez un mappage d’API à plusieurs niveaux, API Gateway convertit tous les noms d’en-tête en minuscules.

Création d’un mappage d’API

Pour créer un mappage d’API, vous devez d’abord créer un nom de domaine personnalisé, une API et une étape. Pour plus d’informations sur la création d’un nom de domaine personnalisé, consultez Configuration d’un nom de domaine personnalisé régional dans API Gateway.

AWS Management Console
Pour créer un mappage d’API
  1. Connectez-vous à la console API Gateway à l'adresse https://console.aws.amazon.com/apigateway.

  2. Choisissez Noms de domaine personnalisés.

  3. Sélectionnez un nom de domaine personnalisé que vous avez déjà créé.

  4. Choisissez Mappages d’API.

  5. Choisissez Configurer les mappages d’API.

  6. Choisissez Ajouter un nouveau mappage.

  7. Entrez une API, une Étape et, éventuellement, un Chemin d’accès.

  8. Choisissez Enregistrer.

AWS CLI

La commande suivante de la create-api-mapping crée un mappage d’API. Dans cet exemple, API Gateway envoie des demandes api.example.com/v1 à l’API et à l’étape spécifiés.

aws apigatewayv2 create-api-mapping \ --domain-name api.example.com \ --api-mapping-key v1 \ --api-id a1b2c3d4 \ --stage test
AWS CloudFormation

L' AWS CloudFormation exemple suivant crée un mappage d'API.

MyApiMapping: Type: 'AWS::ApiGatewayV2::ApiMapping' Properties: DomainName: api.example.com ApiMappingKey: 'v1' ApiId: !Ref MyApi Stage: !Ref MyStage
Pour créer un mappage d’API
  1. Connectez-vous à la console API Gateway à l'adresse https://console.aws.amazon.com/apigateway.

  2. Choisissez Noms de domaine personnalisés.

  3. Sélectionnez un nom de domaine personnalisé que vous avez déjà créé.

  4. Choisissez Mappages d’API.

  5. Choisissez Configurer les mappages d’API.

  6. Choisissez Ajouter un nouveau mappage.

  7. Entrez une API, une Étape et, éventuellement, un Chemin d’accès.

  8. Choisissez Enregistrer.

ConfidentialitéConditions d'utilisation du sitePréférences de cookies
© 2025, Amazon Web Services, Inc. ou ses affiliés. Tous droits réservés.