pulumi-azure-kotlin/com.pulumi.azure.compute.kotlin/SharedImage

SharedImage

class SharedImage : KotlinCustomResource

Manages a Shared Image within a Shared Image Gallery.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";
const example = new azure.core.ResourceGroup("example", {
    name: "example-resources",
    location: "West Europe",
});
const exampleSharedImageGallery = new azure.compute.SharedImageGallery("example", {
    name: "example_image_gallery",
    resourceGroupName: example.name,
    location: example.location,
    description: "Shared images and things.",
    tags: {
        Hello: "There",
        World: "Example",
    },
});
const exampleSharedImage = new azure.compute.SharedImage("example", {
    name: "my-image",
    galleryName: exampleSharedImageGallery.name,
    resourceGroupName: example.name,
    location: example.location,
    osType: "Linux",
    identifier: {
        publisher: "PublisherName",
        offer: "OfferName",
        sku: "ExampleSku",
    },
});

import pulumi
import pulumi_azure as azure
example = azure.core.ResourceGroup("example",
    name="example-resources",
    location="West Europe")
example_shared_image_gallery = azure.compute.SharedImageGallery("example",
    name="example_image_gallery",
    resource_group_name=example.name,
    location=example.location,
    description="Shared images and things.",
    tags={
        "Hello": "There",
        "World": "Example",
    })
example_shared_image = azure.compute.SharedImage("example",
    name="my-image",
    gallery_name=example_shared_image_gallery.name,
    resource_group_name=example.name,
    location=example.location,
    os_type="Linux",
    identifier={
        "publisher": "PublisherName",
        "offer": "OfferName",
        "sku": "ExampleSku",
    })

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Azure = Pulumi.Azure;
return await Deployment.RunAsync(() =>
{
    var example = new Azure.Core.ResourceGroup("example", new()
    {
        Name = "example-resources",
        Location = "West Europe",
    });
    var exampleSharedImageGallery = new Azure.Compute.SharedImageGallery("example", new()
    {
        Name = "example_image_gallery",
        ResourceGroupName = example.Name,
        Location = example.Location,
        Description = "Shared images and things.",
        Tags =
        {
            { "Hello", "There" },
            { "World", "Example" },
        },
    });
    var exampleSharedImage = new Azure.Compute.SharedImage("example", new()
    {
        Name = "my-image",
        GalleryName = exampleSharedImageGallery.Name,
        ResourceGroupName = example.Name,
        Location = example.Location,
        OsType = "Linux",
        Identifier = new Azure.Compute.Inputs.SharedImageIdentifierArgs
        {
            Publisher = "PublisherName",
            Offer = "OfferName",
            Sku = "ExampleSku",
        },
    });
});

package main
import (
	"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/compute"
	"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/core"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := core.NewResourceGroup(ctx, "example", &core.ResourceGroupArgs{
			Name:     pulumi.String("example-resources"),
			Location: pulumi.String("West Europe"),
		})
		if err != nil {
			return err
		}
		exampleSharedImageGallery, err := compute.NewSharedImageGallery(ctx, "example", &compute.SharedImageGalleryArgs{
			Name:              pulumi.String("example_image_gallery"),
			ResourceGroupName: example.Name,
			Location:          example.Location,
			Description:       pulumi.String("Shared images and things."),
			Tags: pulumi.StringMap{
				"Hello": pulumi.String("There"),
				"World": pulumi.String("Example"),
			},
		})
		if err != nil {
			return err
		}
		_, err = compute.NewSharedImage(ctx, "example", &compute.SharedImageArgs{
			Name:              pulumi.String("my-image"),
			GalleryName:       exampleSharedImageGallery.Name,
			ResourceGroupName: example.Name,
			Location:          example.Location,
			OsType:            pulumi.String("Linux"),
			Identifier: &compute.SharedImageIdentifierArgs{
				Publisher: pulumi.String("PublisherName"),
				Offer:     pulumi.String("OfferName"),
				Sku:       pulumi.String("ExampleSku"),
			},
		})
		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.azure.core.ResourceGroup;
import com.pulumi.azure.core.ResourceGroupArgs;
import com.pulumi.azure.compute.SharedImageGallery;
import com.pulumi.azure.compute.SharedImageGalleryArgs;
import com.pulumi.azure.compute.SharedImage;
import com.pulumi.azure.compute.SharedImageArgs;
import com.pulumi.azure.compute.inputs.SharedImageIdentifierArgs;
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 example = new ResourceGroup("example", ResourceGroupArgs.builder()
            .name("example-resources")
            .location("West Europe")
            .build());
        var exampleSharedImageGallery = new SharedImageGallery("exampleSharedImageGallery", SharedImageGalleryArgs.builder()
            .name("example_image_gallery")
            .resourceGroupName(example.name())
            .location(example.location())
            .description("Shared images and things.")
            .tags(Map.ofEntries(
                Map.entry("Hello", "There"),
                Map.entry("World", "Example")
            ))
            .build());
        var exampleSharedImage = new SharedImage("exampleSharedImage", SharedImageArgs.builder()
            .name("my-image")
            .galleryName(exampleSharedImageGallery.name())
            .resourceGroupName(example.name())
            .location(example.location())
            .osType("Linux")
            .identifier(SharedImageIdentifierArgs.builder()
                .publisher("PublisherName")
                .offer("OfferName")
                .sku("ExampleSku")
                .build())
            .build());
    }
}

resources:
  example:
    type: azure:core:ResourceGroup
    properties:
      name: example-resources
      location: West Europe
  exampleSharedImageGallery:
    type: azure:compute:SharedImageGallery
    name: example
    properties:
      name: example_image_gallery
      resourceGroupName: ${example.name}
      location: ${example.location}
      description: Shared images and things.
      tags:
        Hello: There
        World: Example
  exampleSharedImage:
    type: azure:compute:SharedImage
    name: example
    properties:
      name: my-image
      galleryName: ${exampleSharedImageGallery.name}
      resourceGroupName: ${example.name}
      location: ${example.location}
      osType: Linux
      identifier:
        publisher: PublisherName
        offer: OfferName
        sku: ExampleSku

Import

Shared Images can be imported using the resource id, e.g.

$ pulumi import azure:compute/sharedImage:SharedImage image1 /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Compute/galleries/gallery1/images/image1

Properties

acceleratedNetworkSupportEnabled

val acceleratedNetworkSupportEnabled: Output<Boolean>?

Specifies if the Shared Image supports Accelerated Network. Changing this forces a new resource to be created.

architecture

val architecture: Output<String>?

CPU architecture supported by an OS. Possible values are x64 and Arm64. Defaults to x64. Changing this forces a new resource to be created.

confidentialVmEnabled

val confidentialVmEnabled: Output<Boolean>?

Specifies if Confidential Virtual Machines enabled. It will enable all the features of trusted, with higher confidentiality features for isolate machines or encrypted data. Available for Gen2 machines. Changing this forces a new resource to be created.

confidentialVmSupported

val confidentialVmSupported: Output<Boolean>?

Specifies if supports creation of both Confidential virtual machines and Gen2 virtual machines with standard security from a compatible Gen2 OS disk VHD or Gen2 Managed image. Changing this forces a new resource to be created.

description

val description: Output<String>?

A description of this Shared Image.

diskControllerTypeNvmeEnabled

val diskControllerTypeNvmeEnabled: Output<Boolean>?

Specifies if the Shared Image supports NVMe disks. Changing this forces a new resource to be created.

diskTypesNotAlloweds

val diskTypesNotAlloweds: Output<List<String>>?

One or more Disk Types not allowed for the Image. Possible values include Standard_LRS and Premium_LRS.

endOfLifeDate

val endOfLifeDate: Output<String>?

The end of life date in RFC3339 format of the Image.

eula

val eula: Output<String>?

The End User Licence Agreement for the Shared Image. Changing this forces a new resource to be created.

galleryName

val galleryName: Output<String>

Specifies the name of the Shared Image Gallery in which this Shared Image should exist. Changing this forces a new resource to be created.

hibernationEnabled

val hibernationEnabled: Output<Boolean>?

Specifies if the Shared Image supports hibernation. Changing this forces a new resource to be created.

hyperVGeneration

val hyperVGeneration: Output<String>?

The generation of HyperV that the Virtual Machine used to create the Shared Image is based on. Possible values are V1 and V2. Defaults to V1. Changing this forces a new resource to be created.

val id: Output<String>

identifier

val identifier: Output<SharedImageIdentifier>

An identifier block as defined below.

location

val location: Output<String>

Specifies the supported Azure location where the Shared Image Gallery exists. Changing this forces a new resource to be created.

maxRecommendedMemoryInGb

val maxRecommendedMemoryInGb: Output<Int>?

Maximum memory in GB recommended for the Image.

maxRecommendedVcpuCount

val maxRecommendedVcpuCount: Output<Int>?

Maximum count of vCPUs recommended for the Image.

minRecommendedMemoryInGb

val minRecommendedMemoryInGb: Output<Int>?

Minimum memory in GB recommended for the Image.

minRecommendedVcpuCount

val minRecommendedVcpuCount: Output<Int>?

Minimum count of vCPUs recommended for the Image.

name

val name: Output<String>

Specifies the name of the Shared Image. Changing this forces a new resource to be created.

osType

val osType: Output<String>

The type of Operating System present in this Shared Image. Possible values are Linux and Windows. Changing this forces a new resource to be created.

privacyStatementUri

val privacyStatementUri: Output<String>?

The URI containing the Privacy Statement associated with this Shared Image. Changing this forces a new resource to be created.

pulumiChildResources

val pulumiChildResources: Set<KotlinResource>

pulumiResourceName

val pulumiResourceName: String

pulumiResourceType

val pulumiResourceType: String

purchasePlan

val purchasePlan: Output<SharedImagePurchasePlan>?

A purchase_plan block as defined below.

releaseNoteUri

val releaseNoteUri: Output<String>?

The URI containing the Release Notes associated with this Shared Image.

resourceGroupName

val resourceGroupName: Output<String>

The name of the resource group in which the Shared Image Gallery exists. Changing this forces a new resource to be created.

specialized

val specialized: Output<Boolean>?

Specifies that the Operating System used inside this Image has not been Generalized (for example, sysprep on Windows has not been run). Changing this forces a new resource to be created. !>Note: It's recommended to Generalize images where possible - Specialized Images reuse the same UUID internally within each Virtual Machine, which can have unintended side-effects.