Skip to content

Commit 16a57b5

Browse files
committed
Merge remote-tracking branch 'upstream/main' into fxl---retirement-include
2 parents ee54321 + 0e9a8c9 commit 16a57b5

2,527 files changed

Lines changed: 25202 additions & 39052 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.openpublishing.redirection.json

Lines changed: 660 additions & 0 deletions
Large diffs are not rendered by default.

articles/active-directory-b2c/partner-transmit-security.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ zone_pivot_groups: b2c-policy-type
2020

2121
[!INCLUDE [active-directory-b2c-end-of-sale-notice-b](../../includes/active-directory-b2c-end-of-sale-notice-b.md)]
2222

23-
In this tutorial, learn to integrate Azure Active Directory B2C (Azure AD B2C) authentication with [Transmit Security's Detection and Response Services (DRS)](https://transmitsecurity.com/platform/detection-and-response). Transmit Security allows you to detect risk in customer interactions on digital channels, and to enable informed identity and trust decisions across the consumer experience.
23+
In this tutorial, learn to integrate Azure Active Directory B2C (Azure AD B2C) authentication with [Transmit Security's Detection and Response Services (DRS)](https://transmitsecurity.com/core-services/fraud-prevention). Transmit Security allows you to detect risk in customer interactions on digital channels, and to enable informed identity and trust decisions across the consumer experience.
2424

2525
::: zone pivot="b2c-user-flow"
2626

articles/api-center/design-api-github-copilot-azure.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: With AI assistance, API developers can use the Azure API Center plu
44
author: dlepow
55
ms.service: azure-api-center
66
ms.topic: how-to
7-
ms.date: 02/10/2025
7+
ms.date: 09/26/2025
88
ms.update-cycle: 180-days
99
ms.author: danlep
1010
ms.collection: ce-skilling-ai-copilot
@@ -14,10 +14,10 @@ ms.custom:
1414

1515
# Design and develop APIs using API Center plugin for GitHub Copilot for Azure
1616

17-
The API Center plugin for [GitHub Copilot for Azure](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) (preview) accelerates design and development of new APIs starting from natural language prompts. With AI assistance available through the API Center plugin combined with the API Center VS Code extension, simply describe your API and quickly generate an OpenAPI spec for API development that complies with your organization's standards. After you generate a compliant spec, you can register the API with your [API center](overview.md).
17+
The API Center plugin for [GitHub Copilot for Azure](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) accelerates design and development of new APIs starting from natural language prompts. With AI assistance available through the API Center plugin combined with the API Center VS Code extension, simply describe your API and quickly generate an OpenAPI spec for API development that complies with your organization's standards. After you generate a compliant spec, you can register the API with your [API center](overview.md).
1818

1919
[!INCLUDE [vscode-extension-basic-prerequisites](includes/vscode-extension-basic-prerequisites.md)]
20-
* [GitHub Copilot for Azure](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) - to generate OpenAPI specification files using the Azure API Center Plugin for [GitHub Copilot for Azure](/azure/developer/github-copilot-azure/introduction) (preview)
20+
* [GitHub Copilot for Azure](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) - to generate OpenAPI specification files using the Azure API Center Plugin for [GitHub Copilot for Azure](/azure/developer/github-copilot-azure/introduction)
2121

2222
[!INCLUDE [vscode-extension-setup](includes/vscode-extension-setup.md)]
2323

articles/api-center/import-api-management-apis.md

Lines changed: 26 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Add APIs to your Azure API center inventory from your API Managemen
44
author: dlepow
55
ms.service: azure-api-center
66
ms.topic: how-to
7-
ms.date: 06/28/2024
7+
ms.date: 09/29/2025
88
ms.author: danlep
99
ms.custom: devx-track-azurecli
1010
# Customer intent: As an API program manager, I want to add APIs that are managed in my Azure API Management instance to my API center.
@@ -16,26 +16,26 @@ This article shows how to import (add) APIs from an Azure API Management instanc
1616

1717
This article shows two options for using the Azure CLI to add APIs to your API center from API Management:
1818

19-
* **Option 1** - Export an API definition from an API Management instance using the [az apim api export](/cli/azure/apim/api#az-apim-api-export) command. Then, import the definition to your API center.
19+
* **Option 1**: Export an API definition from an API Management instance using the [az apim api export](/cli/azure/apim/api#az-apim-api-export) command, then import the definition to your API center.
2020

21-
Possible ways to import an API definition exported from API Management include:
22-
* Run [az apic api register](/cli/azure/apic/api#az-apic-api-register) to register a new API in your API center.
23-
* Run [az apic api definition import-specification](/cli/azure/apic/api/definition#az-apic-api-definition-import-specification) to import the API definition to an existing API.
21+
Possible ways to import an API definition exported from API Management include:
22+
* Run [az apic api register](/cli/azure/apic/api#az-apic-api-register) to register a new API in your API center.
23+
* Run [az apic api definition import-specification](/cli/azure/apic/api/definition#az-apic-api-definition-import-specification) to import the API definition to an existing API.
24+
25+
* **Option 2**: Import APIs directly from API Management to your API center using the [az apic import-from-apim](/cli/azure/apic#az-apic-import-from-apim) command.
2426

25-
* **Option 2** - Import APIs directly from API Management to your API center using the [az apic import-from-apim](/cli/azure/apic#az-apic-import-from-apim) command.
26-
2727
After importing API definitions or APIs from API Management, you can add metadata and documentation in your API center to help stakeholders discover, understand, and consume the API.
2828

2929
> [!TIP]
3030
> You can also set up automatic synchronization of APIs from API Management to your API center. For more information, see [Link an API Management instance to synchronize APIs to your API center](synchronize-api-management-apis.md).
3131
3232
## Prerequisites
3333

34-
* An API center in your Azure subscription. If you haven't created one, see [Quickstart: Create your API center](set-up-api-center.md).
34+
* An API center in your Azure subscription. If you don't have one, see [Quickstart: Create your API center](set-up-api-center.md).
3535

36-
* One or more instances of Azure API Management, in the same or a different subscription. When you import APIs directly from API Management, the API Management instance and API center must be in the same directory. If you haven't created one, see [Create an Azure API Management instance](../api-management/get-started-create-service-instance.md).
36+
* One or more instances of Azure API Management in the same or a different subscription. When you import APIs directly from API Management, the API Management instance and API center must be in the same directory. If you don't have one, see [Create an Azure API Management instance](../api-management/get-started-create-service-instance.md).
3737

38-
* One or more APIs managed in your API Management instance that you want to add to your API center.
38+
* One or more APIs managed in your API Management instance that you want to add to your API center.
3939

4040
* For Azure CLI:
4141
[!INCLUDE [include](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
@@ -51,7 +51,7 @@ First, export an API from your API Management instance to an API definition usin
5151

5252
### Export API to a local API definition file
5353

54-
The following example command exports the API with identifier *my-api* in the *myAPIManagement* instance of API. The API is exported in OpenApiJson format to a local OpenAPI definition file at the path you specify.
54+
The following example command exports the API with identifier *my-api* in the *myAPIManagement* instance of API. The API is exported in OpenApiJson format to a local OpenAPI definition file at the path you specify.
5555

5656
```azurecli
5757
#! /bin/bash
@@ -66,10 +66,10 @@ az apim api export --api-id my-api --resource-group myResourceGroup `
6666
--service-name myAPIManagement --export-format OpenApiJsonFile `
6767
--file-path '/path/to/folder'
6868
```
69-
### Export API to a URL
7069

71-
In the following example, [az apim api export](/cli/azure/apim/api#az-apim-api-export) exports the API with identifier *my-api* in OpenApiJson format to a URL in Azure storage. The URL is available for approximately 5 minutes. Here, the value of the URL is stored in the *$link* variable.
70+
### Export API to a URL
7271

72+
In the following example, [az apim api export](/cli/azure/apim/api#az-apim-api-export) exports the API with identifier *my-api* in OpenApiJson format to a URL in Azure storage. The URL is available for approximately five minutes. Here, the value of the URL is stored in the *$link* variable.
7373

7474
```azurecli
7575
#! /bin/bash
@@ -84,6 +84,7 @@ $link=$(az apim api export --api-id my-api --resource-group myResourceGroup `
8484
--service-name myAPIManagement --export-format OpenApiJsonUrl --query properties.value.link `
8585
--output tsv)
8686
```
87+
8788
### Register API in your API center from exported API definition
8889

8990
You can register a new API in your API center from the exported definition by using the [az apic api register](/cli/azure/apic/api#az-apic-api-register) command.
@@ -120,10 +121,10 @@ az apic api definition import-specification `
120121

121122
## Option 2: Import APIs directly from your API Management instance
122123

123-
The following are steps to import APIs from your API Management instance to your API center using the [az apic import-from-apim](/cli/azure/apic#az-apic-service-import-from-apim) command. This command is useful when you want to import multiple APIs from API Management to your API center, but you can also use it to import a single API.
124+
The following are steps to import APIs from your API Management instance to your API center using the [az apic import-from-apim](/cli/azure/apic#az-apic-service-import-from-apim) command. This command is useful when you want to import multiple APIs from API Management to your API center. You can also use it to import a single API.
124125

125126
When you add APIs from an API Management instance to your API center using `az apic import-from-apim`, the following happens automatically:
126-
127+
127128
* Each API's [versions](key-concepts.md#api-version), [definitions](key-concepts.md#api-definition), and [deployment](key-concepts.md#deployment) information are copied to your API center.
128129
* The API receives a system-generated API name in your API center. It retains its display name (title) from API Management.
129130
* The **Lifecycle stage** of the API is set to *Design*.
@@ -139,12 +140,13 @@ When you add APIs from an API Management instance to your API center using `az a
139140

140141
### Import APIs from API Management
141142

142-
Use the [az apic import-from-apim](/cli/azure/apic#az-apic-import-from-apim) command to import one or more APIs from your API Management instance to your API center.
143+
Use the [az apic import-from-apim](/cli/azure/apic#az-apic-import-from-apim) command to import one or more APIs from your API Management instance to your API center.
143144

144145
> [!NOTE]
146+
>
145147
> * This command depends on a managed identity configured in your API center that has read permissions to the API Management instance. If you haven't added or configured a managed identity, see [Add a managed identity in your API center](#add-a-managed-identity-in-your-api-center) earlier in this article.
146148
>
147-
> * If your API center has multiple managed identities, the command searches first for a system-assigned identity. If none is found, it picks the first user-assigned identity in the list.
149+
> * If your API center has multiple managed identities, the command searches first for a system-assigned identity. If none is found, it picks the first user-assigned identity in the list.
148150
149151
#### Import all APIs from an API Management instance
150152

@@ -166,12 +168,12 @@ az apic import-from-apim --service-name <api-center-name> --resource-group <reso
166168

167169
> [!NOTE]
168170
> If your API Management instance has a large number of APIs, import to your API center might take some time.
169-
171+
170172
#### Import a specific API from an API Management instance
171173

172-
Specify an API to import using its name from the API Management instance.
174+
Specify an API to import using its name from the API Management instance.
173175

174-
In the following command, substitute the names of your API center, your API center's resource group, your API Management instance, and your instance's resource group. Pass an API name such as `petstore-api` using the `--apim-apis` parameter.
176+
In the following command, substitute the names of your API center, your API center's resource group, your API Management instance, and your instance's resource group. Pass an API name such as `petstore-api` using the `--apim-apis` parameter.
175177

176178
```azurecli
177179
#! /bin/bash
@@ -180,7 +182,6 @@ az apic import-from-apim --service-name <api-center-name> --resource-group <reso
180182
--apim-apis 'petstore-api'
181183
```
182184

183-
184185
```azurecli
185186
# Formatted for PowerShell
186187
az apic import-from-apim --service-name <api-center-name> --resource-group <resource-group-name> `
@@ -190,13 +191,13 @@ az apic import-from-apim --service-name <api-center-name> --resource-group <reso
190191

191192
> [!NOTE]
192193
> Specify an API name using the API resource name in the API Management instance, not the display name. Example: `petstore-api` instead of `Petstore API`.
193-
194+
194195
After importing APIs from API Management, you can view and manage the imported APIs in your API center.
195196

196197
## Related content
197198

198-
* [Azure CLI reference for Azure API Center](/cli/azure/apic)
199-
* [Azure CLI reference for API Management](/cli/azure/apim)
200-
* [Manage API inventory with Azure CLI commands](manage-apis-azure-cli.md)
199+
* [Azure CLI reference for Azure API Center](/cli/azure/apic)
200+
* [Azure CLI reference for API Management](/cli/azure/apim)
201+
* [Use the Azure CLI to manage your API inventory](manage-apis-azure-cli.md)
201202
* [Assign Azure roles to a managed identity](../role-based-access-control/role-assignments-portal-managed-identity.yml)
202203
* [Azure API Management documentation](../api-management/index.yml)
-1.27 KB
Loading

articles/api-center/resources.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: Azure API Center - Code samples and labs
2+
title: Azure API Center - Code Samples and Labs
33
description: Find code samples, reference implementations, labs, and deployment templates to create, populate, and govern your Azure API center.
44
author: dlepow
55

66
ms.service: azure-api-center
77
ms.topic: concept-article
8-
ms.date: 06/11/2024
8+
ms.date: 09/25/2025
99
ms.author: danlep
1010
---
1111

@@ -15,22 +15,22 @@ This article links to open-source code resources for Azure API Center solutions.
1515

1616
## Azure Developer CLI (`azd`) samples
1717

18-
* [Azure API Center reference](https://github.com/Azure-Samples/APICenter-Reference) - Reference deployment for an API center, including integration with Azure API Management and GitHub action workflows for API registration.
18+
* [Azure API Center reference](https://github.com/Azure-Samples/APICenter-Reference): Reference deployment for an API center, including integration with Azure API Management and GitHub action workflows for API registration.
1919

20-
* [API analyzer](https://github.com/Azure/APICenter-Analyzer) - Enable linting and analysis of API definitions in your API center.
20+
* [API analyzer](https://github.com/Azure/APICenter-Analyzer): Enable linting and analysis of API definitions in your API center.
2121

22-
* [Expose SAP APIs](https://github.com/Azure-Samples/azd-apic-sap/) - Govern SAP APIs in various API management solutions in a single place with your API center.
22+
* [Expose SAP APIs](https://github.com/Azure-Samples/azd-apic-sap/): Govern SAP APIs in various API management solutions in a single place with your API center.
2323

2424
## Labs
2525

26-
* [Universal API Center labs](https://github.com/Azure-Samples/universal-api-center) - Jupyter notebooks with scripts to import APIs to an API center from diverse API management gateway solutions and sources.
26+
* [Universal API Center labs](https://github.com/Azure-Samples/universal-api-center): Jupyter notebooks with scripts to import APIs to an API center from diverse API management gateway solutions and sources.
2727

2828
## Quickstart templates
2929

30-
* [Create an API center](/samples/azure/azure-quickstart-templates/azure-api-center-create/) - Bicep and Azure Resource Manager templates to deploy an API center in your Azure subscription.
30+
* [Create an API center](/samples/azure/azure-quickstart-templates/azure-api-center-create/): Bicep and Azure Resource Manager templates to deploy an API center in your Azure subscription.
3131

3232
## Related content
3333

34-
* [Enable linting and analysis in your API center](enable-managed-api-analysis-linting.md)
35-
* [Enable the Azure API Center portal](set-up-api-center-portal.md)
34+
* [Analyze APIs in your API center - Microsoft managed](enable-managed-api-analysis-linting.md)
35+
* [Set up your API Center portal](set-up-api-center-portal.md)
3636
* [azd template library](https://azure.github.io/awesome-azd/)

articles/api-management/TOC.yml

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,8 @@
9595
href: api-management-howto-use-managed-service-identity.md
9696
- name: Send events to Event Grid
9797
href: how-to-event-grid.md
98+
- name: Reduce environmental impact
99+
href: sustainability.md
98100
- name: Network isolation
99101
items:
100102
- name: Networking options
@@ -131,8 +133,6 @@
131133
href: /azure/cloud-adoption-framework/scenarios/app-platform/api-management/landing-zone-accelerator?toc=%2Fazure%2Fapi-management%2Ftoc.json&bc=/azure/api-management/breadcrumb/toc.json
132134
- name: Manage using automation
133135
href: automation-manage-api-management.md
134-
- name: Configure using Git
135-
href: api-management-configuration-repository-git.md
136136
- name: DevOps and CI/CD
137137
href: devops-api-development-templates.md
138138
- name: Resiliency and reliability
@@ -291,6 +291,8 @@
291291
href: api-management-sample-flexible-throttling.md
292292
- name: Using external services
293293
href: api-management-sample-send-request.md
294+
- name: Send messages to Azure Service Bus
295+
href: api-management-howto-send-service-bus.md
294296
- name: Manage secrets using named values
295297
displayName: Azure CLI, az apim nv
296298
href: api-management-howto-properties.md
@@ -430,6 +432,8 @@
430432
href: developer-portal-basic-authentication.md
431433
- name: Authenticate with Microsoft Entra ID
432434
href: api-management-howto-aad.md
435+
- name: Authenticate with Microsoft Entra External ID
436+
href: api-management-howto-entra-external-id.md
433437
- name: Authenticate with Azure AD B2C
434438
href: api-management-howto-aad-b2c.md
435439
- name: Delegate authentication
@@ -597,6 +601,8 @@
597601
href: rewrite-uri-policy.md
598602
- name: send-one-way-request
599603
href: send-one-way-request-policy.md
604+
- name: send-service-bus-message
605+
href: send-service-bus-message-policy.md
600606
- name: send-request
601607
href: send-request-policy.md
602608
- name: set-backend-service

0 commit comments

Comments
 (0)