Skip to main content

images

Creates, updates, deletes, gets or lists an images resource.

Overview​

Nameimages
TypeResource
Idazure_stack.disconnected_operations.images

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringFully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}.
namestringThe name of the resource.
compatibleVersionsarrayThe versions that are compatible for this update package.
provisioningStatestringThe resource provisioning state. Known values are: "Succeeded", "Failed", and "Canceled". (Succeeded, Failed, Canceled)
releaseDatestring (date)The release date. Required.
releaseDisplayNamestringThe release name. Required.
releaseNotesstringThe release notes. Required.
releaseTypestringThe release type. Required. Known values are: "Install" and "Update". (Install, Update)
releaseVersionstringThe version of the package in the format 1.1.1. Required.
systemDataobjectAzure Resource Manager metadata containing createdBy and modifiedBy information.
typestringThe type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".
updatePropertiesobjectImage update properties for update release type image.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectresource_group_name, name, image_name, subscription_idGet the resource.
list_by_disconnected_operationselectresource_group_name, name, subscription_id$filter, $top, $skipList by disconnected operation.
list_download_uriexecresource_group_name, name, image_name, subscription_idGet the URI to download the image.

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
image_namestringThe name of the Image. Required.
namestringName of the resource. Required.
resource_group_namestringThe name of the resource group. The name is case insensitive. Required.
subscription_idstring
$filterstringFilter the result list using the given expression. Default value is None.
$skipintegerThe number of result items to skip. Default value is None.
$topintegerThe number of result items to return. Default value is None.

SELECT examples​

Get the resource.

SELECT
id,
name,
compatibleVersions,
provisioningState,
releaseDate,
releaseDisplayName,
releaseNotes,
releaseType,
releaseVersion,
systemData,
type,
updateProperties
FROM azure_stack.disconnected_operations.images
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND name = '{{ name }}' -- required
AND image_name = '{{ image_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;

Lifecycle Methods​

Get the URI to download the image.

EXEC azure_stack.disconnected_operations.images.list_download_uri
@resource_group_name='{{ resource_group_name }}' --required,
@name='{{ name }}' --required,
@image_name='{{ image_name }}' --required,
@subscription_id='{{ subscription_id }}' --required
;