Skip to content

Export 2026-04-01 vm/ vmss extension image list-version and show #1078

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
William (william051200) wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Export 2026-04-01 vm/ vmss extension image list-version and show #1078

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions Commands/vm/extension/image/_list-versions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,3 +25,14 @@ List the versions for available extensions.
```bash
vm extension image list-versions --publisher Microsoft.Azure.Extensions -l westus -n DockerExtension -o table
```

### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2xvY2F0aW9ucy97fS9wdWJsaXNoZXJzL3t9L2FydGlmYWN0dHlwZXMvdm1leHRlbnNpb24vdHlwZXMve30vdmVyc2lvbnM=/2026-04-01.xml) **Stable**

<!-- mgmt-plane /subscriptions/{}/providers/microsoft.compute/locations/{}/publishers/{}/artifacttypes/vmextension/types/{}/versions 2026-04-01 -->

#### examples

- Find the available versions for the Docker extension.
```bash
vm extension image list-versions --publisher Microsoft.Azure.Extensions -l westus -n DockerExtension -o table
```
17 changes: 17 additions & 0 deletions Commands/vm/extension/image/_show.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,3 +37,20 @@ Display information for an extension.
vm extension image list-versions --publisher Microsoft.Azure.Extensions -l westus -n DockerExtension --query "[].name" -o tsv | sort | tail -n 1
vm extension image show -l westus --publisher Microsoft.Azure.Extensions -n DockerExtension --version LatestVersion
```

### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2xvY2F0aW9ucy97fS9wdWJsaXNoZXJzL3t9L2FydGlmYWN0dHlwZXMvdm1leHRlbnNpb24vdHlwZXMve30vdmVyc2lvbnMve30=/2026-04-01.xml) **Stable**

<!-- mgmt-plane /subscriptions/{}/providers/microsoft.compute/locations/{}/publishers/{}/artifacttypes/vmextension/types/{}/versions/{} 2026-04-01 -->

#### examples

- Show the CustomScript extension version 2.0.2.
```bash
vm extension image show -l westus -n CustomScript --publisher Microsoft.Azure.Extensions --version 2.0.2
```

- Show the latest version of the Docker extension.
```bash
vm extension image list-versions --publisher Microsoft.Azure.Extensions -l westus -n DockerExtension --query "[].name" -o tsv | sort | tail -n 1
vm extension image show -l westus --publisher Microsoft.Azure.Extensions -n DockerExtension --version LatestVersion
```
1 change: 1 addition & 0 deletions ...saXNoZXJzL3t9L2FydGlmYWN0dHlwZXMvdm1leHRlbnNpb24vdHlwZXMve30vdmVyc2lvbnM=/2026-04-01.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
{"plane": "mgmt-plane", "resources": [{"id": "/subscriptions/{}/providers/microsoft.compute/locations/{}/publishers/{}/artifacttypes/vmextension/types/{}/versions", "version": "2026-04-01", "swagger": "mgmt-plane/compute/ResourceProviders/Microsoft.Compute/Paths/L3N1YnNjcmlwdGlvbnMve3N1YnNjcmlwdGlvbklkfS9wcm92aWRlcnMvTWljcm9zb2Z0LkNvbXB1dGUvbG9jYXRpb25zL3tsb2NhdGlvbn0vcHVibGlzaGVycy97cHVibGlzaGVyTmFtZX0vYXJ0aWZhY3R0eXBlcy92bWV4dGVuc2lvbi90eXBlcy97dHlwZX0vdmVyc2lvbnM=/V/MjAyNi0wNC0wMQ=="}], "commandGroups": [{"name": "vm extension image", "commands": [{"name": "list-versions", "version": "2026-04-01", "resources": [{"id": "/subscriptions/{}/providers/microsoft.compute/locations/{}/publishers/{}/artifacttypes/vmextension/types/{}/versions", "version": "2026-04-01", "swagger": "mgmt-plane/compute/ResourceProviders/Microsoft.Compute/Paths/L3N1YnNjcmlwdGlvbnMve3N1YnNjcmlwdGlvbklkfS9wcm92aWRlcnMvTWljcm9zb2Z0LkNvbXB1dGUvbG9jYXRpb25zL3tsb2NhdGlvbn0vcHVibGlzaGVycy97cHVibGlzaGVyTmFtZX0vYXJ0aWZhY3R0eXBlcy92bWV4dGVuc2lvbi90eXBlcy97dHlwZX0vdmVyc2lvbnM=/V/MjAyNi0wNC0wMQ=="}], "argGroups": [{"name": "", "args": [{"type": "ResourceLocation", "var": "$Path.location", "options": ["l", "location"], "required": true, "idPart": "name"}, {"type": "string", "var": "$Path.publisherName", "options": ["p", "publisher", "publisher-name"], "required": true, "group": "", "idPart": "child_name_1", "help": {"short": "Image publisher name."}}, {"type": "SubscriptionId", "var": "$Path.subscriptionId", "options": ["subscription"], "required": true, "idPart": "subscription"}, {"type": "string", "var": "$Path.type", "options": ["n", "name", "type"], "required": true, "group": "", "idPart": "child_name_3", "help": {"short": "Name of the extension."}}, {"type": "string", "var": "$Query.expand", "options": ["expand"], "help": {"short": "Expand the response to include additional read-only metadata. Allowed values: `properties` — returns extended metadata (`releaseCategory`, `urgencyLevel`, `runProfile`)."}, "enum": {"items": [{"name": "properties", "value": "properties"}]}}, {"type": "string", "var": "$Query.filter", "options": ["filter"], "group": "", "help": {"short": "The filter to apply on the operation. Default value is None."}}, {"type": "string", "var": "$Query.orderby", "options": ["orderby"], "group": "", "help": {"short": "The $orderby odata query option."}}, {"type": "integer32", "var": "$Query.top", "options": ["top"], "group": "", "help": {"short": "The $top odata query option."}}]}], "operations": [{"operationId": "VirtualMachineExtensionImages_ListVersions", "http": {"path": "/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/publishers/{publisherName}/artifacttypes/vmextension/types/{type}/versions", "request": {"method": "get", "path": {"params": [{"type": "string", "name": "location", "arg": "$Path.location", "required": true, "format": {"minLength": 1}}, {"type": "string", "name": "publisherName", "arg": "$Path.publisherName", "required": true}, {"type": "string", "name": "subscriptionId", "arg": "$Path.subscriptionId", "required": true, "format": {"minLength": 1}}, {"type": "string", "name": "type", "arg": "$Path.type", "required": true}]}, "query": {"params": [{"type": "string", "name": "$expand", "arg": "$Query.expand", "enum": {"items": [{"value": "properties"}]}}, {"type": "string", "name": "$filter", "arg": "$Query.filter"}, {"type": "string", "name": "$orderby", "arg": "$Query.orderby"}, {"type": "integer32", "name": "$top", "arg": "$Query.top"}], "consts": [{"readOnly": true, "const": true, "default": {"value": "2026-04-01"}, "type": "string", "name": "api-version", "required": true, "format": {"minLength": 1}}]}}, "responses": [{"statusCode": [200], "body": {"json": {"var": "$Instance", "schema": {"type": "array<object>", "item": {"type": "object", "props": [{"readOnly": true, "type": "ResourceId", "name": "id", "format": {"template": "/subscriptions/{}/providers/Microsoft.Compute/locations/{}/publishers/{}/artifacttypes/vmextension/types/{}/versions/{}"}}, {"type": "ResourceLocation", "name": "location", "required": true}, {"readOnly": true, "type": "string", "name": "name"}, {"type": "object", "name": "properties", "props": [{"type": "string", "name": "computeRole", "required": true}, {"readOnly": true, "type": "object", "name": "extensionFeatureMetadata", "props": [{"type": "array<object>", "name": "extensionFeatureTags", "item": {"type": "object", "props": [{"type": "string", "name": "key", "required": true}, {"type": "string", "name": "value"}]}, "identifiers": ["key"]}]}, {"type": "string", "name": "handlerSchema", "required": true}, {"type": "string", "name": "operatingSystem", "required": true}, {"readOnly": true, "type": "string", "name": "releaseCategory", "enum": {"items": [{"value": "BugFix"}, {"value": "CompatibilityUpdate"}, {"value": "NewFeature"}, {"value": "Other"}, {"value": "SecurityFix"}]}}, {"readOnly": true, "type": "string", "name": "releaseNotes"}, {"readOnly": true, "type": "string", "name": "runProfile", "enum": {"items": [{"value": "Hybrid"}, {"value": "LongRunning"}, {"value": "Other"}, {"value": "RunOnce"}]}}, {"type": "boolean", "name": "supportsMultipleExtensions"}, {"readOnly": true, "type": "string", "name": "urgencyLevel", "enum": {"items": [{"value": "Emergency"}, {"value": "Expedited"}, {"value": "Regular"}]}}, {"type": "boolean", "name": "vmScaleSetEnabled"}], "clientFlatten": true}, {"readOnly": true, "type": "object", "name": "systemData", "props": [{"type": "dateTime", "name": "createdAt", "format": {"protocol": "iso"}}, {"type": "string", "name": "createdBy"}, {"type": "string", "name": "createdByType", "enum": {"items": [{"value": "Application"}, {"value": "Key"}, {"value": "ManagedIdentity"}, {"value": "User"}]}}, {"type": "dateTime", "name": "lastModifiedAt", "format": {"protocol": "iso"}}, {"type": "string", "name": "lastModifiedBy"}, {"type": "string", "name": "lastModifiedByType", "enum": {"items": [{"value": "Application"}, {"value": "Key"}, {"value": "ManagedIdentity"}, {"value": "User"}]}}]}, {"type": "object", "name": "tags", "additionalProps": {"item": {"type": "string"}}}, {"readOnly": true, "type": "string", "name": "type"}]}}}}}, {"isError": true, "body": {"json": {"schema": {"type": "@ODataV4Format"}}}}]}}], "outputs": [{"type": "array", "ref": "$Instance", "clientFlatten": true}], "confirmation": ""}]}]}
159 changes: 159 additions & 0 deletions ...JsaXNoZXJzL3t9L2FydGlmYWN0dHlwZXMvdm1leHRlbnNpb24vdHlwZXMve30vdmVyc2lvbnM=/2026-04-01.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,159 @@
<?xml version='1.0' encoding='utf-8'?>
<CodeGen plane="mgmt-plane">
<resource id="/subscriptions/{}/providers/microsoft.compute/locations/{}/publishers/{}/artifacttypes/vmextension/types/{}/versions" version="2026-04-01" swagger="mgmt-plane/compute/ResourceProviders/Microsoft.Compute/Paths/L3N1YnNjcmlwdGlvbnMve3N1YnNjcmlwdGlvbklkfS9wcm92aWRlcnMvTWljcm9zb2Z0LkNvbXB1dGUvbG9jYXRpb25zL3tsb2NhdGlvbn0vcHVibGlzaGVycy97cHVibGlzaGVyTmFtZX0vYXJ0aWZhY3R0eXBlcy92bWV4dGVuc2lvbi90eXBlcy97dHlwZX0vdmVyc2lvbnM=/V/MjAyNi0wNC0wMQ=="/>
<commandGroup name="vm extension image">
<command name="list-versions" version="2026-04-01" confirmation="">
<resource id="/subscriptions/{}/providers/microsoft.compute/locations/{}/publishers/{}/artifacttypes/vmextension/types/{}/versions" version="2026-04-01" swagger="mgmt-plane/compute/ResourceProviders/Microsoft.Compute/Paths/L3N1YnNjcmlwdGlvbnMve3N1YnNjcmlwdGlvbklkfS9wcm92aWRlcnMvTWljcm9zb2Z0LkNvbXB1dGUvbG9jYXRpb25zL3tsb2NhdGlvbn0vcHVibGlzaGVycy97cHVibGlzaGVyTmFtZX0vYXJ0aWZhY3R0eXBlcy92bWV4dGVuc2lvbi90eXBlcy97dHlwZX0vdmVyc2lvbnM=/V/MjAyNi0wNC0wMQ=="/>
<argGroup name="">
<arg type="ResourceLocation" var="$Path.location" options="location l" required="True" idPart="name"/>
<arg type="string" var="$Path.publisherName" options="publisher-name publisher p" required="True" group="" idPart="child_name_1">
<help short="Image publisher name."/>
</arg>
<arg type="SubscriptionId" var="$Path.subscriptionId" options="subscription" required="True" idPart="subscription"/>
<arg type="string" var="$Path.type" options="name type n" required="True" group="" idPart="child_name_3">
<help short="Name of the extension."/>
</arg>
<arg type="string" var="$Query.expand" options="expand">
<help short="Expand the response to include additional read-only metadata. Allowed values: `properties` — returns extended metadata (`releaseCategory`, `urgencyLevel`, `runProfile`)."/>
<enum>
<item name="properties" value="&quot;properties&quot;"/>
</enum>
</arg>
<arg type="string" var="$Query.filter" options="filter" group="">
<help short="The filter to apply on the operation. Default value is None."/>
</arg>
<arg type="string" var="$Query.orderby" options="orderby" group="">
<help short="The $orderby odata query option."/>
</arg>
<arg type="integer32" var="$Query.top" options="top" group="">
<help short="The $top odata query option."/>
</arg>
</argGroup>
<operation operationId="VirtualMachineExtensionImages_ListVersions">
<http path="/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/publishers/{publisherName}/artifacttypes/vmextension/types/{type}/versions">
<request method="get">
<path>
<param type="string" name="location" arg="$Path.location" required="True">
<format minLength="1"/>
</param>
<param type="string" name="publisherName" arg="$Path.publisherName" required="True"/>
<param type="string" name="subscriptionId" arg="$Path.subscriptionId" required="True">
<format minLength="1"/>
</param>
<param type="string" name="type" arg="$Path.type" required="True"/>
</path>
<query>
<param type="string" name="$expand" arg="$Query.expand">
<enum>
<item value="&quot;properties&quot;"/>
</enum>
</param>
<param type="string" name="$filter" arg="$Query.filter"/>
<param type="string" name="$orderby" arg="$Query.orderby"/>
<param type="integer32" name="$top" arg="$Query.top"/>
<const readOnly="True" const="True" type="string" name="api-version" required="True">
<default value="&quot;2026-04-01&quot;"/>
<format minLength="1"/>
</const>
</query>
</request>
<response statusCode="200">
<body>
<json var="$Instance">
<schema type="array<object>">
<item type="object">
<prop readOnly="True" type="ResourceId" name="id">
<format template="/subscriptions/{}/providers/Microsoft.Compute/locations/{}/publishers/{}/artifacttypes/vmextension/types/{}/versions/{}"/>
</prop>
<prop type="ResourceLocation" name="location" required="True"/>
<prop readOnly="True" type="string" name="name"/>
<prop type="object" name="properties" clientFlatten="True">
<prop type="string" name="computeRole" required="True"/>
<prop readOnly="True" type="object" name="extensionFeatureMetadata">
<prop type="array<object>" name="extensionFeatureTags" identifiers="key">
<item type="object">
<prop type="string" name="key" required="True"/>
<prop type="string" name="value"/>
</item>
</prop>
</prop>
<prop type="string" name="handlerSchema" required="True"/>
<prop type="string" name="operatingSystem" required="True"/>
<prop readOnly="True" type="string" name="releaseCategory">
<enum>
<item value="&quot;BugFix&quot;"/>
<item value="&quot;CompatibilityUpdate&quot;"/>
<item value="&quot;NewFeature&quot;"/>
<item value="&quot;Other&quot;"/>
<item value="&quot;SecurityFix&quot;"/>
</enum>
</prop>
<prop readOnly="True" type="string" name="releaseNotes"/>
<prop readOnly="True" type="string" name="runProfile">
<enum>
<item value="&quot;Hybrid&quot;"/>
<item value="&quot;LongRunning&quot;"/>
<item value="&quot;Other&quot;"/>
<item value="&quot;RunOnce&quot;"/>
</enum>
</prop>
<prop type="boolean" name="supportsMultipleExtensions"/>
<prop readOnly="True" type="string" name="urgencyLevel">
<enum>
<item value="&quot;Emergency&quot;"/>
<item value="&quot;Expedited&quot;"/>
<item value="&quot;Regular&quot;"/>
</enum>
</prop>
<prop type="boolean" name="vmScaleSetEnabled"/>
</prop>
<prop readOnly="True" type="object" name="systemData">
<prop type="dateTime" name="createdAt">
<format protocol="iso"/>
</prop>
<prop type="string" name="createdBy"/>
<prop type="string" name="createdByType">
<enum>
<item value="&quot;Application&quot;"/>
<item value="&quot;Key&quot;"/>
<item value="&quot;ManagedIdentity&quot;"/>
<item value="&quot;User&quot;"/>
</enum>
</prop>
<prop type="dateTime" name="lastModifiedAt">
<format protocol="iso"/>
</prop>
<prop type="string" name="lastModifiedBy"/>
<prop type="string" name="lastModifiedByType">
<enum>
<item value="&quot;Application&quot;"/>
<item value="&quot;Key&quot;"/>
<item value="&quot;ManagedIdentity&quot;"/>
<item value="&quot;User&quot;"/>
</enum>
</prop>
</prop>
<prop type="object" name="tags">
<additionalProp>
<item type="string"/>
</additionalProp>
</prop>
<prop readOnly="True" type="string" name="type"/>
</item>
</schema>
</json>
</body>
</response>
<response isError="True">
<body>
<json>
<schema type="@ODataV4Format"/>
</json>
</body>
</response>
</http>
</operation>
<output type="array" ref="$Instance" clientFlatten="True"/>
</command>
</commandGroup>
</CodeGen>
Loading
Loading