CustomImage

class CustomImage : KotlinCustomResource

A custom image. Uses Azure REST API version 2018-09-15. In version 2.x of the Azure Native provider, it used API version 2018-09-15.

Example Usage

CustomImages_CreateOrUpdate

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
var customImage = new AzureNative.DevTestLab.CustomImage("customImage", new()
{
Description = "My Custom Image",
LabName = "{labName}",
Name = "{customImageName}",
ResourceGroupName = "resourceGroupName",
Tags =
{
{ "tagName1", "tagValue1" },
},
Vm = new AzureNative.DevTestLab.Inputs.CustomImagePropertiesFromVmArgs
{
LinuxOsInfo = new AzureNative.DevTestLab.Inputs.LinuxOsInfoArgs
{
LinuxOsState = AzureNative.DevTestLab.LinuxOsState.NonDeprovisioned,
},
SourceVmId = "/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/virtualmachines/{vmName}",
},
});
});
package main
import (
devtestlab "github.com/pulumi/pulumi-azure-native-sdk/devtestlab/v2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := devtestlab.NewCustomImage(ctx, "customImage", &devtestlab.CustomImageArgs{
Description: pulumi.String("My Custom Image"),
LabName: pulumi.String("{labName}"),
Name: pulumi.String("{customImageName}"),
ResourceGroupName: pulumi.String("resourceGroupName"),
Tags: pulumi.StringMap{
"tagName1": pulumi.String("tagValue1"),
},
Vm: &devtestlab.CustomImagePropertiesFromVmArgs{
LinuxOsInfo: &devtestlab.LinuxOsInfoArgs{
LinuxOsState: pulumi.String(devtestlab.LinuxOsStateNonDeprovisioned),
},
SourceVmId: pulumi.String("/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/virtualmachines/{vmName}"),
},
})
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.devtestlab.CustomImage;
import com.pulumi.azurenative.devtestlab.CustomImageArgs;
import com.pulumi.azurenative.devtestlab.inputs.CustomImagePropertiesFromVmArgs;
import com.pulumi.azurenative.devtestlab.inputs.LinuxOsInfoArgs;
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 customImage = new CustomImage("customImage", CustomImageArgs.builder()
.description("My Custom Image")
.labName("{labName}")
.name("{customImageName}")
.resourceGroupName("resourceGroupName")
.tags(Map.of("tagName1", "tagValue1"))
.vm(CustomImagePropertiesFromVmArgs.builder()
.linuxOsInfo(LinuxOsInfoArgs.builder()
.linuxOsState("NonDeprovisioned")
.build())
.sourceVmId("/subscriptions/{subscriptionId}/resourcegroups/resourceGroupName/providers/microsoft.devtestlab/labs/{labName}/virtualmachines/{vmName}")
.build())
.build());
}
}

Import

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

$ pulumi import azure-native:devtestlab:CustomImage {customImageName} /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/customimages/{name}

Properties

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

The author of the custom image.

Link copied to clipboard
val azureApiVersion: Output<String>

The Azure API version of the resource.

Link copied to clipboard
val creationDate: Output<String>

The creation date of the custom image.

Link copied to clipboard

Storage information about the plan related to this custom image

Link copied to clipboard

Storage information about the data disks present in the custom image

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

The description of the custom image.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard

Whether or not the custom images underlying offer/plan has been enabled for programmatic deployment

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

The location of the resource.

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

The Managed Image Id backing the custom image.

Link copied to clipboard

The Managed Snapshot Id backing the custom image.

Link copied to clipboard
val name: Output<String>

The name of the resource.

Link copied to clipboard

The provisioning status of the resource.

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

The tags of the resource.

Link copied to clipboard
val type: Output<String>

The type of the resource.

Link copied to clipboard

The unique immutable identifier of a resource (Guid).

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard

The VHD from which the image is to be created.

Link copied to clipboard

The virtual machine from which the image is to be created.