community_gallery_images
Creates, updates, deletes, gets or lists a community_gallery_images resource.
Overview
| Name | community_gallery_images |
| Type | Resource |
| Id | azure.compute.community_gallery_images |
Fields
The following fields are returned by SELECT queries:
- get
- list
| Name | Datatype | Description |
|---|---|---|
name | string | Resource name. |
architecture | string | The architecture of the image. Applicable to OS disks only. Known values are: "x64" and "Arm64". (x64, Arm64) |
artifactTags | object | The artifact tags of a community gallery resource. |
disallowed | object | Describes the disallowed disk types. |
disclaimer | string | The disclaimer for a community gallery resource. |
endOfLifeDate | string (date-time) | The end of life date of the gallery image definition. This property can be used for decommissioning purposes. This property is updatable. |
eula | string | The end-user license agreement for the current community gallery image. |
features | array | A list of gallery image features. |
hyperVGeneration | string | The hypervisor generation of the Virtual Machine. Applicable to OS disks only. Known values are: "V1" and "V2". (V1, V2) |
identifier | object | The identifier information of community gallery. |
location | string | Resource location. |
osState | string | This property allows the user to specify whether the virtual machines created under this image are 'Generalized' or 'Specialized'. Required. Known values are: "Generalized" and "Specialized". (Generalized, Specialized) |
osType | string | This property allows you to specify the type of the OS that is included in the disk when creating a VM from a managed image. Possible values are: Windows, Linux.. Required. Known values are: "Windows" and "Linux". (Windows, Linux) |
privacyStatementUri | string | Privacy statement URI for the current community gallery image. |
purchasePlan | object | Describes the gallery image definition purchase plan. This is used by marketplace images. |
recommended | object | The properties describe the recommended machine configuration for this Image Definition. These properties are updatable. |
type | string | Resource type. |
| Name | Datatype | Description |
|---|---|---|
name | string | Resource name. |
architecture | string | The architecture of the image. Applicable to OS disks only. Known values are: "x64" and "Arm64". (x64, Arm64) |
artifactTags | object | The artifact tags of a community gallery resource. |
disallowed | object | Describes the disallowed disk types. |
disclaimer | string | The disclaimer for a community gallery resource. |
endOfLifeDate | string (date-time) | The end of life date of the gallery image definition. This property can be used for decommissioning purposes. This property is updatable. |
eula | string | The end-user license agreement for the current community gallery image. |
features | array | A list of gallery image features. |
hyperVGeneration | string | The hypervisor generation of the Virtual Machine. Applicable to OS disks only. Known values are: "V1" and "V2". (V1, V2) |
identifier | object | The identifier information of community gallery. |
location | string | Resource location. |
osState | string | This property allows the user to specify whether the virtual machines created under this image are 'Generalized' or 'Specialized'. Required. Known values are: "Generalized" and "Specialized". (Generalized, Specialized) |
osType | string | This property allows you to specify the type of the OS that is included in the disk when creating a VM from a managed image. Possible values are: Windows, Linux.. Required. Known values are: "Windows" and "Linux". (Windows, Linux) |
privacyStatementUri | string | Privacy statement URI for the current community gallery image. |
purchasePlan | object | Describes the gallery image definition purchase plan. This is used by marketplace images. |
recommended | object | The properties describe the recommended machine configuration for this Image Definition. These properties are updatable. |
type | string | Resource type. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | location, public_gallery_name, gallery_image_name, subscription_id | Get a community gallery image. | |
list | select | location, public_gallery_name, subscription_id | List community gallery images inside a gallery. |
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.
| Name | Datatype | Description |
|---|---|---|
gallery_image_name | string | The name of the community gallery image definition. Required. |
location | string | The name of the Azure region. Required. |
public_gallery_name | string | The public name of the community gallery. Required. |
subscription_id | string |
SELECT examples
- get
- list
Get a community gallery image.
SELECT
name,
architecture,
artifactTags,
disallowed,
disclaimer,
endOfLifeDate,
eula,
features,
hyperVGeneration,
identifier,
location,
osState,
osType,
privacyStatementUri,
purchasePlan,
recommended,
type
FROM azure.compute.community_gallery_images
WHERE location = '{{ location }}' -- required
AND public_gallery_name = '{{ public_gallery_name }}' -- required
AND gallery_image_name = '{{ gallery_image_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;
List community gallery images inside a gallery.
SELECT
name,
architecture,
artifactTags,
disallowed,
disclaimer,
endOfLifeDate,
eula,
features,
hyperVGeneration,
identifier,
location,
osState,
osType,
privacyStatementUri,
purchasePlan,
recommended,
type
FROM azure.compute.community_gallery_images
WHERE location = '{{ location }}' -- required
AND public_gallery_name = '{{ public_gallery_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;