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
;