Merge pull request #307130 from MicrosoftDocs/main

Auto Publish – main to live - 2025-10-20 17:00 UTC

Author: learn-build-service-prod[bot]

.openpublishing.redirection.json

@@ -3209,6 +3209,11 @@
       "redirect_url": "/azure/api-management/monitor-api-management",
       "redirect_document_id": false
     },
+    {
+      "source_path_from_root": "/articles/api-management/api-management-key-concepts-experiment.md",
+      "redirect_url": "/azure/api-management/api-management-key-concepts",
+      "redirect_document_id": false
+    },
     {
       "source_path_from_root": "/articles/vpn-gateway/vpn-gateway-cross-premises-options.md",
       "redirect_url": "/previous-versions/azure/vpn-gateway/vpn-gateway-about-vpn-gateway-settings",

articles/api-center/.openpublishing.redirection.json

@@ -4,7 +4,21 @@
             "source_path_from_root": "/articles/api-center/use-vscode-extension.md",
             "redirect_url": "/azure/api-center/build-register-apis-vscode-extension",
             "redirect_document_id": false
+        },
+        {
+            "source_path_from_root": "/articles/api-center/add-metadata-properties.md",
+            "redirect_url": "tutorials/add-metadata-properties",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/api-center/configure-environments-deployments.md",
+            "redirect_url": "tutorials/configure-environments-deployments",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/api-center/register-apis.md",
+            "redirect_url": "tutorials/register-apis",
+            "redirect_document_id": true
         }
-
     ]
 }

articles/api-center/TOC.yml

@@ -28,11 +28,11 @@
   - name: Tutorials
     items:
     - name: 1 - Define custom metadata
-      href: add-metadata-properties.md
+      href: ./tutorials/add-metadata-properties.md
     - name: 2 - Add APIs to the inventory
-      href: register-apis.md
+      href: ./tutorials/register-apis.md
     - name: 3 - Add environments and deployments
-      href: configure-environments-deployments.md
+      href: ./tutorials/configure-environments-deployments.md
   expanded: true
 - name: API inventory
   items:

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

@@ -26,9 +26,9 @@ You can configure settings to authorize access to APIs in your [API center](over
 
 * An API center in your Azure subscription. If you haven't created one already, see [Quickstart: Create your API center](set-up-api-center.md).
 
-* Register at least one API in your API center. For more information, see [Tutorial: Register APIs in your API inventory](register-apis.md).
+* Register at least one API in your API center. For more information, see [Tutorial: Register APIs in your API inventory](./tutorials/register-apis.md).
 
-* Configure an environment and a deployment for the API. For more information, see [Tutorial: Add environments and deployments for APIs](configure-environments-deployments.md).
+* Configure an environment and a deployment for the API. For more information, see [Tutorial: Add environments and deployments for APIs](./tutorials/configure-environments-deployments.md).
 
 * Set up the API Center portal. For more information, see [Set up API Center portal](set-up-api-center-portal.md).
 

articles/api-center/enable-api-analysis-linting.md

@@ -293,7 +293,7 @@ Now create an event subscription in your API center to trigger the function app
 
 To test the event subscription, try uploading or updating an API definition file associated with an API version in your API center. For example, upload an OpenAPI or AsyncAPI document. After the event subscription is triggered, the function app invokes the API linting engine to analyze the API definition.
 
-* For detailed steps to add an API, API version, and API definition to your API center, see [Tutorial: Register APIs in your API center](register-apis.md).
+* For detailed steps to add an API, API version, and API definition to your API center, see [Tutorial: Register APIs in your API center](./tutorials/register-apis.md).
 * To create an API by uploading an API definition file using the Azure CLI, see [Register API from a specification file](manage-apis-azure-cli.md#register-api-from-a-specification-file---single-step).
 
 To confirm that the event subscription was triggered:

articles/api-center/export-to-copilot-studio.yml

@@ -26,7 +26,7 @@ prerequisites:
 
   dependencies:
     - An API center instance. You can [create one](set-up-api-center.md) in the Azure portal.
-    - An API registered in the API center inventory. The API must have a version associated with a [deployment](configure-environments-deployments.md), and it must have an API definition in OpenAPI 2.0 format.
+    - An API registered in the API center inventory. The API must have a version associated with a [deployment](./tutorials/configure-environments-deployments.md), and it must have an API definition in OpenAPI 2.0 format.
     - A Power Platform [environment](/power-apps/powerapps-overview#power-apps-for-admins).
     - A Microsoft Copilot Studio [license](/microsoft-copilot-studio/requirements-licensing-subscriptions).
 

articles/api-center/includes/quickstart-next-steps.md

@@ -16,4 +16,4 @@ ms.custom: Include file
 Now you can start adding information to the inventory in your API center. To help you organize your APIs and other information, begin by defining custom metadata in your API center.
 
 > [!div class="nextstepaction"]
-> [Define custom metadata](../add-metadata-properties.md)
+> [Define custom metadata](.././tutorials/add-metadata-properties.md)

articles/api-center/includes/synchronized-properties-api-source.md

@@ -10,16 +10,16 @@ ms.date: 01/08/2025
 ms.author: danlep
 ms.custom: Include file
 ---
-You can add or update metadata properties and documentation to the synchronized APIs in your API center to help stakeholders discover, understand, and consume the APIs. Learn more about Azure API Center's [built-in and custom metadata properties](../add-metadata-properties.md).
+You can add or update metadata properties and documentation to the synchronized APIs in your API center to help stakeholders discover, understand, and consume the APIs. Learn more about Azure API Center's [built-in and custom metadata properties](.././tutorials/add-metadata-properties.md).
 
 The following table shows entity properties that can be modified in Azure API Center and properties that are set based on their values in the API source. 
 
 | Entity       | Properties configurable in API Center                     | Properties determined in integrated API source                                           |
 |--------------|-----------------------------------------|-----------------|
-| API          | summary<br/>lifecycleStage<br/>termsOfService<br/>license<br/>externalDocumentation<br/>customProperties    | title<br/>description<br/>kind                   |
-| API version  | lifecycleStage      | title<br/>definitions (if synchronized)                            |
-| Environment  | title<br/>description<br/>kind</br>server.managementPortalUri<br/>onboarding<br/>customProperties      | server.type
-| Deployment   |  title<br/>description<br/>server<br/>state<br/>customProperties    |      server.runtimeUri |
+| API          | summary<br />lifecycleStage<br />termsOfService<br />license<br />externalDocumentation<br />customProperties    | title<br />description<br />kind                   |
+| API version  | lifecycleStage      | title<br />definitions (if synchronized)                            |
+| Environment  | title<br />description<br />kind</br>server.managementPortalUri<br />onboarding<br />customProperties      | server.type
+| Deployment   |  title<br />description<br />server<br />state<br />customProperties    |      server.runtimeUri |
 
 > [!NOTE]
 > Resource and system IDs for entities synchronized to Azure API Center are automatically generated and can't be changed.

articles/api-center/index.yml

@@ -42,11 +42,11 @@ landingContent:
       - linkListType: tutorial
         links:
           - text: 1 - Customize metadata properties
-            url: add-metadata-properties.md
+            url: ././tutorials/add-metadata-properties.md
           - text: 2 - Add APIs to the inventory
-            url: register-apis.md
+            url: ././tutorials/register-apis.md
           - text: 3 - Add environments and deployments
-            url: configure-environments-deployments.md
+            url: ././tutorials/configure-environments-deployments.md
       - linkListType: how-to-guide
         links:
           - text: Manage inventory - Azure CLI

articles/api-center/metadata.md

@@ -49,7 +49,7 @@ The following tables list built-in metadata provided for Azure API Center entiti
 
 ## Custom metadata
 
-Define custom metadata using the [Azure portal](add-metadata-properties.md), the Azure API Center [REST API](/rest/api/resource-manager/apicenter/metadata-schemas), or the [Azure CLI](/cli/azure/apic/metadata) to help organize and filter APIs, environments, and deployments in your API center. Azure API Center supports custom metadata of the following types. 
+Define custom metadata using the [Azure portal](././tutorials/add-metadata-properties.md), the Azure API Center [REST API](/rest/api/resource-manager/apicenter/metadata-schemas), or the [Azure CLI](/cli/azure/apic/metadata) to help organize and filter APIs, environments, and deployments in your API center. Azure API Center supports custom metadata of the following types. 
 
 Type | Description | Example name |
 |--------|----------|-------------|
@@ -87,4 +87,4 @@ Use built-in and custom metadata to organize your APIs, environments, and deploy
 
 * [What is Azure API Center?](overview.md)
 * [API Center - key concepts](key-concepts.md)
-* [Tutorial: Define custom metadata](add-metadata-properties.md)
+* [Tutorial: Define custom metadata](././tutorials/add-metadata-properties.md)