Skip to content

Commit 98bfce1

Browse files
committed
resolve conflict
2 parents b692c44 + d3a3979 commit 98bfce1

File tree

2,037 files changed

+20543
-15957
lines changed

Some content is hidden

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

2,037 files changed

+20543
-15957
lines changed

.openpublishing.redirection.json

Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,75 @@
11
{
22
"redirections": [
3+
{
4+
"source_path": "articles/databox-online/azure-stack-edge-gpu-deploy-sample-module-marketplace.md",
5+
"redirect_url": "https://azuremarketplace.microsoft.com/marketplace/apps?page=1",
6+
"redirect_document_id": false
7+
},
8+
{
9+
"source_path": "articles/partner-solutions/logzio/create.md",
10+
"redirect_url": "/previous-versions/azure/partner-solutions/logzio/create",
11+
"redirect_document_id": false
12+
},
13+
{
14+
"source_path": "articles/partner-solutions/logzio/manage.md",
15+
"redirect_url": "/previous-versions/azure/partner-solutions/logzio/manage",
16+
"redirect_document_id": false
17+
},
18+
{
19+
"source_path": "articles/partner-solutions/logzio/overview.md",
20+
"redirect_url": "/previous-versions/azure/partner-solutions/logzio/overview",
21+
"redirect_document_id": false
22+
},
23+
{
24+
"source_path": "articles/partner-solutions/logzio/setup-sso.md",
25+
"redirect_url": "/previous-versions/azure/partner-solutions/logzio/setup-sso",
26+
"redirect_document_id": false
27+
},
28+
{
29+
"source_path": "articles/partner-solutions/logzio/troubleshoot.md",
30+
"redirect_url": "/previous-versions/azure/partner-solutions/logzio/troubleshoot",
31+
"redirect_document_id": false
32+
},
33+
{
34+
"source_path_from_root": "/articles/hdinsight-aks/index.yml",
35+
"redirect_url": "/previous-versions/azure/hdinsight-aks",
36+
"redirect_document_id": false
37+
},
38+
{
39+
"source_path_from_root": "/articles/hdinsight-aks/flink/index.md",
40+
"redirect_url": "/previous-versions/azure/hdinsight-aks/flink/flink-overview",
41+
"redirect_document_id": false
42+
},
43+
{
44+
"source_path_from_root": "/articles/hdinsight-aks/prerequisites-subscription.md",
45+
"redirect_url": "/previous-versions/azure/hdinsight-aks/quickstart-prerequisites-subscription",
46+
"redirect_document_id": false
47+
},
48+
{
49+
"source_path_from_root": "/articles/hdinsight-aks/release-notes/index.md",
50+
"redirect_url": "/previous-versions/azure/hdinsight-aks/release-notes/hdinsight-aks-release-notes",
51+
"redirect_document_id": false
52+
},
53+
{
54+
"source_path_from_root": "/articles/hdinsight-aks/prerequisites-resources.md",
55+
"redirect_url": "/previous-versions/azure/hdinsight-aks/quickstart-prerequisites-resources",
56+
"redirect_document_id": false
57+
},
58+
{
59+
"source_path_from_root": "/articles/hdinsight-aks/spark/index.md",
60+
"redirect_url": "/previous-versions/azure/hdinsight-aks/spark/hdinsight-on-aks-spark-overview",
61+
"redirect_document_id": false
62+
},
63+
{
64+
"source_path_from_root": "/articles/hdinsight-aks/get-started.md",
65+
"redirect_url": "/previous-versions/azure/hdinsight-aks/quickstart-get-started",
66+
"redirect_document_id": false
67+
},
68+
{
69+
"source_path_from_root": "/articles/hdinsight-aks/trino/index.md",
70+
"redirect_url": "/previous-versions/azure/hdinsight-aks/trino/trino-overview ",
71+
"redirect_document_id": false
72+
},
373
{
474
"source_path": "articles/hdinsight-aks/cluster-storage.md",
575
"redirect_url": "/previous-versions/azure/hdinsight-aks/cluster-storage",
@@ -1020,6 +1090,11 @@
10201090
"redirect_url": "/azure/migrate/discover-and-assess-using-private-endpoints",
10211091
"redirect_document_id": false
10221092
},
1093+
{
1094+
"source_path": "articles/operator-call-protection/index.yml",
1095+
"redirect_url": "https://learn.microsoft.com",
1096+
"redirect_document_id": false
1097+
},
10231098
{
10241099
"source_path": "articles/operator-5g-core/index.yml",
10251100
"redirect_url": "https://learn.microsoft.com",
@@ -1980,6 +2055,21 @@
19802055
"redirect_url": "./azure-resource-manager/management/deployment-models",
19812056
"redirect_document_id": false
19822057
},
2058+
{
2059+
"source_path_from_root": "/articles/azure-functions/functions-add-output-binding-storage-queue-java.md",
2060+
"redirect_url": "/azure/azure-functions/functions-add-output-binding-storage-queue-cli?pivots=programming-language-java",
2061+
"redirect_document_id": false
2062+
},
2063+
{
2064+
"source_path_from_root": "/articles/azure-functions/create-first-function-arc-custom-container.md",
2065+
"redirect_url": "/azure/azure-functions/functions-how-to-custom-container?pivots=azure-arc",
2066+
"redirect_document_id": false
2067+
},
2068+
{
2069+
"source_path_from_root": "/articles/azure-functions/create-first-function-arc-cli.md",
2070+
"redirect_url": "/azure/azure-functions/functions-how-to-custom-container?pivots=azure-arc",
2071+
"redirect_document_id": false
2072+
},
19832073
{
19842074
"source_path_from_root": "/articles/azure-functions/create-first-function-vs-code-web.md",
19852075
"redirect_url": "/azure/azure-functions",
@@ -5154,11 +5244,21 @@
51545244
"redirect_url": "/azure/virtual-wan/virtual-wan-about",
51555245
"redirect_document_id": false
51565246
},
5247+
{
5248+
"source_path_from_root": "/articles/virtual-wan/openvpn-azure-ad-client.md",
5249+
"redirect_url": "/azure/virtual-wan/point-to-site-entra-vpn-client-windows",
5250+
"redirect_document_id": false
5251+
},
51575252
{
51585253
"source_path_from_root": "/articles/virtual-wan/high-availability-vpn-client.md",
51595254
"redirect_url": "/azure/virtual-wan/global-hub-profile",
51605255
"redirect_document_id": false
51615256
},
5257+
{
5258+
"source_path_from_root": "/articles/virtual-wan/howto-openvpn-clients.md",
5259+
"redirect_url": "/azure/virtual-wan/point-to-site-vpn-client-certificate-windows-openvpn-client-version-3",
5260+
"redirect_document_id": false
5261+
},
51625262
{
51635263
"source_path_from_root": "/articles/virtual-wan/logs-metrics.md",
51645264
"redirect_url": "/azure/virtual-wan/monitor-virtual-wan",
@@ -5828,6 +5928,16 @@
58285928
"source_path_from_root": "/articles/reliability/reliability-hdinsight-on-aks.md",
58295929
"redirect_url": "/azure/reliability/overview-reliability-guidance",
58305930
"redirect_document_id": false
5931+
},
5932+
{
5933+
"source_path_from_root": "/articles/managed-grafana/concept-role-based-access-control.md",
5934+
"redirect_url": "/azure/managed-grafana/how-to-manage-access-permissions-users-identities",
5935+
"redirect_document_id": false
5936+
},
5937+
{
5938+
"source_path_from_root": "/articles/managed-grafana/how-to-share-grafana-workspace.md",
5939+
"redirect_url": "/azure/managed-grafana/how-to-manage-access-permissions-users-identities",
5940+
"redirect_document_id": false
58315941
}
58325942
]
58335943
}

articles/active-directory-b2c/tutorial-create-user-flows.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -210,10 +210,12 @@ Next, specify that the application should be treated as a public client:
210210
1. In the left menu, under **Manage**, select **Authentication**.
211211
1. Under **Advanced settings**, in the **Allow public client flows** section, set **Enable the following mobile and desktop flows** to **Yes**.
212212
1. Select **Save**.
213-
1. Ensure that **"allowPublicClient": true** is set in the application manifest:
213+
1. Ensure that **"isFallbackPublicClient": true** is set in the application manifest:
214214
1. In the left menu, under **Manage**, select **Manifest** to open application manifest.
215+
1. Switch from the **Microsoft Graph App Manifest (New)** tab to the **AAD Graph App Manifest (Deprecating Soon)** tab.
215216
1. Find **allowPublicClient** key and ensure its value is set to **true**.
216217

218+
217219
Now, grant permissions to the API scope you exposed earlier in the *IdentityExperienceFramework* registration:
218220

219221
1. In the left menu, under **Manage**, select **API permissions**.

articles/active-directory-b2c/whats-new-docs.md

Lines changed: 7 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "What's new in Azure Active Directory business-to-customer (B2C)"
33
description: "New and updated documentation for the Azure Active Directory business-to-customer (B2C)."
4-
ms.date: 01/10/2025
4+
ms.date: 02/04/2025
55
ms.service: azure-active-directory
66
ms.subservice: b2c
77
ms.topic: whats-new
@@ -17,6 +17,12 @@ manager: CelesteDG
1717

1818
Welcome to what's new in Azure Active Directory B2C documentation. This article lists new and significantly updated docs from the past three months. To learn what's new with the B2C service, see [What's new in Microsoft Entra ID](../active-directory/fundamentals/whats-new.md), [Azure AD B2C developer release notes](custom-policy-developer-notes.md) and [What's new in Microsoft Entra External ID](/entra/external-id/whats-new-docs).
1919

20+
## January 2025
21+
22+
### Updated articles
23+
24+
- [Azure Active Directory B2C service limits and restrictions](service-limits.md) - Updated limits
25+
2026
## December 2024
2127

2228
### Updated articles
@@ -29,12 +35,3 @@ Welcome to what's new in Azure Active Directory B2C documentation. This article
2935

3036
- [Azure Active Directory B2C: Region availability & data residency](data-residency.md) - Updated data residency location
3137

32-
## October 2024
33-
34-
### Updated articles
35-
36-
- [Secure APIs used for API connectors in Azure AD B2C](secure-rest-api.md) - Flow updates
37-
- [Application types that can be used in Active Directory B2C](application-types.md) - Implicit grant flow updates
38-
- [Configure authentication in a sample single-page application by using Azure AD B2C](configure-authentication-sample-spa-app.md) - Implicit grant flow updates
39-
- [Single-page application sign-in using the OAuth 2.0 implicit flow in Azure Active Directory B2C](implicit-flow-single-page-application.md) - Implicit grant flow updates
40-
- [Register a single-page application in Azure Active Directory B2C](tutorial-register-spa.md) - Implicit grant flow updates

articles/api-center/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,8 @@
4646
href: synchronize-aws-gateway-apis.md
4747
- name: Build and register APIs - VS Code extension
4848
href: build-register-apis-vscode-extension.md
49+
- name: Design and develop APIs - GitHub Copilot for Azure
50+
href: design-api-github-copilot-azure.md
4951
- name: Register APIs - GitHub Actions
5052
href: register-apis-github-actions.md
5153
- name: API governance

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

Lines changed: 2 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,6 @@ API producer developers in your organization can build and register APIs in your
1717

1818
* Add an existing API to an API center as a one-time operation, or integrate a development pipeline to register APIs as part of a CI/CD workflow.
1919
* Use GitHub Copilot to generate new OpenAPI specs from API code.
20-
* Use natural language prompts with the API Center plugin for GitHub Copilot for Azure to create new OpenAPI specs.
2120

2221
API consumer developers can also take advantage of features in the extension to [discover and consume APIs](discover-apis-vscode-extension.md) in the API center and ensure [API governance](govern-apis-vscode-extension.md).
2322

@@ -28,7 +27,6 @@ The following Visual Studio Code extensions are needed for the specified scenari
2827
* [GitHub Actions](https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-github-actions) - to register APIs using a CI/CD pipeline with GitHub Actions
2928
* [Azure Pipelines](https://marketplace.visualstudio.com/items?itemName=ms-azure-devops.azure-pipelines) - to register APIs using a CI/CD pipeline with Azure Pipelines
3029
* [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) - to generate OpenAPI specification files from API code
31-
* [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)
3230

3331
[!INCLUDE [vscode-extension-setup](includes/vscode-extension-setup.md)]
3432

@@ -64,33 +62,8 @@ Use the power of [GitHub Copilot](https://marketplace.visualstudio.com/items?ite
6462

6563
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.
6664

67-
## Generate OpenAPI spec using natural language prompts
68-
69-
The API Center plugin for [GitHub Copilot for Azure](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) (preview) helps you design new APIs starting from natural language prompts. With AI assistance, quickly generate an OpenAPI spec for API development that complies with your organization's standards.
70-
71-
> [!NOTE]
72-
> This feature is available in the pre-release version of the API Center extension.
73-
74-
1. If desired, set an active API style guide. Use the **Ctrl+Shift+P** keyboard shortcut to open the Command Palette. Type **Azure API Center: Set API Style Guide**, make a selection, and hit **Enter**.
75-
76-
If no style guide is set, the default `spectral:oas` ruleset is used.
77-
1. In the chat panel, make a request in natural language to the `@azure` agent to describe what the API does. Example:
78-
79-
```vscode
80-
@azure Generate OpenAPI spec: An API that allows customers to pay for an order using various payment methods such as cash, checks, credit cards, and debit cards.
81-
```
82-
83-
The agent responds with an OpenAPI specification document.
84-
85-
:::image type="content" source="media/build-register-apis-vscode-extension/generate-api-specification.png" alt-text="Screenshot showing how to use @azure extension to generate an OpenAPI spec from a prompt.":::
86-
87-
88-
1. Review the generated output for accuracy and compliance with your API style guide. Refine the prompt if needed to regenerate.
89-
90-
> [!TIP]
91-
> Effective prompts focus on an API's business requirements rather than implementation details. Shorter prompts sometimes work better than longer ones.
92-
1. When it meets your requirements, save the generated OpenAPI specification to a file.
93-
1. Register the API with your API center. Select **Register your API in API Center** button in the chat panel, or select **Azure API Center: Register API** from the Command Palette, and follow the prompts.
65+
> [!TIP]
66+
> API developers can also generate new OpenAPI specs using natural language prompts with the API Center plugin for GitHub Copilot for Azure. [Learn more](design-api-github-copilot-azure.md).
9467
9568
## Related content
9669

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
---
2+
title: Develop APIs with GitHub Copilot for Azure - API Center plugin
3+
description: With AI assistance, API developers can use the Azure API Center plugin for GitHub Copilot for Azure to design and develop compliant APIs.
4+
author: dlepow
5+
ms.service: azure-api-center
6+
ms.topic: how-to
7+
ms.date: 02/10/2025
8+
ms.author: danlep
9+
ms.collection: ce-skilling-ai-copilot
10+
ms.custom:
11+
# Customer intent: As an API developer, I want to use my Visual Studio Code environment and GitHub Copilot for Azure to generate Open API specs from natural language prompts.
12+
---
13+
14+
# Design and develop APIs using API Center plugin for GitHub Copilot for Azure
15+
16+
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+
18+
> [!NOTE]
19+
> This feature is available in the pre-release version of the API Center extension.
20+
21+
[!INCLUDE [vscode-extension-basic-prerequisites](includes/vscode-extension-basic-prerequisites.md)]
22+
* [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)
23+
24+
[!INCLUDE [vscode-extension-setup](includes/vscode-extension-setup.md)]
25+
26+
## Make request to the @azure agent
27+
28+
Follow these steps to generate an OpenAPI specification using natural language prompts with GitHub Copilot for Azure:
29+
30+
1. If desired, set an active API style guide in the Azure API Center extension. Use the **Ctrl+Shift+P** keyboard shortcut to open the Command Palette. Type **Azure API Center: Set API Style Guide**, make a selection, and hit **Enter**.
31+
32+
If no style guide is set, the default `spectral:oas` ruleset is used. Learn more about [API specification linting](govern-apis-vscode-extension.md#api-design-conformance) using the API Center extension.
33+
1. In the chat panel, make a request in natural language to the `@azure` agent to describe what the API does. Example:
34+
35+
```copilot-prompt
36+
@azure Generate an OpenAPI spec: An API that allows customers to pay for an order using various payment methods such as cash, checks, credit cards, and debit cards. Check that there are no duplicate keys.
37+
```
38+
39+
Copilot is powered by AI, so surprises and mistakes are possible. For more information, see Copilot FAQs.
40+
41+
The agent responds with an OpenAPI specification document.
42+
43+
:::image type="content" source="media/design-api-github-copilot-azure/generate-api-specification.png" alt-text="Screenshot showing how to use @azure extension to generate an OpenAPI spec from a prompt.":::
44+
45+
1. Review the generated output for accuracy, completeness, and compliance with your API style guide.
46+
47+
Refine the prompt if needed to regenerate the spec, or repeat the process using a different style guide that you set in the Azure API Center extension.
48+
49+
> [!TIP]
50+
> Effective prompts focus on an API's business requirements rather than implementation details. Shorter prompts sometimes work better than longer ones.
51+
52+
1. When it meets your requirements, save the generated OpenAPI specification to a file.
53+
54+
## Register the API in your API center
55+
56+
Use the Azure API Center extension for VS Code to register the API in your API center from the generated specification file. After registering the API, you can use the extension to view the API documentation, generate an HTTP client, perform further linting and analysis, and more.
57+
58+
59+
1. In VS Code, select **Register your API in API Center** button in the chat panel, or select **Azure API Center: Register API** from the Command Palette.
60+
61+
1. Select **Manual**.
62+
63+
1. Select the API center to register APIs with.
64+
65+
1. Answer prompts with information including API title, type, version title, version lifecycle, definition title, specification name, and definition (specification) file to complete API registration.
66+
67+
After the API is registered, you can perform various tasks using the extension. For example, [view API documentation](discover-apis-vscode-extension.md#view-api-documentation) in the Swagger UI:
68+
69+
1. Expand the API Center tree view to select the definition for the API version that you registered.
70+
71+
1. Right-click on the definition, and select **Open API Documentation**. A new tab appears with the Swagger UI for the API definition.
72+
73+
:::image type="content" source="media/design-api-github-copilot-azure/view-definition-swagger-ui.png" alt-text="Screenshot of the Swagger UI in the VS Code extension.":::
74+
75+
## Related content
76+
77+
* [Azure API Center - key concepts](key-concepts.md)
78+
* [Build and register APIs with the Azure API Center extension for Visual Studio Code](build-register-apis-vscode-extension.md)
79+
* [Discover and consume APIs with the Azure API Center extension for Visual Studio Code](discover-apis-vscode-extension.md)
80+
* [Govern APIs with the Azure API Center extension for Visual Studio Code](govern-apis-vscode-extension.md)
81+
* [Enable and view platform API catalog in Visual Studio Code](enable-platform-api-catalog-vscode-extension.md)
82+
* [Overview of GitHub Copilot for Azure](/azure/developer/github-copilot-azure/introduction)
83+

0 commit comments

Comments
 (0)