Merge pull request #272017 from MicrosoftDocs/release-ga-api-center

 Release-ga-api-center --> main

Author: huypub

articles/api-center/TOC.yml

@@ -5,20 +5,24 @@
   items:
     - name: Overview
       items:
-      - name: What is API Center?
+      - name: What is Azure API Center?
         displayName: Overview
         href: overview.md
       - name: Key concepts
         href: key-concepts.md  
       - name: Service limits
-        href: ../azure-resource-manager/management/azure-subscription-service-limits.md#api-center-preview-limits
+        href: ../azure-resource-manager/management/azure-subscription-service-limits.md?toc=/azure/api-center/toc.json&bc=/azure/api-center/breadcrumb/toc.json#api-center-limits
+      - name: Frequently asked questions
+        href: frequently-asked-questions.yml    
     - name: Quickstarts
       items:
-          - name: Create an API center
+          - name: Create an API center - portal
             href: set-up-api-center.md
+          - name: Create an API center - CLI
+            href: set-up-api-center-azure-cli.md
     - name: Tutorials
       items:
-          - name: 1 - Customize metadata properties
+          - name: 1 - Define custom metadata
             href: add-metadata-properties.md
           - name: 2 - Add APIs to the inventory
             href: register-apis.md
@@ -30,18 +34,24 @@
         href: manage-apis-azure-cli.md
       - name: Import APIs from API Management
         href: import-api-management-apis.md
+      - name: Build and register APIs - VS Code extension
+        href: use-vscode-extension.md
 - name: API governance
   items:
+      - name: Use metadata for governance
+        href: metadata.md
       - name: Analyze APIs using linting rules
         href: enable-api-analysis-linting.md
 - name: API discovery and consumption
   items:
-      - name: Enable API Center portal
+      - name: Self-host Azure API Center portal
         href: enable-api-center-portal.md
-      - name: Use VS Code extension
-        href: use-vscode-extension.md
       - name: Discover APIs with GitHub Copilot Chat
         href: use-vscode-extension-copilot.md
+- name: API center management and operations
+  items:
+      - name: Reliability
+        href: ../reliability/reliability-api-center.md?toc=/azure/api-center/toc.json&bc=/azure/api-center/breadcrumb/toc.json
 - name: Reference
   items:
       - name: Azure CLI
@@ -57,6 +67,8 @@
           - name: Python
             href: https://pypi.org/project/azure-mgmt-apicenter
       - name: Event Grid schema
-        href: ../event-grid/event-schema-api-center.md
+        href: ../event-grid/event-schema-api-center.md?toc=/azure/api-center/toc.json&bc=/azure/api-center/breadcrumb/toc.json
       - name: Resource Manager template
-        href: /azure/templates/microsoft.apicenter/allversions
+        href: /azure/templates/microsoft.apicenter/allversions
+      - name: Azure built-in roles
+        href: ../role-based-access-control/built-in-roles.md?toc=/azure/api-center/toc.json&bc=/azure/api-center/breadcrumb/toc.json#integration

articles/api-center/add-metadata-properties.md

@@ -1,91 +1,89 @@
 ---
-title: Tutorial - Customize metadata properties in Azure API Center (preview) | Microsoft Docs
-description: In this tutorial, define custom metadata properties in your API center. Use custom and built-in properties to organize your APIs.
+title: Tutorial - Define custom metadata for API governance
+description: In this tutorial, define custom metadata in your API center. Use custom and built-in metadata to organize and govern your APIs.
 author: dlepow
 ms.service: api-center
 ms.topic: tutorial
-ms.date: 11/07/2023
+ms.date: 04/19/2024
 ms.author: danlep 
+#customer intent: As the owner of an Azure API center, I want a step by step introduction to configure custom metadata properties to govern my APIs.
 ---
 
-# Tutorial: Customize metadata properties
+# Tutorial: Define custom metadata
 
-In this tutorial, define custom properties to help you organize your APIs and other information in your API center. Use custom metadata properties and several built-in properties for search and filtering and to enforce governance standards in your organization. 
+In this tutorial, define custom metadata to help you organize your APIs and other information in your API center. Use custom and built-in metadata for search and filtering and to enforce governance standards in your organization. 
 
-For background information about the metadata schema in API Center, see [Key concepts](key-concepts.md).
+For background information about metadata in Azure API Center, see:
+
+* [Key concepts](key-concepts.md#metadata)
+* [Metadata for API governance](metadata.md)
 
 In this tutorial, you learn how to use the portal to:
 > [!div class="checklist"]
-> * Define custom metadata properties in your API center
+> * Define custom metadata in your API center
 > * View the metadata schema
 
-[!INCLUDE [api-center-preview-feedback](includes/api-center-preview-feedback.md)]
-
 ## Prerequisites
 
 * 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).
 
-## Define properties in the metadata schema
+## Define metadata
 
-You organize your API inventory by setting values of metadata properties. While several common properties such as "API type" and "Version lifecycle" are available out of the box, each API center provides a configurable metadata schema so you can add properties that are specific to your organization. 
+Here you define two custom metadata examples: *Line of business* and *Public-facing*; if you prefer, define other metadata of your own. When you add or update APIs and other information in your inventory, you'll set values for custom and any common built-in metadata.
 
-Here you define two example properties: *Line of business* and *Public-facing*; if you prefer, define other properties of your own. When you add or update APIs and other information in your inventory, you'll set values for these properties and any common built-in properties.
+[!INCLUDE [metadata-sensitive-data](includes/metadata-sensitive-data.md)]
 
-> [!IMPORTANT]
-> Take care not to include any sensitive, confidential, or personal information in the titles (names) of metadata properties you define. These titles are visible in monitoring logs that are used by Microsoft to improve the functionality of the service. However, other metadata details and values are your protected customer data. 
+1. In the [Azure portal](https://portal.azure.com), navigate to your API center.
 
-1. In the left menu, select **Metadata schema > + Add property**. 
+1. In the left menu, under **Assets**, select **Metadata > + New metadata**. 
 
-1. On the **Details** tab, enter information about the property. 
+1. On the **Details** tab, enter information about the metadata. 
 
     1. In **Title**, enter *Line of business*. 
 
-    1. Select type **Predefined choices** and enter choices such as *Marketing, Finance, IT, Sales*, and so on. Optionally enable **Allow selection of multiple values**. 
+    1. Optionally, enter a **Description**.
 
-    :::image type="content" source="media/add-metadata-properties/metadata-property-details.png" alt-text="Screenshot of metadata schema property in the portal.":::
+    1. Select type **Predefined choices** and enter choices such as *Marketing, Finance, IT, Sales*, and so on. Optionally enable **Allow selection of multiple values**. Select **Next**.
 
-1. On the **Assignments** tab, select **Required** for APIs. Select **Optional** for Deployments and Environments. (You'll add these entities in later tutorials.)
+    :::image type="content" source="media/add-metadata-properties/metadata-property-details.png" alt-text="Screenshot of adding custom metadata in the portal.":::
 
-    :::image type="content" source="media/add-metadata-properties/metadata-property-assignments.png" alt-text="Screenshot of metadata property assignments in the portal.":::
+1. On the **Assignments** tab, select **Required** for APIs. Select **Optional** for Deployments and Environments. (You'll add these entities in later tutorials.) Select **Next**.
 
-1. On the **Review + Create** tab, review the settings and select **Create**. 
+    :::image type="content" source="media/add-metadata-properties/metadata-property-assignments.png" alt-text="Screenshot of metadata assignments in the portal." :::
+
+1. On the **Review + create** tab, review the settings and select **Create**. 
 
-    The property is added to the list. 
+    The metadata is added to the list on the **Metadata** page. 
 
-1. Select **+ Add property** to add another property.
+1. Select **+ New metadata** to add another example.
 
-1. On the **Details** tab, enter information about the property. 
+1. On the **Details** tab, enter information about the metadata. 
 
     1. In **Title**, enter *Public-facing*. 
 
     1. Select type **Boolean**. 
 
 1. On the **Assignments** tab, select **Required** for APIs. Select **Not applicable** for Deployments and Environments. 
 
-1. On the **Review + Create** tab, review the settings and select **Create**. 
+1. On the **Review + create** tab, review the settings and select **Create**. 
 
-    The property is added to the list.
+    The metadata is added to the list.
 
 ## View metadata schema
 
-You can view and download the JSON schema for the metadata properties in your API center. The schema includes built-in and custom properties.
+You can view and download the JSON schema for the metadata defined in your API center. The schema includes built-in and custom metadata.
 
-1. In the left menu, select **Metadata schema > View schema**. 
+1. In the left menu, under **Assets**, select **Metadata > View metadata schema**. 
 
-1. Select **View schema > API** to see the metadata schema for APIs, which includes built-in properties and the properties that you added. You can also view the metadata schema defined for deployments and environments in your API center.
+1. Select **View metadata schema > APIs** to see the metadata schema for APIs, which includes built-in and custom metadata. You can also view the metadata schema defined for deployments and environments in your API center.
 
     :::image type="content" source="media/add-metadata-properties/metadata-schema.png" alt-text="Screenshot of metadata schema in the portal." lightbox="media/add-metadata-properties/metadata-schema.png":::
 
-> [!NOTE]
-> * Add properties in the schema at any time and apply them to APIs and other entities in your API center. 
-> * After adding a property, you can change its assignment to an entity, for example from required to optional for APIs.
-> * You can't delete, unassign, or change the type of properties that are currently set in entities. Remove them from the entities first, and then you can delete or change them.
-
 ## Next steps
 
 In this tutorial, you learned how to use the portal to:
 > [!div class="checklist"]    
-> * Define custom metadata properties in your API center
+> * Define custom metadata in your API center
 > * View the metadata schema
 
 Now that you've prepared your metadata schema, add APIs to the inventory in your API center. 

articles/api-center/breadcrumb/TOC.yml

@@ -0,0 +1,20 @@
+items:
+- name: Azure
+  tocHref: /azure/
+  topicHref: /azure/index
+  items:
+    - name: API Center
+      tocHref: /azure/azure-resource-manager/
+      topicHref: /azure/api-center/index
+    - name: API Center
+      tocHref: /azure/templates/
+      topicHref: /azure/api-center/index
+    - name: API Center
+      tocHref: /azure/reliability/
+      topicHref: /azure/api-center/index
+    - name: API Center
+      tocHref: /azure/api-management/
+      topicHref: /azure/api-center/index
+    - name: API Center
+      tocHref: /azure/event-grid/
+      topicHref: /azure/api-center/index