1. Packages
  2. Alibaba Cloud
  3. API Docs
  4. ecs
  5. Disk
Alibaba Cloud v3.57.1 published on Wednesday, Jun 26, 2024 by Pulumi

alicloud.ecs.Disk

Explore with Pulumi AI

alicloud logo
Alibaba Cloud v3.57.1 published on Wednesday, Jun 26, 2024 by Pulumi

    Provides a ECS disk resource.

    DEPRECATED: This resource has been renamed to alicloud.ecs.EcsDisk from version 1.122.0.

    NOTE: One of size or snapshot_id is required when specifying an ECS disk. If all of them be specified, size must more than the size of snapshot which snapshot_id represents. Currently, alicloud.ecs.Disk doesn’t resize disk.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as alicloud from "@pulumi/alicloud";
    
    // Create a new ECS disk.
    const ecsDisk = new alicloud.ecs.Disk("ecs_disk", {
        availabilityZone: "cn-beijing-b",
        name: "New-disk",
        description: "Hello ecs disk.",
        category: "cloud_efficiency",
        size: 30,
        encrypted: true,
        kmsKeyId: "2a6767f0-a16c-4679-a60f-13bf*****",
        tags: {
            Name: "TerraformTest",
        },
    });
    
    import pulumi
    import pulumi_alicloud as alicloud
    
    # Create a new ECS disk.
    ecs_disk = alicloud.ecs.Disk("ecs_disk",
        availability_zone="cn-beijing-b",
        name="New-disk",
        description="Hello ecs disk.",
        category="cloud_efficiency",
        size=30,
        encrypted=True,
        kms_key_id="2a6767f0-a16c-4679-a60f-13bf*****",
        tags={
            "Name": "TerraformTest",
        })
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/ecs"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// Create a new ECS disk.
    		_, err := ecs.NewDisk(ctx, "ecs_disk", &ecs.DiskArgs{
    			AvailabilityZone: pulumi.String("cn-beijing-b"),
    			Name:             pulumi.String("New-disk"),
    			Description:      pulumi.String("Hello ecs disk."),
    			Category:         pulumi.String("cloud_efficiency"),
    			Size:             pulumi.Int(30),
    			Encrypted:        pulumi.Bool(true),
    			KmsKeyId:         pulumi.String("2a6767f0-a16c-4679-a60f-13bf*****"),
    			Tags: pulumi.Map{
    				"Name": pulumi.Any("TerraformTest"),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using AliCloud = Pulumi.AliCloud;
    
    return await Deployment.RunAsync(() => 
    {
        // Create a new ECS disk.
        var ecsDisk = new AliCloud.Ecs.Disk("ecs_disk", new()
        {
            AvailabilityZone = "cn-beijing-b",
            Name = "New-disk",
            Description = "Hello ecs disk.",
            Category = "cloud_efficiency",
            Size = 30,
            Encrypted = true,
            KmsKeyId = "2a6767f0-a16c-4679-a60f-13bf*****",
            Tags = 
            {
                { "Name", "TerraformTest" },
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.alicloud.ecs.Disk;
    import com.pulumi.alicloud.ecs.DiskArgs;
    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) {
            // Create a new ECS disk.
            var ecsDisk = new Disk("ecsDisk", DiskArgs.builder()
                .availabilityZone("cn-beijing-b")
                .name("New-disk")
                .description("Hello ecs disk.")
                .category("cloud_efficiency")
                .size("30")
                .encrypted(true)
                .kmsKeyId("2a6767f0-a16c-4679-a60f-13bf*****")
                .tags(Map.of("Name", "TerraformTest"))
                .build());
    
        }
    }
    
    resources:
      # Create a new ECS disk.
      ecsDisk:
        type: alicloud:ecs:Disk
        name: ecs_disk
        properties:
          availabilityZone: cn-beijing-b
          name: New-disk
          description: Hello ecs disk.
          category: cloud_efficiency
          size: '30'
          encrypted: true
          kmsKeyId: 2a6767f0-a16c-4679-a60f-13bf*****
          tags:
            Name: TerraformTest
    

    Create Disk Resource

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

    Constructor syntax

    new Disk(name: string, args?: DiskArgs, opts?: CustomResourceOptions);
    @overload
    def Disk(resource_name: str,
             args: Optional[DiskArgs] = None,
             opts: Optional[ResourceOptions] = None)
    
    @overload
    def Disk(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             advanced_features: Optional[str] = None,
             availability_zone: Optional[str] = None,
             category: Optional[str] = None,
             delete_auto_snapshot: Optional[bool] = None,
             delete_with_instance: Optional[bool] = None,
             description: Optional[str] = None,
             disk_name: Optional[str] = None,
             dry_run: Optional[bool] = None,
             enable_auto_snapshot: Optional[bool] = None,
             encrypt_algorithm: Optional[str] = None,
             encrypted: Optional[bool] = None,
             instance_id: Optional[str] = None,
             kms_key_id: Optional[str] = None,
             name: Optional[str] = None,
             payment_type: Optional[str] = None,
             performance_level: Optional[str] = None,
             resource_group_id: Optional[str] = None,
             size: Optional[int] = None,
             snapshot_id: Optional[str] = None,
             storage_set_id: Optional[str] = None,
             storage_set_partition_number: Optional[int] = None,
             tags: Optional[Mapping[str, Any]] = None,
             type: Optional[str] = None,
             zone_id: Optional[str] = None)
    func NewDisk(ctx *Context, name string, args *DiskArgs, opts ...ResourceOption) (*Disk, error)
    public Disk(string name, DiskArgs? args = null, CustomResourceOptions? opts = null)
    public Disk(String name, DiskArgs args)
    public Disk(String name, DiskArgs args, CustomResourceOptions options)
    
    type: alicloud:ecs:Disk
    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 DiskArgs
    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 DiskArgs
    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 DiskArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DiskArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DiskArgs
    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 diskResource = new AliCloud.Ecs.Disk("diskResource", new()
    {
        AdvancedFeatures = "string",
        Category = "string",
        DeleteAutoSnapshot = false,
        DeleteWithInstance = false,
        Description = "string",
        DiskName = "string",
        DryRun = false,
        EnableAutoSnapshot = false,
        EncryptAlgorithm = "string",
        Encrypted = false,
        InstanceId = "string",
        KmsKeyId = "string",
        PaymentType = "string",
        PerformanceLevel = "string",
        ResourceGroupId = "string",
        Size = 0,
        SnapshotId = "string",
        StorageSetId = "string",
        StorageSetPartitionNumber = 0,
        Tags = 
        {
            { "string", "any" },
        },
        Type = "string",
        ZoneId = "string",
    });
    
    example, err := ecs.NewDisk(ctx, "diskResource", &ecs.DiskArgs{
    	AdvancedFeatures:          pulumi.String("string"),
    	Category:                  pulumi.String("string"),
    	DeleteAutoSnapshot:        pulumi.Bool(false),
    	DeleteWithInstance:        pulumi.Bool(false),
    	Description:               pulumi.String("string"),
    	DiskName:                  pulumi.String("string"),
    	DryRun:                    pulumi.Bool(false),
    	EnableAutoSnapshot:        pulumi.Bool(false),
    	EncryptAlgorithm:          pulumi.String("string"),
    	Encrypted:                 pulumi.Bool(false),
    	InstanceId:                pulumi.String("string"),
    	KmsKeyId:                  pulumi.String("string"),
    	PaymentType:               pulumi.String("string"),
    	PerformanceLevel:          pulumi.String("string"),
    	ResourceGroupId:           pulumi.String("string"),
    	Size:                      pulumi.Int(0),
    	SnapshotId:                pulumi.String("string"),
    	StorageSetId:              pulumi.String("string"),
    	StorageSetPartitionNumber: pulumi.Int(0),
    	Tags: pulumi.Map{
    		"string": pulumi.Any("any"),
    	},
    	Type:   pulumi.String("string"),
    	ZoneId: pulumi.String("string"),
    })
    
    var diskResource = new Disk("diskResource", DiskArgs.builder()
        .advancedFeatures("string")
        .category("string")
        .deleteAutoSnapshot(false)
        .deleteWithInstance(false)
        .description("string")
        .diskName("string")
        .dryRun(false)
        .enableAutoSnapshot(false)
        .encryptAlgorithm("string")
        .encrypted(false)
        .instanceId("string")
        .kmsKeyId("string")
        .paymentType("string")
        .performanceLevel("string")
        .resourceGroupId("string")
        .size(0)
        .snapshotId("string")
        .storageSetId("string")
        .storageSetPartitionNumber(0)
        .tags(Map.of("string", "any"))
        .type("string")
        .zoneId("string")
        .build());
    
    disk_resource = alicloud.ecs.Disk("diskResource",
        advanced_features="string",
        category="string",
        delete_auto_snapshot=False,
        delete_with_instance=False,
        description="string",
        disk_name="string",
        dry_run=False,
        enable_auto_snapshot=False,
        encrypt_algorithm="string",
        encrypted=False,
        instance_id="string",
        kms_key_id="string",
        payment_type="string",
        performance_level="string",
        resource_group_id="string",
        size=0,
        snapshot_id="string",
        storage_set_id="string",
        storage_set_partition_number=0,
        tags={
            "string": "any",
        },
        type="string",
        zone_id="string")
    
    const diskResource = new alicloud.ecs.Disk("diskResource", {
        advancedFeatures: "string",
        category: "string",
        deleteAutoSnapshot: false,
        deleteWithInstance: false,
        description: "string",
        diskName: "string",
        dryRun: false,
        enableAutoSnapshot: false,
        encryptAlgorithm: "string",
        encrypted: false,
        instanceId: "string",
        kmsKeyId: "string",
        paymentType: "string",
        performanceLevel: "string",
        resourceGroupId: "string",
        size: 0,
        snapshotId: "string",
        storageSetId: "string",
        storageSetPartitionNumber: 0,
        tags: {
            string: "any",
        },
        type: "string",
        zoneId: "string",
    });
    
    type: alicloud:ecs:Disk
    properties:
        advancedFeatures: string
        category: string
        deleteAutoSnapshot: false
        deleteWithInstance: false
        description: string
        diskName: string
        dryRun: false
        enableAutoSnapshot: false
        encryptAlgorithm: string
        encrypted: false
        instanceId: string
        kmsKeyId: string
        paymentType: string
        performanceLevel: string
        resourceGroupId: string
        size: 0
        snapshotId: string
        storageSetId: string
        storageSetPartitionNumber: 0
        tags:
            string: any
        type: string
        zoneId: string
    

    Disk Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The Disk resource accepts the following input properties:

    AdvancedFeatures string
    AvailabilityZone string
    The Zone to create the disk in.

    Deprecated: Field 'availability_zone' has been deprecated from provider version 1.122.0. New field 'zone_id' instead

    Category string
    Category of the disk. Valid values are cloud, cloud_efficiency, cloud_ssd, cloud_essd, cloud_essd_entry. Default is cloud_efficiency.
    DeleteAutoSnapshot bool
    Indicates whether the automatic snapshot is deleted when the disk is released. Default value: false.
    DeleteWithInstance bool
    Indicates whether the disk is released together with the instance: Default value: false.
    Description string
    Description of the disk. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.
    DiskName string
    DryRun bool
    EnableAutoSnapshot bool
    Indicates whether to apply a created automatic snapshot policy to the disk. Default value: false.
    EncryptAlgorithm string
    Encrypted bool
    If true, the disk will be encrypted, conflict with snapshot_id.
    InstanceId string
    KmsKeyId string
    The ID of the KMS key corresponding to the data disk, The specified parameter Encrypted must be true when KmsKeyId is not empty.
    Name string
    Name of the ECS disk. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.

    Deprecated: Field 'name' has been deprecated from provider version 1.122.0. New field 'disk_name' instead.

    PaymentType string
    PerformanceLevel string
    Specifies the performance level of an ESSD when you create the ESSD. Default value: PL1. Valid values:

    • PL1: A single ESSD delivers up to 50,000 random read/write IOPS.
    • PL2: A single ESSD delivers up to 100,000 random read/write IOPS.
    • PL3: A single ESSD delivers up to 1,000,000 random read/write IOPS.
    ResourceGroupId string

    The Id of resource group which the disk belongs.

    NOTE: Disk category cloud has been outdated and it only can be used none I/O Optimized ECS instances. Recommend cloud_efficiency and cloud_ssd disk.

    Size int
    The size of the disk in GiBs. When resize the disk, the new size must be greater than the former value, or you would get an error InvalidDiskSize.TooSmall.
    SnapshotId string
    A snapshot to base the disk off of. If the disk size required by snapshot is greater than size, the size will be ignored, conflict with encrypted.
    StorageSetId string
    StorageSetPartitionNumber int
    Tags Dictionary<string, object>
    A mapping of tags to assign to the resource.
    Type string
    ZoneId string
    AdvancedFeatures string
    AvailabilityZone string
    The Zone to create the disk in.

    Deprecated: Field 'availability_zone' has been deprecated from provider version 1.122.0. New field 'zone_id' instead

    Category string
    Category of the disk. Valid values are cloud, cloud_efficiency, cloud_ssd, cloud_essd, cloud_essd_entry. Default is cloud_efficiency.
    DeleteAutoSnapshot bool
    Indicates whether the automatic snapshot is deleted when the disk is released. Default value: false.
    DeleteWithInstance bool
    Indicates whether the disk is released together with the instance: Default value: false.
    Description string
    Description of the disk. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.
    DiskName string
    DryRun bool
    EnableAutoSnapshot bool
    Indicates whether to apply a created automatic snapshot policy to the disk. Default value: false.
    EncryptAlgorithm string
    Encrypted bool
    If true, the disk will be encrypted, conflict with snapshot_id.
    InstanceId string
    KmsKeyId string
    The ID of the KMS key corresponding to the data disk, The specified parameter Encrypted must be true when KmsKeyId is not empty.
    Name string
    Name of the ECS disk. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.

    Deprecated: Field 'name' has been deprecated from provider version 1.122.0. New field 'disk_name' instead.

    PaymentType string
    PerformanceLevel string
    Specifies the performance level of an ESSD when you create the ESSD. Default value: PL1. Valid values:

    • PL1: A single ESSD delivers up to 50,000 random read/write IOPS.
    • PL2: A single ESSD delivers up to 100,000 random read/write IOPS.
    • PL3: A single ESSD delivers up to 1,000,000 random read/write IOPS.
    ResourceGroupId string

    The Id of resource group which the disk belongs.

    NOTE: Disk category cloud has been outdated and it only can be used none I/O Optimized ECS instances. Recommend cloud_efficiency and cloud_ssd disk.

    Size int
    The size of the disk in GiBs. When resize the disk, the new size must be greater than the former value, or you would get an error InvalidDiskSize.TooSmall.
    SnapshotId string
    A snapshot to base the disk off of. If the disk size required by snapshot is greater than size, the size will be ignored, conflict with encrypted.
    StorageSetId string
    StorageSetPartitionNumber int
    Tags map[string]interface{}
    A mapping of tags to assign to the resource.
    Type string
    ZoneId string
    advancedFeatures String
    availabilityZone String
    The Zone to create the disk in.

    Deprecated: Field 'availability_zone' has been deprecated from provider version 1.122.0. New field 'zone_id' instead

    category String
    Category of the disk. Valid values are cloud, cloud_efficiency, cloud_ssd, cloud_essd, cloud_essd_entry. Default is cloud_efficiency.
    deleteAutoSnapshot Boolean
    Indicates whether the automatic snapshot is deleted when the disk is released. Default value: false.
    deleteWithInstance Boolean
    Indicates whether the disk is released together with the instance: Default value: false.
    description String
    Description of the disk. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.
    diskName String
    dryRun Boolean
    enableAutoSnapshot Boolean
    Indicates whether to apply a created automatic snapshot policy to the disk. Default value: false.
    encryptAlgorithm String
    encrypted Boolean
    If true, the disk will be encrypted, conflict with snapshot_id.
    instanceId String
    kmsKeyId String
    The ID of the KMS key corresponding to the data disk, The specified parameter Encrypted must be true when KmsKeyId is not empty.
    name String
    Name of the ECS disk. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.

    Deprecated: Field 'name' has been deprecated from provider version 1.122.0. New field 'disk_name' instead.

    paymentType String
    performanceLevel String
    Specifies the performance level of an ESSD when you create the ESSD. Default value: PL1. Valid values:

    • PL1: A single ESSD delivers up to 50,000 random read/write IOPS.
    • PL2: A single ESSD delivers up to 100,000 random read/write IOPS.
    • PL3: A single ESSD delivers up to 1,000,000 random read/write IOPS.
    resourceGroupId String

    The Id of resource group which the disk belongs.

    NOTE: Disk category cloud has been outdated and it only can be used none I/O Optimized ECS instances. Recommend cloud_efficiency and cloud_ssd disk.

    size Integer
    The size of the disk in GiBs. When resize the disk, the new size must be greater than the former value, or you would get an error InvalidDiskSize.TooSmall.
    snapshotId String
    A snapshot to base the disk off of. If the disk size required by snapshot is greater than size, the size will be ignored, conflict with encrypted.
    storageSetId String
    storageSetPartitionNumber Integer
    tags Map<String,Object>
    A mapping of tags to assign to the resource.
    type String
    zoneId String
    advancedFeatures string
    availabilityZone string
    The Zone to create the disk in.

    Deprecated: Field 'availability_zone' has been deprecated from provider version 1.122.0. New field 'zone_id' instead

    category string
    Category of the disk. Valid values are cloud, cloud_efficiency, cloud_ssd, cloud_essd, cloud_essd_entry. Default is cloud_efficiency.
    deleteAutoSnapshot boolean
    Indicates whether the automatic snapshot is deleted when the disk is released. Default value: false.
    deleteWithInstance boolean
    Indicates whether the disk is released together with the instance: Default value: false.
    description string
    Description of the disk. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.
    diskName string
    dryRun boolean
    enableAutoSnapshot boolean
    Indicates whether to apply a created automatic snapshot policy to the disk. Default value: false.
    encryptAlgorithm string
    encrypted boolean
    If true, the disk will be encrypted, conflict with snapshot_id.
    instanceId string
    kmsKeyId string
    The ID of the KMS key corresponding to the data disk, The specified parameter Encrypted must be true when KmsKeyId is not empty.
    name string
    Name of the ECS disk. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.

    Deprecated: Field 'name' has been deprecated from provider version 1.122.0. New field 'disk_name' instead.

    paymentType string
    performanceLevel string
    Specifies the performance level of an ESSD when you create the ESSD. Default value: PL1. Valid values:

    • PL1: A single ESSD delivers up to 50,000 random read/write IOPS.
    • PL2: A single ESSD delivers up to 100,000 random read/write IOPS.
    • PL3: A single ESSD delivers up to 1,000,000 random read/write IOPS.
    resourceGroupId string

    The Id of resource group which the disk belongs.

    NOTE: Disk category cloud has been outdated and it only can be used none I/O Optimized ECS instances. Recommend cloud_efficiency and cloud_ssd disk.

    size number
    The size of the disk in GiBs. When resize the disk, the new size must be greater than the former value, or you would get an error InvalidDiskSize.TooSmall.
    snapshotId string
    A snapshot to base the disk off of. If the disk size required by snapshot is greater than size, the size will be ignored, conflict with encrypted.
    storageSetId string
    storageSetPartitionNumber number
    tags {[key: string]: any}
    A mapping of tags to assign to the resource.
    type string
    zoneId string
    advanced_features str
    availability_zone str
    The Zone to create the disk in.

    Deprecated: Field 'availability_zone' has been deprecated from provider version 1.122.0. New field 'zone_id' instead

    category str
    Category of the disk. Valid values are cloud, cloud_efficiency, cloud_ssd, cloud_essd, cloud_essd_entry. Default is cloud_efficiency.
    delete_auto_snapshot bool
    Indicates whether the automatic snapshot is deleted when the disk is released. Default value: false.
    delete_with_instance bool
    Indicates whether the disk is released together with the instance: Default value: false.
    description str
    Description of the disk. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.
    disk_name str
    dry_run bool
    enable_auto_snapshot bool
    Indicates whether to apply a created automatic snapshot policy to the disk. Default value: false.
    encrypt_algorithm str
    encrypted bool
    If true, the disk will be encrypted, conflict with snapshot_id.
    instance_id str
    kms_key_id str
    The ID of the KMS key corresponding to the data disk, The specified parameter Encrypted must be true when KmsKeyId is not empty.
    name str
    Name of the ECS disk. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.

    Deprecated: Field 'name' has been deprecated from provider version 1.122.0. New field 'disk_name' instead.

    payment_type str
    performance_level str
    Specifies the performance level of an ESSD when you create the ESSD. Default value: PL1. Valid values:

    • PL1: A single ESSD delivers up to 50,000 random read/write IOPS.
    • PL2: A single ESSD delivers up to 100,000 random read/write IOPS.
    • PL3: A single ESSD delivers up to 1,000,000 random read/write IOPS.
    resource_group_id str

    The Id of resource group which the disk belongs.

    NOTE: Disk category cloud has been outdated and it only can be used none I/O Optimized ECS instances. Recommend cloud_efficiency and cloud_ssd disk.

    size int
    The size of the disk in GiBs. When resize the disk, the new size must be greater than the former value, or you would get an error InvalidDiskSize.TooSmall.
    snapshot_id str
    A snapshot to base the disk off of. If the disk size required by snapshot is greater than size, the size will be ignored, conflict with encrypted.
    storage_set_id str
    storage_set_partition_number int
    tags Mapping[str, Any]
    A mapping of tags to assign to the resource.
    type str
    zone_id str
    advancedFeatures String
    availabilityZone String
    The Zone to create the disk in.

    Deprecated: Field 'availability_zone' has been deprecated from provider version 1.122.0. New field 'zone_id' instead

    category String
    Category of the disk. Valid values are cloud, cloud_efficiency, cloud_ssd, cloud_essd, cloud_essd_entry. Default is cloud_efficiency.
    deleteAutoSnapshot Boolean
    Indicates whether the automatic snapshot is deleted when the disk is released. Default value: false.
    deleteWithInstance Boolean
    Indicates whether the disk is released together with the instance: Default value: false.
    description String
    Description of the disk. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.
    diskName String
    dryRun Boolean
    enableAutoSnapshot Boolean
    Indicates whether to apply a created automatic snapshot policy to the disk. Default value: false.
    encryptAlgorithm String
    encrypted Boolean
    If true, the disk will be encrypted, conflict with snapshot_id.
    instanceId String
    kmsKeyId String
    The ID of the KMS key corresponding to the data disk, The specified parameter Encrypted must be true when KmsKeyId is not empty.
    name String
    Name of the ECS disk. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.

    Deprecated: Field 'name' has been deprecated from provider version 1.122.0. New field 'disk_name' instead.

    paymentType String
    performanceLevel String
    Specifies the performance level of an ESSD when you create the ESSD. Default value: PL1. Valid values:

    • PL1: A single ESSD delivers up to 50,000 random read/write IOPS.
    • PL2: A single ESSD delivers up to 100,000 random read/write IOPS.
    • PL3: A single ESSD delivers up to 1,000,000 random read/write IOPS.
    resourceGroupId String

    The Id of resource group which the disk belongs.

    NOTE: Disk category cloud has been outdated and it only can be used none I/O Optimized ECS instances. Recommend cloud_efficiency and cloud_ssd disk.

    size Number
    The size of the disk in GiBs. When resize the disk, the new size must be greater than the former value, or you would get an error InvalidDiskSize.TooSmall.
    snapshotId String
    A snapshot to base the disk off of. If the disk size required by snapshot is greater than size, the size will be ignored, conflict with encrypted.
    storageSetId String
    storageSetPartitionNumber Number
    tags Map<Any>
    A mapping of tags to assign to the resource.
    type String
    zoneId String

    Outputs

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

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

    Look up Existing Disk Resource

    Get an existing Disk 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?: DiskState, opts?: CustomResourceOptions): Disk
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            advanced_features: Optional[str] = None,
            availability_zone: Optional[str] = None,
            category: Optional[str] = None,
            delete_auto_snapshot: Optional[bool] = None,
            delete_with_instance: Optional[bool] = None,
            description: Optional[str] = None,
            disk_name: Optional[str] = None,
            dry_run: Optional[bool] = None,
            enable_auto_snapshot: Optional[bool] = None,
            encrypt_algorithm: Optional[str] = None,
            encrypted: Optional[bool] = None,
            instance_id: Optional[str] = None,
            kms_key_id: Optional[str] = None,
            name: Optional[str] = None,
            payment_type: Optional[str] = None,
            performance_level: Optional[str] = None,
            resource_group_id: Optional[str] = None,
            size: Optional[int] = None,
            snapshot_id: Optional[str] = None,
            status: Optional[str] = None,
            storage_set_id: Optional[str] = None,
            storage_set_partition_number: Optional[int] = None,
            tags: Optional[Mapping[str, Any]] = None,
            type: Optional[str] = None,
            zone_id: Optional[str] = None) -> Disk
    func GetDisk(ctx *Context, name string, id IDInput, state *DiskState, opts ...ResourceOption) (*Disk, error)
    public static Disk Get(string name, Input<string> id, DiskState? state, CustomResourceOptions? opts = null)
    public static Disk get(String name, Output<String> id, DiskState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    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:
    AdvancedFeatures string
    AvailabilityZone string
    The Zone to create the disk in.

    Deprecated: Field 'availability_zone' has been deprecated from provider version 1.122.0. New field 'zone_id' instead

    Category string
    Category of the disk. Valid values are cloud, cloud_efficiency, cloud_ssd, cloud_essd, cloud_essd_entry. Default is cloud_efficiency.
    DeleteAutoSnapshot bool
    Indicates whether the automatic snapshot is deleted when the disk is released. Default value: false.
    DeleteWithInstance bool
    Indicates whether the disk is released together with the instance: Default value: false.
    Description string
    Description of the disk. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.
    DiskName string
    DryRun bool
    EnableAutoSnapshot bool
    Indicates whether to apply a created automatic snapshot policy to the disk. Default value: false.
    EncryptAlgorithm string
    Encrypted bool
    If true, the disk will be encrypted, conflict with snapshot_id.
    InstanceId string
    KmsKeyId string
    The ID of the KMS key corresponding to the data disk, The specified parameter Encrypted must be true when KmsKeyId is not empty.
    Name string
    Name of the ECS disk. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.

    Deprecated: Field 'name' has been deprecated from provider version 1.122.0. New field 'disk_name' instead.

    PaymentType string
    PerformanceLevel string
    Specifies the performance level of an ESSD when you create the ESSD. Default value: PL1. Valid values:

    • PL1: A single ESSD delivers up to 50,000 random read/write IOPS.
    • PL2: A single ESSD delivers up to 100,000 random read/write IOPS.
    • PL3: A single ESSD delivers up to 1,000,000 random read/write IOPS.
    ResourceGroupId string

    The Id of resource group which the disk belongs.

    NOTE: Disk category cloud has been outdated and it only can be used none I/O Optimized ECS instances. Recommend cloud_efficiency and cloud_ssd disk.

    Size int
    The size of the disk in GiBs. When resize the disk, the new size must be greater than the former value, or you would get an error InvalidDiskSize.TooSmall.
    SnapshotId string
    A snapshot to base the disk off of. If the disk size required by snapshot is greater than size, the size will be ignored, conflict with encrypted.
    Status string
    The disk status.
    StorageSetId string
    StorageSetPartitionNumber int
    Tags Dictionary<string, object>
    A mapping of tags to assign to the resource.
    Type string
    ZoneId string
    AdvancedFeatures string
    AvailabilityZone string
    The Zone to create the disk in.

    Deprecated: Field 'availability_zone' has been deprecated from provider version 1.122.0. New field 'zone_id' instead

    Category string
    Category of the disk. Valid values are cloud, cloud_efficiency, cloud_ssd, cloud_essd, cloud_essd_entry. Default is cloud_efficiency.
    DeleteAutoSnapshot bool
    Indicates whether the automatic snapshot is deleted when the disk is released. Default value: false.
    DeleteWithInstance bool
    Indicates whether the disk is released together with the instance: Default value: false.
    Description string
    Description of the disk. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.
    DiskName string
    DryRun bool
    EnableAutoSnapshot bool
    Indicates whether to apply a created automatic snapshot policy to the disk. Default value: false.
    EncryptAlgorithm string
    Encrypted bool
    If true, the disk will be encrypted, conflict with snapshot_id.
    InstanceId string
    KmsKeyId string
    The ID of the KMS key corresponding to the data disk, The specified parameter Encrypted must be true when KmsKeyId is not empty.
    Name string
    Name of the ECS disk. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.

    Deprecated: Field 'name' has been deprecated from provider version 1.122.0. New field 'disk_name' instead.

    PaymentType string
    PerformanceLevel string
    Specifies the performance level of an ESSD when you create the ESSD. Default value: PL1. Valid values:

    • PL1: A single ESSD delivers up to 50,000 random read/write IOPS.
    • PL2: A single ESSD delivers up to 100,000 random read/write IOPS.
    • PL3: A single ESSD delivers up to 1,000,000 random read/write IOPS.
    ResourceGroupId string

    The Id of resource group which the disk belongs.

    NOTE: Disk category cloud has been outdated and it only can be used none I/O Optimized ECS instances. Recommend cloud_efficiency and cloud_ssd disk.

    Size int
    The size of the disk in GiBs. When resize the disk, the new size must be greater than the former value, or you would get an error InvalidDiskSize.TooSmall.
    SnapshotId string
    A snapshot to base the disk off of. If the disk size required by snapshot is greater than size, the size will be ignored, conflict with encrypted.
    Status string
    The disk status.
    StorageSetId string
    StorageSetPartitionNumber int
    Tags map[string]interface{}
    A mapping of tags to assign to the resource.
    Type string
    ZoneId string
    advancedFeatures String
    availabilityZone String
    The Zone to create the disk in.

    Deprecated: Field 'availability_zone' has been deprecated from provider version 1.122.0. New field 'zone_id' instead

    category String
    Category of the disk. Valid values are cloud, cloud_efficiency, cloud_ssd, cloud_essd, cloud_essd_entry. Default is cloud_efficiency.
    deleteAutoSnapshot Boolean
    Indicates whether the automatic snapshot is deleted when the disk is released. Default value: false.
    deleteWithInstance Boolean
    Indicates whether the disk is released together with the instance: Default value: false.
    description String
    Description of the disk. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.
    diskName String
    dryRun Boolean
    enableAutoSnapshot Boolean
    Indicates whether to apply a created automatic snapshot policy to the disk. Default value: false.
    encryptAlgorithm String
    encrypted Boolean
    If true, the disk will be encrypted, conflict with snapshot_id.
    instanceId String
    kmsKeyId String
    The ID of the KMS key corresponding to the data disk, The specified parameter Encrypted must be true when KmsKeyId is not empty.
    name String
    Name of the ECS disk. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.

    Deprecated: Field 'name' has been deprecated from provider version 1.122.0. New field 'disk_name' instead.

    paymentType String
    performanceLevel String
    Specifies the performance level of an ESSD when you create the ESSD. Default value: PL1. Valid values:

    • PL1: A single ESSD delivers up to 50,000 random read/write IOPS.
    • PL2: A single ESSD delivers up to 100,000 random read/write IOPS.
    • PL3: A single ESSD delivers up to 1,000,000 random read/write IOPS.
    resourceGroupId String

    The Id of resource group which the disk belongs.

    NOTE: Disk category cloud has been outdated and it only can be used none I/O Optimized ECS instances. Recommend cloud_efficiency and cloud_ssd disk.

    size Integer
    The size of the disk in GiBs. When resize the disk, the new size must be greater than the former value, or you would get an error InvalidDiskSize.TooSmall.
    snapshotId String
    A snapshot to base the disk off of. If the disk size required by snapshot is greater than size, the size will be ignored, conflict with encrypted.
    status String
    The disk status.
    storageSetId String
    storageSetPartitionNumber Integer
    tags Map<String,Object>
    A mapping of tags to assign to the resource.
    type String
    zoneId String
    advancedFeatures string
    availabilityZone string
    The Zone to create the disk in.

    Deprecated: Field 'availability_zone' has been deprecated from provider version 1.122.0. New field 'zone_id' instead

    category string
    Category of the disk. Valid values are cloud, cloud_efficiency, cloud_ssd, cloud_essd, cloud_essd_entry. Default is cloud_efficiency.
    deleteAutoSnapshot boolean
    Indicates whether the automatic snapshot is deleted when the disk is released. Default value: false.
    deleteWithInstance boolean
    Indicates whether the disk is released together with the instance: Default value: false.
    description string
    Description of the disk. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.
    diskName string
    dryRun boolean
    enableAutoSnapshot boolean
    Indicates whether to apply a created automatic snapshot policy to the disk. Default value: false.
    encryptAlgorithm string
    encrypted boolean
    If true, the disk will be encrypted, conflict with snapshot_id.
    instanceId string
    kmsKeyId string
    The ID of the KMS key corresponding to the data disk, The specified parameter Encrypted must be true when KmsKeyId is not empty.
    name string
    Name of the ECS disk. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.

    Deprecated: Field 'name' has been deprecated from provider version 1.122.0. New field 'disk_name' instead.

    paymentType string
    performanceLevel string
    Specifies the performance level of an ESSD when you create the ESSD. Default value: PL1. Valid values:

    • PL1: A single ESSD delivers up to 50,000 random read/write IOPS.
    • PL2: A single ESSD delivers up to 100,000 random read/write IOPS.
    • PL3: A single ESSD delivers up to 1,000,000 random read/write IOPS.
    resourceGroupId string

    The Id of resource group which the disk belongs.

    NOTE: Disk category cloud has been outdated and it only can be used none I/O Optimized ECS instances. Recommend cloud_efficiency and cloud_ssd disk.

    size number
    The size of the disk in GiBs. When resize the disk, the new size must be greater than the former value, or you would get an error InvalidDiskSize.TooSmall.
    snapshotId string
    A snapshot to base the disk off of. If the disk size required by snapshot is greater than size, the size will be ignored, conflict with encrypted.
    status string
    The disk status.
    storageSetId string
    storageSetPartitionNumber number
    tags {[key: string]: any}
    A mapping of tags to assign to the resource.
    type string
    zoneId string
    advanced_features str
    availability_zone str
    The Zone to create the disk in.

    Deprecated: Field 'availability_zone' has been deprecated from provider version 1.122.0. New field 'zone_id' instead

    category str
    Category of the disk. Valid values are cloud, cloud_efficiency, cloud_ssd, cloud_essd, cloud_essd_entry. Default is cloud_efficiency.
    delete_auto_snapshot bool
    Indicates whether the automatic snapshot is deleted when the disk is released. Default value: false.
    delete_with_instance bool
    Indicates whether the disk is released together with the instance: Default value: false.
    description str
    Description of the disk. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.
    disk_name str
    dry_run bool
    enable_auto_snapshot bool
    Indicates whether to apply a created automatic snapshot policy to the disk. Default value: false.
    encrypt_algorithm str
    encrypted bool
    If true, the disk will be encrypted, conflict with snapshot_id.
    instance_id str
    kms_key_id str
    The ID of the KMS key corresponding to the data disk, The specified parameter Encrypted must be true when KmsKeyId is not empty.
    name str
    Name of the ECS disk. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.

    Deprecated: Field 'name' has been deprecated from provider version 1.122.0. New field 'disk_name' instead.

    payment_type str
    performance_level str
    Specifies the performance level of an ESSD when you create the ESSD. Default value: PL1. Valid values:

    • PL1: A single ESSD delivers up to 50,000 random read/write IOPS.
    • PL2: A single ESSD delivers up to 100,000 random read/write IOPS.
    • PL3: A single ESSD delivers up to 1,000,000 random read/write IOPS.
    resource_group_id str

    The Id of resource group which the disk belongs.

    NOTE: Disk category cloud has been outdated and it only can be used none I/O Optimized ECS instances. Recommend cloud_efficiency and cloud_ssd disk.

    size int
    The size of the disk in GiBs. When resize the disk, the new size must be greater than the former value, or you would get an error InvalidDiskSize.TooSmall.
    snapshot_id str
    A snapshot to base the disk off of. If the disk size required by snapshot is greater than size, the size will be ignored, conflict with encrypted.
    status str
    The disk status.
    storage_set_id str
    storage_set_partition_number int
    tags Mapping[str, Any]
    A mapping of tags to assign to the resource.
    type str
    zone_id str
    advancedFeatures String
    availabilityZone String
    The Zone to create the disk in.

    Deprecated: Field 'availability_zone' has been deprecated from provider version 1.122.0. New field 'zone_id' instead

    category String
    Category of the disk. Valid values are cloud, cloud_efficiency, cloud_ssd, cloud_essd, cloud_essd_entry. Default is cloud_efficiency.
    deleteAutoSnapshot Boolean
    Indicates whether the automatic snapshot is deleted when the disk is released. Default value: false.
    deleteWithInstance Boolean
    Indicates whether the disk is released together with the instance: Default value: false.
    description String
    Description of the disk. This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.
    diskName String
    dryRun Boolean
    enableAutoSnapshot Boolean
    Indicates whether to apply a created automatic snapshot policy to the disk. Default value: false.
    encryptAlgorithm String
    encrypted Boolean
    If true, the disk will be encrypted, conflict with snapshot_id.
    instanceId String
    kmsKeyId String
    The ID of the KMS key corresponding to the data disk, The specified parameter Encrypted must be true when KmsKeyId is not empty.
    name String
    Name of the ECS disk. This name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Default value is null.

    Deprecated: Field 'name' has been deprecated from provider version 1.122.0. New field 'disk_name' instead.

    paymentType String
    performanceLevel String
    Specifies the performance level of an ESSD when you create the ESSD. Default value: PL1. Valid values:

    • PL1: A single ESSD delivers up to 50,000 random read/write IOPS.
    • PL2: A single ESSD delivers up to 100,000 random read/write IOPS.
    • PL3: A single ESSD delivers up to 1,000,000 random read/write IOPS.
    resourceGroupId String

    The Id of resource group which the disk belongs.

    NOTE: Disk category cloud has been outdated and it only can be used none I/O Optimized ECS instances. Recommend cloud_efficiency and cloud_ssd disk.

    size Number
    The size of the disk in GiBs. When resize the disk, the new size must be greater than the former value, or you would get an error InvalidDiskSize.TooSmall.
    snapshotId String
    A snapshot to base the disk off of. If the disk size required by snapshot is greater than size, the size will be ignored, conflict with encrypted.
    status String
    The disk status.
    storageSetId String
    storageSetPartitionNumber Number
    tags Map<Any>
    A mapping of tags to assign to the resource.
    type String
    zoneId String

    Import

    Cloud disk can be imported using the id, e.g.

    $ pulumi import alicloud:ecs/disk:Disk example d-abc12345678
    

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

    Package Details

    Repository
    Alibaba Cloud pulumi/pulumi-alicloud
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the alicloud Terraform Provider.
    alicloud logo
    Alibaba Cloud v3.57.1 published on Wednesday, Jun 26, 2024 by Pulumi