1. Packages
  2. Azure Classic
  3. API Docs
  4. compute
  5. DiskPoolManagedDiskAttachment

We recommend using Azure Native.

Viewing docs for Azure v4.42.0 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
azure logo

We recommend using Azure Native.

Viewing docs for Azure v4.42.0 (Older version)
published on Monday, Mar 9, 2026 by Pulumi

    Manages a Disk Pool Managed Disk Attachment.

    Note: Must be either a premium SSD, standard SSD, or an ultra disk in the same region and availability zone as the disk pool.

    Note: Ultra disks must have a disk sector size of 512 bytes.

    Note: Must be a shared disk, with a maxShares value of two or greater.

    Note: You must provide the StoragePool resource provider RBAC permissions to the disks that will be added to the disk pool.

    Example Usage

    using System.Collections.Generic;
    using Pulumi;
    using Azure = Pulumi.Azure;
    using AzureAD = Pulumi.AzureAD;
    
    class MyStack : Stack
    {
        public MyStack()
        {
            var exampleResourceGroup = new Azure.Core.ResourceGroup("exampleResourceGroup", new Azure.Core.ResourceGroupArgs
            {
                Location = "West Europe",
            });
            var exampleVirtualNetwork = new Azure.Network.VirtualNetwork("exampleVirtualNetwork", new Azure.Network.VirtualNetworkArgs
            {
                ResourceGroupName = exampleResourceGroup.Name,
                Location = exampleResourceGroup.Location,
                AddressSpaces = 
                {
                    "10.0.0.0/16",
                },
            });
            var exampleSubnet = new Azure.Network.Subnet("exampleSubnet", new Azure.Network.SubnetArgs
            {
                ResourceGroupName = exampleResourceGroup.Name,
                VirtualNetworkName = exampleVirtualNetwork.Name,
                AddressPrefixes = 
                {
                    "10.0.0.0/24",
                },
                Delegations = 
                {
                    new Azure.Network.Inputs.SubnetDelegationArgs
                    {
                        Name = "diskspool",
                        ServiceDelegation = new Azure.Network.Inputs.SubnetDelegationServiceDelegationArgs
                        {
                            Actions = 
                            {
                                "Microsoft.Network/virtualNetworks/read",
                            },
                            Name = "Microsoft.StoragePool/diskPools",
                        },
                    },
                },
            });
            var exampleDiskPool = new Azure.Compute.DiskPool("exampleDiskPool", new Azure.Compute.DiskPoolArgs
            {
                ResourceGroupName = exampleResourceGroup.Name,
                Location = exampleResourceGroup.Location,
                SubnetId = exampleSubnet.Id,
                Zones = 
                {
                    "1",
                },
                SkuName = "Basic_B1",
            });
            var exampleManagedDisk = new Azure.Compute.ManagedDisk("exampleManagedDisk", new Azure.Compute.ManagedDiskArgs
            {
                ResourceGroupName = exampleResourceGroup.Name,
                Location = exampleResourceGroup.Location,
                CreateOption = "Empty",
                StorageAccountType = "Premium_LRS",
                DiskSizeGb = 4,
                MaxShares = 2,
                Zones = 
                {
                    "1",
                },
            });
            var exampleServicePrincipal = Output.Create(AzureAD.GetServicePrincipal.InvokeAsync(new AzureAD.GetServicePrincipalArgs
            {
                DisplayName = "StoragePool Resource Provider",
            }));
            var roles = 
            {
                "Disk Pool Operator",
                "Virtual Machine Contributor",
            };
            var exampleAssignment = new List<Azure.Authorization.Assignment>();
            for (var rangeIndex = 0; rangeIndex < roles.Length; rangeIndex++)
            {
                var range = new { Value = rangeIndex };
                exampleAssignment.Add(new Azure.Authorization.Assignment($"exampleAssignment-{range.Value}", new Azure.Authorization.AssignmentArgs
                {
                    PrincipalId = exampleServicePrincipal.Apply(exampleServicePrincipal => exampleServicePrincipal.Id),
                    RoleDefinitionName = roles[range.Value],
                    Scope = exampleManagedDisk.Id,
                }));
            }
            var exampleDiskPoolManagedDiskAttachment = new Azure.Compute.DiskPoolManagedDiskAttachment("exampleDiskPoolManagedDiskAttachment", new Azure.Compute.DiskPoolManagedDiskAttachmentArgs
            {
                DiskPoolId = exampleDiskPool.Id,
                ManagedDiskId = exampleManagedDisk.Id,
            }, new CustomResourceOptions
            {
                DependsOn = 
                {
                    exampleAssignment,
                },
            });
        }
    
    }
    

    Example coming soon!

    Example coming soon!

    import * as pulumi from "@pulumi/pulumi";
    import * as azure from "@pulumi/azure";
    import * as azuread from "@pulumi/azuread";
    
    const exampleResourceGroup = new azure.core.ResourceGroup("exampleResourceGroup", {location: "West Europe"});
    const exampleVirtualNetwork = new azure.network.VirtualNetwork("exampleVirtualNetwork", {
        resourceGroupName: exampleResourceGroup.name,
        location: exampleResourceGroup.location,
        addressSpaces: ["10.0.0.0/16"],
    });
    const exampleSubnet = new azure.network.Subnet("exampleSubnet", {
        resourceGroupName: exampleResourceGroup.name,
        virtualNetworkName: exampleVirtualNetwork.name,
        addressPrefixes: ["10.0.0.0/24"],
        delegations: [{
            name: "diskspool",
            serviceDelegation: {
                actions: ["Microsoft.Network/virtualNetworks/read"],
                name: "Microsoft.StoragePool/diskPools",
            },
        }],
    });
    const exampleDiskPool = new azure.compute.DiskPool("exampleDiskPool", {
        resourceGroupName: exampleResourceGroup.name,
        location: exampleResourceGroup.location,
        subnetId: exampleSubnet.id,
        zones: ["1"],
        skuName: "Basic_B1",
    });
    const exampleManagedDisk = new azure.compute.ManagedDisk("exampleManagedDisk", {
        resourceGroupName: exampleResourceGroup.name,
        location: exampleResourceGroup.location,
        createOption: "Empty",
        storageAccountType: "Premium_LRS",
        diskSizeGb: 4,
        maxShares: 2,
        zones: ["1"],
    });
    const exampleServicePrincipal = azuread.getServicePrincipal({
        displayName: "StoragePool Resource Provider",
    });
    const roles = [
        "Disk Pool Operator",
        "Virtual Machine Contributor",
    ];
    const exampleAssignment: azure.authorization.Assignment[];
    for (const range = {value: 0}; range.value < roles.length; range.value++) {
        exampleAssignment.push(new azure.authorization.Assignment(`exampleAssignment-${range.value}`, {
            principalId: exampleServicePrincipal.then(exampleServicePrincipal => exampleServicePrincipal.id),
            roleDefinitionName: roles[range.value],
            scope: exampleManagedDisk.id,
        }));
    }
    const exampleDiskPoolManagedDiskAttachment = new azure.compute.DiskPoolManagedDiskAttachment("exampleDiskPoolManagedDiskAttachment", {
        diskPoolId: exampleDiskPool.id,
        managedDiskId: exampleManagedDisk.id,
    }, {
        dependsOn: [exampleAssignment],
    });
    
    import pulumi
    import pulumi_azure as azure
    import pulumi_azuread as azuread
    
    example_resource_group = azure.core.ResourceGroup("exampleResourceGroup", location="West Europe")
    example_virtual_network = azure.network.VirtualNetwork("exampleVirtualNetwork",
        resource_group_name=example_resource_group.name,
        location=example_resource_group.location,
        address_spaces=["10.0.0.0/16"])
    example_subnet = azure.network.Subnet("exampleSubnet",
        resource_group_name=example_resource_group.name,
        virtual_network_name=example_virtual_network.name,
        address_prefixes=["10.0.0.0/24"],
        delegations=[azure.network.SubnetDelegationArgs(
            name="diskspool",
            service_delegation=azure.network.SubnetDelegationServiceDelegationArgs(
                actions=["Microsoft.Network/virtualNetworks/read"],
                name="Microsoft.StoragePool/diskPools",
            ),
        )])
    example_disk_pool = azure.compute.DiskPool("exampleDiskPool",
        resource_group_name=example_resource_group.name,
        location=example_resource_group.location,
        subnet_id=example_subnet.id,
        zones=["1"],
        sku_name="Basic_B1")
    example_managed_disk = azure.compute.ManagedDisk("exampleManagedDisk",
        resource_group_name=example_resource_group.name,
        location=example_resource_group.location,
        create_option="Empty",
        storage_account_type="Premium_LRS",
        disk_size_gb=4,
        max_shares=2,
        zones=["1"])
    example_service_principal = azuread.get_service_principal(display_name="StoragePool Resource Provider")
    roles = [
        "Disk Pool Operator",
        "Virtual Machine Contributor",
    ]
    example_assignment = []
    for range in [{"value": i} for i in range(0, len(roles))]:
        example_assignment.append(azure.authorization.Assignment(f"exampleAssignment-{range['value']}",
            principal_id=example_service_principal.id,
            role_definition_name=roles[range["value"]],
            scope=example_managed_disk.id))
    example_disk_pool_managed_disk_attachment = azure.compute.DiskPoolManagedDiskAttachment("exampleDiskPoolManagedDiskAttachment",
        disk_pool_id=example_disk_pool.id,
        managed_disk_id=example_managed_disk.id,
        opts=pulumi.ResourceOptions(depends_on=[example_assignment]))
    

    Example coming soon!

    Create DiskPoolManagedDiskAttachment Resource

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

    Constructor syntax

    new DiskPoolManagedDiskAttachment(name: string, args: DiskPoolManagedDiskAttachmentArgs, opts?: CustomResourceOptions);
    @overload
    def DiskPoolManagedDiskAttachment(resource_name: str,
                                      args: DiskPoolManagedDiskAttachmentArgs,
                                      opts: Optional[ResourceOptions] = None)
    
    @overload
    def DiskPoolManagedDiskAttachment(resource_name: str,
                                      opts: Optional[ResourceOptions] = None,
                                      disk_pool_id: Optional[str] = None,
                                      managed_disk_id: Optional[str] = None)
    func NewDiskPoolManagedDiskAttachment(ctx *Context, name string, args DiskPoolManagedDiskAttachmentArgs, opts ...ResourceOption) (*DiskPoolManagedDiskAttachment, error)
    public DiskPoolManagedDiskAttachment(string name, DiskPoolManagedDiskAttachmentArgs args, CustomResourceOptions? opts = null)
    public DiskPoolManagedDiskAttachment(String name, DiskPoolManagedDiskAttachmentArgs args)
    public DiskPoolManagedDiskAttachment(String name, DiskPoolManagedDiskAttachmentArgs args, CustomResourceOptions options)
    
    type: azure:compute:DiskPoolManagedDiskAttachment
    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 DiskPoolManagedDiskAttachmentArgs
    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 DiskPoolManagedDiskAttachmentArgs
    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 DiskPoolManagedDiskAttachmentArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DiskPoolManagedDiskAttachmentArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DiskPoolManagedDiskAttachmentArgs
    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 diskPoolManagedDiskAttachmentResource = new Azure.Compute.DiskPoolManagedDiskAttachment("diskPoolManagedDiskAttachmentResource", new()
    {
        DiskPoolId = "string",
        ManagedDiskId = "string",
    });
    
    example, err := compute.NewDiskPoolManagedDiskAttachment(ctx, "diskPoolManagedDiskAttachmentResource", &compute.DiskPoolManagedDiskAttachmentArgs{
    	DiskPoolId:    pulumi.String("string"),
    	ManagedDiskId: pulumi.String("string"),
    })
    
    var diskPoolManagedDiskAttachmentResource = new DiskPoolManagedDiskAttachment("diskPoolManagedDiskAttachmentResource", DiskPoolManagedDiskAttachmentArgs.builder()
        .diskPoolId("string")
        .managedDiskId("string")
        .build());
    
    disk_pool_managed_disk_attachment_resource = azure.compute.DiskPoolManagedDiskAttachment("diskPoolManagedDiskAttachmentResource",
        disk_pool_id="string",
        managed_disk_id="string")
    
    const diskPoolManagedDiskAttachmentResource = new azure.compute.DiskPoolManagedDiskAttachment("diskPoolManagedDiskAttachmentResource", {
        diskPoolId: "string",
        managedDiskId: "string",
    });
    
    type: azure:compute:DiskPoolManagedDiskAttachment
    properties:
        diskPoolId: string
        managedDiskId: string
    

    DiskPoolManagedDiskAttachment 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 DiskPoolManagedDiskAttachment resource accepts the following input properties:

    DiskPoolId string
    The ID of the Disk Pool. Changing this forces a new Disk Pool Managed Disk Attachment to be created.
    ManagedDiskId string
    The ID of the Managed Disk. Changing this forces a new Disks Pool Managed Disk Attachment to be created.
    DiskPoolId string
    The ID of the Disk Pool. Changing this forces a new Disk Pool Managed Disk Attachment to be created.
    ManagedDiskId string
    The ID of the Managed Disk. Changing this forces a new Disks Pool Managed Disk Attachment to be created.
    diskPoolId String
    The ID of the Disk Pool. Changing this forces a new Disk Pool Managed Disk Attachment to be created.
    managedDiskId String
    The ID of the Managed Disk. Changing this forces a new Disks Pool Managed Disk Attachment to be created.
    diskPoolId string
    The ID of the Disk Pool. Changing this forces a new Disk Pool Managed Disk Attachment to be created.
    managedDiskId string
    The ID of the Managed Disk. Changing this forces a new Disks Pool Managed Disk Attachment to be created.
    disk_pool_id str
    The ID of the Disk Pool. Changing this forces a new Disk Pool Managed Disk Attachment to be created.
    managed_disk_id str
    The ID of the Managed Disk. Changing this forces a new Disks Pool Managed Disk Attachment to be created.
    diskPoolId String
    The ID of the Disk Pool. Changing this forces a new Disk Pool Managed Disk Attachment to be created.
    managedDiskId String
    The ID of the Managed Disk. Changing this forces a new Disks Pool Managed Disk Attachment to be created.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing DiskPoolManagedDiskAttachment Resource

    Get an existing DiskPoolManagedDiskAttachment resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: DiskPoolManagedDiskAttachmentState, opts?: CustomResourceOptions): DiskPoolManagedDiskAttachment
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            disk_pool_id: Optional[str] = None,
            managed_disk_id: Optional[str] = None) -> DiskPoolManagedDiskAttachment
    func GetDiskPoolManagedDiskAttachment(ctx *Context, name string, id IDInput, state *DiskPoolManagedDiskAttachmentState, opts ...ResourceOption) (*DiskPoolManagedDiskAttachment, error)
    public static DiskPoolManagedDiskAttachment Get(string name, Input<string> id, DiskPoolManagedDiskAttachmentState? state, CustomResourceOptions? opts = null)
    public static DiskPoolManagedDiskAttachment get(String name, Output<String> id, DiskPoolManagedDiskAttachmentState state, CustomResourceOptions options)
    resources:  _:    type: azure:compute:DiskPoolManagedDiskAttachment    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    DiskPoolId string
    The ID of the Disk Pool. Changing this forces a new Disk Pool Managed Disk Attachment to be created.
    ManagedDiskId string
    The ID of the Managed Disk. Changing this forces a new Disks Pool Managed Disk Attachment to be created.
    DiskPoolId string
    The ID of the Disk Pool. Changing this forces a new Disk Pool Managed Disk Attachment to be created.
    ManagedDiskId string
    The ID of the Managed Disk. Changing this forces a new Disks Pool Managed Disk Attachment to be created.
    diskPoolId String
    The ID of the Disk Pool. Changing this forces a new Disk Pool Managed Disk Attachment to be created.
    managedDiskId String
    The ID of the Managed Disk. Changing this forces a new Disks Pool Managed Disk Attachment to be created.
    diskPoolId string
    The ID of the Disk Pool. Changing this forces a new Disk Pool Managed Disk Attachment to be created.
    managedDiskId string
    The ID of the Managed Disk. Changing this forces a new Disks Pool Managed Disk Attachment to be created.
    disk_pool_id str
    The ID of the Disk Pool. Changing this forces a new Disk Pool Managed Disk Attachment to be created.
    managed_disk_id str
    The ID of the Managed Disk. Changing this forces a new Disks Pool Managed Disk Attachment to be created.
    diskPoolId String
    The ID of the Disk Pool. Changing this forces a new Disk Pool Managed Disk Attachment to be created.
    managedDiskId String
    The ID of the Managed Disk. Changing this forces a new Disks Pool Managed Disk Attachment to be created.

    Import

    Disks Pool Managed Disk Attachments can be imported using the resource id, e.g.

     $ pulumi import azure:compute/diskPoolManagedDiskAttachment:DiskPoolManagedDiskAttachment example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resGroup1/providers/Microsoft.StoragePool/diskPools/storagePool1/managedDisks|/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resGroup1/providers/Microsoft.Compute/disks/disk1
    

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

    Package Details

    Repository
    Azure Classic pulumi/pulumi-azure
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the azurerm Terraform Provider.
    azure logo

    We recommend using Azure Native.

    Viewing docs for Azure v4.42.0 (Older version)
    published on Monday, Mar 9, 2026 by Pulumi
      Try Pulumi Cloud free. Your team will thank you.