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
Copy file name to clipboardExpand all lines: articles/api-center/synchronize-api-management-apis.md
+14-9Lines changed: 14 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,15 +4,15 @@ description: Integrate an API Management instance to Azure API Center for automa
4
4
author: dlepow
5
5
ms.service: azure-api-center
6
6
ms.topic: how-to
7
-
ms.date: 07/22/2025
7
+
ms.date: 01/20/2026
8
8
ms.author: danlep
9
9
ms.custom: devx-track-azurecli
10
10
# Customer intent: As an API program manager, I want to integrate my Azure API Management instance with my API center and synchronize API Management APIs to my inventory.
11
11
---
12
12
13
13
# Synchronize APIs from an API Management instance
14
14
15
-
This article shows how to integrate an API Management instance so that the instances's APIs are continuously kept up to date in your [API center](overview.md) inventory.
15
+
This article shows how to integrate an API Management instance so that the instance's APIs are continuously kept up to date in your [API center](overview.md) inventory.
16
16
17
17
> [!TIP]
18
18
> This article explains how to integrate an API Management instance from your API center. Alternatively, quickly set up integration directly from an API Management instance. In the left menu of your instance, under **APIs**, select **API Center**, and select a target API center in your subscription to synchronize APIs to.
@@ -31,7 +31,7 @@ API Management APIs automatically synchronize to the API center whenever existin
31
31
32
32
> [!NOTE]
33
33
> * There are [limits](../azure-resource-manager/management/azure-subscription-service-limits.md?toc=/azure/api-center/toc.json&bc=/azure/api-center/breadcrumb/toc.json#azure-api-center-limits) for the number of integrated API Management instances (API sources).
34
-
> *An integrated API Management instance can be configured in a virtual network.
34
+
> *You can configure an integrated API Management instance in a virtual network.
35
35
> * API updates in API Management typically synchronize to your API center within minutes, but synchronization can take up to 24 hours.
36
36
> * API definitions also synchronize to the API center if you select the option to include them during integration.
37
37
@@ -41,7 +41,7 @@ API Management APIs automatically synchronize to the API center whenever existin
41
41
42
42
## Prerequisites
43
43
44
-
* An API center in your Azure subscription. If you haven't created one, see [Quickstart: Create your API center](set-up-api-center.md).
44
+
* An API center in your Azure subscription. If you didn't create an API center, see [Quickstart: Create your API center](set-up-api-center.md).
45
45
46
46
* An Azure API Management instance, in the same or a different subscription. The instance must be in the same directory.
47
47
@@ -51,7 +51,7 @@ API Management APIs automatically synchronize to the API center whenever existin
> Azure CLI command examples in this article can run in PowerShell or a bash shell. Where needed because of different variable syntax, separate command examples are provided for the two shells.
54
+
> You can run Azure CLI command examples in this article in PowerShell or a bash shell. Where different variable syntax is required, the article provides separate command examples for the two shells.
@@ -61,14 +61,14 @@ API Management APIs automatically synchronize to the API center whenever existin
61
61
62
62
## Integrate an API Management instance
63
63
64
-
You can integrate an API Management instance using the portal or the Azure CLI.
64
+
You can integrate an API Management instance by using the portal or the Azure CLI.
65
65
66
66
#### [Portal](#tab/portal)
67
67
68
-
1. In the [portal](https://portal.azure.com), navigate to your API center.
68
+
1. In the [portal](https://portal.azure.com), go to your API center.
69
69
1. Under **Platforms**, select **Integrations**.
70
70
1. Select **+ New integration** > **From Azure API Management**.
71
-
1. In the **Integrate your Azure API Management Service** page:
71
+
1. In **Integrate your Azure API Management Service**:
72
72
1. Select whether to synchronize all APIs from the API Management instance or only APIs that are in an API Management [workspace](../api-management/workspaces-overview.md).
73
73
1. Select the **Subscription**, **Resource group**, and **Azure API Management service** that you want to integrate. If you want to synchronize only APIs from a workspace, make a selection in **Choose a workspace**.
74
74
1. In **Integration details**, enter an identifier.
@@ -85,9 +85,14 @@ You can integrate an API Management instance using the portal or the Azure CLI.
85
85
86
86
Run the [az apic integration create apim](/cli/azure/apic/integration/create#az-apic-integration-create-apim) command to integrate an API Management instance to your API center.
87
87
88
+
> [!NOTE]
89
+
>
90
+
> * This command is only available in the preview version of the APIC extension.
91
+
> * Install the new preview version before using this command.
92
+
88
93
* Provide the names of the resource group, API center, and integration.
89
94
90
-
* If the API Management instance and the API center are in the same resource group, you can provide the API Management instance name as the value of `azure-apim`; otherwise, provide the Azure resource ID.
95
+
* If the API Management instance and the API center are in the same resource group, you can provide the API Management instance name as the value of `azure-apim`. Otherwise, provide the Azure resource ID.
Copy file name to clipboardExpand all lines: articles/api-center/synchronize-aws-gateway-apis.md
+23-18Lines changed: 23 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: Integrate an Amazon API Gateway to Azure API Center for automatic s
4
4
author: dlepow
5
5
ms.service: azure-api-center
6
6
ms.topic: how-to
7
-
ms.date: 06/02/2025
7
+
ms.date: 01/21/2026
8
8
ms.author: danlep
9
9
ms.custom:
10
10
- devx-track-azurecli
@@ -24,9 +24,9 @@ Integrating Amazon API Gateway as an API source for your API center enables cont
24
24
25
25
When you integrate an Amazon API Gateway as an API source, the following happens:
26
26
27
-
1. APIs, and optionally API definitions (specs), from the API Gateway are added to the API center inventory.
27
+
1.The API center inventory adds APIs, and optionally API definitions (specs), from the API Gateway.
28
28
1. You configure an [environment](key-concepts.md#environment) of type *Amazon API Gateway* in the API center.
29
-
1.An associated [deployment](key-concepts.md#deployment) is created for each synchronized API definition.
29
+
1.You create an associated [deployment](key-concepts.md#deployment) for each synchronized API definition.
30
30
31
31
Synchronization is one-way from Amazon API Gateway to your Azure API center, meaning API updates in the API center aren't synchronized back to Amazon API Gateway.
32
32
@@ -42,9 +42,9 @@ Synchronization is one-way from Amazon API Gateway to your Azure API center, mea
42
42
43
43
## Prerequisites
44
44
45
-
* An API center in your Azure subscription. If you haven't created one, see [Quickstart: Create your API center](set-up-api-center.md).
45
+
* An API center in your Azure subscription. If you didn't create one, see [Quickstart: Create your API center](set-up-api-center.md).
46
46
47
-
* An Azure key vault. If you need to create one, see [Quickstart: Create a key vault using the Azure portal](/azure/key-vault/general/quick-create-portal). To add or manage secrets in the key vault, at least the **Key Vault Secrets Officer** role or equivalent permissions are required.
47
+
* An Azure key vault. If you need to create one, see [Quickstart: Create a key vault using the Azure portal](/azure/key-vault/general/quick-create-portal). To add or manage secrets in the key vault, you need at least the **Key Vault Secrets Officer** role or equivalent permissions.
48
48
49
49
* An [Amazon API Gateway](https://docs.aws.amazon.com/apigateway/).
50
50
@@ -56,22 +56,22 @@ Synchronization is one-way from Amazon API Gateway to your Azure API center, mea
> Azure CLI command examples in this article can run in PowerShell or a bash shell. Where needed because of different variable syntax, separate command examples are provided for the two shells.
59
+
> You can run Azure CLI command examples in this article in PowerShell or a bash shell. Where needed because of different variable syntax, separate command examples are provided for the two shells.
60
60
61
61
## Create IAM user access keys
62
62
63
63
To authenticate your API center to Amazon API Gateway, you need access keys for an AWS IAM user.
64
64
65
-
To generate the required access key ID and secret key using the AWS Management Console, see [Create an access key for yourself](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-key-self-managed.html#Using_CreateAccessKey) in the AWS documentation.
65
+
To generate the required access key ID and secret key by using the AWS Management Console, see [Create an access key for yourself](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-key-self-managed.html#Using_CreateAccessKey) in the AWS documentation.
66
66
67
67
Save your access keys in a safe location. You'll store them in Azure Key Vault in the next steps.
68
68
69
69
> [!CAUTION]
70
-
> Access keys are long-term credentials, and you should manage them as securely as you would a password. Learn more about [securing access keys](https://docs.aws.amazon.com/IAM/latest/UserGuide/securing_access-keys.html)
70
+
> Access keys are long-term credentials. Manage them as securely as you would a password. Learn more about [securing access keys](https://docs.aws.amazon.com/IAM/latest/UserGuide/securing_access-keys.html)
71
71
72
72
## Store IAM user access keys in Azure Key Vault
73
73
74
-
Manually upload and securely store the two IAM user access keys in Azure Key Vault using the configuration recommended in the following table. For more information, see [Quickstart: Set and retrieve a secret from Azure Key Vault using the Azure portal](/azure/key-vault/secrets/quick-create-portal).
74
+
Manually upload and securely store the two IAM user access keys in Azure Key Vault by using the configuration recommended in the following table. For more information, see [Quickstart: Set and retrieve a secret from Azure Key Vault using the Azure portal](/azure/key-vault/secrets/quick-create-portal).
75
75
76
76
77
77
| AWS secret | Upload options | Name | Secret value |
@@ -81,7 +81,7 @@ Manually upload and securely store the two IAM user access keys in Azure Key Vau
81
81
82
82
:::image type="content" source="media/synchronize-aws-gateway-apis/key-vault-secrets.png" alt-text="Screenshot of secrets list in Azure Key Vault in the portal.":::
83
83
84
-
Take note of the **Secret identifier** of each secret, a URI similar to `https://<key-vault-name>.vault.azure.net/secrets/<secret-name>`. You'll use these identifiers in the next steps.
84
+
Take note of the **Secret identifier** of each secret, a URI similar to `https://<key-vault-name>.vault.azure.net/secrets/<secret-name>`. You use these identifiers in the next steps.
@@ -93,19 +93,19 @@ Take note of the **Secret identifier** of each secret, a URI similar to `https:/
93
93
94
94
## Integrate an Amazon API Gateway
95
95
96
-
You can integrate an Amazon API Gateway using the portal or the Azure CLI.
96
+
You can integrate an Amazon API Gateway by using the portal or the Azure CLI.
97
97
98
98
#### [Portal](#tab/portal)
99
-
1. In the [portal](https://portal.azure.com), navigate to your API center.
99
+
1. In the [portal](https://portal.azure.com), go to your API center.
100
100
1. Under **Platforms**, select **Integrations**.
101
101
1. Select **+ New integration** > **From Amazon API Gateway**.
102
-
1. In the **Integrate your Amazon API Gateway Service** page:
103
-
1. For the **AWS access key** and **AWS secret access key**, click**Select** and select the subscription, key vault, secret that you stored.
104
-
1. Select the **AWS region** where the Amazon API Gateway is deployed.
102
+
1. In **Integrate your Amazon API Gateway Service**:
103
+
1. For the **AWS access key** and **AWS secret access key**, select**Select** and choose the subscription, key vault, and secret that you stored.
104
+
1. Select the **AWS region** where you deployed the Amazon API Gateway.
105
105
1. In **Integration details**, enter an identifier.
106
106
1. In **Environment details**, enter an **Environment title** (name), **Environment type**, and optional **Description**.
107
107
1. In **API Details**:
108
-
1. Select a **Lifecycle** for the synchronized APIs. (You can update this value for the APIs after they're added to your API center.)
108
+
1. Select a **Lifecycle** for the synchronized APIs. (You can update this value for the APIs after you add them to your API center.)
109
109
1. Optionally, select whether to include API definitions with the synchronized APIs.
110
110
1. Select **Create**.
111
111
@@ -116,9 +116,14 @@ You can integrate an Amazon API Gateway using the portal or the Azure CLI.
116
116
117
117
Run the [az apic integration create aws](/cli/azure/apic/integration/create#az-apic-integration-create-aws) (preview) command to integrate an Amazon API Gateway to your API center.
118
118
119
+
> [!NOTE]
120
+
>
121
+
> * This command is only available in the preview version of the APIC extension.
122
+
> * Install the new preview version before using this command.
123
+
119
124
* Provide the names of the resource group, API center, and integration.
120
125
121
-
* Provide the Key Vault secret identifiers for the AWS access key and secret access key, and the AWS region where the Amazon API Gateway is deployed.
126
+
* Provide the Key Vault secret identifiers for the AWS access key and secret access key, and the AWS region where you deployed the Amazon API Gateway.
122
127
123
128
```azurecli
124
129
az apic integration create aws \
@@ -131,7 +136,7 @@ az apic integration create aws \
131
136
```
132
137
---
133
138
134
-
The environment is added in your API center. The Amazon API Gateway APIs are imported to the API center inventory.
139
+
The environment is added to your API center. The Amazon API Gateway APIs are imported to the API center inventory.
0 commit comments