Compartir a través de

Importar una API de gRPC

SE APLICA A: Desarrollador | Premium

En este artículo se explica cómo importar una definición de servicio gRPC como una API en API Management. Después, puede administrar la API en API Management, proteger el acceso y aplicar otras directivas, además de aprobar solicitudes de API de gRPC a través de la puerta de enlace al back-end de gRPC.

Para agregar una API de gRPC a API Management, debe hacer lo siguiente:

  • Cargar el archivo de definición Protobuf (búfer de protocolo) de la API en API Management
  • Especificar la ubicación del servicio gRPC
  • Configurar la API en API Management

API Management admite el tránsito con los siguientes tipos de métodos de servicio gRPC: unario, streaming de servidor, streaming de cliente y streaming bidireccional. Para obtener información general sobre gRPC, consulte Introducción a gRPC.

Nota

  • Actualmente, las API de gRPC solo se admiten en la puerta de enlace autohospedada, no en la puerta de enlace administrada para la instancia de API Management.
  • Actualmente, las API de gRPC de prueba no se admiten en la consola de prueba de Azure Portal ni en el portal para desarrolladores de API Management.
  • La importación se limita a un único archivo Protobuff (.proto).

Requisitos previos

Adición de una API de gRPC

  1. Vaya a la instancia de API Management en Azure Portal.

  2. En el menú izquierdo, seleccione API>+ Agregar API.

  3. En Definir una nueva API, seleccione gRPC.

    Captura de pantalla de la creación de una API gRPC en el portal.

  4. En la ventana Crear una API de gRPC, seleccione Completa.

  5. Para una API de gRPC, debe especificar la siguiente configuración:

    1. En Cargar esquema, seleccione un archivo .proto local asociado a la API que se va a importar.

    2. En Dirección URL del servidor gRPC, escriba la dirección del servicio gRPC. Esta dirección debe ser accesible mediante HTTPS.

    3. En Puertas de enlace, seleccione el recurso de puerta de enlace que quiera usar para exponer la API.

      Importante

      En versión preliminar pública, solo puede seleccionar una puerta de enlace autohospedada. No se admite la puerta de enlace Administrada.

  6. Escriba los valores restantes para configurar la API. Estos valores de configuración se explican en el tutorial Importar y publicar la primera API.

  7. Seleccione Crear.

    La API se agrega a la lista de API. Puede consultar la configuración en la pestaña Configuración de la API.

Llamada a servicios gRPC con .NET

Para obtener información sobre cómo llamar a servicios gRPC con .NET, consulte los siguientes artículos:

Anexión de otras API

Puede crear una API fuera de las API expuestas por diferentes servicios, entre las que se incluyen:

  • Especificación de OpenAPI
  • Una API SOAP
  • Una GraphQL API
  • Una aplicación web hospedada en Azure App Service
  • Funciones de Azure
  • Azure Logic Apps
  • Azure Service Fabric

Nota

Al importar una API, las operaciones se anexan a la API actual.

Para anexar una API a una API existente:

  1. Vaya a la instancia de Azure API Management en Azure Portal:

    Recorte de pantalla que muestra la página servicios de API Management.

  2. Seleccione API en la página Información general o seleccione API >API en el menú de la izquierda.

    Recorte de pantalla que muestra la selección de las API en la página Información general.

  3. Seleccione los puntos suspensivos (...) junto a la API que desea anexar a otra API.

  4. Seleccione Importar en el menú desplegable:

    Recorte de pantalla que muestra el comando Importar.

  5. Seleccione un servicio desde el que se va a importar una API.

Contenido relacionado