[APIC] CLI extension install

Author: dlepow

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

@@ -59,8 +59,7 @@ This article provides two options to deploy the linting engine and event subscri
 * For Azure CLI:
     [!INCLUDE [include](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
 
-    > [!NOTE]
-    > `az apic` commands require the `apic-extension` Azure CLI extension. If you haven't used `az apic` commands, the extension is installed dynamically when you run your first `az apic` command. Learn more about [Azure CLI extensions](/cli/azure/azure-cli-extensions-overview).
+    [!INCLUDE [install-apic-extension](includes/install-apic-extension.md)]
 
     > [!NOTE]
     > Azure CLI command examples in this article can run in PowerShell or a bash shell. Where needed because of different variable syntax, separate command examples are provided for the two shells.

articles/api-center/import-api-management-apis.md

@@ -39,8 +39,7 @@ After importing API definitions or APIs from API Management, you can add metadat
 * For Azure CLI:
     [!INCLUDE [include](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
 
-    > [!NOTE]
-    > `az apic` commands require the `apic-extension` Azure CLI extension. If you haven't used `az apic` commands, the extension is installed dynamically when you run your first `az apic` command. Learn more about [Azure CLI extensions](/cli/azure/azure-cli-extensions-overview).
+    [!INCLUDE [install-apic-extension](includes/install-apic-extension.md)]
 
     > [!NOTE]
     > Azure CLI command examples in this article can run in PowerShell or a bash shell. Where needed because of different variable syntax, separate command examples are provided for the two shells.

articles/api-center/includes/install-apic-extension.md

@@ -0,0 +1,2 @@
+> [!NOTE]
+> `az apic` commands require the `apic-extension` Azure CLI extension. If you haven't used `az apic` commands, the extension can be installed dynamically when you run your first `az apic` command, or you can install the extension manually. Learn more about [Azure CLI extensions](/cli/azure/azure-cli-extensions-overview).g

articles/api-center/manage-apis-azure-cli.md

@@ -3,9 +3,8 @@ title: Manage API inventory in Azure API Center - Azure CLI
 description: Use the Azure CLI to create and update APIs, API versions, and API definitions in your Azure API center.
 author: dlepow
 ms.service: api-center
-ms.custom: devx-track-azurecli
 ms.topic: how-to
-ms.date: 04/30/2024
+ms.date: 01/12/2024
 ms.author: danlep 
 # Customer intent: As an API program manager, I want to automate processes to register and update APIs in my Azure API center.
 ---
@@ -14,21 +13,20 @@ ms.author: danlep
 
 This article shows how to use [`az apic api`](/cli/azure/apic/api) commands in the Azure CLI to add and configure APIs in your [API center](overview.md) inventory. Use commands in the Azure CLI to script operations to manage your API inventory and other aspects of your API center.  
 
-> [!VIDEO https://www.youtube.com/embed/Dvar8Dg25s0]
+[!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).
 
 * For Azure CLI:
-    [!INCLUDE [include](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
+    [!INCLUDE [include](~/articles/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
 
-    > [!NOTE]
-    > `az apic` commands require the `apic-extension` Azure CLI extension. If you haven't used `az apic` commands, the extension is installed dynamically when you run your first `az apic` command. Learn more about [Azure CLI extensions](/cli/azure/azure-cli-extensions-overview).
+    [!INCLUDE [install-apic-extension](includes/install-apic-extension.md)]
 
 ## Register API, API version, and definition
 
-The following steps show how to create an API and associate a single API version and API definition. For background about the data model in Azure API Center, see [Key concepts](key-concepts.md).
+The following steps show how to create an API and associate a single API version and API definition. For background about the data model in API Center, see [Key concepts](key-concepts.md).
 
 ### Create an API
 
@@ -38,10 +36,12 @@ The following example creates an API named *Petstore API* in the *myResourceGrou
 
 ```azurecli-interactive
 az apic api create  --resource-group myResourceGroup \
-    --service myAPICenter --api-id petstore-api \
-    --title "Petstore API" --type "rest"
+    --service myAPICenter --name petstore-api \
+    --title "Petstore API" --kind "rest"
 ```
 
+By default, the command sets the API's **Lifecycle stage** to *design*.
+
 > [!NOTE]
 > After creating an API, you can update the API's properties by using the [az apic api update](/cli/azure/apic/api#az_apic_api_update) command.
 
@@ -50,12 +50,12 @@ az apic api create  --resource-group myResourceGroup \
 
 Use the [az apic api version create](/cli/azure/apic/api/version#az_apic_api_version_create) command to create a version for your API. 
 
-The following example creates an API version named *v1-0-0* for the *petstore-api* API that you created in the previous section. The version is set to the *testing* lifecycle stage.
+The following example creates an API version named *v1-0-0* for the *petstore-api* API that you created in the previous section. 
 
 ```azurecli-interactive
 az apic api version create --resource-group myResourceGroup \
-    --service myAPICenter --api-id petstore-api \
-    --version-id v1-0-0 --title "v1-0-0" --lifecycle-stage "testing"
+    --service myAPICenter --api-name petstore-api \
+    --version v1-0-0 --title "v1-0-0"
 ```
 
 ### Create API definition and add specification file 
@@ -68,8 +68,8 @@ The following example uses the [az apic api definition create](/cli/azure/apic/a
 
 ```azurecli-interactive
 az apic api definition create --resource-group myResourceGroup \
-    --service myAPICenter --api-id petstore-api \
-    --version-id v1-0-0 --definition-id openapi --title "OpenAPI"
+    --service myAPICenter --api-name petstore-api \
+    --version v1-0-0 --name "openapi" --title "OpenAPI"
 ```
 
 #### Import a specification file
@@ -82,8 +82,8 @@ The following example imports an OpenAPI specification file from a publicly acce
 ```azurecli-interactive
 az apic api definition import-specification \
     --resource-group myResourceGroup --service myAPICenter \
-    --api-id petstore-api --version-id v1-0-0 \
-    --definition-id openapi --format "link" \
+    --api-name petstore-api --version-name v1-0-0 \
+    --definition-name openapi --format "link" \
     --value 'https://petstore3.swagger.io/api/v3/openapi.json' \
     --specification '{"name":"openapi","version":"3.0.2"}'
 ```
@@ -100,8 +100,8 @@ The following example exports the specification file from the *openapi* definiti
 ```azurecli-interactive
 az apic api definition export-specification \
     --resource-group myResourceGroup --service myAPICenter \
-    --api-id petstore-api --version-id v1-0-0 \
-    --definition-id openapi --file-name "/Path/to/specificationFile.json"
+    --api-name petstore-api --version-name v1-0-0 \
+    --definition-name openapi --file-name "/Path/to/specificationFile.json"
 ```
 
 ## Register API from a specification file - single step
@@ -129,13 +129,11 @@ Use the [az apic api delete](/cli/azure/apic/api#az_apic_api_delete) command to
 ```azurecli-interactive
 az apic api delete \
     --resource-group myResoureGroup --service myAPICenter \
-    --api-id petstore-api
+    --name petstore-api
 ```
 
 To delete individual API versions and definitions, use [az apic api version delete](/cli/azure/apic/api/version#az-apic-api-version-delete) and [az apic api definition delete](/cli/azure/apic/api/definition#az-apic-api-definition-delete), respectively.
 
 ## Related content
 
-* See the [Azure CLI reference for Azure API Center](/cli/azure/apic) for a complete command list, including commands to manage [environments](/cli/azure/apic/environment), [deployments](/cli/azure/apic/api/deployment), [metadata schemas](/cli/azure/apic/metadata), and [services](/cli/azure/apic/service).
-* [Import APIs to your API center from API Management](import-api-management-apis.md)
-* [Use the Visual Studio extension for API Center](use-vscode-extension.md) to build and register APIs from Visual Studio Code.
+See the [Azure CLI reference for API Center](/cli/azure/apic) for a complete command list, including commands to manage [environments](/cli/azure/apic/environment), [deployments](/cli/azure/apic/api/deployment), [metadata schemas](/cli/azure/apic/metadata-schema), and [API Center services](/cli/azure/apic/service).

articles/api-center/set-up-api-center-azure-cli.md

@@ -17,8 +17,7 @@ ms.author: danlep
 * For Azure CLI:
     [!INCLUDE [include](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
 
-    > [!NOTE]
-    > `az apic` commands require the `apic-extension` Azure CLI extension. If you haven't used `az apic` commands, the extension is installed dynamically when you run your first `az apic` command. Learn more about [Azure CLI extensions](/cli/azure/azure-cli-extensions-overview).
+    [!INCLUDE [install-apic-extension](includes/install-apic-extension.md)]
 
 ## Register the Microsoft.ApiCenter provider