Merge pull request Azure#194 from am-lim/main

[devcenter] Update to 2023-04-01 API

Commands/devcenter/admin/attached-network/_create.md

@@ -14,3 +14,14 @@ Create an attached network connection.
     ```bash
         devcenter admin attached-network create --attached-network-connection-name "{attachedNetworkConnectionName}" --network-connection-id "/subscriptions/{subscriptionId}/resourceGroups/rg1/providers/Microsoft.DevCenter/networkConnections/{networkConnectionName}" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2023-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9hdHRhY2hlZG5ldHdvcmtzL3t9/2023-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/attachednetworks/{} 2023-04-01 -->
+
+#### examples
+
+- Create
+    ```bash
+        devcenter admin attached-network create --attached-network-connection-name "network-uswest3" --network-connection-id "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/rg1/providers/Microsoft.DevCenter/NetworkConnections/network-uswest3" --dev-center-name "Contoso" --resource-group "rg1"
+    ```

Commands/devcenter/admin/attached-network/_delete.md

@@ -1,6 +1,6 @@
 # [Command] _devcenter admin attached-network delete_
 
-Delete a NetworkConnection.
+Delete an attached network connection.
 
 ## Versions
 
@@ -14,3 +14,14 @@ Delete a NetworkConnection.
     ```bash
         devcenter admin attached-network delete --attached-network-connection-name "{attachedNetworkConnectionName}" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2023-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9hdHRhY2hlZG5ldHdvcmtzL3t9/2023-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/attachednetworks/{} 2023-04-01 -->
+
+#### examples
+
+- Delete
+    ```bash
+        devcenter admin attached-network delete --attached-network-connection-name "network-uswest3" --dev-center-name "Contoso" --resource-group "rg1"
+    ```

Commands/devcenter/admin/attached-network/_list.md

@@ -1,6 +1,6 @@
 # [Command] _devcenter admin attached-network list_
 
-List the attached NetworkConnections for a Project.
+List the attached network connections configured for a dev center or project.
 
 ## Versions
 
@@ -20,3 +20,20 @@ List the attached NetworkConnections for a Project.
     ```bash
         devcenter admin attached-network list --project-name "{projectName}" --resource-group "rg1"
     ```
+
+### [2023-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9hdHRhY2hlZG5ldHdvcmtz/2023-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/attachednetworks 2023-04-01 -->
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/projects/{}/attachednetworks 2023-04-01 -->
+
+#### examples
+
+- List by dev center
+    ```bash
+        devcenter admin attached-network list --dev-center-name "Contoso" --resource-group "rg1"
+    ```
+
+- List by project
+    ```bash
+        devcenter admin attached-network list --project-name "DevProject" --resource-group "rg1"
+    ```

Commands/devcenter/admin/attached-network/_show.md

@@ -1,6 +1,6 @@
 # [Command] _devcenter admin attached-network show_
 
-Get an attached NetworkConnection.
+Get an attached network connection configured for a dev center or project.
 
 ## Versions
 
@@ -20,3 +20,20 @@ Get an attached NetworkConnection.
     ```bash
         devcenter admin attached-network show --name "{attachedNetworkConnectionName}" --project-name "{projectName}" --resource-group "rg1"
     ```
+
+### [2023-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9hdHRhY2hlZG5ldHdvcmtzL3t9/2023-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/attachednetworks/{} 2023-04-01 -->
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/projects/{}/attachednetworks/{} 2023-04-01 -->
+
+#### examples
+
+- Get a dev center attached network connection
+    ```bash
+        devcenter admin attached-network show --name" network-uswest3" --dev-center-name "Contoso" --resource-group "rg1"
+    ```
+
+- Get a project attached network connection
+    ```bash
+        az devcenter admin attached-network show --name "network-uswest3" --project-name "{projectName}" --resource-group "rg1"
+    ```

Commands/devcenter/admin/attached-network/readme.md

@@ -1,17 +1,17 @@
 # [Group] _devcenter admin attached-network_
 
-Manage attached network with devcenter
+Manage attached networks.
 
 ## Commands
 
 - [create](/Commands/devcenter/admin/attached-network/_create.md)
 : Create an attached network connection.
 
 - [delete](/Commands/devcenter/admin/attached-network/_delete.md)
-: Delete a NetworkConnection.
+: Delete an attached network connection.
 
 - [list](/Commands/devcenter/admin/attached-network/_list.md)
-: List the attached NetworkConnections for a Project.
+: List the attached network connections configured for a dev center or project.
 
 - [show](/Commands/devcenter/admin/attached-network/_show.md)
-: Get an attached NetworkConnection.
+: Get an attached network connection configured for a dev center or project.

Commands/devcenter/admin/catalog/_create.md

@@ -19,3 +19,19 @@ Create a catalog.
     ```bash
         devcenter admin catalog create --git-hub path="/templates" branch="main" secret-identifier="https://contosokv.vault.azure.net/secrets/CentralRepoPat" uri="https://github.com/Contoso/centralrepo-fake.git" --name "{catalogName}" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2023-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncy97fQ==/2023-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs/{} 2023-04-01 -->
+
+#### examples
+
+- Create using an Azure DevOps repository
+    ```bash
+        devcenter admin catalog create --ado-git path="/templates" branch="main" secret-identifier="https://contosokv.vault.azure.net/secrets/CentralRepoPat" uri="https://contoso@dev.azure.com/contoso/contosoOrg/_git/centralrepo-fakecontoso" --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
+    ```
+
+- Create using a GitHub repository
+    ```bash
+        devcenter admin catalog create --git-hub path="/templates" branch="main" secret-identifier="https://contosokv.vault.azure.net/secrets/CentralRepoPat" uri="https://github.com/Contoso/centralrepo-fake.git" --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
+    ```

Commands/devcenter/admin/catalog/_delete.md

@@ -14,3 +14,14 @@ Delete a catalog resource.
     ```bash
         devcenter admin catalog delete --name "{catalogName}" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2023-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncy97fQ==/2023-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs/{} 2023-04-01 -->
+
+#### examples
+
+- Delete
+    ```bash
+        devcenter admin catalog delete --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
+    ```

Commands/devcenter/admin/catalog/_list.md

@@ -1,6 +1,6 @@
 # [Command] _devcenter admin catalog list_
 
-List catalogs for a devcenter.
+List catalogs for a dev center.
 
 ## Versions
 
@@ -14,3 +14,14 @@ List catalogs for a devcenter.
     ```bash
         devcenter admin catalog list --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2023-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncw==/2023-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs 2023-04-01 -->
+
+#### examples
+
+- List
+    ```bash
+        devcenter admin catalog list --dev-center-name "Contoso" --resource-group "rg1"
+    ```

Commands/devcenter/admin/catalog/_show.md

@@ -1,6 +1,6 @@
 # [Command] _devcenter admin catalog show_
 
-Get a catalog
+Get a catalog.
 
 ## Versions
 
@@ -14,3 +14,14 @@ Get a catalog
     ```bash
         devcenter admin catalog show --name "{catalogName}" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2023-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncy97fQ==/2023-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs/{} 2023-04-01 -->
+
+#### examples
+
+- Get
+    ```bash
+        devcenter admin catalog show --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
+    ```

Commands/devcenter/admin/catalog/_sync.md

@@ -14,3 +14,14 @@ Syncs templates for a template source.
     ```bash
         devcenter admin catalog sync --name "{catalogName}" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2023-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncy97fS9zeW5j/2023-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs/{}/sync 2023-04-01 -->
+
+#### examples
+
+- Sync
+    ```bash
+        devcenter admin catalog sync --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
+    ```

Commands/devcenter/admin/catalog/_update.md

@@ -1,6 +1,6 @@
 # [Command] _devcenter admin catalog update_
 
-Update updates a catalog.
+Update a catalog.
 
 ## Versions
 
@@ -14,3 +14,14 @@ Update updates a catalog.
     ```bash
         devcenter admin catalog update --git-hub path="/environments" --name "{catalogName}" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2023-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncy97fQ==/2023-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs/{} 2023-04-01 -->
+
+#### examples
+
+- Update
+    ```bash
+        devcenter admin catalog update --git-hub path="/environments" --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
+    ```

Commands/devcenter/admin/catalog/readme.md

@@ -1,6 +1,6 @@
 # [Group] _devcenter admin catalog_
 
-Manage catalog with dev center
+Manage catalogs.
 
 ## Commands
 
@@ -11,13 +11,13 @@ Manage catalog with dev center
 : Delete a catalog resource.
 
 - [list](/Commands/devcenter/admin/catalog/_list.md)
-: List catalogs for a devcenter.
+: List catalogs for a dev center.
 
 - [show](/Commands/devcenter/admin/catalog/_show.md)
-: Get a catalog
+: Get a catalog.
 
 - [sync](/Commands/devcenter/admin/catalog/_sync.md)
 : Syncs templates for a template source.
 
 - [update](/Commands/devcenter/admin/catalog/_update.md)
-: Update updates a catalog.
+: Update a catalog.

Commands/devcenter/admin/check-name-availability/_execute.md

@@ -1,6 +1,6 @@
 # [Command] _devcenter admin check-name-availability execute_
 
-Check the availability of name for resource
+Check the availability of name for resource.
 
 ## Versions
 
@@ -14,3 +14,14 @@ Check the availability of name for resource
     ```bash
         devcenter admin check-name-availability execute --name "name1" --type "Microsoft.DevCenter/devcenters"
     ```
+
+### [2023-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvY2hlY2tuYW1lYXZhaWxhYmlsaXR5/2023-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.devcenter/checknameavailability 2023-04-01 -->
+
+#### examples
+
+- Check name availability
+    ```bash
+        devcenter admin check-name-availability execute --name "name1" --type "Microsoft.DevCenter/devcenters"
+    ```

Commands/devcenter/admin/check-name-availability/readme.md

@@ -1,8 +1,8 @@
 # [Group] _devcenter admin check-name-availability_
 
-Manage check name availability with devcenter
+Manage check name availability.
 
 ## Commands
 
 - [execute](/Commands/devcenter/admin/check-name-availability/_execute.md)
-: Check the availability of name for resource
+: Check the availability of name for resource.

Commands/devcenter/admin/devbox-definition/_create.md

@@ -1,6 +1,6 @@
 # [Command] _devcenter admin devbox-definition create_
 
-Create a Dev Box definition.
+Create a dev box definition.
 
 ## Versions
 
@@ -14,3 +14,14 @@ Create a Dev Box definition.
     ```bash
         devcenter admin devbox-definition create --location "eastus" --hibernate-support "Enabled" --image-reference id="/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/Example/providers/Microsoft.DevCenter/devcenters/Contoso/galleries/contosogallery/images/exampleImage/version/1.0.0" --os-storage-type "ssd_1024gb" --sku name="general_a_8c32gb_v1" --name "WebDevBox" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2023-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9kZXZib3hkZWZpbml0aW9ucy97fQ==/2023-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/devboxdefinitions/{} 2023-04-01 -->
+
+#### examples
+
+- Create
+    ```bash
+        devcenter admin devbox-definition create --location "eastus" --image-reference id="/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/Example/providers/Microsoft.DevCenter/devcenters/Contoso/galleries/contosogallery/images/exampleImage/version/1.0.0" --os-storage-type "ssd_1024gb" --sku name="general_a_8c32gb_v1" --name "WebDevBox" --dev-center-name "Contoso" --resource-group "rg1"
+    ```

Commands/devcenter/admin/devbox-definition/_delete.md

@@ -1,6 +1,6 @@
 # [Command] _devcenter admin devbox-definition delete_
 
-Delete a Dev Box definition
+Delete a dev box definition.
 
 ## Versions
 
@@ -14,3 +14,14 @@ Delete a Dev Box definition
     ```bash
         devcenter admin devbox-definition delete --name "WebDevBox" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2023-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9kZXZib3hkZWZpbml0aW9ucy97fQ==/2023-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/devboxdefinitions/{} 2023-04-01 -->
+
+#### examples
+
+- Delete
+    ```bash
+        devcenter admin devbox-definition delete --name "WebDevBox" --dev-center-name "Contoso" --resource-group "rg1"
+    ```

Commands/devcenter/admin/devbox-definition/_list.md

@@ -1,6 +1,6 @@
 # [Command] _devcenter admin devbox-definition list_
 
-List Dev Box definitions configured for a project.
+List dev box definitions configured for a dev center or project.
 
 ## Versions
 
@@ -20,3 +20,20 @@ List Dev Box definitions configured for a project.
     ```bash
         devcenter admin devbox-definition list --project-name "ContosoProject" --resource-group "rg1"
     ```
+
+### [2023-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9kZXZib3hkZWZpbml0aW9ucw==/2023-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/devboxdefinitions 2023-04-01 -->
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/projects/{}/devboxdefinitions 2023-04-01 -->
+
+#### examples
+
+- List by dev center
+    ```bash
+        devcenter admin devbox-definition list --dev-center-name "Contoso" --resource-group "rg1"
+    ```
+
+- List by project
+    ```bash
+        devcenter admin devbox-definition list --project-name "ContosoProject" --resource-group "rg1"
+    ```

Commands/devcenter/admin/devbox-definition/_show.md

@@ -1,6 +1,6 @@
 # [Command] _devcenter admin devbox-definition show_
 
-Get a Dev Box definition
+Get a dev box definition configured for a dev center or a project.
 
 ## Versions
 
@@ -20,3 +20,20 @@ Get a Dev Box definition
     ```bash
         devcenter admin devbox-definition show --name "WebDevBox" --project-name "ContosoProject" --resource-group "rg1"
     ```
+
+### [2023-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9kZXZib3hkZWZpbml0aW9ucy97fQ==/2023-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/devboxdefinitions/{} 2023-04-01 -->
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/projects/{}/devboxdefinitions/{} 2023-04-01 -->
+
+#### examples
+
+- Get a dev center dev box definition
+    ```bash
+        devcenter admin devbox-definition show --name "WebDevBox" --dev-center-name "Contoso" --resource-group "rg1"
+    ```
+
+- Get a project dev box definition
+    ```bash
+        devcenter admin devbox-definition show --name "WebDevBox" --project-name "ContosoProject" --resource-group "rg1"
+    ```