Merge pull request #239641 from MicrosoftDocs/release-preview-api-center

API Center public preview--scheduled release at 10AM of 6/15

Author: huypub

articles/api-center/TOC.yml

@@ -0,0 +1,22 @@
+- name: Azure API Center Documentation
+  href: index.yml
+- name: Overview
+  expanded: true
+  items:
+      - name: What is API Center?
+        displayName: Overview
+        href: overview.md
+      - name: Service limits
+        href: ../azure-resource-manager/management/azure-subscription-service-limits.md#api-center-preview-limits
+- name: Concepts
+  items:
+      - name: Key concepts
+        href: key-concepts.md
+- name: Tutorials
+  items:
+      - name: Set up an API center
+        href: set-up-api-center.md
+- name: Reference
+  items:
+      - name: REST API
+        href: https://aka.ms/apicenter/docs/rest

articles/api-center/includes/api-center-preview-feedback.md

@@ -0,0 +1,16 @@
+---
+
+title: Include file
+description: Include file
+services: api-center
+author: dlepow
+
+ms.service: api-center
+ms.topic: include
+ms.date: 05/24/2023
+ms.author: danlep
+ms.custom: Include file
+---
+
+> [!NOTE]
+> API Center is in preview. During preview, request features, report bugs, or provide other feedback in this [GitHub repo](https://aka.ms/apicenter/preview/feedback).

articles/api-center/includes/api-center-service-limits.md

@@ -0,0 +1,23 @@
+---
+
+title: Include file
+description: Include file
+services: api-center
+author: dlepow
+
+ms.service: api-center
+ms.topic: include
+ms.date: 05/17/2023
+ms.author: danlep
+ms.custom: Include file
+---
+
+| Resource | Limit<sup>1</sup> |
+| ---------------------------------------------------------------------- | -------------------------- |
+| Maximum number of APIs | 1,000 |
+| Maximum number of versions per API | 100 |
+| Maximum number of environments | 1,000 |
+| Maximum number of custom metadata properties | 100 |
+| Maximum number of child properties in custom metadata property of type "object" | 100 |
+
+<sup>1</sup> To increase an API Center limit, contact [support](https://azure.microsoft.com/support/options/).<br/>

articles/api-center/index.yml

@@ -0,0 +1,33 @@
+### YamlMime:Landing 
+
+title: Azure API Center (preview) documentation 
+summary: API Center helps you develop and maintain a structured inventory of your organization's APIs. API Center enables API discovery, reuse, and governance at scale.
+
+metadata: 
+  title: Azure API Center documentation | Microsoft Docs
+  description: Azure API Center helps you develop and maintain a structured inventory of your organization's APIs. API Center enables API discovery, reuse, and governance at scale.
+  ms.service: api-center
+  ms.topic: landing-page
+  ms.collection: 
+  author: dlepow
+  ms.author: danlep
+  ms.date: 05/24/2023
+
+# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | whats-new
+
+landingContent:
+# Cards and links should be based on top customer tasks or top subjects
+# Start card title with a verb
+  # Card
+  - title: About API Center
+    linkLists:
+      - linkListType: overview
+        links:
+          - text: What is API Center?
+            url: overview.md
+          - text: Key concepts
+            url: key-concepts.md
+      - linkListType: get-started
+        links:
+          - text: Tutorial - Set up your API center
+            url: set-up-api-center.md

articles/api-center/key-concepts.md

@@ -0,0 +1,55 @@
+---
+title: Azure API Center (preview) - Key concepts
+description: Key concepts of Azure API Center. API Center enables tracking APIs in a centralized location for discovery, reuse, and governance.
+author: dlepow
+editor: ''
+ 
+ms.service: api-center
+ms.topic: conceptual
+ms.date: 06/05/2023
+ms.author: danlep
+ms.custom: 
+---
+
+# Azure API Center (preview) - key concepts
+
+This article goes into more detail about key concepts of [Azure API Center](overview.md). API Center enables tracking APIs in a centralized location for discovery, reuse, and governance.
+
+[!INCLUDE [api-center-preview-feedback](includes/api-center-preview-feedback.md)]
+
+## API
+
+A top-level logical entity in API Center that represents any real-world API. API Center supports APIs of any type, including REST, GraphQL, gRPC, SOAP, WebSocket, and Webhook.
+
+An API can be managed by any API management solution (such as Azure [API Management](../api-management/api-management-key-concepts.md) or solutions from other providers), or unmanaged.
+
+## API version
+
+APIs typically have multiple versions across lifecycle stages. In API Center, associate one or more versions with each API, aligned with specific API changes. Some versions may introduce major or breaking changes, while others add minor improvements. An API version can be at any lifecycle stage – from design, to preview, production, or deprecated. 
+
+Each API version may be defined with a specification file, such as an OpenAPI definition for a REST API. API Center allows any specification file formatted as text (YAML, JSON, markdown, and so on). You can upload OpenAPI, gRPC, GraphQL, AsyncAPI, WSDL, and WADL specifications, among others.
+
+## Environment
+
+Use API Center to maintain information about your APIs' environments. An environment represents a location where an API runtime could be deployed, typically an API management platform, API gateway, or compute service. Each environment has a type (such as production or staging) and may include information about developer portal or management interfaces.
+
+## Deployment
+
+In API Center, a deployment identifies a specific environment used for the runtime of an API version. For example, an API version could have two deployments: a deployment in a staging Azure API Management service and a deployment in a production Azure API Management service.
+
+## Metadata and metadata schema
+
+In API Center, you organize your APIs and other assets by setting values of metadata properties, which can be used for searching and filtering and to enforce governance standards. API Center provides several common built-in properties such as "API type" and "Lifecycle". An API Center owner can augment the built-in properties by defining custom properties in a metadata schema to organize their APIs, deployments, and environments according to their organization's requirements. For example, create a *Line of business* property to identify the business unit that owns an API. 
+
+API Center supports properties of type array, boolean, number, object, predefined choices, and string. 
+
+API Center's metadata schema is compatible with JSON and YAML schema specifications, to allow for schema validation in developer tooling and automated pipelines.
+
+## Workspace
+
+To enable multiple teams to work independently in a single deployment, API Center provides workspaces. Similar to API Management [workspaces](../api-management/workspaces-overview.md), workspaces in API Center allow separate teams to access and manage a part of the API inventory. Access is controlled through Azure role-based access control (RBAC).
+
+## Next steps
+
+* [Set up your API center](set-up-api-center.md)
+

articles/api-center/media/set-up-api-center/add-version.png

@@ -0,0 +1,71 @@
+---
+title: Azure API Center (preview) - Overview
+description: Introduction to key scenarios and capabilities of Azure API Center. API Center inventories an organization's APIs to promote API discovery, reuse, and governance at scale.
+author: dlepow
+editor: ''
+ 
+ms.service: api-center
+ms.topic: overview
+ms.date: 06/05/2023
+ms.author: danlep
+ms.custom: references_regions
+---
+
+# What is Azure API Center (preview)?
+
+API Center enables tracking all of your APIs in a centralized location for discovery, reuse, and governance. Use API Center to develop and maintain a structured and organized inventory of your organization's APIs - regardless of their type, lifecycle stage, or deployment location - along with related information such as version details, specification files, and common metadata. 
+
+[!INCLUDE [api-center-preview-feedback](includes/api-center-preview-feedback.md)]
+
+> [!NOTE]
+> API Center is a solution for API inventory management. If you're looking for a solution to manage, secure, and publish your organization's API backends through an API gateway, see the [Azure API Management](../api-management/api-management-key-concepts.md) service.
+
+## Benefits
+
+With API Center, stakeholders throughout your organization - including API program managers, application developers, and API developers - can discover, govern, and reuse APIs.  
+
+* **API program managers**, usually IT or enterprise architects leading organizational API programs, who foster API reuse, quality, and compliance. API Center provides these users with a centralized inventory view of all APIs in the organization and information about those APIs, such as their deployments.
+* **Application developers**, including both professional developers and low-code/no-code developers, who discover and consume APIs to accelerate or enable development of applications. API Center helps these users find, understand, and get access to available APIs and reach the API developer teams who support them.
+* **API developers**, who design, develop, document, and publish APIs that meet organizational standards and comply with industry regulations. API Center helps these users reduce duplication, boost adoption, and track their APIs throughout their lifecycles.  
+
+## Key capabilities
+
+In preview, create and use an API Center in the Azure portal for the following:
+
+* **API inventory management** - Register all of your organization's APIs for inclusion in a centralized inventory.
+* **Real-world API representation** - Add real-world information about each API including versions and specifications such as OpenAPI specifications. List API deployments and associate them with runtime environments, for example representing API management solutions.
+* **Metadata properties** - Organize and filter APIs and related resources using built-in and custom metadata properties, to help with API governance and discoverability by API consumers.  
+* **Workspaces** - Enable multiple teams to work independently in API Center by creating workspaces with permissions based on role-based access control.
+
+For more information about the information assets and capabilities in API Center, see [Key concepts](key-concepts.md).
+
+## Preview limitations
+
+* In preview, API Center is available in the following Azure regions:
+
+    * East US 
+    * UK South     
+    * Central India 
+    * Australia East 
+    
+## Frequently asked questions
+
+### Q: Is API Center part of Azure API Management? 
+
+A: API Center is a stand-alone Azure service that's complementary to Azure API Management and API management services from other providers. API Center provides a unified API inventory for all APIs in the organization, including APIs that don't run in API gateways (such as those that are still in design) and those that are managed with different API management solutions. 
+
+### Q: Is my data encrypted in API Center?
+
+A: Yes, all data in API Center is encrypted at rest.
+
+## Next steps
+
+> [!div class="nextstepaction"]
+> [Get access to the preview](https://aka.ms/apicenter/joinpreview)
+
+
+> [!div class="nextstepaction"]
+> [Set up your API center](set-up-api-center.md)
+
+> [!div class="nextstepaction"]
+> [Provide feedback](https://aka.ms/apicenter/preview/feedback)