1. Packages
  2. Azure Native v1
  3. API Docs
  4. compute
  5. Gallery
These are the docs for Azure Native v1. We recommenend using the latest version, Azure Native v2.
Azure Native v1 v1.104.0 published on Thursday, Jul 6, 2023 by Pulumi

azure-native.compute.Gallery

Explore with Pulumi AI

azure-native-v1 logo
These are the docs for Azure Native v1. We recommenend using the latest version, Azure Native v2.
Azure Native v1 v1.104.0 published on Thursday, Jul 6, 2023 by Pulumi

    Specifies information about the Shared Image Gallery that you want to create or update. API Version: 2020-09-30.

    Example Usage

    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using AzureNative = Pulumi.AzureNative;
    
    return await Deployment.RunAsync(() => 
    {
        var gallery = new AzureNative.Compute.Gallery("gallery", new()
        {
            Description = "This is the gallery description.",
            GalleryName = "myGalleryName",
            Location = "West US",
            ResourceGroupName = "myResourceGroup",
            SharingProfile = new AzureNative.Compute.Inputs.SharingProfileArgs
            {
                Permissions = "Groups",
            },
        });
    
    });
    
    package main
    
    import (
    	compute "github.com/pulumi/pulumi-azure-native-sdk/compute"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := compute.NewGallery(ctx, "gallery", &compute.GalleryArgs{
    			Description:       pulumi.String("This is the gallery description."),
    			GalleryName:       pulumi.String("myGalleryName"),
    			Location:          pulumi.String("West US"),
    			ResourceGroupName: pulumi.String("myResourceGroup"),
    			SharingProfile: &compute.SharingProfileArgs{
    				Permissions: pulumi.String("Groups"),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.azurenative.compute.Gallery;
    import com.pulumi.azurenative.compute.GalleryArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var gallery = new Gallery("gallery", GalleryArgs.builder()        
                .description("This is the gallery description.")
                .galleryName("myGalleryName")
                .location("West US")
                .resourceGroupName("myResourceGroup")
                .sharingProfile(Map.of("permissions", "Groups"))
                .build());
    
        }
    }
    
    import pulumi
    import pulumi_azure_native as azure_native
    
    gallery = azure_native.compute.Gallery("gallery",
        description="This is the gallery description.",
        gallery_name="myGalleryName",
        location="West US",
        resource_group_name="myResourceGroup",
        sharing_profile=azure_native.compute.SharingProfileArgs(
            permissions="Groups",
        ))
    
    import * as pulumi from "@pulumi/pulumi";
    import * as azure_native from "@pulumi/azure-native";
    
    const gallery = new azure_native.compute.Gallery("gallery", {
        description: "This is the gallery description.",
        galleryName: "myGalleryName",
        location: "West US",
        resourceGroupName: "myResourceGroup",
        sharingProfile: {
            permissions: "Groups",
        },
    });
    
    resources:
      gallery:
        type: azure-native:compute:Gallery
        properties:
          description: This is the gallery description.
          galleryName: myGalleryName
          location: West US
          resourceGroupName: myResourceGroup
          sharingProfile:
            permissions: Groups
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using AzureNative = Pulumi.AzureNative;
    
    return await Deployment.RunAsync(() => 
    {
        var gallery = new AzureNative.Compute.Gallery("gallery", new()
        {
            Description = "This is the gallery description.",
            GalleryName = "myGalleryName",
            Location = "West US",
            ResourceGroupName = "myResourceGroup",
        });
    
    });
    
    package main
    
    import (
    	compute "github.com/pulumi/pulumi-azure-native-sdk/compute"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := compute.NewGallery(ctx, "gallery", &compute.GalleryArgs{
    			Description:       pulumi.String("This is the gallery description."),
    			GalleryName:       pulumi.String("myGalleryName"),
    			Location:          pulumi.String("West US"),
    			ResourceGroupName: pulumi.String("myResourceGroup"),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.azurenative.compute.Gallery;
    import com.pulumi.azurenative.compute.GalleryArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var gallery = new Gallery("gallery", GalleryArgs.builder()        
                .description("This is the gallery description.")
                .galleryName("myGalleryName")
                .location("West US")
                .resourceGroupName("myResourceGroup")
                .build());
    
        }
    }
    
    import pulumi
    import pulumi_azure_native as azure_native
    
    gallery = azure_native.compute.Gallery("gallery",
        description="This is the gallery description.",
        gallery_name="myGalleryName",
        location="West US",
        resource_group_name="myResourceGroup")
    
    import * as pulumi from "@pulumi/pulumi";
    import * as azure_native from "@pulumi/azure-native";
    
    const gallery = new azure_native.compute.Gallery("gallery", {
        description: "This is the gallery description.",
        galleryName: "myGalleryName",
        location: "West US",
        resourceGroupName: "myResourceGroup",
    });
    
    resources:
      gallery:
        type: azure-native:compute:Gallery
        properties:
          description: This is the gallery description.
          galleryName: myGalleryName
          location: West US
          resourceGroupName: myResourceGroup
    

    Create Gallery Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Gallery(name: string, args: GalleryArgs, opts?: CustomResourceOptions);
    @overload
    def Gallery(resource_name: str,
                args: GalleryArgs,
                opts: Optional[ResourceOptions] = None)
    
    @overload
    def Gallery(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                resource_group_name: Optional[str] = None,
                description: Optional[str] = None,
                gallery_name: Optional[str] = None,
                location: Optional[str] = None,
                sharing_profile: Optional[SharingProfileArgs] = None,
                tags: Optional[Mapping[str, str]] = None)
    func NewGallery(ctx *Context, name string, args GalleryArgs, opts ...ResourceOption) (*Gallery, error)
    public Gallery(string name, GalleryArgs args, CustomResourceOptions? opts = null)
    public Gallery(String name, GalleryArgs args)
    public Gallery(String name, GalleryArgs args, CustomResourceOptions options)
    
    type: azure-native:compute:Gallery
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args GalleryArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args GalleryArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args GalleryArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args GalleryArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args GalleryArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var galleryResource = new AzureNative.Compute.Gallery("galleryResource", new()
    {
        ResourceGroupName = "string",
        Description = "string",
        GalleryName = "string",
        Location = "string",
        SharingProfile = 
        {
            { "permissions", "string" },
        },
        Tags = 
        {
            { "string", "string" },
        },
    });
    
    example, err := compute.NewGallery(ctx, "galleryResource", &compute.GalleryArgs{
    	ResourceGroupName: "string",
    	Description:       "string",
    	GalleryName:       "string",
    	Location:          "string",
    	SharingProfile: map[string]interface{}{
    		"permissions": "string",
    	},
    	Tags: map[string]interface{}{
    		"string": "string",
    	},
    })
    
    var galleryResource = new Gallery("galleryResource", GalleryArgs.builder()
        .resourceGroupName("string")
        .description("string")
        .galleryName("string")
        .location("string")
        .sharingProfile(%!v(PANIC=Format method: runtime error: invalid memory address or nil pointer dereference))
        .tags(%!v(PANIC=Format method: runtime error: invalid memory address or nil pointer dereference))
        .build());
    
    gallery_resource = azure_native.compute.Gallery("galleryResource",
        resource_group_name=string,
        description=string,
        gallery_name=string,
        location=string,
        sharing_profile={
            permissions: string,
        },
        tags={
            string: string,
        })
    
    const galleryResource = new azure_native.compute.Gallery("galleryResource", {
        resourceGroupName: "string",
        description: "string",
        galleryName: "string",
        location: "string",
        sharingProfile: {
            permissions: "string",
        },
        tags: {
            string: "string",
        },
    });
    
    type: azure-native:compute:Gallery
    properties:
        description: string
        galleryName: string
        location: string
        resourceGroupName: string
        sharingProfile:
            permissions: string
        tags:
            string: string
    

    Gallery Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Gallery resource accepts the following input properties:

    ResourceGroupName string
    The name of the resource group.
    Description string
    The description of this Shared Image Gallery resource. This property is updatable.
    GalleryName string
    The name of the Shared Image Gallery. The allowed characters are alphabets and numbers with dots and periods allowed in the middle. The maximum length is 80 characters.
    Location string
    Resource location
    SharingProfile Pulumi.AzureNative.Compute.Inputs.SharingProfile
    Profile for gallery sharing to subscription or tenant
    Tags Dictionary<string, string>
    Resource tags
    ResourceGroupName string
    The name of the resource group.
    Description string
    The description of this Shared Image Gallery resource. This property is updatable.
    GalleryName string
    The name of the Shared Image Gallery. The allowed characters are alphabets and numbers with dots and periods allowed in the middle. The maximum length is 80 characters.
    Location string
    Resource location
    SharingProfile SharingProfileArgs
    Profile for gallery sharing to subscription or tenant
    Tags map[string]string
    Resource tags
    resourceGroupName String
    The name of the resource group.
    description String
    The description of this Shared Image Gallery resource. This property is updatable.
    galleryName String
    The name of the Shared Image Gallery. The allowed characters are alphabets and numbers with dots and periods allowed in the middle. The maximum length is 80 characters.
    location String
    Resource location
    sharingProfile SharingProfile
    Profile for gallery sharing to subscription or tenant
    tags Map<String,String>
    Resource tags
    resourceGroupName string
    The name of the resource group.
    description string
    The description of this Shared Image Gallery resource. This property is updatable.
    galleryName string
    The name of the Shared Image Gallery. The allowed characters are alphabets and numbers with dots and periods allowed in the middle. The maximum length is 80 characters.
    location string
    Resource location
    sharingProfile SharingProfile
    Profile for gallery sharing to subscription or tenant
    tags {[key: string]: string}
    Resource tags
    resource_group_name str
    The name of the resource group.
    description str
    The description of this Shared Image Gallery resource. This property is updatable.
    gallery_name str
    The name of the Shared Image Gallery. The allowed characters are alphabets and numbers with dots and periods allowed in the middle. The maximum length is 80 characters.
    location str
    Resource location
    sharing_profile SharingProfileArgs
    Profile for gallery sharing to subscription or tenant
    tags Mapping[str, str]
    Resource tags
    resourceGroupName String
    The name of the resource group.
    description String
    The description of this Shared Image Gallery resource. This property is updatable.
    galleryName String
    The name of the Shared Image Gallery. The allowed characters are alphabets and numbers with dots and periods allowed in the middle. The maximum length is 80 characters.
    location String
    Resource location
    sharingProfile Property Map
    Profile for gallery sharing to subscription or tenant
    tags Map<String>
    Resource tags

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Gallery resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    Resource name
    ProvisioningState string
    The provisioning state, which only appears in the response.
    Type string
    Resource type
    Identifier Pulumi.AzureNative.Compute.Outputs.GalleryIdentifierResponse
    Describes the gallery unique name.
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    Resource name
    ProvisioningState string
    The provisioning state, which only appears in the response.
    Type string
    Resource type
    Identifier GalleryIdentifierResponse
    Describes the gallery unique name.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    Resource name
    provisioningState String
    The provisioning state, which only appears in the response.
    type String
    Resource type
    identifier GalleryIdentifierResponse
    Describes the gallery unique name.
    id string
    The provider-assigned unique ID for this managed resource.
    name string
    Resource name
    provisioningState string
    The provisioning state, which only appears in the response.
    type string
    Resource type
    identifier GalleryIdentifierResponse
    Describes the gallery unique name.
    id str
    The provider-assigned unique ID for this managed resource.
    name str
    Resource name
    provisioning_state str
    The provisioning state, which only appears in the response.
    type str
    Resource type
    identifier GalleryIdentifierResponse
    Describes the gallery unique name.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    Resource name
    provisioningState String
    The provisioning state, which only appears in the response.
    type String
    Resource type
    identifier Property Map
    Describes the gallery unique name.

    Supporting Types

    GalleryIdentifierResponse, GalleryIdentifierResponseArgs

    UniqueName string
    The unique name of the Shared Image Gallery. This name is generated automatically by Azure.
    UniqueName string
    The unique name of the Shared Image Gallery. This name is generated automatically by Azure.
    uniqueName String
    The unique name of the Shared Image Gallery. This name is generated automatically by Azure.
    uniqueName string
    The unique name of the Shared Image Gallery. This name is generated automatically by Azure.
    unique_name str
    The unique name of the Shared Image Gallery. This name is generated automatically by Azure.
    uniqueName String
    The unique name of the Shared Image Gallery. This name is generated automatically by Azure.

    GallerySharingPermissionTypes, GallerySharingPermissionTypesArgs

    Private
    Private
    Groups
    Groups
    GallerySharingPermissionTypesPrivate
    Private
    GallerySharingPermissionTypesGroups
    Groups
    Private
    Private
    Groups
    Groups
    Private
    Private
    Groups
    Groups
    PRIVATE
    Private
    GROUPS
    Groups
    "Private"
    Private
    "Groups"
    Groups

    SharingProfile, SharingProfileArgs

    Permissions string | Pulumi.AzureNative.Compute.GallerySharingPermissionTypes
    This property allows you to specify the permission of sharing gallery. Possible values are: Private Groups
    Permissions string | GallerySharingPermissionTypes
    This property allows you to specify the permission of sharing gallery. Possible values are: Private Groups
    permissions String | GallerySharingPermissionTypes
    This property allows you to specify the permission of sharing gallery. Possible values are: Private Groups
    permissions string | GallerySharingPermissionTypes
    This property allows you to specify the permission of sharing gallery. Possible values are: Private Groups
    permissions str | GallerySharingPermissionTypes
    This property allows you to specify the permission of sharing gallery. Possible values are: Private Groups
    permissions String | "Private" | "Groups"
    This property allows you to specify the permission of sharing gallery. Possible values are: Private Groups

    SharingProfileGroupResponse, SharingProfileGroupResponseArgs

    Ids List<string>
    A list of subscription/tenant ids the gallery is aimed to be shared to.
    Type string
    This property allows you to specify the type of sharing group. Possible values are: Subscriptions AADTenants
    Ids []string
    A list of subscription/tenant ids the gallery is aimed to be shared to.
    Type string
    This property allows you to specify the type of sharing group. Possible values are: Subscriptions AADTenants
    ids List<String>
    A list of subscription/tenant ids the gallery is aimed to be shared to.
    type String
    This property allows you to specify the type of sharing group. Possible values are: Subscriptions AADTenants
    ids string[]
    A list of subscription/tenant ids the gallery is aimed to be shared to.
    type string
    This property allows you to specify the type of sharing group. Possible values are: Subscriptions AADTenants
    ids Sequence[str]
    A list of subscription/tenant ids the gallery is aimed to be shared to.
    type str
    This property allows you to specify the type of sharing group. Possible values are: Subscriptions AADTenants
    ids List<String>
    A list of subscription/tenant ids the gallery is aimed to be shared to.
    type String
    This property allows you to specify the type of sharing group. Possible values are: Subscriptions AADTenants

    SharingProfileResponse, SharingProfileResponseArgs

    Groups List<Pulumi.AzureNative.Compute.Inputs.SharingProfileGroupResponse>
    A list of sharing profile groups.
    Permissions string
    This property allows you to specify the permission of sharing gallery. Possible values are: Private Groups
    Groups []SharingProfileGroupResponse
    A list of sharing profile groups.
    Permissions string
    This property allows you to specify the permission of sharing gallery. Possible values are: Private Groups
    groups List<SharingProfileGroupResponse>
    A list of sharing profile groups.
    permissions String
    This property allows you to specify the permission of sharing gallery. Possible values are: Private Groups
    groups SharingProfileGroupResponse[]
    A list of sharing profile groups.
    permissions string
    This property allows you to specify the permission of sharing gallery. Possible values are: Private Groups
    groups Sequence[SharingProfileGroupResponse]
    A list of sharing profile groups.
    permissions str
    This property allows you to specify the permission of sharing gallery. Possible values are: Private Groups
    groups List<Property Map>
    A list of sharing profile groups.
    permissions String
    This property allows you to specify the permission of sharing gallery. Possible values are: Private Groups

    Import

    An existing resource can be imported using its type token, name, and identifier, e.g.

    $ pulumi import azure-native:compute:Gallery myGalleryName /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName} 
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    azure-native-v1 pulumi/pulumi-azure-native
    License
    Apache-2.0
    azure-native-v1 logo
    These are the docs for Azure Native v1. We recommenend using the latest version, Azure Native v2.
    Azure Native v1 v1.104.0 published on Thursday, Jul 6, 2023 by Pulumi