Merge pull request #273891 from dlepow/gacli

[APIC][release-ga-api-center] Update CLI commands

Author: American-Dipper

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

@@ -4,7 +4,7 @@ description: Add APIs to your Azure API center inventory from your API Managemen
 author: dlepow
 ms.service: api-center
 ms.topic: how-to
-ms.date: 03/08/2024
+ms.date: 04/30/2024
 ms.author: danlep 
 ms.custom: devx-track-azurecli
 # Customer intent: As an API program manager, I want to add APIs that are managed in my Azure API Management instance to my API center.
@@ -57,14 +57,14 @@ The following example command exports the API with identifier *my-api* in the *m
 #! /bin/bash
 az apim api export --api-id my-api --resource-group myResourceGroup \
     --service-name myAPIManagement --export-format OpenApiJsonFile \
-    --file-path /path/to/folder
+    --file-path "/path/to/folder"
 ```
 
 ```azurecli
 #! PowerShell syntax
 az apim api export --api-id my-api --resource-group myResourceGroup `
     --service-name myAPIManagement --export-format OpenApiJsonFile `
-    --file-path /path/to/folder
+    --file-path '/path/to/folder'
 ```
 ### Export API to a URL
 
@@ -91,7 +91,7 @@ You can register a new API in your API center from the exported definition by us
 The following example registers an API in the *myAPICenter* API center from a local OpenAPI definition file named *definitionFile.json*.
 
 ```azurecli
-az apic api register --resource-group myResourceGroup --service myAPICenter --api-location "/path/to/definitionFile.json
+az apic api register --resource-group myResourceGroup --service myAPICenter --api-location "/path/to/definitionFile.json"
 ```
 
 ### Import API definition to an existing API in your API center
@@ -104,17 +104,17 @@ This example assumes you have an API named *my-api* and an associated API versio
 #! /bin/bash
 az apic api definition import-specification \
     --resource-group myResourceGroup --service myAPICenter \
-    --api-name my-api --version-name v1-0-0 \
-    --definition-name openapi --format "link" --value '$link' \
+    --api-id my-api --version-id v1-0-0 \
+    --definition-id openapi --format "link" --value '$link' \
     --specification '{"name":"openapi","version":"3.0.2"}'
 ```
 
 ```azurecli
 # PowerShell syntax
 az apic api definition import-specification `
     --resource-group myResourceGroup --service myAPICenter `
-    --api-name my-api --version-name v1-0-0 `
-    --definition-name openapi --format "link" --value '$link' `
+    --api-id my-api --version-id v1-0-0 `
+    --definition-id openapi --format "link" --value '$link' `
     --specification '{"name":"openapi","version":"3.0.2"}'
 ```
 
@@ -131,7 +131,7 @@ When you add APIs from an API Management instance to your API center using `az a
 
 ### Add a managed identity in your API center
 
-For this scenario, your API center uses a [managed identity](/entra/identity/managed-identities-azure-resources/overview) to access APIs in your API Management instance. You can use either a system-assigned or user-assigned managed identity. If you haven't added a managed identity in your API center, you can add it in the Azure portal or by using the Azure CLI. 
+For this scenario, your API center uses a [managed identity](/entra/identity/managed-identities-azure-resources/overview) to access APIs in your API Management instance. Depending on your needs, use either a system-assigned or user-assigned managed identity. If you haven't added a managed identity in your API center, you can add it in the Azure portal or by using the Azure CLI. 
 
 #### Add a system-assigned identity
 

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

@@ -5,7 +5,7 @@ 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.
 ---
@@ -38,12 +38,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.
 
@@ -52,12 +50,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 
@@ -70,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-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
@@ -84,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-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"}'
 ```
@@ -102,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-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
@@ -131,13 +129,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 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-schema), and [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.