[devcenter] Update data plane API to v2024-10-01-preview

src/devcenter/HISTORY.rst

@@ -2,6 +2,10 @@
 
 Release History
 ===============
+6.2.0
+++++++
+* Update data plane API to v2024-10-01-preview
+
 6.1.0
 ++++++
 * Update control plane API to v2024-10-01-preview

src/devcenter/azext_devcenter/__init__.py

@@ -17,10 +17,9 @@
 class DevCenterCommandsLoader(AzCommandsLoader):
     def __init__(self, cli_ctx=None):
         from azure.cli.core.commands import CliCommandType
-        from azext_devcenter._client_factory import cf_devcenter_cl
 
         devcenter_custom = CliCommandType(
-            operations_tmpl="azext_devcenter.custom#{}", client_factory=cf_devcenter_cl
+            operations_tmpl="azext_devcenter.custom#{}"
         )
         parent = super(DevCenterCommandsLoader, self)
         parent.__init__(cli_ctx=cli_ctx, custom_command_type=devcenter_custom)
@@ -44,7 +43,6 @@ def load_command_table(self, args):
 
     def load_arguments(self, command):
         from azext_devcenter._params import load_arguments
-
         load_arguments(self, command)
 
 

src/devcenter/azext_devcenter/_help.py

@@ -49,6 +49,38 @@
 --name "DevProject"
 """
 
+helps[
+    "devcenter dev project list-abilities"
+] = """
+    type: command
+    short-summary: "List the signed-in user's permitted abilities in a project."
+    examples:
+      - name: List using dev center
+        text: |-
+               az devcenter dev project list-abilities --dev-center-name "ContosoDevCenter" --user-id "00000000-0000-0000-0000-000000000000" \
+--name "DevProject"
+      - name: List using endpoint
+        text: |-
+               az devcenter dev project list-abilities --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --user-id "00000000-0000-0000-0000-000000000000" \
+--name "DevProject"
+"""
+
+helps[
+    "devcenter dev project show-operation"
+] = """
+    type: command
+    short-summary: "Get the status of an operation."
+    examples:
+      - name: Get using dev center
+        text: |-
+               az devcenter dev project show-operation --dev-center-name "ContosoDevCenter" \
+--name "DevProject" --operation-id "f5dbdfab-fa0e-4831-8d13-25359aa5e680"
+      - name: Get using endpoint
+        text: |-
+               az devcenter dev project show-operation --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" \
+--name "DevProject" --operation-id "f5dbdfab-fa0e-4831-8d13-25359aa5e680"
+"""
+
 helps[
     "devcenter dev pool"
 ] = """
@@ -182,13 +214,14 @@
       - name: Get using dev center
         text: |-
                az devcenter dev dev-box show --name "MyDevBox" --dev-center-name "ContosoDevCenter" \
-               --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
+--project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
       - name: Get using endpoint
         text: |-
                az devcenter dev dev-box show --name "MyDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" \
 --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
 """
 
+
 helps[
     "devcenter dev dev-box create"
 ] = """
@@ -214,7 +247,7 @@
       - name: Delete using dev center
         text: |-
                az devcenter dev dev-box delete --name "MyDevBox" --dev-center-name "ContosoDevCenter" \
-               --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
+--project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
       - name: Delete using endpoint
         text: |-
                az devcenter dev dev-box delete --name "MyDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" \
@@ -246,7 +279,7 @@
       - name: Start using dev center
         text: |-
                az devcenter dev dev-box start --name "MyDevBox" --dev-center-name "ContosoDevCenter" \
-               --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
+--project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
       - name: Start using endpoint
         text: |-
                az devcenter dev dev-box start --name "MyDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" \
@@ -262,7 +295,7 @@
       - name: Restart using dev center
         text: |-
                az devcenter dev dev-box restart --name "MyDevBox" --dev-center-name "ContosoDevCenter" \
-               --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
+--project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
       - name: Restart using endpoint
         text: |-
                az devcenter dev dev-box restart --name "MyDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" \
@@ -278,7 +311,7 @@
       - name: Repair using dev center
         text: |-
                az devcenter dev dev-box repair --name "MyDevBox" --dev-center-name "ContosoDevCenter" \
-               --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
+--project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
       - name: Repair using endpoint
         text: |-
                az devcenter dev dev-box repair --name "MyDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" \
@@ -294,7 +327,7 @@
       - name: Stop using dev center
         text: |-
                az devcenter dev dev-box stop --name "MyDevBox" --dev-center-name "ContosoDevCenter" \
-               --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
+--project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
       - name: Stop using endpoint
         text: |-
                az devcenter dev dev-box stop --name "MyDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" \
@@ -423,6 +456,70 @@
 "schedule-default" --user-id "00000000-0000-0000-0000-000000000000"
 """
 
+helps[
+    "devcenter dev dev-box capture-snapshot"
+] = """
+    type: command
+    short-summary: "Captures a manual snapshot of the dev box."
+    examples:
+      - name: Capture snapshot using dev center
+        text: |-
+               az devcenter dev dev-box capture-snapshot --name "MyDevBox" --dev-center-name "ContosoDevCenter" \
+--project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
+      - name: Capture snapshot using endpoint
+        text: |-
+               az devcenter dev dev-box capture-snapshot --name "MyDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" \
+--project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
+"""
+
+helps[
+    "devcenter dev dev-box restore-snapshot"
+] = """
+    type: command
+    short-summary: "Restores a dev box to a specified snapshot."
+    examples:
+      - name: Restore snapshot using dev center
+        text: |-
+               az devcenter dev dev-box restore-snapshot --name "MyDevBox" --dev-center-name "ContosoDevCenter" \
+--project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --snapshot-id "CPC_f5dbdfab-fa0e-4831-8d13-25359aa5e680"
+      - name: Restore snapshot using endpoint
+        text: |-
+               az devcenter dev dev-box restore-snapshot --name "MyDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" \
+--project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --snapshot-id "CPC_f5dbdfab-fa0e-4831-8d13-25359aa5e680"
+"""
+
+helps[
+    "devcenter dev dev-box show-snapshot"
+] = """
+    type: command
+    short-summary: "Get a snapshot by snapshot id."
+    examples:
+      - name: Get snapshot using dev center
+        text: |-
+               az devcenter dev dev-box show-snapshot --name "MyDevBox" --dev-center-name "ContosoDevCenter" \
+--project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --snapshot-id "CPC_f5dbdfab-fa0e-4831-8d13-25359aa5e680"
+      - name: Get snapshot using endpoint
+        text: |-
+               az devcenter dev dev-box show-snapshot --name "MyDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" \
+--project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --snapshot-id "CPC_f5dbdfab-fa0e-4831-8d13-25359aa5e680"
+"""
+
+helps[
+    "devcenter dev dev-box list-snapshot"
+] = """
+    type: command
+    short-summary: "List snapshots for a dev box"
+    examples:
+      - name: List snapshots using dev center
+        text: |-
+               az devcenter dev dev-box list-snapshot --name "MyDevBox" --dev-center-name "ContosoDevCenter" \
+--project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
+      - name: List snapshots using endpoint
+        text: |-
+               az devcenter dev dev-box list-snapshot --name "MyDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" \
+--project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
+"""
+
 helps[
     "devcenter dev environment"
 ] = """
@@ -471,6 +568,7 @@
 --name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
 """
 
+
 helps[
     "devcenter dev environment create"
 ] = """
@@ -603,6 +701,61 @@
 --project-name "DevProject"
 """
 
+helps[
+    "devcenter dev environment-type show"
+] = """
+    type: command
+    short-summary: "Get an environment type configured for a project."
+    examples:
+      - name: Get using dev center
+        text: |-
+               az devcenter dev environment-type show --dev-center-name "ContosoDevCenter" \
+--project-name "DevProject" --environment-type-name "foo"
+      - name: Get using endpoint
+        text: |-
+               az devcenter dev environment-type show --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" \
+--project-name "DevProject" --environment-type-name "foo"
+"""
+
+helps[
+    "devcenter dev environment-type list-abilities"
+] = """
+    type: command
+    short-summary: "List the signed-in user's permitted abilities in an environment type."
+    examples:
+      - name: List using dev center
+        text: |-
+               az devcenter dev environment-type list-abilities --dev-center-name "ContosoDevCenter" \
+--project-name "DevProject" --environment-type-name "foo" --user-id "00000000-0000-0000-0000-000000000000"
+      - name: List using endpoint
+        text: |-
+               az devcenter dev environment-type list-abilities --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" \
+--project-name "DevProject" --environment-type-name "foo" --user-id "00000000-0000-0000-0000-000000000000"
+"""
+
+helps[
+    "devcenter dev image-build"
+] = """
+    type: group
+    short-summary: Manage image builds.
+"""
+
+helps[
+    "devcenter dev image-build show-log"
+] = """
+    type: command
+    short-summary: "Get the log for an imaging build task."
+    examples:
+      - name: Get using dev center
+        text: |-
+               az devcenter dev image-build show-log --dev-center-name "ContosoDevCenter" \
+--project-name "DevProject" --image-build-log-id "f5dbdfab-fa0e-4831-8d13-25359aa5e680"
+      - name: Get using endpoint
+        text: |-
+               az devcenter dev image-build show-log --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" \
+--project-name "DevProject" --image-build-log-id "f5dbdfab-fa0e-4831-8d13-25359aa5e680"
+"""
+
 helps[
     "devcenter dev environment-definition"
 ] = """
@@ -801,12 +954,12 @@
       - name: Get using dev center
         text: |-
               az devcenter dev environment update-expiration-date --dev-center-name "ContosoDevCenter" \
---name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --expiration "2025-11-30T22:35:00+00:00"
+--name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --expiration "2026-11-30T22:35:00+00:00"
     examples:
       - name: Get using endpoint
         text: |-
               az devcenter dev environment update-expiration-date --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" \
---name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --expiration "2025-11-30T22:35:00+00:00"
+--name "mydevenv" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --expiration "2026-11-30T22:35:00+00:00"
 
 """