Compartir vía

Importación de una API de gRPC

  • Artículo

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 Introduction 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 Importación y publicación de 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 a partir de las API expuestas por distintos servicios, como los siguientes:

  • Una especificación de OpenAPI
  • Una API SOAP
  • GraphQL API
  • Una aplicación web hospedada en Azure App Service
  • Aplicación de función de Azure
  • Azure Logic Apps
  • Azure Service Fabric

Para anexar una API distinta a la API existente, siga estos pasos.

Nota

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

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

    Recorte de pantalla de la navegación a la instancia de API Management en el portal.

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

    Recorte de pantalla de la selección de API en la página Información general del portal.

  3. Haga clic en ... junto a la API a la que desea anexar otra API.

  4. Seleccione Importar en el menú desplegable.

    Selección de Importar

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

    Recorte de pantalla de la selección de un servicio en el portal.