Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi IDP Pulumi Cloud Packages Tutorials
  1. Packages
  2. Azure Native
  3. API Docs
  4. compute
  5. getGalleryImage
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.7.1 published on Wednesday, Aug 13, 2025 by Pulumi
pulumi/pulumi-azure-native

azure-native.compute.getGalleryImage

Explore with Pulumi AI

azure-native logo
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.7.1 published on Wednesday, Aug 13, 2025 by Pulumi
pulumi/pulumi-azure-native

    Retrieves information about a gallery image definition.

    Uses Azure REST API version 2024-03-03.

    Other available API versions: 2022-03-03, 2022-08-03, 2023-07-03. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native compute [ApiVersion]. See the version guide for details.

    Using getGalleryImage

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getGalleryImage(args: GetGalleryImageArgs, opts?: InvokeOptions): Promise<GetGalleryImageResult>
function getGalleryImageOutput(args: GetGalleryImageOutputArgs, opts?: InvokeOptions): Output<GetGalleryImageResult>
    def get_gallery_image(gallery_image_name: Optional[str] = None,
                      gallery_name: Optional[str] = None,
                      resource_group_name: Optional[str] = None,
                      opts: Optional[InvokeOptions] = None) -> GetGalleryImageResult
def get_gallery_image_output(gallery_image_name: Optional[pulumi.Input[str]] = None,
                      gallery_name: Optional[pulumi.Input[str]] = None,
                      resource_group_name: Optional[pulumi.Input[str]] = None,
                      opts: Optional[InvokeOptions] = None) -> Output[GetGalleryImageResult]
    func LookupGalleryImage(ctx *Context, args *LookupGalleryImageArgs, opts ...InvokeOption) (*LookupGalleryImageResult, error)
func LookupGalleryImageOutput(ctx *Context, args *LookupGalleryImageOutputArgs, opts ...InvokeOption) LookupGalleryImageResultOutput

    > Note: This function is named LookupGalleryImage in the Go SDK.

    public static class GetGalleryImage 
{
    public static Task<GetGalleryImageResult> InvokeAsync(GetGalleryImageArgs args, InvokeOptions? opts = null)
    public static Output<GetGalleryImageResult> Invoke(GetGalleryImageInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetGalleryImageResult> getGalleryImage(GetGalleryImageArgs args, InvokeOptions options)
public static Output<GetGalleryImageResult> getGalleryImage(GetGalleryImageArgs args, InvokeOptions options)

    fn::invoke:
  function: azure-native:compute:getGalleryImage
  arguments:
    # arguments dictionary

    The following arguments are supported:

    GalleryImageName string
    The name of the gallery image definition to be retrieved.
    GalleryName string
    The name of the Shared Image Gallery.
    ResourceGroupName string
    The name of the resource group. The name is case insensitive.
    GalleryImageName string
    The name of the gallery image definition to be retrieved.
    GalleryName string
    The name of the Shared Image Gallery.
    ResourceGroupName string
    The name of the resource group. The name is case insensitive.
    galleryImageName String
    The name of the gallery image definition to be retrieved.
    galleryName String
    The name of the Shared Image Gallery.
    resourceGroupName String
    The name of the resource group. The name is case insensitive.
    galleryImageName string
    The name of the gallery image definition to be retrieved.
    galleryName string
    The name of the Shared Image Gallery.
    resourceGroupName string
    The name of the resource group. The name is case insensitive.
    gallery_image_name str
    The name of the gallery image definition to be retrieved.
    gallery_name str
    The name of the Shared Image Gallery.
    resource_group_name str
    The name of the resource group. The name is case insensitive.
    galleryImageName String
    The name of the gallery image definition to be retrieved.
    galleryName String
    The name of the Shared Image Gallery.
    resourceGroupName String
    The name of the resource group. The name is case insensitive.

    getGalleryImage Result

    The following output properties are available:

    AzureApiVersion string
    The Azure API version of the resource.
    Id string
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    Identifier Pulumi.AzureNative.Compute.Outputs.GalleryImageIdentifierResponse
    This is the gallery image definition identifier.
    Location string
    The geo-location where the resource lives
    Name string
    The name of the resource
    OsState string
    This property allows the user to specify whether the virtual machines created under this image are 'Generalized' or '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.
    ProvisioningState string
    The provisioning state, which only appears in the response.
    SystemData Pulumi.AzureNative.Compute.Outputs.SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    Type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    AllowUpdateImage bool
    Optional. Must be set to true if the gallery image features are being updated.
    Architecture string
    The architecture of the image. Applicable to OS disks only.
    Description string
    The description of this gallery image definition resource. This property is updatable.
    Disallowed Pulumi.AzureNative.Compute.Outputs.DisallowedResponse
    Describes the disallowed disk types.
    EndOfLifeDate string
    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 Eula agreement for the gallery image definition.
    Features List<Pulumi.AzureNative.Compute.Outputs.GalleryImageFeatureResponse>
    A list of gallery image features.
    HyperVGeneration string
    The hypervisor generation of the Virtual Machine. Applicable to OS disks only.
    PrivacyStatementUri string
    The privacy statement uri.
    PurchasePlan Pulumi.AzureNative.Compute.Outputs.ImagePurchasePlanResponse
    Describes the gallery image definition purchase plan. This is used by marketplace images.
    Recommended Pulumi.AzureNative.Compute.Outputs.RecommendedMachineConfigurationResponse
    The properties describe the recommended machine configuration for this Image Definition. These properties are updatable.
    ReleaseNoteUri string
    The release note uri.
    Tags Dictionary<string, string>
    Resource tags.
    AzureApiVersion string
    The Azure API version of the resource.
    Id string
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    Identifier GalleryImageIdentifierResponse
    This is the gallery image definition identifier.
    Location string
    The geo-location where the resource lives
    Name string
    The name of the resource
    OsState string
    This property allows the user to specify whether the virtual machines created under this image are 'Generalized' or '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.
    ProvisioningState string
    The provisioning state, which only appears in the response.
    SystemData SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    Type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    AllowUpdateImage bool
    Optional. Must be set to true if the gallery image features are being updated.
    Architecture string
    The architecture of the image. Applicable to OS disks only.
    Description string
    The description of this gallery image definition resource. This property is updatable.
    Disallowed DisallowedResponse
    Describes the disallowed disk types.
    EndOfLifeDate string
    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 Eula agreement for the gallery image definition.
    Features []GalleryImageFeatureResponse
    A list of gallery image features.
    HyperVGeneration string
    The hypervisor generation of the Virtual Machine. Applicable to OS disks only.
    PrivacyStatementUri string
    The privacy statement uri.
    PurchasePlan ImagePurchasePlanResponse
    Describes the gallery image definition purchase plan. This is used by marketplace images.
    Recommended RecommendedMachineConfigurationResponse
    The properties describe the recommended machine configuration for this Image Definition. These properties are updatable.
    ReleaseNoteUri string
    The release note uri.
    Tags map[string]string
    Resource tags.
    azureApiVersion String
    The Azure API version of the resource.
    id String
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    identifier GalleryImageIdentifierResponse
    This is the gallery image definition identifier.
    location String
    The geo-location where the resource lives
    name String
    The name of the resource
    osState String
    This property allows the user to specify whether the virtual machines created under this image are 'Generalized' or '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.
    provisioningState String
    The provisioning state, which only appears in the response.
    systemData SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type String
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    allowUpdateImage Boolean
    Optional. Must be set to true if the gallery image features are being updated.
    architecture String
    The architecture of the image. Applicable to OS disks only.
    description String
    The description of this gallery image definition resource. This property is updatable.
    disallowed DisallowedResponse
    Describes the disallowed disk types.
    endOfLifeDate String
    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 Eula agreement for the gallery image definition.
    features List<GalleryImageFeatureResponse>
    A list of gallery image features.
    hyperVGeneration String
    The hypervisor generation of the Virtual Machine. Applicable to OS disks only.
    privacyStatementUri String
    The privacy statement uri.
    purchasePlan ImagePurchasePlanResponse
    Describes the gallery image definition purchase plan. This is used by marketplace images.
    recommended RecommendedMachineConfigurationResponse
    The properties describe the recommended machine configuration for this Image Definition. These properties are updatable.
    releaseNoteUri String
    The release note uri.
    tags Map<String,String>
    Resource tags.
    azureApiVersion string
    The Azure API version of the resource.
    id string
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    identifier GalleryImageIdentifierResponse
    This is the gallery image definition identifier.
    location string
    The geo-location where the resource lives
    name string
    The name of the resource
    osState string
    This property allows the user to specify whether the virtual machines created under this image are 'Generalized' or '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.
    provisioningState string
    The provisioning state, which only appears in the response.
    systemData SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    allowUpdateImage boolean
    Optional. Must be set to true if the gallery image features are being updated.
    architecture string
    The architecture of the image. Applicable to OS disks only.
    description string
    The description of this gallery image definition resource. This property is updatable.
    disallowed DisallowedResponse
    Describes the disallowed disk types.
    endOfLifeDate string
    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 Eula agreement for the gallery image definition.
    features GalleryImageFeatureResponse[]
    A list of gallery image features.
    hyperVGeneration string
    The hypervisor generation of the Virtual Machine. Applicable to OS disks only.
    privacyStatementUri string
    The privacy statement uri.
    purchasePlan ImagePurchasePlanResponse
    Describes the gallery image definition purchase plan. This is used by marketplace images.
    recommended RecommendedMachineConfigurationResponse
    The properties describe the recommended machine configuration for this Image Definition. These properties are updatable.
    releaseNoteUri string
    The release note uri.
    tags {[key: string]: string}
    Resource tags.
    azure_api_version str
    The Azure API version of the resource.
    id str
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    identifier GalleryImageIdentifierResponse
    This is the gallery image definition identifier.
    location str
    The geo-location where the resource lives
    name str
    The name of the resource
    os_state str
    This property allows the user to specify whether the virtual machines created under this image are 'Generalized' or 'Specialized'.
    os_type str
    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.
    provisioning_state str
    The provisioning state, which only appears in the response.
    system_data SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type str
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    allow_update_image bool
    Optional. Must be set to true if the gallery image features are being updated.
    architecture str
    The architecture of the image. Applicable to OS disks only.
    description str
    The description of this gallery image definition resource. This property is updatable.
    disallowed DisallowedResponse
    Describes the disallowed disk types.
    end_of_life_date str
    The end of life date of the gallery image definition. This property can be used for decommissioning purposes. This property is updatable.
    eula str
    The Eula agreement for the gallery image definition.
    features Sequence[GalleryImageFeatureResponse]
    A list of gallery image features.
    hyper_v_generation str
    The hypervisor generation of the Virtual Machine. Applicable to OS disks only.
    privacy_statement_uri str
    The privacy statement uri.
    purchase_plan ImagePurchasePlanResponse
    Describes the gallery image definition purchase plan. This is used by marketplace images.
    recommended RecommendedMachineConfigurationResponse
    The properties describe the recommended machine configuration for this Image Definition. These properties are updatable.
    release_note_uri str
    The release note uri.
    tags Mapping[str, str]
    Resource tags.
    azureApiVersion String
    The Azure API version of the resource.
    id String
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    identifier Property Map
    This is the gallery image definition identifier.
    location String
    The geo-location where the resource lives
    name String
    The name of the resource
    osState String
    This property allows the user to specify whether the virtual machines created under this image are 'Generalized' or '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.
    provisioningState String
    The provisioning state, which only appears in the response.
    systemData Property Map
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type String
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    allowUpdateImage Boolean
    Optional. Must be set to true if the gallery image features are being updated.
    architecture String
    The architecture of the image. Applicable to OS disks only.
    description String
    The description of this gallery image definition resource. This property is updatable.
    disallowed Property Map
    Describes the disallowed disk types.
    endOfLifeDate String
    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 Eula agreement for the gallery image definition.
    features List<Property Map>
    A list of gallery image features.
    hyperVGeneration String
    The hypervisor generation of the Virtual Machine. Applicable to OS disks only.
    privacyStatementUri String
    The privacy statement uri.
    purchasePlan Property Map
    Describes the gallery image definition purchase plan. This is used by marketplace images.
    recommended Property Map
    The properties describe the recommended machine configuration for this Image Definition. These properties are updatable.
    releaseNoteUri String
    The release note uri.
    tags Map<String>
    Resource tags.

    Supporting Types

    DisallowedResponse

    DiskTypes List<string>
    A list of disk types.
    DiskTypes []string
    A list of disk types.
    diskTypes List<String>
    A list of disk types.
    diskTypes string[]
    A list of disk types.
    disk_types Sequence[str]
    A list of disk types.
    diskTypes List<String>
    A list of disk types.

    GalleryImageFeatureResponse

    Name string
    The name of the gallery image feature.
    StartsAtVersion string
    The minimum gallery image version which supports this feature.
    Value string
    The value of the gallery image feature.
    Name string
    The name of the gallery image feature.
    StartsAtVersion string
    The minimum gallery image version which supports this feature.
    Value string
    The value of the gallery image feature.
    name String
    The name of the gallery image feature.
    startsAtVersion String
    The minimum gallery image version which supports this feature.
    value String
    The value of the gallery image feature.
    name string
    The name of the gallery image feature.
    startsAtVersion string
    The minimum gallery image version which supports this feature.
    value string
    The value of the gallery image feature.
    name str
    The name of the gallery image feature.
    starts_at_version str
    The minimum gallery image version which supports this feature.
    value str
    The value of the gallery image feature.
    name String
    The name of the gallery image feature.
    startsAtVersion String
    The minimum gallery image version which supports this feature.
    value String
    The value of the gallery image feature.

    GalleryImageIdentifierResponse

    Offer string
    The name of the gallery image definition offer.
    Publisher string
    The name of the gallery image definition publisher.
    Sku string
    The name of the gallery image definition SKU.
    Offer string
    The name of the gallery image definition offer.
    Publisher string
    The name of the gallery image definition publisher.
    Sku string
    The name of the gallery image definition SKU.
    offer String
    The name of the gallery image definition offer.
    publisher String
    The name of the gallery image definition publisher.
    sku String
    The name of the gallery image definition SKU.
    offer string
    The name of the gallery image definition offer.
    publisher string
    The name of the gallery image definition publisher.
    sku string
    The name of the gallery image definition SKU.
    offer str
    The name of the gallery image definition offer.
    publisher str
    The name of the gallery image definition publisher.
    sku str
    The name of the gallery image definition SKU.
    offer String
    The name of the gallery image definition offer.
    publisher String
    The name of the gallery image definition publisher.
    sku String
    The name of the gallery image definition SKU.

    ImagePurchasePlanResponse

    Name string
    The plan ID.
    Product string
    The product ID.
    Publisher string
    The publisher ID.
    Name string
    The plan ID.
    Product string
    The product ID.
    Publisher string
    The publisher ID.
    name String
    The plan ID.
    product String
    The product ID.
    publisher String
    The publisher ID.
    name string
    The plan ID.
    product string
    The product ID.
    publisher string
    The publisher ID.
    name str
    The plan ID.
    product str
    The product ID.
    publisher str
    The publisher ID.
    name String
    The plan ID.
    product String
    The product ID.
    publisher String
    The publisher ID.

    RecommendedMachineConfigurationResponse

    Memory ResourceRangeResponse
    Describes the resource range.
    VCPUs ResourceRangeResponse
    Describes the resource range.
    memory ResourceRangeResponse
    Describes the resource range.
    vCPUs ResourceRangeResponse
    Describes the resource range.
    memory ResourceRangeResponse
    Describes the resource range.
    vCPUs ResourceRangeResponse
    Describes the resource range.
    memory ResourceRangeResponse
    Describes the resource range.
    v_cpus ResourceRangeResponse
    Describes the resource range.
    memory Property Map
    Describes the resource range.
    vCPUs Property Map
    Describes the resource range.

    ResourceRangeResponse

    Max int
    The maximum number of the resource.
    Min int
    The minimum number of the resource.
    Max int
    The maximum number of the resource.
    Min int
    The minimum number of the resource.
    max Integer
    The maximum number of the resource.
    min Integer
    The minimum number of the resource.
    max number
    The maximum number of the resource.
    min number
    The minimum number of the resource.
    max int
    The maximum number of the resource.
    min int
    The minimum number of the resource.
    max Number
    The maximum number of the resource.
    min Number
    The minimum number of the resource.

    SystemDataResponse

    CreatedAt string
    The timestamp of resource creation (UTC).
    CreatedBy string
    The identity that created the resource.
    CreatedByType string
    The type of identity that created the resource.
    LastModifiedAt string
    The timestamp of resource last modification (UTC)
    LastModifiedBy string
    The identity that last modified the resource.
    LastModifiedByType string
    The type of identity that last modified the resource.
    CreatedAt string
    The timestamp of resource creation (UTC).
    CreatedBy string
    The identity that created the resource.
    CreatedByType string
    The type of identity that created the resource.
    LastModifiedAt string
    The timestamp of resource last modification (UTC)
    LastModifiedBy string
    The identity that last modified the resource.
    LastModifiedByType string
    The type of identity that last modified the resource.
    createdAt String
    The timestamp of resource creation (UTC).
    createdBy String
    The identity that created the resource.
    createdByType String
    The type of identity that created the resource.
    lastModifiedAt String
    The timestamp of resource last modification (UTC)
    lastModifiedBy String
    The identity that last modified the resource.
    lastModifiedByType String
    The type of identity that last modified the resource.
    createdAt string
    The timestamp of resource creation (UTC).
    createdBy string
    The identity that created the resource.
    createdByType string
    The type of identity that created the resource.
    lastModifiedAt string
    The timestamp of resource last modification (UTC)
    lastModifiedBy string
    The identity that last modified the resource.
    lastModifiedByType string
    The type of identity that last modified the resource.
    created_at str
    The timestamp of resource creation (UTC).
    created_by str
    The identity that created the resource.
    created_by_type str
    The type of identity that created the resource.
    last_modified_at str
    The timestamp of resource last modification (UTC)
    last_modified_by str
    The identity that last modified the resource.
    last_modified_by_type str
    The type of identity that last modified the resource.
    createdAt String
    The timestamp of resource creation (UTC).
    createdBy String
    The identity that created the resource.
    createdByType String
    The type of identity that created the resource.
    lastModifiedAt String
    The timestamp of resource last modification (UTC)
    lastModifiedBy String
    The identity that last modified the resource.
    lastModifiedByType String
    The type of identity that last modified the resource.

    Package Details

    Repository
    Azure Native pulumi/pulumi-azure-native
    License
    Apache-2.0
    azure-native logo
    This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
    Azure Native v3.7.1 published on Wednesday, Aug 13, 2025 by Pulumi
    pulumi/pulumi-azure-native