pulumi-azure-native-kotlin/com.pulumi.azurenative.compute.kotlin/Gallery

Gallery

class Gallery : KotlinCustomResource

Specifies information about the Shared Image Gallery that you want to create or update. Uses Azure REST API version 2024-03-03. In version 2.x of the Azure Native provider, it used API version 2022-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/#accessing-any-api-version-via-local-packages for details.

Example Usage

Create a community gallery.

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
        {
            CommunityGalleryInfo = new AzureNative.Compute.Inputs.CommunityGalleryInfoArgs
            {
                Eula = "eula",
                PublicNamePrefix = "PirPublic",
                PublisherContact = "pir@microsoft.com",
                PublisherUri = "uri",
            },
            Permissions = AzureNative.Compute.GallerySharingPermissionTypes.Community,
        },
    });
});
Content copied to clipboard
package main
import (
	compute "github.com/pulumi/pulumi-azure-native-sdk/compute/v2"
	"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{
				CommunityGalleryInfo: &compute.CommunityGalleryInfoArgs{
					Eula:             pulumi.String("eula"),
					PublicNamePrefix: pulumi.String("PirPublic"),
					PublisherContact: pulumi.String("pir@microsoft.com"),
					PublisherUri:     pulumi.String("uri"),
				},
				Permissions: pulumi.String(compute.GallerySharingPermissionTypesCommunity),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
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 com.pulumi.azurenative.compute.inputs.SharingProfileArgs;
import com.pulumi.azurenative.compute.inputs.CommunityGalleryInfoArgs;
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(SharingProfileArgs.builder()
                .communityGalleryInfo(CommunityGalleryInfoArgs.builder()
                    .eula("eula")
                    .publicNamePrefix("PirPublic")
                    .publisherContact("pir@microsoft.com")
                    .publisherUri("uri")
                    .build())
                .permissions("Community")
                .build())
            .build());
    }
}
Content copied to clipboard

Create or update a simple gallery with sharing profile.

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 = AzureNative.Compute.GallerySharingPermissionTypes.Groups,
        },
    });
});
Content copied to clipboard
package main
import (
	compute "github.com/pulumi/pulumi-azure-native-sdk/compute/v2"
	"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(compute.GallerySharingPermissionTypesGroups),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
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 com.pulumi.azurenative.compute.inputs.SharingProfileArgs;
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(SharingProfileArgs.builder()
                .permissions("Groups")
                .build())
            .build());
    }
}
Content copied to clipboard

Create or update a simple gallery with soft deletion enabled.

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",
        SoftDeletePolicy = new AzureNative.Compute.Inputs.SoftDeletePolicyArgs
        {
            IsSoftDeleteEnabled = true,
        },
    });
});
Content copied to clipboard
package main
import (
	compute "github.com/pulumi/pulumi-azure-native-sdk/compute/v2"
	"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"),
			SoftDeletePolicy: &compute.SoftDeletePolicyArgs{
				IsSoftDeleteEnabled: pulumi.Bool(true),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
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 com.pulumi.azurenative.compute.inputs.SoftDeletePolicyArgs;
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")
            .softDeletePolicy(SoftDeletePolicyArgs.builder()
                .isSoftDeleteEnabled(true)
                .build())
            .build());
    }
}
Content copied to clipboard

Create or update a simple gallery.

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",
    });
});
Content copied to clipboard
package main
import (
	compute "github.com/pulumi/pulumi-azure-native-sdk/compute/v2"
	"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
	})
}
Content copied to clipboard
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());
    }
}
Content copied to clipboard

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}
Content copied to clipboard

Properties

Link copied to clipboard
val azureApiVersion: Output<String>

The Azure API version of the resource.

Link copied to clipboard
val description: Output<String>?

The description of this Shared Image Gallery resource. This property is updatable.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val identifier: Output<GalleryIdentifierResponse>?

Describes the gallery unique name.

Link copied to clipboard
val identity: Output<GalleryIdentityResponse>?

The identity of the gallery, if configured.

Link copied to clipboard
val location: Output<String>

Resource location

Link copied to clipboard
val name: Output<String>

Resource name

Link copied to clipboard
val provisioningState: Output<String>

The provisioning state, which only appears in the response.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val sharingProfile: Output<SharingProfileResponse>?

Profile for gallery sharing to subscription or tenant

Link copied to clipboard
val sharingStatus: Output<SharingStatusResponse>

Sharing status of current gallery.

Link copied to clipboard
val softDeletePolicy: Output<SoftDeletePolicyResponse>?

Contains information about the soft deletion policy of the gallery.

Link copied to clipboard
val tags: Output<Map<String, String>>?

Resource tags

Link copied to clipboard
val type: Output<String>

Resource type

Link copied to clipboard
val urn: Output<String>