Skip to content

Commit 94465f6

Browse files
committed
fix
2 parents 526421a + 439433e commit 94465f6

File tree

1,981 files changed

+21352
-9940
lines changed

Some content is hidden

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

1,981 files changed

+21352
-9940
lines changed

.openpublishing.redirection.json

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,11 @@
55
"redirect_url": "/previous-versions/azure/private-multi-access-edge-compute-mec/index",
66
"redirect_document_id": false
77
},
8+
{
9+
"source_path": "articles/site-recovery/shared-disks-common-questions.md",
10+
"redirect_url": "/azure/site-recovery/azure-to-azure-common-questions",
11+
"redirect_document_id": false
12+
},
813
{
914
"source_path": "articles/network-watcher/traffic-analytics-schema-update.md",
1015
"redirect_url": "/previous-versions/azure/network-watcher/traffic-analytics-schema-update",
@@ -499,6 +504,11 @@
499504
"redirect_url": "/azure/security/fundamentals/azure-CA-details",
500505
"redirect_document_id": false
501506
},
507+
{
508+
"source_path": "articles/security/fundamentals/recover-from-identity-compromise.md",
509+
"redirect_url": "/azure/security/fundamentals/ransomware-detect-respond#road-to-recovery",
510+
"redirect_document_id": false
511+
},
502512
{
503513
"source_path": "articles/event-grid/event-schema-storage-actions.md",
504514
"redirect_url": "/azure/storage-actions/overview",
@@ -6968,6 +6978,26 @@
69686978
"source_path": "articles/defender-for-iot/organizations/eiot-sensor.md",
69696979
"redirect_url": "/azure/defender-for-iot/organizations/concept-enterprise",
69706980
"redirect_document_id": false
6981+
},
6982+
{
6983+
"source_path": "articles/cyclecloud/release-notes/ccws/2024.09.18.md",
6984+
"redirect_url": "/azure/cyclecloud/release-notes/ccws/2024-09-18",
6985+
"redirect_document_id": false
6986+
},
6987+
{
6988+
"source_path": "articles/cyclecloud/release-notes/ccws/2024.11.08.md",
6989+
"redirect_url": "/azure/cyclecloud/release-notes/ccws/2024-11-08",
6990+
"redirect_document_id": false
6991+
},
6992+
{
6993+
"source_path": "articles/cyclecloud/release-notes/ccws/2024.12.18.md",
6994+
"redirect_url": "/azure/cyclecloud/release-notes/ccws/2024-12-18",
6995+
"redirect_document_id": false
6996+
},
6997+
{
6998+
"source_path": "articles/cyclecloud/release-notes/ccws/2025.02.06.md",
6999+
"redirect_url": "/azure/cyclecloud/release-notes/ccws/2025-02-06",
7000+
"redirect_document_id": false
69717001
}
69727002
]
69737003
}

articles/active-directory-b2c/service-limits.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,8 @@ zone_pivot_groups: b2c-policy-type
1414

1515

1616
#Customer intent: As an Azure AD B2C user, I want to understand the service limits and restrictions, so that I can ensure that my application stays within the allowed usage constraints and request limits.
17-
17+
ms.custom:
18+
- build-2025
1819
---
1920

2021
# Azure Active Directory B2C service limits and restrictions

articles/api-center/authorize-api-access.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to configure access to APIs in the Azure API Center inven
44
author: dlepow
55
ms.service: azure-api-center
66
ms.topic: how-to
7-
ms.date: 04/30/2025
7+
ms.date: 06/02/2025
88
ms.author: danlep
99
ms.custom:
1010
# Customer intent: As an API program manager, I want to store API authorization information in my API center and enable authorized users to test APIs in the API Center portal.
@@ -57,12 +57,12 @@ To manage the API key securely, store it in Azure Key Vault, and access the key
5757

5858
| **Setting** | **Description** |
5959
|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|
60-
| **Title** | A name for the authorization. |
61-
| **Description** | Optional description for the authorization. |
60+
| **Title** | Enter a name for the authorization. |
61+
| **Description** | Optionally, enter a description for the authorization. |
6262
| **Security scheme** | Select **API Key**. |
63-
|**API key location** | How the key is presented in API requests. Available values are **Header** (request header) and **Query** (query parameter). |
64-
| **API key parameter name** | Name of the HTTP header or query parameter that contains the API key. Example: `x-api-key` |
65-
| **API key Key Vault secret reference** | Secret identifier of the API key in Azure Key Vault. Example: `https://<key-vault-name>.vault.azure.net/secrets/<secret-name>/<version>` |
63+
|**API key location** | Select how the key is presented in API requests. Available values are **Header** (request header) and **Query** (query parameter). |
64+
| **API key parameter name** | Enter the name of the HTTP header or query parameter that contains the API key. Example: `x-api-key` |
65+
| **API key Key Vault secret reference** | Click **Select** and select the subscription, key vault, and secret that you stored. Example: `https://<key-vault-name>.vault.azure.net/secrets/<secret-name>` |
6666

6767
1. Select **Create**.
6868

@@ -114,24 +114,24 @@ To manage the secret securely, store it in Azure Key Vault, and access the key v
114114
1. In the left menu, under **Governance**, select **Authorization (preview)** > **+ Add configuration**.
115115
1. In the **Add configuration** page, set the values as follows:
116116

117-
:::image type="content" source="media/authorize-api-access/configure-oauth.png" alt-text="Screenshot of configuring OAuth 2.0 in the portal.":::
117+
:::image type="content" source="media/authorize-api-access/configure-oauth.png" lightbox="media/authorize-api-access/configure-oauth.png" alt-text="Screenshot of configuring OAuth 2.0 in the portal.":::
118118

119119

120120
> [!NOTE]
121121
> Configure settings based on the app registration you created previously in your identity provider. If you're using Microsoft Entra ID, find the **Client ID** on the **Overview** page of the app registration, and find the URL endpoints on the **Overview** > **Endpoints** page.
122122
123123
| **Setting** | **Description** |
124124
|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|
125-
| **Title** | A name for the authorization. |
126-
| **Description** | Optional description for the authorization. |
125+
| **Title** | Enter a name for the authorization. |
126+
| **Description** | Optionally, enter a description for the authorization. |
127127
| **Security scheme** | Select **OAuth2**. |
128-
| **Client ID** | Client ID (GUID) of the app that you created in your identity provider. |
129-
| **Client secret** | Secret identifier of the client secret in Azure Key Vault.<br/><br/>Example: `https://<key-vault-name>.vault.azure.net/secrets/<secret-name>/<version>` |
130-
| **Authorization URL** | OAuth 2.0 authorization endpoint for the identity provider.<br/><br/>Example for Microsoft Entra ID: `https://login.microsoftonline.com/<tenant>/oauth2/v2.0/authorize` |
131-
| **Token URL** | OAuth 2.0 token endpoint for the identity provider.<br/><br/>Example for Microsoft Entra ID: `https://login.microsoftonline.com/<tenant>/oauth2/v2.0/token` |
132-
| **Refresh URL** | OAuth 2.0 token refresh endpoint for the identity provider. For most providers, same as the **Token URL**<br/><br/>Example for Microsoft Entra ID: `https://login.microsoftonline.com/<tenant>/oauth2/v2.0/token` |
133-
| **OAuth2 flow** | One or both of the OAuth 2.0 flows that you want to use. Available values are **Authorization code (PKCE)** and **Client credentials**. |
134-
| **Scopes** | One or more API scopes configured for your API, separated by spaces. If no scopes are configured, enter `.default`. |
128+
| **Client ID** | Enter the client ID (GUID) of the app that you created in your identity provider. |
129+
| **Client secret** | Click **Select** and select the subscription, key vault, and client secret that you stored.<br/><br/>Example: `https://<key-vault-name>.vault.azure.net/secrets/<secret-name>` |
130+
| **Authorization URL** | Enter the OAuth 2.0 authorization endpoint for the identity provider.<br/><br/>Example for Microsoft Entra ID: `https://login.microsoftonline.com/<tenant>/oauth2/v2.0/authorize` |
131+
| **Token URL** | Enter the OAuth 2.0 token endpoint for the identity provider.<br/><br/>Example for Microsoft Entra ID: `https://login.microsoftonline.com/<tenant>/oauth2/v2.0/token` |
132+
| **Refresh URL** | Enter the OAuth 2.0 token refresh endpoint for the identity provider. For most providers, same as the **Token URL**<br/><br/>Example for Microsoft Entra ID: `https://login.microsoftonline.com/<tenant>/oauth2/v2.0/token` |
133+
| **OAuth2 flow** | Select one or both of the OAuth 2.0 flows that you want to use. Available values are **Authorization code (PKCE)** and **Client credentials**. |
134+
| **Scopes** | Enter one or more API scopes configured for your API, separated by spaces. If no scopes are configured, enter `.default`. |
135135

136136
1. Select **Create** to save the configuration.
137137

articles/api-center/build-register-apis-vscode-extension.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: API developers can use the Azure API Center extension for Visual St
44
author: dlepow
55
ms.service: azure-api-center
66
ms.topic: how-to
7-
ms.date: 11/08/2024
7+
ms.date: 05/28/2025
88
ms.author: danlep
99
ms.collection: ce-skilling-ai-copilot
1010
ms.custom:
@@ -60,6 +60,8 @@ Use the power of [GitHub Copilot](https://marketplace.visualstudio.com/items?ite
6060
6161
:::image type="content" source="media/build-register-apis-vscode-extension/generate-api-documentation.gif" alt-text="Animation showing how to use GitHub Copilot to generate an OpenAPI spec from code." lightbox="media/build-register-apis-vscode-extension/generate-api-documentation.gif":::
6262

63+
You can also generate an OpenAPI specification from all of the files in your current project. Use the **Azure API Center: Generate OpenAPI Spec from Entire Project** command from the Command Palette.
64+
6365
After generating the OpenAPI specification file and checking for accuracy, you can register the API with your API center using the **Azure API Center: Register API** command.
6466

6567
> [!TIP]
@@ -70,6 +72,6 @@ After generating the OpenAPI specification file and checking for accuracy, you c
7072
* [Azure API Center - key concepts](key-concepts.md)
7173
* [Discover and consume APIs with the Azure API Center extension for Visual Studio Code](discover-apis-vscode-extension.md)
7274
* [Govern APIs with the Azure API Center extension for Visual Studio Code](govern-apis-vscode-extension.md)
73-
* [Enable and view API Center portal in Visual Studio Code](enable-api-center-portal-vs-code-extension.md)
75+
* [Enable API Center portal view in Visual Studio Code](enable-api-center-portal-vs-code-extension.md)
7476
* [Overview of GitHub Copilot for Azure](/azure/developer/github-copilot-azure/introduction)
7577

articles/api-center/discover-apis-vscode-extension.md

Lines changed: 21 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: API developers can use the Azure API Center extension for Visual St
44
author: dlepow
55
ms.service: azure-api-center
66
ms.topic: how-to
7-
ms.date: 10/16/2024
7+
ms.date: 05/27/2025
88
ms.author: danlep
99
ms.custom:
1010
# Customer intent: As an API developer, I want to use my Visual Studio Code environment to discover and consume APIs in my organizations API center.
@@ -21,12 +21,13 @@ API developers in your organization can discover and consume APIs in your [API c
2121
API developers can also take advantage of features in the extension to [register APIs](build-register-apis-vscode-extension.md) in the API center and ensure [API governance](govern-apis-vscode-extension.md).
2222

2323
> [!TIP]
24-
> If you want enterprise app developers to discover your APIs in a centralized location, optionally enable the read-only [API Center portal](enable-api-center-portal-vs-code-extension.md) in Visual Studio Code.
24+
> If you want enterprise app developers to discover your APIs in a centralized location, optionally enable the read-only [API Center portal view](enable-api-center-portal-vs-code-extension.md) in Visual Studio Code.
2525
2626
[!INCLUDE [vscode-extension-basic-prerequisites](includes/vscode-extension-basic-prerequisites.md)]
2727

2828
* [REST client extension](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) - to send HTTP requests and view the responses in Visual Studio Code directly
2929
* [Microsoft Kiota extension](https://marketplace.visualstudio.com/items?itemName=ms-graph.kiota) - to generate API clients
30+
- [Microsoft 365 Agents Toolkit](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.ms-teams-vscode-extension) - to create Microsoft 365 declarative agents
3031

3132
[!INCLUDE [vscode-extension-setup](includes/vscode-extension-setup.md)]
3233

@@ -36,7 +37,7 @@ API center resources appear in the tree view on the left-hand side. Expand an AP
3637

3738
:::image type="content" source="media/discover-apis-vscode-extension/explore-api-centers.png" alt-text="Screenshot of API Center tree view in Visual Studio Code." lightbox="media/discover-apis-vscode-extension/explore-api-centers.png":::
3839

39-
Search for APIs within an API Center by using the search icon shown in the **Apis** tree view item.
40+
Search for APIs within an API Center by using the search icon shown in the **APIs** tree view item.
4041

4142
## View API documentation
4243

@@ -53,7 +54,7 @@ You can view the documentation for an API definition in your API center and try
5354
> Depending on the API, you might need to provide authorization credentials or an API key to try the API.
5455
5556
> [!TIP]
56-
> Using the pre-release version of the extension, you can generate API documentation in Markdown, a format that's easy to maintain and share with end users. Right-click on the definition, and select **Generate Markdown**.
57+
> You can generate API documentation in Markdown, a format that's easy to maintain and share with end users. Right-click on the definition, and select **Generate Markdown**.
5758
5859
## Generate HTTP file
5960

@@ -103,10 +104,24 @@ You can also export a specification using the Command Palette:
103104
1. Select **Azure API Center: Export API Specification Document**.
104105
1. Make selections to navigate to an API definition. A new tab appears that renders an API specification document.
105106

106-
## Related content
107+
108+
## Create M365 declarative agent
109+
110+
You can create a [declarative agent for Microsoft 365 Copilot](/microsoft-365-copilot/extensibility/overview-declarative-agent) from an OpenAPI definition in your API center. With a declarative agent, you customize Microsoft 365 Copilot to help you meet the unique business needs of your users. When you build a declarative agent, you provide the instructions, actions, and knowledge to tailor Copilot for your business scenarios.
111+
112+
To export a declarative agent in the extension's tree view:
113+
114+
1. Expand the API Center tree view to show an OpenAPI definition.
115+
1. Right-click on the definition, and select **Export M365 Declarative Agent**.
116+
1. When prompted:
117+
1. Select one or more API operations that Copilot can interact with.
118+
1. Select a workspace folder.
119+
1. Enter an application name.
120+
121+
The declarative agent is created in the selected workspace folder. Use the Microsoft 365 Agents Toolkit to further customize and deploy the agent.
107122

108123
* [Azure API Center - key concepts](key-concepts.md)
109124
* [Build and register APIs with the Azure API Center extension for Visual Studio Code](build-register-apis-vscode-extension.md)
110125
* [Govern APIs with the Azure API Center extension for Visual Studio Code](govern-apis-vscode-extension.md)
111-
* [Enable and view API Center portal in Visual Studio Code](enable-api-center-portal-vs-code-extension.md)
126+
* [Enable API Center portal view in Visual Studio Code](enable-api-center-portal-vs-code-extension.md)
112127

0 commit comments

Comments
 (0)