Las API HTTP utilizan el protocolo HTTP para exponer rápidamente servicios internos en un sistema distribuido. Este tema describe cómo crear una API HTTP en la consola.
Casos de uso
Las API se pueden crear dentro o fuera de una instancia, según su caso de uso.
Crear una API dentro de una instancia
Gestión dedicada de recursos: La API gestiona recursos o lógica interna únicamente dentro de una instancia específica.
Seguridad y aislamiento: Los datos o funciones requieren un aislamiento estricto y solo se pueden invocar desde dentro de la instancia.
Configuración simplificada del servicio: Limitar la configuración a una instancia específica facilita la gestión de la API.
Crear una API fuera de una instancia
Acceso compartido entre instancias: Varias instancias comparten una única definición de API.
Gestión y monitoreo centralizados: Control unificado de permisos, registros y gestión de tráfico.
Las API creadas dentro de una instancia son visibles y se pueden gestionar únicamente en dicha instancia.
Las API creadas fuera de una instancia no se pueden editar ni eliminar desde dentro de una instancia. Debe gestionarlas desde la lista externa de API.
Crear una API HTTP en la consola
-
Puede crear una API en Cloud-native API Gateway de dos maneras:
External API
Inicie sesión en la consola de Cloud-native API Gateway. En el panel de navegación izquierdo, elija API. En la barra de menú superior, seleccione una región.
Haga clic en Create API y luego haga clic en Create en la tarjeta HTTP API.
In-instance API
Inicie sesión en la consola de Cloud-native API Gateway. En el panel de navegación izquierdo, elija Instance. En la barra de menú superior, seleccione una región.
En la página Instance, haga clic en el ID de la instancia de gateway deseada. En el panel de navegación izquierdo, elija API. En la esquina superior derecha, haga clic en Create API.
Haga clic en Create en la tarjeta HTTP API.
-
En el panel Create REST API, configure los parámetros y haga clic en OK.
Elemento de configuración
Descripción
API Name
Un nombre personalizado para la API. El nombre de la API debe ser único a nivel global.
Description
Introduzca una descripción para la API.
resource
Seleccione el resource group deseado. Puede hacer clic en Create Resource Group a la derecha.
Crear una API HTTP mediante la importación de un Ingress
Requisitos previos
Debe crear un origen de Container Service en Cloud-native API Gateway. Para obtener más información, consulte Manage service sources.
Procedimiento
-
Puede crear una API en Cloud-native API Gateway de dos maneras:
Outside an instance
Inicie sesión en la consola de Cloud-native API Gateway. En el panel de navegación izquierdo, elija API. En la barra de menú superior, seleccione una región.
Haga clic en Create API y luego haga clic en Import Ingress en la tarjeta HTTP API.
In-instance API
Inicie sesión en la consola de Cloud-native API Gateway. En el panel de navegación izquierdo, elija Instance. En la barra de menú superior, seleccione una región.
En la página Instance, haga clic en el ID de la instancia de gateway deseada. En el panel de navegación izquierdo, elija API. En la esquina superior derecha, haga clic en Create API.
Haga clic en Import Ingress en la tarjeta HTTP API.
-
En la sección HTTP API, haga clic en Import Ingress. En la página Import Ingress, configure los parámetros del Ingress y haga clic en OK.
Elemento de configuración
Descripción
API Name
El nombre de la API. También puede hacer clic en Add Description para agregar una descripción al enrutamiento.
Description
La descripción de la API. Puede tener hasta 255 caracteres de longitud.
Instance
Seleccione la instancia de Cloud-native API Gateway.
Source Cluster
El origen del servicio es el clúster de Container Service donde reside el Ingress.
resource
Seleccione el resource group.
Namespace
El namespace que se va a monitorear. Si deja este campo vacío, el gateway monitorea los recursos de Ingress en todos los namespaces.
IngressClass
La IngressClass que se va a monitorear. Si deja este campo vacío, el gateway monitorea todos los tipos de recursos de Ingress.
Update Ingress Status
Si habilita esta función, el Status Endpoint del Ingress monitoreado se reemplaza por el endpoint de entrada del gateway.