import * as pulumi from "@pulumi/pulumi"; /** * Manages an implicit Data Disk of a Virtual Machine. * * > **Note:** The Implicit Data Disk will be deleted instantly after this resource is destroyed. If you want to detach this disk only, you may set `detachImplicitDataDiskOnDeletion` field to `true` within the `virtualMachine` block in the provider `features` block. * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as azure from "@pulumi/azure"; * * const config = new pulumi.Config(); * const prefix = config.get("prefix") || "example"; * const vmName = `${prefix}-vm`; * const example = new azure.core.ResourceGroup("example", { * name: `${prefix}-resources`, * location: "West Europe", * }); * const main = new azure.network.VirtualNetwork("main", { * name: `${prefix}-network`, * addressSpaces: ["10.0.0.0/16"], * location: example.location, * resourceGroupName: example.name, * }); * const internal = new azure.network.Subnet("internal", { * name: "internal", * resourceGroupName: example.name, * virtualNetworkName: main.name, * addressPrefixes: ["10.0.2.0/24"], * }); * const mainNetworkInterface = new azure.network.NetworkInterface("main", { * name: `${prefix}-nic`, * location: example.location, * resourceGroupName: example.name, * ipConfigurations: [{ * name: "internal", * subnetId: internal.id, * privateIpAddressAllocation: "Dynamic", * }], * }); * const exampleVirtualMachine = new azure.compute.VirtualMachine("example", { * name: vmName, * location: example.location, * resourceGroupName: example.name, * networkInterfaceIds: [mainNetworkInterface.id], * vmSize: "Standard_F2", * storageImageReference: { * publisher: "Canonical", * offer: "0001-com-ubuntu-server-jammy", * sku: "22_04-lts", * version: "latest", * }, * storageOsDisk: { * name: "myosdisk1", * caching: "ReadWrite", * createOption: "FromImage", * managedDiskType: "Standard_LRS", * }, * osProfile: { * computerName: vmName, * adminUsername: "testadmin", * adminPassword: "Password1234!", * }, * osProfileLinuxConfig: { * disablePasswordAuthentication: false, * }, * }); * const exampleManagedDisk = new azure.compute.ManagedDisk("example", { * name: `${vmName}-disk1`, * location: example.location, * resourceGroupName: example.name, * storageAccountType: "Standard_LRS", * createOption: "Empty", * diskSizeGb: 10, * }); * const exampleSnapshot = new azure.compute.Snapshot("example", { * name: `${vmName}-snapshot1`, * location: example.location, * resourceGroupName: example.name, * createOption: "Copy", * sourceUri: exampleManagedDisk.id, * }); * const exampleImplicitDataDiskFromSource = new azure.compute.ImplicitDataDiskFromSource("example", { * name: `${vmName}-implicitdisk1`, * virtualMachineId: testAzurermVirtualMachine.id, * lun: 0, * caching: "None", * createOption: "Copy", * diskSizeGb: 20, * sourceResourceId: test.id, * }); * ``` * * ## API Providers * * * This resource uses the following Azure API Providers: * * * `Microsoft.Compute` - 2024-03-01, 2023-04-02 * * ## Import * * The implicit Data Disk of the Virtual Machine can be imported using the `resource id`, e.g. * * ```sh * $ pulumi import azure:compute/implicitDataDiskFromSource:ImplicitDataDiskFromSource example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Compute/virtualMachines/machine1/dataDisks/disk1 * ``` * * > **Note:** This is a Terraform Unique ID matching the format: `{virtualMachineID}/dataDisks/{diskName}` */ export declare class ImplicitDataDiskFromSource extends pulumi.CustomResource { /** * Get an existing ImplicitDataDiskFromSource resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: ImplicitDataDiskFromSourceState, opts?: pulumi.CustomResourceOptions): ImplicitDataDiskFromSource; /** * Returns true if the given object is an instance of ImplicitDataDiskFromSource. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is ImplicitDataDiskFromSource; /** * Specifies the caching requirements for this Data Disk. Possible values are `ReadOnly` and `ReadWrite`. */ readonly caching: pulumi.Output; /** * Specifies the Create Option of the Data Disk. The only possible value is `Copy`. Changing this forces a new resource to be created. */ readonly createOption: pulumi.Output; /** * Specifies the size of the Data Disk in gigabytes. * * > **Note:** Updating `diskSizeGb` to shrink the disk size is not supported on Azure and forces a new Data Disk to be created. * * > **Note:** In certain conditions the Data Disk size can be updated without shutting down the Virtual Machine, however only a subset of Virtual Machine SKUs/Disk combinations support this. More information can be found [for Linux Virtual Machines](https://learn.microsoft.com/en-us/azure/virtual-machines/linux/expand-disks?tabs=azure-cli%2Cubuntu#expand-without-downtime) and [Windows Virtual Machines](https://learn.microsoft.com/azure/virtual-machines/windows/expand-os-disk#expand-without-downtime) respectively. * * > **Note:** If the VM does not meet the requirements to expand the disk without downtime, changing this value is disruptive. The VM will be shut down and deallocated as required by Azure to action the change. Terraform will attempt to start the VM again after the update if it was in a `running` state prior to the change. * * > **Note:** Expanding Ultra Disks and Premium SSD v2 disks without downtime has additional limitations. Allow up to 10 minutes for the correct size to be reflected, and a `rescan` function may be required. For more details, refer to [Expand with Ultra Disks and Premium SSD v2](https://learn.microsoft.com/azure/virtual-machines/linux/expand-disks?tabs=ubuntu#expand-with-ultra-disks-and-premium-ssd-v2). */ readonly diskSizeGb: pulumi.Output; /** * The Logical Unit Number of the Data Disk, which needs to be unique within the Virtual Machine. Changing this forces a new resource to be created. */ readonly lun: pulumi.Output; /** * Specifies the name of this Data Disk. Changing this forces a new resource to be created. */ readonly name: pulumi.Output; /** * The ID of the source resource which this Data Disk was created from. Changing this forces a new resource to be created. */ readonly sourceResourceId: pulumi.Output; /** * The ID of the Virtual Machine to which the Data Disk should be attached. Changing this forces a new resource to be created. */ readonly virtualMachineId: pulumi.Output; /** * Specifies if Write Accelerator is enabled on the disk. This can only be enabled on `Premium_LRS` managed disks with no caching and [M-Series VMs](https://docs.microsoft.com/azure/virtual-machines/workloads/sap/how-to-enable-write-accelerator). Defaults to `false`. */ readonly writeAcceleratorEnabled: pulumi.Output; /** * Create a ImplicitDataDiskFromSource resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: ImplicitDataDiskFromSourceArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering ImplicitDataDiskFromSource resources. */ export interface ImplicitDataDiskFromSourceState { /** * Specifies the caching requirements for this Data Disk. Possible values are `ReadOnly` and `ReadWrite`. */ caching?: pulumi.Input; /** * Specifies the Create Option of the Data Disk. The only possible value is `Copy`. Changing this forces a new resource to be created. */ createOption?: pulumi.Input; /** * Specifies the size of the Data Disk in gigabytes. * * > **Note:** Updating `diskSizeGb` to shrink the disk size is not supported on Azure and forces a new Data Disk to be created. * * > **Note:** In certain conditions the Data Disk size can be updated without shutting down the Virtual Machine, however only a subset of Virtual Machine SKUs/Disk combinations support this. More information can be found [for Linux Virtual Machines](https://learn.microsoft.com/en-us/azure/virtual-machines/linux/expand-disks?tabs=azure-cli%2Cubuntu#expand-without-downtime) and [Windows Virtual Machines](https://learn.microsoft.com/azure/virtual-machines/windows/expand-os-disk#expand-without-downtime) respectively. * * > **Note:** If the VM does not meet the requirements to expand the disk without downtime, changing this value is disruptive. The VM will be shut down and deallocated as required by Azure to action the change. Terraform will attempt to start the VM again after the update if it was in a `running` state prior to the change. * * > **Note:** Expanding Ultra Disks and Premium SSD v2 disks without downtime has additional limitations. Allow up to 10 minutes for the correct size to be reflected, and a `rescan` function may be required. For more details, refer to [Expand with Ultra Disks and Premium SSD v2](https://learn.microsoft.com/azure/virtual-machines/linux/expand-disks?tabs=ubuntu#expand-with-ultra-disks-and-premium-ssd-v2). */ diskSizeGb?: pulumi.Input; /** * The Logical Unit Number of the Data Disk, which needs to be unique within the Virtual Machine. Changing this forces a new resource to be created. */ lun?: pulumi.Input; /** * Specifies the name of this Data Disk. Changing this forces a new resource to be created. */ name?: pulumi.Input; /** * The ID of the source resource which this Data Disk was created from. Changing this forces a new resource to be created. */ sourceResourceId?: pulumi.Input; /** * The ID of the Virtual Machine to which the Data Disk should be attached. Changing this forces a new resource to be created. */ virtualMachineId?: pulumi.Input; /** * Specifies if Write Accelerator is enabled on the disk. This can only be enabled on `Premium_LRS` managed disks with no caching and [M-Series VMs](https://docs.microsoft.com/azure/virtual-machines/workloads/sap/how-to-enable-write-accelerator). Defaults to `false`. */ writeAcceleratorEnabled?: pulumi.Input; } /** * The set of arguments for constructing a ImplicitDataDiskFromSource resource. */ export interface ImplicitDataDiskFromSourceArgs { /** * Specifies the caching requirements for this Data Disk. Possible values are `ReadOnly` and `ReadWrite`. */ caching?: pulumi.Input; /** * Specifies the Create Option of the Data Disk. The only possible value is `Copy`. Changing this forces a new resource to be created. */ createOption: pulumi.Input; /** * Specifies the size of the Data Disk in gigabytes. * * > **Note:** Updating `diskSizeGb` to shrink the disk size is not supported on Azure and forces a new Data Disk to be created. * * > **Note:** In certain conditions the Data Disk size can be updated without shutting down the Virtual Machine, however only a subset of Virtual Machine SKUs/Disk combinations support this. More information can be found [for Linux Virtual Machines](https://learn.microsoft.com/en-us/azure/virtual-machines/linux/expand-disks?tabs=azure-cli%2Cubuntu#expand-without-downtime) and [Windows Virtual Machines](https://learn.microsoft.com/azure/virtual-machines/windows/expand-os-disk#expand-without-downtime) respectively. * * > **Note:** If the VM does not meet the requirements to expand the disk without downtime, changing this value is disruptive. The VM will be shut down and deallocated as required by Azure to action the change. Terraform will attempt to start the VM again after the update if it was in a `running` state prior to the change. * * > **Note:** Expanding Ultra Disks and Premium SSD v2 disks without downtime has additional limitations. Allow up to 10 minutes for the correct size to be reflected, and a `rescan` function may be required. For more details, refer to [Expand with Ultra Disks and Premium SSD v2](https://learn.microsoft.com/azure/virtual-machines/linux/expand-disks?tabs=ubuntu#expand-with-ultra-disks-and-premium-ssd-v2). */ diskSizeGb: pulumi.Input; /** * The Logical Unit Number of the Data Disk, which needs to be unique within the Virtual Machine. Changing this forces a new resource to be created. */ lun: pulumi.Input; /** * Specifies the name of this Data Disk. Changing this forces a new resource to be created. */ name?: pulumi.Input; /** * The ID of the source resource which this Data Disk was created from. Changing this forces a new resource to be created. */ sourceResourceId: pulumi.Input; /** * The ID of the Virtual Machine to which the Data Disk should be attached. Changing this forces a new resource to be created. */ virtualMachineId: pulumi.Input; /** * Specifies if Write Accelerator is enabled on the disk. This can only be enabled on `Premium_LRS` managed disks with no caching and [M-Series VMs](https://docs.microsoft.com/azure/virtual-machines/workloads/sap/how-to-enable-write-accelerator). Defaults to `false`. */ writeAcceleratorEnabled?: pulumi.Input; }