Skip to content

Commit b40ec3f

Browse files
authored
Merge pull request #311889 from dlepow/grpc
[APIM] gRPC support in classic tiers
2 parents f539f25 + 48cd961 commit b40ec3f

3 files changed

Lines changed: 15 additions & 18 deletions

File tree

articles/api-management/api-management-gateways-overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.service: azure-api-management
88
ms.custom:
99
- build-2024
1010
ms.topic: concept-article
11-
ms.date: 02/11/2026
11+
ms.date: 02/17/2026
1212
ms.author: danlep
1313
---
1414

@@ -110,7 +110,7 @@ The following tables compare features available in the following API Management
110110
| [Pass-through GraphQL](graphql-apis-overview.md) | ✔️ | ✔️ |✔️ | ✔️ | ✔️ |
111111
| [Synthetic GraphQL](graphql-apis-overview.md)| ✔️ | ✔️ | ✔️<sup>1</sup> | ✔️<sup>1</sup> ||
112112
| [Pass-through WebSocket](websocket-api.md) | ✔️ | ✔️ || ✔️ | ✔️ |
113-
| [Pass-through gRPC](grpc-api.md) | ||| ✔️ ||
113+
| [Pass-through gRPC](grpc-api.md) | ✔️ ||| ✔️ ||
114114
| [OData](import-api-from-odata.md) | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
115115
| [Azure OpenAI in Microsoft Foundry models and LLMs](azure-ai-foundry-api.md) | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
116116
| [Pass-through MCP server](expose-existing-mcp-server.md) | ✔️ | ✔️ || ✔️ ||

articles/api-management/grpc-api.md

Lines changed: 12 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: dlepow
66

77
ms.service: azure-api-management
88
ms.topic: how-to
9-
ms.date: 10/06/2025
9+
ms.date: 02/18/2026
1010
ms.author: danlep
1111
ms.custom:
1212
- devx-track-arm-template
@@ -17,7 +17,7 @@ ms.custom:
1717
---
1818
# Import a gRPC API
1919

20-
[!INCLUDE [api-management-availability-premium-dev](../../includes/api-management-availability-premium-dev.md)]
20+
[!INCLUDE [api-management-availability-premium-dev-standard-basic](../../includes/api-management-availability-premium-dev-standard-basic.md)]
2121

2222
This article shows how to import a gRPC service definition as an API in API Management. You can then manage the API in API Management, secure access and apply other policies, and pass gRPC API requests through the gateway to the gRPC backend.
2323

@@ -30,21 +30,21 @@ To add a gRPC API to API Management, you need to:
3030
API Management supports pass-through with the following types of gRPC service methods: unary, server streaming, client streaming, and bidirectional streaming. To learn more about gRPC, see [Introduction to gRPC](https://grpc.io/docs/what-is-grpc/introduction/).
3131

3232
> [!NOTE]
33-
> * Currently, gRPC APIs are only supported in the self-hosted gateway, not the managed gateway for your API Management instance.
33+
> * gRPC APIs are supported in the [self-hosted gateway](self-hosted-gateway-overview.md) and in the managed gateway for classic tier instances created starting January 2026 (preview). Contact support to enable gRPC API support in classic tier instances created before this date. gRPC APIs currently aren't supported in the v2 tiers.
3434
> * Currently, testing gRPC APIs isn't supported in the test console of the Azure portal or in the API Management developer portal.
35-
> * Import is limited to a single protobuf (*.proto*) file.
35+
> * Import is limited to a single protobuf (*.proto*) file.
3636
3737
## Prerequisites
3838

3939
* An API Management instance. If you don't already have one, complete the following quickstart: [Create an Azure API Management instance](get-started-create-service-instance.md).
4040

41-
* A gateway resource provisioned in your instance. If you don't already have one, see [Provision a self-hosted gateway in Azure API Management](api-management-howto-provision-self-hosted-gateway.md).
42-
4341
* A gRPC protobuf (*.proto*) file available locally, and gRPC service that's accessible over HTTPS.
4442

43+
* HTTP/2 protocol support enabled for client traffic. For more information, see [Manage protocols and ciphers in Azure API Management](api-management-howto-manage-protocols-ciphers.md).
44+
4545
## Add a gRPC API
4646

47-
1. In the [Azure portal](https://portal.azure.com), navigate to your API Management instance.
47+
1. In the [Azure portal](https://portal.azure.com), go to your API Management instance.
4848

4949
1. Under **APIs** in the sidebar menu, select **APIs**.
5050

@@ -54,7 +54,7 @@ API Management supports pass-through with the following types of gRPC service me
5454

5555
1. In the **Create a gRPC API window**, select **Full**.
5656

57-
1. For a gRPC API, you must specify the following settings:
57+
1. For a gRPC API, specify the following settings:
5858

5959
1. Enter a display name.
6060

@@ -64,18 +64,15 @@ API Management supports pass-through with the following types of gRPC service me
6464

6565
1. For **Gateways**, select the gateway resource that you want to use to expose the API.
6666

67-
> [!IMPORTANT]
68-
> In public preview, you can only select a self-hosted gateway. The **Managed** gateway isn't supported.
69-
70-
1. Enter any remaining settings to configure your API. These settings are explained in the [Import and publish your first API](import-and-publish.md#import-and-publish-a-backend-api) tutorial.
67+
1. Enter any remaining settings to configure your API. The [Import and publish your first API](import-and-publish.md#import-and-publish-a-backend-api) tutorial explains these settings.
7168

7269
1. Select **Create**.
7370

74-
The API is added to the **APIs** list. You can view update your settings by going to the **Settings** tab of the API.
71+
The portal adds the API to the **APIs** list. You can view and update your settings by going to the **Settings** tab of the API.
7572

76-
## Call gRPC services with .NET
73+
## Call gRPC services by using .NET
7774

78-
For information about calling gRPC services with .NET, see the following articles:
75+
For information about calling gRPC services by using .NET, see the following articles:
7976

8077
* [Tutorial: Create a gRPC client and server in ASP.NET Core](/aspnet/core/tutorials/grpc/grpc-start)
8178
* [Troubleshoot gRPC on .NET](/aspnet/core/grpc/troubleshoot#calling-grpc-services-hosted-in-a-sub-directory)

articles/api-management/migrate-amazon-api-gateway-to-api-management.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -142,7 +142,7 @@ As part of the assessment, consider whether to retain or replace existing servic
142142
- *OpenAPI specifications* exported from an Amazon API Gateway REST API contain details specific to the frontend implementation in Amazon API Gateway, not the backend service. You need to remove AWS-specific tags and configure details in the specification (such as the backend service URL) before import to Azure API Management or during the migration process.
143143
- *Kubernetes microservices* backends, such as gRPC APIs, are handled differently:
144144
- Amazon API Gateway connects to the application load balancer in VPC, which in turn provides ingress to AWS EKS.
145-
- Azure API Management supports gRPC APIs on Kubernetes clusters accessed only through the self-hosted gateway.
145+
- Azure API Management typically supports gRPC and other microservice APIs on Kubernetes clusters through the self-hosted gateway.
146146
- Use of gRPC prevents the use of Application Gateway as a WAF.
147147

148148
### Compare API configurations

0 commit comments

Comments
 (0)