update one article

Author: dlepow

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

@@ -3,8 +3,9 @@ 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: 01/12/2024
+ms.date: 04/30/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.
 ---
@@ -13,20 +14,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.  
 
-[!INCLUDE [api-center-preview-feedback](includes/api-center-preview-feedback.md)]
+> [!VIDEO https://www.youtube.com/embed/Dvar8Dg25s0]
 
 ## 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](~/articles/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
+    [!INCLUDE [include](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
 
     [!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 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 Azure API Center, see [Key concepts](key-concepts.md).
 
 ### Create an API
 
@@ -36,12 +37,10 @@ The following example creates an API named *Petstore API* in the *myResourceGrou
 
 ```azurecli-interactive
 az apic api create  --resource-group myResourceGroup \
-    --service myAPICenter --name petstore-api \
-    --title "Petstore API" --kind "rest"
+    --service myAPICenter --api-id petstore-api \
+    --title "Petstore API" --type "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 +49,12 @@ By default, the command sets the API's **Lifecycle stage** to *design*.
 
 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 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.
 
 ```azurecli-interactive
 az apic api version create --resource-group myResourceGroup \
-    --service myAPICenter --api-name petstore-api \
-    --version v1-0-0 --title "v1-0-0"
+    --service myAPICenter --api-id petstore-api \
+    --version-id v1-0-0 --title "v1-0-0" --lifecycle-stage "testing"
 ```
 
 ### Create API definition and add specification file 
@@ -68,8 +67,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-name petstore-api \
-    --version v1-0-0 --name "openapi" --title "OpenAPI"
+    --service myAPICenter --api-id petstore-api \
+    --version-id v1-0-0 --definition-id openapi --title "OpenAPI"
 ```
 
 #### Import a specification file
@@ -82,8 +81,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-name petstore-api --version-name v1-0-0 \
-    --definition-name openapi --format "link" \
+    --api-id petstore-api --version-id v1-0-0 \
+    --definition-id openapi --format "link" \
     --value 'https://petstore3.swagger.io/api/v3/openapi.json' \
     --specification '{"name":"openapi","version":"3.0.2"}'
 ```
@@ -100,8 +99,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-name petstore-api --version-name v1-0-0 \
-    --definition-name openapi --file-name "/Path/to/specificationFile.json"
+    --api-id petstore-api --version-id v1-0-0 \
+    --definition-id openapi --file-name "/Path/to/specificationFile.json"
 ```
 
 ## Register API from a specification file - single step
@@ -129,11 +128,13 @@ 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 \
-    --name petstore-api
+    --api-id 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 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).
+* 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.