You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
23
23
@@ -30,21 +30,21 @@ To add a gRPC API to API Management, you need to:
30
30
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/).
31
31
32
32
> [!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.
34
34
> * 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.
36
36
37
37
## Prerequisites
38
38
39
39
* 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).
40
40
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
-
43
41
* A gRPC protobuf (*.proto*) file available locally, and gRPC service that's accessible over HTTPS.
44
42
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
+
45
45
## Add a gRPC API
46
46
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.
48
48
49
49
1. Under **APIs** in the sidebar menu, select **APIs**.
50
50
@@ -54,7 +54,7 @@ API Management supports pass-through with the following types of gRPC service me
54
54
55
55
1. In the **Create a gRPC API window**, select **Full**.
56
56
57
-
1. For a gRPC API, you must specify the following settings:
57
+
1. For a gRPC API, specify the following settings:
58
58
59
59
1. Enter a display name.
60
60
@@ -64,18 +64,15 @@ API Management supports pass-through with the following types of gRPC service me
64
64
65
65
1. For **Gateways**, select the gateway resource that you want to use to expose the API.
66
66
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.
71
68
72
69
1. Select **Create**.
73
70
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.
75
72
76
-
## Call gRPC services with .NET
73
+
## Call gRPC services by using .NET
77
74
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:
79
76
80
77
*[Tutorial: Create a gRPC client and server in ASP.NET Core](/aspnet/core/tutorials/grpc/grpc-start)
81
78
*[Troubleshoot gRPC on .NET](/aspnet/core/grpc/troubleshoot#calling-grpc-services-hosted-in-a-sub-directory)
Copy file name to clipboardExpand all lines: articles/api-management/migrate-amazon-api-gateway-to-api-management.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -142,7 +142,7 @@ As part of the assessment, consider whether to retain or replace existing servic
142
142
-*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.
143
143
-*Kubernetes microservices* backends, such as gRPC APIs, are handled differently:
144
144
- 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.
146
146
- Use of gRPC prevents the use of Application Gateway as a WAF.
0 commit comments