Merge pull request #508 from blackchoey/ga

feat: apic-extension 1.0.0 release

Commands/apic/_create.md

@@ -0,0 +1,21 @@
+# [Command] _apic create_
+
+Creates an instance or update an existing instance of an Azure API Center service.
+
+## Versions
+
+### [2024-03-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30=/2024-03-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.apicenter/services/{} 2024-03-01 -->
+
+#### examples
+
+- Create service Example 1
+    ```bash
+        apic create -g contoso-resources -n contoso -l eastus
+    ```
+
+- Create Service Example 2
+    ```bash
+        apic create --resource-group contoso-resources --name contoso --location eastus
+    ```

Commands/apic/_delete.md

@@ -0,0 +1,16 @@
+# [Command] _apic delete_
+
+Deletes an instance of an Azure API Center service.
+
+## Versions
+
+### [2024-03-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30=/2024-03-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.apicenter/services/{} 2024-03-01 -->
+
+#### examples
+
+- Delete service
+    ```bash
+        apic delete -n contoso -g contoso-resources
+    ```

Commands/apic/_import-from-apim.md

@@ -0,0 +1,26 @@
+# [Command] _apic import-from-apim_
+
+Imports APIs from an Azure API Management service instance.
+
+## Versions
+
+### [2024-03-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vaW1wb3J0ZnJvbWFwaW0=/2024-03-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.apicenter/services/{}/importfromapim 2024-03-01 -->
+
+#### examples
+
+- Import all APIs from APIM in same resource group
+    ```bash
+        apic import-from-apim -g api-center-test --service-name contoso-apic --apim-name contoso-apim --apim-apis *
+    ```
+
+- Import selected APIs from APIM in same resource group
+    ```bash
+        apic import-from-apim -g api-center-test --service-name contoso-apic --apim-name contoso-apim --apim-apis [echo,foo]
+    ```
+
+- Import all APIs from APIM in another subscription and resource group
+    ```bash
+        apic import-from-apim -g api-center-test --service-name contoso-apic --apim-subscription 00000000-0000-0000-0000-000000000000 --apim-resource-group apim-rg --apim-name contoso-apim --apim-apis *
+    ```

Commands/apic/_list.md

@@ -0,0 +1,19 @@
+# [Command] _apic list_
+
+Lists Azure API Center services within an Azure subscription.
+
+There is a known issue that listing all resources under a subscription does not work. Please list resources by resource group.
+
+## Versions
+
+### [2024-03-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXM=/2024-03-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.apicenter/services 2024-03-01 -->
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.apicenter/services 2024-03-01 -->
+
+#### examples
+
+- List services in resource group
+    ```bash
+        apic list -g contoso-resources
+    ```

Commands/apic/_show.md

@@ -0,0 +1,16 @@
+# [Command] _apic show_
+
+Show details of an Azure API Center service instance.
+
+## Versions
+
+### [2024-03-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30=/2024-03-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.apicenter/services/{} 2024-03-01 -->
+
+#### examples
+
+- Show service details
+    ```bash
+        apic show -g contoso-resources -n contoso
+    ```

Commands/apic/_update.md

@@ -0,0 +1,16 @@
+# [Command] _apic update_
+
+Update an instance of an Azure API Center service.
+
+## Versions
+
+### [2024-03-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30=/2024-03-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.apicenter/services/{} 2024-03-01 -->
+
+#### examples
+
+- Update service details
+    ```bash
+        apic update -g contoso-resources -n contoso
+    ```

Commands/apic/api/_create.md

@@ -12,12 +12,12 @@ Register a new API or update an existing API.
 
 - Create API
     ```bash
-        apic api create -g contoso-resources -s contoso --api-id echo-api --title "Echo API" --type REST
+        apic api create -g contoso-resources -n contoso --api-id echo-api --title "Echo API" --type REST
     ```
 
 - Create API with custom properties
     ```bash
-        apic api create -g contoso-resources -s contoso --api-id echo-api --title "Echo API" --type REST --custom-properties '{\"public-facing\":true}'
+        apic api create -g contoso-resources -n contoso --api-id echo-api --title "Echo API" --type REST --custom-properties '{\"public-facing\":true}'
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/api/_delete.md

@@ -12,7 +12,7 @@ Delete specified API.
 
 - Delete API
     ```bash
-        apic api delete -g contoso-resources -s contoso --api-id echo-api
+        apic api delete -g contoso-resources -n contoso --api-id echo-api
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/api/_list.md

@@ -12,7 +12,12 @@ List a collection of APIs.
 
 - List APIs
     ```bash
-        apic api list -g contoso-resources -s contoso
+        apic api list -g contoso-resources -n contoso
+    ```
+
+- List APIs with filter
+    ```bash
+        apic api list -g contoso-resources -n contoso --filter "kind eq 'rest'"
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlz/2024-03-15-preview.xml) **Stable**

Commands/apic/api/_show.md

@@ -12,7 +12,7 @@ Get details of the API.
 
 - Show API details
     ```bash
-        apic api show -g contoso-resources -s contoso --api-id echo-api
+        apic api show -g contoso-resources -n contoso --api-id echo-api
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/api/_update.md

@@ -12,12 +12,12 @@ Update existing API.
 
 - Update API
     ```bash
-        apic api update -g contoso-resources -s contoso --api-id echo-api --summary "Basic REST API service"
+        apic api update -g contoso-resources -n contoso --api-id echo-api --summary "Basic REST API service"
     ```
 
 - Update custom properties
     ```bash
-        apic api update -g contoso-resources -s contoso --api-id echo-api --custom-properties '{\"public-facing\":true}'
+        apic api update -g contoso-resources -n contoso --api-id echo-api --custom-properties '{\"public-facing\":true}'
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/api/definition/_create.md

@@ -12,7 +12,7 @@ Create a new API definition or update an existing API definition.
 
 - Create API definition
     ```bash
-        apic api definition create -g api-center-test -s contosoeuap --api-id echo-api --version-id 2023-01-01 --definition-id "openapi" --title "OpenAPI"
+        apic api definition create -g api-center-test -n contosoeuap --api-id echo-api --version-id 2023-01-01 --definition-id "openapi" --title "OpenAPI"
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L3ZlcnNpb25zL3t9L2RlZmluaXRpb25zL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/api/definition/_delete.md

@@ -12,7 +12,7 @@ Delete specified API definition.
 
 - Delete API definition
     ```bash
-        apic api definition delete -g api-center-test -s contosoeuap --api-id echo-api --version-id 2023-01-01 --definition-id "openapi"
+        apic api definition delete -g api-center-test -n contosoeuap --api-id echo-api --version-id 2023-01-01 --definition-id "openapi"
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L3ZlcnNpb25zL3t9L2RlZmluaXRpb25zL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/api/definition/_export-specification.md

@@ -12,7 +12,7 @@ Exports the API specification.
 
 - Export Specification
     ```bash
-        apic api version definition export-specification -g api-center-test -s contosoeuap --api-id echo-api --version-id 2023-01-01 --definition-id default
+        apic api definition export-specification -g api-center-test -n contosoeuap --api-id echo-api --version-id 2023-01-01 --definition-id default --file-name filename.json
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L3ZlcnNpb25zL3t9L2RlZmluaXRpb25zL3t9L2V4cG9ydHNwZWNpZmljYXRpb24=/2024-03-15-preview.xml) **Stable**

Commands/apic/api/definition/_import-specification.md

@@ -12,12 +12,12 @@ Imports the API specification.
 
 - Import specification example 1
     ```bash
-        apic api definition import-specification -g api-center-test -s contosoeuap --api-id echo-api-2 --version-id 2023-08-01 --definition-id openapi3 --format "inline" --value '{"openapi":"3.0.1","info":{"title":"httpbin.org","description":"API Management facade for a very handy and free online HTTP tool.","version":"1.0"}}' --specification '{"name":"openapi","version":"3.0.0"}'
+        apic api definition import-specification -g api-center-test -n contosoeuap --api-id echo-api-2 --version-id 2023-08-01 --definition-id openapi3 --format "inline" --value '{"openapi":"3.0.1","info":{"title":"httpbin.org","description":"API Management facade for a very handy and free online HTTP tool.","version":"1.0"}}' --specification '{"name":"openapi","version":"3.0.0"}'
     ```
 
 - Import specification example 2
     ```bash
-        apic api definition import-specification -g api-center-test -s contoso --api-id echo-api --version-id 2023-11-01 --definition-id openapi --format "link" --value 'https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/petstore.json' --specification '{"name":"openapi","version":"3.0.0"}'
+        apic api definition import-specification -g api-center-test -n contoso --api-id echo-api --version-id 2023-11-01 --definition-id openapi --format "link" --value 'https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/petstore.json' --specification '{"name":"openapi","version":"3.0.0"}'
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L3ZlcnNpb25zL3t9L2RlZmluaXRpb25zL3t9L2ltcG9ydHNwZWNpZmljYXRpb24=/2024-03-15-preview.xml) **Stable**

Commands/apic/api/definition/_list.md

@@ -12,7 +12,7 @@ List a collection of API definitions.
 
 - List API definitions
     ```bash
-        apic api definition list -g api-center-test -s contosoeuap --api-id echo-api --version-id 2023-01-01
+        apic api definition list -g api-center-test -n contosoeuap --api-id echo-api --version-id 2023-01-01
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L3ZlcnNpb25zL3t9L2RlZmluaXRpb25z/2024-03-15-preview.xml) **Stable**

Commands/apic/api/definition/_show.md

@@ -12,7 +12,7 @@ Get details of the API definition.
 
 - Show API definition details
     ```bash
-        apic api definition show -g api-center-test -s contosoeuap --api-id echo-api --version-id 2023-01-01 --definition-id "openapi"
+        apic api definition show -g api-center-test -n contosoeuap --api-id echo-api --version-id 2023-01-01 --definition-id "openapi"
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L3ZlcnNpb25zL3t9L2RlZmluaXRpb25zL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/api/definition/_update.md

@@ -12,7 +12,7 @@ Update existing API definition.
 
 - Update API definition
     ```bash
-        apic api definition update -g api-center-test -s contosoeuap --api-id echo-api --version-id 2023-01-01 --definition-id "openapi" --title "OpenAPI"
+        apic api definition update -g api-center-test -n contosoeuap --api-id echo-api --version-id 2023-01-01 --definition-id "openapi" --title "OpenAPI"
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L3ZlcnNpb25zL3t9L2RlZmluaXRpb25zL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/api/deployment/_create.md

@@ -12,7 +12,7 @@ Create a new API deployment or update an existing API deployment.
 
 - Create deployment
     ```bash
-        apic api deployment create -g api-center-test -s contoso --deployment-id production --title "Production deployment" --description "Public cloud production deployment." --api-id echo-api --environment-id "/workspaces/default/environments/production" --definition-id "/workspaces/default/apis/echo-api/versions/2023-01-01/definitions/openapi" --server '{\"runtimeUri\":[\"https://example.com\"]}'
+        apic api deployment create -g api-center-test -n contoso --deployment-id production --title "Production deployment" --description "Public cloud production deployment." --api-id echo-api --environment-id "/workspaces/default/environments/production" --definition-id "/workspaces/default/apis/echo-api/versions/2023-01-01/definitions/openapi" --server '{\"runtimeUri\":[\"https://example.com\"]}'
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L2RlcGxveW1lbnRzL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/api/deployment/_delete.md

@@ -12,7 +12,7 @@ Delete API deployment.
 
 - Delete API deployment
     ```bash
-        apic api deployment delete -g api-center-test -s contoso --deployment-id production --api-id echo-api
+        apic api deployment delete -g api-center-test -n contoso --deployment-id production --api-id echo-api
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L2RlcGxveW1lbnRzL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/api/deployment/_list.md

@@ -12,7 +12,7 @@ List a collection of API deployments.
 
 - List API deployments
     ```bash
-        apic api deployment list -g api-center-test -s contoso --api-id echo-api
+        apic api deployment list -g api-center-test -n contoso --api-id echo-api
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L2RlcGxveW1lbnRz/2024-03-15-preview.xml) **Stable**

Commands/apic/api/deployment/_show.md

@@ -12,7 +12,7 @@ Get details of the API deployment.
 
 - Show API deployment details
     ```bash
-        apic api deployment show -g api-center-test -s contoso --deployment-id production --api-id echo-api
+        apic api deployment show -g api-center-test -n contoso --deployment-id production --api-id echo-api
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L2RlcGxveW1lbnRzL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/api/deployment/_update.md

@@ -12,7 +12,7 @@ Update existing API deployment.
 
 - Update API deployment
     ```bash
-        apic api deployment update -g api-center-test -s contoso --deployment-id production --title "Production deployment" --api-id echo-api
+        apic api deployment update -g api-center-test -n contoso --deployment-id production --title "Production deployment" --api-id echo-api
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L2RlcGxveW1lbnRzL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/api/version/_create.md

@@ -12,7 +12,7 @@ Create a new API version or update an existing API version.
 
 - Create API version
     ```bash
-        apic api version create -g api-center-test -s contosoeuap --api-id echo-api --version-id 2023-01-01 --title "2023-01-01"
+        apic api version create -g api-center-test -n contosoeuap --api-id echo-api --version-id 2023-01-01 --title "2023-01-01" --lifecycle-stage production
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L3ZlcnNpb25zL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/api/version/_delete.md

@@ -12,7 +12,7 @@ Delete specified API version
 
 - Delete API version
     ```bash
-        apic api version delete -g api-center-test -s contosoeuap --api-id echo-api --version-id 2023-01-01
+        apic api version delete -g api-center-test -n contosoeuap --api-id echo-api --version-id 2023-01-01
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L3ZlcnNpb25zL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/api/version/_list.md

@@ -12,7 +12,7 @@ List a collection of API versions.
 
 - List API versions
     ```bash
-        apic api version list -g api-center-test -s contosoeuap --api-id echo-api
+        apic api version list -g api-center-test -n contosoeuap --api-id echo-api
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L3ZlcnNpb25z/2024-03-15-preview.xml) **Stable**

Commands/apic/api/version/_show.md

@@ -12,7 +12,7 @@ Get details of the API version.
 
 - Show API version details
     ```bash
-        apic api version show -g api-center-test -s contoso --api-id echo-api --version-id 2023-01-01
+        apic api version show -g api-center-test -n contoso --api-id echo-api --version-id 2023-01-01
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L3ZlcnNpb25zL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/api/version/_update.md

@@ -12,7 +12,7 @@ Update existing API version.
 
 - Update API version
     ```bash
-        apic api version update -g api-center-test -s contosoeuap --api-id echo-api --version-id 2023-01-01 --title "2023-01-01"
+        apic api version update -g api-center-test -n contosoeuap --api-id echo-api --version-id 2023-01-01 --title "2023-01-01"
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9hcGlzL3t9L3ZlcnNpb25zL3t9/2024-03-15-preview.xml) **Stable**

Commands/apic/environment/_create.md

@@ -12,7 +12,7 @@ Create a new environment or update an existing environment.
 
 - Create environment
     ```bash
-        apic environment create -g api-center-test -s contosoeuap --environment-id public --title "Public cloud" --type "development"
+        apic environment create -g api-center-test -n contosoeuap --environment-id public --title "Public cloud" --type "development"
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9lbnZpcm9ubWVudHMve30=/2024-03-15-preview.xml) **Stable**

Commands/apic/environment/_delete.md

@@ -12,7 +12,7 @@ Delete the environment.
 
 - Delete environment
     ```bash
-        apic environment delete -g api-center-test -s contosoeuap --environment-id public
+        apic environment delete -g api-center-test -n contosoeuap --environment-id public
     ```
 
 ### [2024-03-15-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5hcGljZW50ZXIvc2VydmljZXMve30vd29ya3NwYWNlcy97fS9lbnZpcm9ubWVudHMve30=/2024-03-15-preview.xml) **Stable**