Merge pull request #623 from am-lim/main

[devcenter] Update control plane and data plane API to v2024-10-01-preview
Azure · Jan 7, 2025 · 2dbe138 · 2dbe138
2 parents d4e75db + 439783b
commit 2dbe138
Show file tree

Hide file tree

Showing 457 changed files with 31,831 additions and 318 deletions.
diff --git a/Commands/devcenter/admin/attached-network/_create.md b/Commands/devcenter/admin/attached-network/_create.md
@@ -58,3 +58,14 @@ Create an attached network connection.
     ```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"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9hdHRhY2hlZG5ldHdvcmtzL3t9/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/attachednetworks/{} 2024-10-01-preview -->
+
+#### 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"
+    ```
diff --git a/Commands/devcenter/admin/attached-network/_delete.md b/Commands/devcenter/admin/attached-network/_delete.md
@@ -58,3 +58,14 @@ Delete an attached network connection.
     ```bash
         devcenter admin attached-network delete --attached-network-connection-name "network-uswest3" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9hdHRhY2hlZG5ldHdvcmtzL3t9/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/attachednetworks/{} 2024-10-01-preview -->
+
+#### examples
+
+- Delete
+    ```bash
+        devcenter admin attached-network delete --attached-network-connection-name "network-uswest3" --dev-center-name "Contoso" --resource-group "rg1"
+    ```
diff --git a/Commands/devcenter/admin/attached-network/_list.md b/Commands/devcenter/admin/attached-network/_list.md
@@ -88,3 +88,20 @@ List the attached network connections configured for a dev center or project.
     ```bash
         devcenter admin attached-network list --project-name "DevProject" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9hdHRhY2hlZG5ldHdvcmtz/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/attachednetworks 2024-10-01-preview -->
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/projects/{}/attachednetworks 2024-10-01-preview -->
+
+#### 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"
+    ```
diff --git a/Commands/devcenter/admin/attached-network/_show.md b/Commands/devcenter/admin/attached-network/_show.md
@@ -88,3 +88,20 @@ Get an attached network connection configured for a dev center or project.
     ```bash
         az devcenter admin attached-network show --name "network-uswest3" --project-name "{projectName}" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9hdHRhY2hlZG5ldHdvcmtzL3t9/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/attachednetworks/{} 2024-10-01-preview -->
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/projects/{}/attachednetworks/{} 2024-10-01-preview -->
+
+#### 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"
+    ```
diff --git a/Commands/devcenter/admin/catalog-task/_get-error-detail.md b/Commands/devcenter/admin/catalog-task/_get-error-detail.md
@@ -25,3 +25,14 @@ Gets customization task error details.
     ```bash
         devcenter admin catalog-task get-error-detail --catalog-name "CentralCatalog" --task-name "SampleTask" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncy97fS90YXNrcy97fS9nZXRlcnJvcmRldGFpbHM=/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs/{}/tasks/{}/geterrordetails 2024-10-01-preview -->
+
+#### examples
+
+- Get error detail
+    ```bash
+        devcenter admin catalog-task get-error-detail --catalog-name "CentralCatalog" --task-name "SampleTask" --dev-center-name "Contoso" --resource-group "rg1"
+    ```
diff --git a/Commands/devcenter/admin/catalog-task/_list.md b/Commands/devcenter/admin/catalog-task/_list.md
@@ -25,3 +25,14 @@ List tasks in the catalog.
     ```bash
         devcenter admin catalog-task list --catalog-name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncy97fS90YXNrcw==/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs/{}/tasks 2024-10-01-preview -->
+
+#### examples
+
+- List
+    ```bash
+        devcenter admin catalog-task list --catalog-name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
+    ```
diff --git a/Commands/devcenter/admin/catalog-task/_show.md b/Commands/devcenter/admin/catalog-task/_show.md
@@ -25,3 +25,14 @@ Get a task from the catalog.
     ```bash
         devcenter admin catalog-task show --catalog-name "CentralCatalog" --task-name "SampleTask" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncy97fS90YXNrcy97fQ==/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs/{}/tasks/{} 2024-10-01-preview -->
+
+#### examples
+
+- Get
+    ```bash
+        devcenter admin catalog-task show --catalog-name "CentralCatalog" --task-name "SampleTask" --dev-center-name "Contoso" --resource-group "rg1"
+    ```
diff --git a/Commands/devcenter/admin/catalog/_connect.md b/Commands/devcenter/admin/catalog/_connect.md
@@ -36,3 +36,14 @@ Connects a catalog to enable syncing.
     ```bash
         devcenter admin catalog connect --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncy97fS9jb25uZWN0/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs/{}/connect 2024-10-01-preview -->
+
+#### examples
+
+- Connect
+    ```bash
+        devcenter admin catalog connect --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
+    ```
diff --git a/Commands/devcenter/admin/catalog/_create.md b/Commands/devcenter/admin/catalog/_create.md
@@ -83,3 +83,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 "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncy97fQ==/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs/{} 2024-10-01-preview -->
+
+#### 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"
+    ```
diff --git a/Commands/devcenter/admin/catalog/_delete.md b/Commands/devcenter/admin/catalog/_delete.md
@@ -58,3 +58,14 @@ Delete a catalog resource.
     ```bash
         devcenter admin catalog delete --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncy97fQ==/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs/{} 2024-10-01-preview -->
+
+#### examples
+
+- Delete
+    ```bash
+        devcenter admin catalog delete --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
+    ```
diff --git a/Commands/devcenter/admin/catalog/_get-sync-error-detail.md b/Commands/devcenter/admin/catalog/_get-sync-error-detail.md
@@ -25,3 +25,14 @@ Gets catalog synchronization error details.
     ```bash
         devcenter admin catalog get-sync-error-detail --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncy97fS9nZXRzeW5jZXJyb3JkZXRhaWxz/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs/{}/getsyncerrordetails 2024-10-01-preview -->
+
+#### examples
+
+- Get synchronization error detail
+    ```bash
+        devcenter admin catalog get-sync-error-detail --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
+    ```
diff --git a/Commands/devcenter/admin/catalog/_list.md b/Commands/devcenter/admin/catalog/_list.md
@@ -58,3 +58,14 @@ List catalogs for a dev center.
     ```bash
         devcenter admin catalog list --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncw==/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs 2024-10-01-preview -->
+
+#### examples
+
+- List
+    ```bash
+        devcenter admin catalog list --dev-center-name "Contoso" --resource-group "rg1"
+    ```
diff --git a/Commands/devcenter/admin/catalog/_show.md b/Commands/devcenter/admin/catalog/_show.md
@@ -58,3 +58,14 @@ Get a catalog.
     ```bash
         devcenter admin catalog show --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncy97fQ==/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs/{} 2024-10-01-preview -->
+
+#### examples
+
+- Get
+    ```bash
+        devcenter admin catalog show --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
+    ```
diff --git a/Commands/devcenter/admin/catalog/_sync.md b/Commands/devcenter/admin/catalog/_sync.md
@@ -58,3 +58,14 @@ Syncs templates for a template source.
     ```bash
         devcenter admin catalog sync --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncy97fS9zeW5j/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs/{}/sync 2024-10-01-preview -->
+
+#### examples
+
+- Sync
+    ```bash
+        devcenter admin catalog sync --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
+    ```
diff --git a/Commands/devcenter/admin/catalog/_update.md b/Commands/devcenter/admin/catalog/_update.md
@@ -58,3 +58,14 @@ Update a catalog.
     ```bash
         devcenter admin catalog update --git-hub path="/environments" --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9jYXRhbG9ncy97fQ==/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/catalogs/{} 2024-10-01-preview -->
+
+#### examples
+
+- Update
+    ```bash
+        devcenter admin catalog update --git-hub path="/environments" --name "CentralCatalog" --dev-center-name "Contoso" --resource-group "rg1"
+    ```
diff --git a/Commands/devcenter/admin/check-name-availability/_execute.md b/Commands/devcenter/admin/check-name-availability/_execute.md
@@ -58,3 +58,14 @@ Check the availability of name for resource.
     ```bash
         devcenter admin check-name-availability execute --name "name1" --type "Microsoft.DevCenter/devcenters"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvY2hlY2tuYW1lYXZhaWxhYmlsaXR5/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.devcenter/checknameavailability 2024-10-01-preview -->
+
+#### examples
+
+- Check name availability
+    ```bash
+        devcenter admin check-name-availability execute --name "name1" --type "Microsoft.DevCenter/devcenters"
+    ```
diff --git a/Commands/devcenter/admin/check-scoped-name-availability/_execute.md b/Commands/devcenter/admin/check-scoped-name-availability/_execute.md
@@ -19,3 +19,19 @@ Check the availability of name for resource
     ```bash
         devcenter admin check-scoped-name-availability execute --name "name1" --type ""Microsoft.DevCenter/devcenters/catalogs" --scope  "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/rg1/providers/Microsoft.DevCenter/devcenters/Contoso"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvY2hlY2tzY29wZWRuYW1lYXZhaWxhYmlsaXR5/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.devcenter/checkscopednameavailability 2024-10-01-preview -->
+
+#### examples
+
+- Checked scoped name availability of project catalog
+    ```bash
+        devcenter admin check-scoped-name-availability execute --name "name1" --type ""Microsoft.DevCenter/projects/catalogs" --scope "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/rg1/providers/Microsoft.DevCenter/projects/DevProject"
+    ```
+
+- Checked scoped name availability of dev center catalog
+    ```bash
+        devcenter admin check-scoped-name-availability execute --name "name1" --type ""Microsoft.DevCenter/devcenters/catalogs" --scope  "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/rg1/providers/Microsoft.DevCenter/devcenters/Contoso"
+    ```
diff --git a/Commands/devcenter/admin/devbox-definition/_create.md b/Commands/devcenter/admin/devbox-definition/_create.md
@@ -58,3 +58,14 @@ Create a dev box definition.
     ```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"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9kZXZib3hkZWZpbml0aW9ucy97fQ==/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/devboxdefinitions/{} 2024-10-01-preview -->
+
+#### 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"
+    ```
diff --git a/Commands/devcenter/admin/devbox-definition/_delete.md b/Commands/devcenter/admin/devbox-definition/_delete.md
@@ -58,3 +58,14 @@ Delete a dev box definition.
     ```bash
         devcenter admin devbox-definition delete --name "WebDevBox" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9kZXZib3hkZWZpbml0aW9ucy97fQ==/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/devboxdefinitions/{} 2024-10-01-preview -->
+
+#### examples
+
+- Delete
+    ```bash
+        devcenter admin devbox-definition delete --name "WebDevBox" --dev-center-name "Contoso" --resource-group "rg1"
+    ```
diff --git a/Commands/devcenter/admin/devbox-definition/_list.md b/Commands/devcenter/admin/devbox-definition/_list.md
@@ -88,3 +88,20 @@ List dev box definitions configured for a dev center or project.
     ```bash
         devcenter admin devbox-definition list --project-name "ContosoProject" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9kZXZib3hkZWZpbml0aW9ucw==/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/devboxdefinitions 2024-10-01-preview -->
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/projects/{}/devboxdefinitions 2024-10-01-preview -->
+
+#### 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"
+    ```
diff --git a/Commands/devcenter/admin/devbox-definition/_show.md b/Commands/devcenter/admin/devbox-definition/_show.md
@@ -88,3 +88,20 @@ Get a dev box definition configured for a dev center or a project.
     ```bash
         devcenter admin devbox-definition show --name "WebDevBox" --project-name "ContosoProject" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9kZXZib3hkZWZpbml0aW9ucy97fQ==/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/devboxdefinitions/{} 2024-10-01-preview -->
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/projects/{}/devboxdefinitions/{} 2024-10-01-preview -->
+
+#### 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"
+    ```
diff --git a/Commands/devcenter/admin/devbox-definition/_update.md b/Commands/devcenter/admin/devbox-definition/_update.md
@@ -58,3 +58,14 @@ Update a dev box definition.
     ```bash
         devcenter admin devbox-definition update --image-reference id="/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/Example/providers/Microsoft.DevCenter/devcenters/Contoso/galleries/contosogallery/images/exampleImage/version/2.0.0" --name "WebDevBox" --dev-center-name "Contoso" --resource-group "rg1"
     ```
+
+### [2024-10-01-preview](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5kZXZjZW50ZXIvZGV2Y2VudGVycy97fS9kZXZib3hkZWZpbml0aW9ucy97fQ==/2024-10-01-preview.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.devcenter/devcenters/{}/devboxdefinitions/{} 2024-10-01-preview -->
+
+#### examples
+
+- Update
+    ```bash
+        devcenter admin devbox-definition update --image-reference id="/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/Example/providers/Microsoft.DevCenter/devcenters/Contoso/galleries/contosogallery/images/exampleImage/version/2.0.0" --name "WebDevBox" --dev-center-name "Contoso" --resource-group "rg1"
+    ```