Los mapeos de la API se utilizan para conectar etapas de la API a un nombre de dominio personalizado. Después de crear un nombre de dominio y configurar registros DNS, se utilizan mapeos de la API para enviar tráfico a las API a través del nombre de dominio personalizado.
Un mapeo de la API especifica una API, una etapa y, de forma opcional, una ruta que se utilizará para el mapeo. Por ejemplo, puede mapear la etapa de production de una API a wss://api.example.com/orders.
Antes de crear un mapeo de la API, debe tener una API, una etapa y un nombre de dominio personalizado. Para obtener más información sobre cómo crear un nombre de dominio personalizado, consulte Configuración de un nombre de dominio personalizado regional en API Gateway.
Restricciones
-
En un mapeo de la API, el nombre de dominio personalizado y las API mapeadas deben estar en la misma cuenta de AWS.
-
Los mapeos de la API deben contener solo letras, números y los siguientes caracteres:
$-_.+!*'(). -
La longitud máxima de la ruta en un mapeo de la API es de 300 caracteres.
-
No puede mapear las API de WebSocket al mismo nombre de dominio personalizado que una API HTTP o API REST.
-
Si crea una asignación de API con varios niveles, API Gateway convierte todos los nombres de encabezado a minúsculas.
Creación de un mapeo de la API
Para crear un mapeo de la API, primero debe crear un nombre de dominio personalizado, una API y una etapa. Para obtener información sobre cómo crear un nombre de dominio personalizado, consulte Configuración de un nombre de dominio personalizado regional en API Gateway.
Para crear un mapeo de la API
Inicie sesión en la consola de API Gateway, en https://console.aws.amazon.com/apigateway
. -
Elija Custom domain names (Nombres de dominio personalizados).
-
Seleccione un nombre de dominio personalizado que ya haya creado.
-
Elija API mappings (Mapeos de la API).
-
Elija Configure API mappings (Configurar asignaciones de API).
-
Seleccione Add new mapping (Agregar nueva asignación).
-
Introduzca una API, una Stage (Etapa) y, de forma opcional, una Path (Ruta).
-
Seleccione Guardar.
