Alibaba Cloud v3.53.0, Apr 17 24

Alibaba Cloud v3.53.0 published on Wednesday, Apr 17, 2024 by Pulumi

alicloud.ecs.Instance

Explore with Pulumi AI

Alibaba Cloud v3.53.0 published on Wednesday, Apr 17, 2024 by Pulumi

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";

const config = new pulumi.Config();
const name = config.get("name") || "terraform-example";
// Create a new ECS instance for VPC
const vpc = new alicloud.vpc.Network("vpc", {
    vpcName: name,
    cidrBlock: "172.16.0.0/16",
});
// Create a new ECS instance for a VPC
const group = new alicloud.ecs.SecurityGroup("group", {
    description: "foo",
    vpcId: vpc.id,
});
const key = new alicloud.kms.Key("key", {
    description: "Hello KMS",
    pendingWindowInDays: 7,
    status: "Enabled",
});
const default = alicloud.getZones({
    availableDiskCategory: "cloud_efficiency",
    availableResourceCreation: "VSwitch",
});
const vswitch = new alicloud.vpc.Switch("vswitch", {
    vpcId: vpc.id,
    cidrBlock: "172.16.0.0/24",
    zoneId: _default.then(_default => _default.zones?.[0]?.id),
    vswitchName: name,
});
const instance = new alicloud.ecs.Instance("instance", {
    availabilityZone: _default.then(_default => _default.zones?.[0]?.id),
    securityGroups: [group].map(__item => __item.id),
    instanceType: "ecs.n4.large",
    systemDiskCategory: "cloud_efficiency",
    systemDiskName: name,
    systemDiskDescription: "test_foo_system_disk_description",
    imageId: "ubuntu_18_04_64_20G_alibase_20190624.vhd",
    instanceName: name,
    vswitchId: vswitch.id,
    internetMaxBandwidthOut: 10,
    dataDisks: [{
        name: "disk2",
        size: 20,
        category: "cloud_efficiency",
        description: "disk2",
        encrypted: true,
        kmsKeyId: key.id,
    }],
});

import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "terraform-example"
# Create a new ECS instance for VPC
vpc = alicloud.vpc.Network("vpc",
    vpc_name=name,
    cidr_block="172.16.0.0/16")
# Create a new ECS instance for a VPC
group = alicloud.ecs.SecurityGroup("group",
    description="foo",
    vpc_id=vpc.id)
key = alicloud.kms.Key("key",
    description="Hello KMS",
    pending_window_in_days=7,
    status="Enabled")
default = alicloud.get_zones(available_disk_category="cloud_efficiency",
    available_resource_creation="VSwitch")
vswitch = alicloud.vpc.Switch("vswitch",
    vpc_id=vpc.id,
    cidr_block="172.16.0.0/24",
    zone_id=default.zones[0].id,
    vswitch_name=name)
instance = alicloud.ecs.Instance("instance",
    availability_zone=default.zones[0].id,
    security_groups=[__item.id for __item in [group]],
    instance_type="ecs.n4.large",
    system_disk_category="cloud_efficiency",
    system_disk_name=name,
    system_disk_description="test_foo_system_disk_description",
    image_id="ubuntu_18_04_64_20G_alibase_20190624.vhd",
    instance_name=name,
    vswitch_id=vswitch.id,
    internet_max_bandwidth_out=10,
    data_disks=[alicloud.ecs.InstanceDataDiskArgs(
        name="disk2",
        size=20,
        category="cloud_efficiency",
        description="disk2",
        encrypted=True,
        kms_key_id=key.id,
    )])

package main

import (
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/ecs"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/kms"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/vpc"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
cfg := config.New(ctx, "")
name := "terraform-example";
if param := cfg.Get("name"); param != ""{
name = param
}
// Create a new ECS instance for VPC
vpc, err := vpc.NewNetwork(ctx, "vpc", &vpc.NetworkArgs{
VpcName: pulumi.String(name),
CidrBlock: pulumi.String("172.16.0.0/16"),
})
if err != nil {
return err
}
// Create a new ECS instance for a VPC
group, err := ecs.NewSecurityGroup(ctx, "group", &ecs.SecurityGroupArgs{
Description: pulumi.String("foo"),
VpcId: vpc.ID(),
})
if err != nil {
return err
}
key, err := kms.NewKey(ctx, "key", &kms.KeyArgs{
Description: pulumi.String("Hello KMS"),
PendingWindowInDays: pulumi.Int(7),
Status: pulumi.String("Enabled"),
})
if err != nil {
return err
}
_default, err := alicloud.GetZones(ctx, &alicloud.GetZonesArgs{
AvailableDiskCategory: pulumi.StringRef("cloud_efficiency"),
AvailableResourceCreation: pulumi.StringRef("VSwitch"),
}, nil);
if err != nil {
return err
}
vswitch, err := vpc.NewSwitch(ctx, "vswitch", &vpc.SwitchArgs{
VpcId: vpc.ID(),
CidrBlock: pulumi.String("172.16.0.0/24"),
ZoneId: pulumi.String(_default.Zones[0].Id),
VswitchName: pulumi.String(name),
})
if err != nil {
return err
}
var splat0 pulumi.StringArray
for _, val0 := range %!v(PANIC=Format method: fatal: An assertion has failed: tok: ) {
splat0 = append(splat0, val0.ID())
}
_, err = ecs.NewInstance(ctx, "instance", &ecs.InstanceArgs{
AvailabilityZone: pulumi.String(_default.Zones[0].Id),
SecurityGroups: splat0,
InstanceType: pulumi.String("ecs.n4.large"),
SystemDiskCategory: pulumi.String("cloud_efficiency"),
SystemDiskName: pulumi.String(name),
SystemDiskDescription: pulumi.String("test_foo_system_disk_description"),
ImageId: pulumi.String("ubuntu_18_04_64_20G_alibase_20190624.vhd"),
InstanceName: pulumi.String(name),
VswitchId: vswitch.ID(),
InternetMaxBandwidthOut: pulumi.Int(10),
DataDisks: ecs.InstanceDataDiskArray{
&ecs.InstanceDataDiskArgs{
Name: pulumi.String("disk2"),
Size: pulumi.Int(20),
Category: pulumi.String("cloud_efficiency"),
Description: pulumi.String("disk2"),
Encrypted: pulumi.Bool(true),
KmsKeyId: key.ID(),
},
},
})
if err != nil {
return err
}
return nil
})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;

return await Deployment.RunAsync(() => 
{
    var config = new Config();
    var name = config.Get("name") ?? "terraform-example";
    // Create a new ECS instance for VPC
    var vpc = new AliCloud.Vpc.Network("vpc", new()
    {
        VpcName = name,
        CidrBlock = "172.16.0.0/16",
    });

    // Create a new ECS instance for a VPC
    var @group = new AliCloud.Ecs.SecurityGroup("group", new()
    {
        Description = "foo",
        VpcId = vpc.Id,
    });

    var key = new AliCloud.Kms.Key("key", new()
    {
        Description = "Hello KMS",
        PendingWindowInDays = 7,
        Status = "Enabled",
    });

    var @default = AliCloud.GetZones.Invoke(new()
    {
        AvailableDiskCategory = "cloud_efficiency",
        AvailableResourceCreation = "VSwitch",
    });

    var vswitch = new AliCloud.Vpc.Switch("vswitch", new()
    {
        VpcId = vpc.Id,
        CidrBlock = "172.16.0.0/24",
        ZoneId = @default.Apply(@default => @default.Apply(getZonesResult => getZonesResult.Zones[0]?.Id)),
        VswitchName = name,
    });

    var instance = new AliCloud.Ecs.Instance("instance", new()
    {
        AvailabilityZone = @default.Apply(@default => @default.Apply(getZonesResult => getZonesResult.Zones[0]?.Id)),
        SecurityGroups = new[]
        {
            @group,
        }.Select(__item => __item.Id).ToList(),
        InstanceType = "ecs.n4.large",
        SystemDiskCategory = "cloud_efficiency",
        SystemDiskName = name,
        SystemDiskDescription = "test_foo_system_disk_description",
        ImageId = "ubuntu_18_04_64_20G_alibase_20190624.vhd",
        InstanceName = name,
        VswitchId = vswitch.Id,
        InternetMaxBandwidthOut = 10,
        DataDisks = new[]
        {
            new AliCloud.Ecs.Inputs.InstanceDataDiskArgs
            {
                Name = "disk2",
                Size = 20,
                Category = "cloud_efficiency",
                Description = "disk2",
                Encrypted = true,
                KmsKeyId = key.Id,
            },
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.vpc.Network;
import com.pulumi.alicloud.vpc.NetworkArgs;
import com.pulumi.alicloud.ecs.SecurityGroup;
import com.pulumi.alicloud.ecs.SecurityGroupArgs;
import com.pulumi.alicloud.kms.Key;
import com.pulumi.alicloud.kms.KeyArgs;
import com.pulumi.alicloud.AlicloudFunctions;
import com.pulumi.alicloud.inputs.GetZonesArgs;
import com.pulumi.alicloud.vpc.Switch;
import com.pulumi.alicloud.vpc.SwitchArgs;
import com.pulumi.alicloud.ecs.Instance;
import com.pulumi.alicloud.ecs.InstanceArgs;
import com.pulumi.alicloud.ecs.inputs.InstanceDataDiskArgs;
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) {
        final var config = ctx.config();
        final var name = config.get("name").orElse("terraform-example");
        // Create a new ECS instance for VPC
        var vpc = new Network("vpc", NetworkArgs.builder()        
            .vpcName(name)
            .cidrBlock("172.16.0.0/16")
            .build());

        // Create a new ECS instance for a VPC
        var group = new SecurityGroup("group", SecurityGroupArgs.builder()        
            .description("foo")
            .vpcId(vpc.id())
            .build());

        var key = new Key("key", KeyArgs.builder()        
            .description("Hello KMS")
            .pendingWindowInDays("7")
            .status("Enabled")
            .build());

        final var default = AlicloudFunctions.getZones(GetZonesArgs.builder()
            .availableDiskCategory("cloud_efficiency")
            .availableResourceCreation("VSwitch")
            .build());

        var vswitch = new Switch("vswitch", SwitchArgs.builder()        
            .vpcId(vpc.id())
            .cidrBlock("172.16.0.0/24")
            .zoneId(default_.zones()[0].id())
            .vswitchName(name)
            .build());

        var instance = new Instance("instance", InstanceArgs.builder()        
            .availabilityZone(default_.zones()[0].id())
            .securityGroups(group.stream().map(element -> element.id()).collect(toList()))
            .instanceType("ecs.n4.large")
            .systemDiskCategory("cloud_efficiency")
            .systemDiskName(name)
            .systemDiskDescription("test_foo_system_disk_description")
            .imageId("ubuntu_18_04_64_20G_alibase_20190624.vhd")
            .instanceName(name)
            .vswitchId(vswitch.id())
            .internetMaxBandwidthOut(10)
            .dataDisks(InstanceDataDiskArgs.builder()
                .name("disk2")
                .size(20)
                .category("cloud_efficiency")
                .description("disk2")
                .encrypted(true)
                .kmsKeyId(key.id())
                .build())
            .build());

    }
}

Coming soon!

Module Support

You can use the existing ecs-instance module to create several ECS instances one-click.

Create Instance Resource

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

Constructor syntax

new Instance(name: string, args?: InstanceArgs, opts?: CustomResourceOptions);

@overload
def Instance(resource_name: str,
             args: Optional[InstanceArgs] = None,
             opts: Optional[ResourceOptions] = None)

@overload
def Instance(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             allocate_public_ip: Optional[bool] = None,
             auto_release_time: Optional[str] = None,
             auto_renew_period: Optional[int] = None,
             availability_zone: Optional[str] = None,
             credit_specification: Optional[str] = None,
             data_disks: Optional[Sequence[InstanceDataDiskArgs]] = None,
             dedicated_host_id: Optional[str] = None,
             deletion_protection: Optional[bool] = None,
             deployment_set_id: Optional[str] = None,
             description: Optional[str] = None,
             dry_run: Optional[bool] = None,
             force_delete: Optional[bool] = None,
             host_name: Optional[str] = None,
             hpc_cluster_id: Optional[str] = None,
             http_endpoint: Optional[str] = None,
             http_put_response_hop_limit: Optional[int] = None,
             http_tokens: Optional[str] = None,
             image_id: Optional[str] = None,
             include_data_disks: Optional[bool] = None,
             instance_charge_type: Optional[str] = None,
             instance_name: Optional[str] = None,
             instance_type: Optional[str] = None,
             internet_charge_type: Optional[str] = None,
             internet_max_bandwidth_in: Optional[int] = None,
             internet_max_bandwidth_out: Optional[int] = None,
             ipv6_address_count: Optional[int] = None,
             ipv6_addresses: Optional[Sequence[str]] = None,
             is_outdated: Optional[bool] = None,
             key_name: Optional[str] = None,
             kms_encrypted_password: Optional[str] = None,
             kms_encryption_context: Optional[Mapping[str, Any]] = None,
             launch_template_id: Optional[str] = None,
             launch_template_name: Optional[str] = None,
             launch_template_version: Optional[str] = None,
             maintenance_action: Optional[str] = None,
             maintenance_notify: Optional[bool] = None,
             maintenance_time: Optional[InstanceMaintenanceTimeArgs] = None,
             network_interfaces: Optional[InstanceNetworkInterfacesArgs] = None,
             operator_type: Optional[str] = None,
             password: Optional[str] = None,
             period: Optional[int] = None,
             period_unit: Optional[str] = None,
             private_ip: Optional[str] = None,
             renewal_status: Optional[str] = None,
             resource_group_id: Optional[str] = None,
             role_name: Optional[str] = None,
             secondary_private_ip_address_count: Optional[int] = None,
             secondary_private_ips: Optional[Sequence[str]] = None,
             security_enhancement_strategy: Optional[str] = None,
             security_groups: Optional[Sequence[str]] = None,
             spot_duration: Optional[int] = None,
             spot_price_limit: Optional[float] = None,
             spot_strategy: Optional[str] = None,
             status: Optional[str] = None,
             stopped_mode: Optional[str] = None,
             system_disk_auto_snapshot_policy_id: Optional[str] = None,
             system_disk_category: Optional[str] = None,
             system_disk_description: Optional[str] = None,
             system_disk_encrypt_algorithm: Optional[str] = None,
             system_disk_encrypted: Optional[bool] = None,
             system_disk_kms_key_id: Optional[str] = None,
             system_disk_name: Optional[str] = None,
             system_disk_performance_level: Optional[str] = None,
             system_disk_size: Optional[int] = None,
             system_disk_storage_cluster_id: Optional[str] = None,
             tags: Optional[Mapping[str, str]] = None,
             user_data: Optional[str] = None,
             volume_tags: Optional[Mapping[str, Any]] = None,
             vswitch_id: Optional[str] = None)

func NewInstance(ctx *Context, name string, args *InstanceArgs, opts ...ResourceOption) (*Instance, error)

public Instance(string name, InstanceArgs? args = null, CustomResourceOptions? opts = null)

public Instance(String name, InstanceArgs args)
public Instance(String name, InstanceArgs args, CustomResourceOptions options)

type: alicloud:ecs:Instance
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 InstanceArgs: 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 InstanceArgs: 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 InstanceArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args InstanceArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args InstanceArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

Example

The following reference example uses placeholder values for all input properties.

var exampleinstanceResourceResourceFromEcsinstance = new AliCloud.Ecs.Instance("exampleinstanceResourceResourceFromEcsinstance", new()
{
    AutoReleaseTime = "string",
    AutoRenewPeriod = 0,
    AvailabilityZone = "string",
    CreditSpecification = "string",
    DataDisks = new[]
    {
        new AliCloud.Ecs.Inputs.InstanceDataDiskArgs
        {
            Size = 0,
            AutoSnapshotPolicyId = "string",
            Category = "string",
            DeleteWithInstance = false,
            Description = "string",
            Device = "string",
            Encrypted = false,
            KmsKeyId = "string",
            Name = "string",
            PerformanceLevel = "string",
            SnapshotId = "string",
        },
    },
    DedicatedHostId = "string",
    DeletionProtection = false,
    DeploymentSetId = "string",
    Description = "string",
    DryRun = false,
    ForceDelete = false,
    HostName = "string",
    HpcClusterId = "string",
    HttpEndpoint = "string",
    HttpPutResponseHopLimit = 0,
    HttpTokens = "string",
    ImageId = "string",
    IncludeDataDisks = false,
    InstanceChargeType = "string",
    InstanceName = "string",
    InstanceType = "string",
    InternetChargeType = "string",
    InternetMaxBandwidthOut = 0,
    Ipv6AddressCount = 0,
    Ipv6Addresses = new[]
    {
        "string",
    },
    IsOutdated = false,
    KeyName = "string",
    KmsEncryptedPassword = "string",
    KmsEncryptionContext = 
    {
        { "string", "any" },
    },
    LaunchTemplateId = "string",
    LaunchTemplateName = "string",
    LaunchTemplateVersion = "string",
    MaintenanceAction = "string",
    MaintenanceNotify = false,
    MaintenanceTime = new AliCloud.Ecs.Inputs.InstanceMaintenanceTimeArgs
    {
        EndTime = "string",
        StartTime = "string",
    },
    NetworkInterfaces = new AliCloud.Ecs.Inputs.InstanceNetworkInterfacesArgs
    {
        NetworkInterfaceId = "string",
    },
    OperatorType = "string",
    Password = "string",
    Period = 0,
    PeriodUnit = "string",
    PrivateIp = "string",
    RenewalStatus = "string",
    ResourceGroupId = "string",
    RoleName = "string",
    SecondaryPrivateIpAddressCount = 0,
    SecondaryPrivateIps = new[]
    {
        "string",
    },
    SecurityEnhancementStrategy = "string",
    SecurityGroups = new[]
    {
        "string",
    },
    SpotDuration = 0,
    SpotPriceLimit = 0,
    SpotStrategy = "string",
    Status = "string",
    StoppedMode = "string",
    SystemDiskAutoSnapshotPolicyId = "string",
    SystemDiskCategory = "string",
    SystemDiskDescription = "string",
    SystemDiskEncryptAlgorithm = "string",
    SystemDiskEncrypted = false,
    SystemDiskKmsKeyId = "string",
    SystemDiskName = "string",
    SystemDiskPerformanceLevel = "string",
    SystemDiskSize = 0,
    SystemDiskStorageClusterId = "string",
    Tags = 
    {
        { "string", "string" },
    },
    UserData = "string",
    VolumeTags = 
    {
        { "string", "any" },
    },
    VswitchId = "string",
});

example, err := ecs.NewInstance(ctx, "exampleinstanceResourceResourceFromEcsinstance", &ecs.InstanceArgs{
	AutoReleaseTime:     pulumi.String("string"),
	AutoRenewPeriod:     pulumi.Int(0),
	AvailabilityZone:    pulumi.String("string"),
	CreditSpecification: pulumi.String("string"),
	DataDisks: ecs.InstanceDataDiskArray{
		&ecs.InstanceDataDiskArgs{
			Size:                 pulumi.Int(0),
			AutoSnapshotPolicyId: pulumi.String("string"),
			Category:             pulumi.String("string"),
			DeleteWithInstance:   pulumi.Bool(false),
			Description:          pulumi.String("string"),
			Device:               pulumi.String("string"),
			Encrypted:            pulumi.Bool(false),
			KmsKeyId:             pulumi.String("string"),
			Name:                 pulumi.String("string"),
			PerformanceLevel:     pulumi.String("string"),
			SnapshotId:           pulumi.String("string"),
		},
	},
	DedicatedHostId:         pulumi.String("string"),
	DeletionProtection:      pulumi.Bool(false),
	DeploymentSetId:         pulumi.String("string"),
	Description:             pulumi.String("string"),
	DryRun:                  pulumi.Bool(false),
	ForceDelete:             pulumi.Bool(false),
	HostName:                pulumi.String("string"),
	HpcClusterId:            pulumi.String("string"),
	HttpEndpoint:            pulumi.String("string"),
	HttpPutResponseHopLimit: pulumi.Int(0),
	HttpTokens:              pulumi.String("string"),
	ImageId:                 pulumi.String("string"),
	IncludeDataDisks:        pulumi.Bool(false),
	InstanceChargeType:      pulumi.String("string"),
	InstanceName:            pulumi.String("string"),
	InstanceType:            pulumi.String("string"),
	InternetChargeType:      pulumi.String("string"),
	InternetMaxBandwidthOut: pulumi.Int(0),
	Ipv6AddressCount:        pulumi.Int(0),
	Ipv6Addresses: pulumi.StringArray{
		pulumi.String("string"),
	},
	IsOutdated:           pulumi.Bool(false),
	KeyName:              pulumi.String("string"),
	KmsEncryptedPassword: pulumi.String("string"),
	KmsEncryptionContext: pulumi.Map{
		"string": pulumi.Any("any"),
	},
	LaunchTemplateId:      pulumi.String("string"),
	LaunchTemplateName:    pulumi.String("string"),
	LaunchTemplateVersion: pulumi.String("string"),
	MaintenanceAction:     pulumi.String("string"),
	MaintenanceNotify:     pulumi.Bool(false),
	MaintenanceTime: &ecs.InstanceMaintenanceTimeArgs{
		EndTime:   pulumi.String("string"),
		StartTime: pulumi.String("string"),
	},
	NetworkInterfaces: &ecs.InstanceNetworkInterfacesArgs{
		NetworkInterfaceId: pulumi.String("string"),
	},
	OperatorType:                   pulumi.String("string"),
	Password:                       pulumi.String("string"),
	Period:                         pulumi.Int(0),
	PeriodUnit:                     pulumi.String("string"),
	PrivateIp:                      pulumi.String("string"),
	RenewalStatus:                  pulumi.String("string"),
	ResourceGroupId:                pulumi.String("string"),
	RoleName:                       pulumi.String("string"),
	SecondaryPrivateIpAddressCount: pulumi.Int(0),
	SecondaryPrivateIps: pulumi.StringArray{
		pulumi.String("string"),
	},
	SecurityEnhancementStrategy: pulumi.String("string"),
	SecurityGroups: pulumi.StringArray{
		pulumi.String("string"),
	},
	SpotDuration:                   pulumi.Int(0),
	SpotPriceLimit:                 pulumi.Float64(0),
	SpotStrategy:                   pulumi.String("string"),
	Status:                         pulumi.String("string"),
	StoppedMode:                    pulumi.String("string"),
	SystemDiskAutoSnapshotPolicyId: pulumi.String("string"),
	SystemDiskCategory:             pulumi.String("string"),
	SystemDiskDescription:          pulumi.String("string"),
	SystemDiskEncryptAlgorithm:     pulumi.String("string"),
	SystemDiskEncrypted:            pulumi.Bool(false),
	SystemDiskKmsKeyId:             pulumi.String("string"),
	SystemDiskName:                 pulumi.String("string"),
	SystemDiskPerformanceLevel:     pulumi.String("string"),
	SystemDiskSize:                 pulumi.Int(0),
	SystemDiskStorageClusterId:     pulumi.String("string"),
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	UserData: pulumi.String("string"),
	VolumeTags: pulumi.Map{
		"string": pulumi.Any("any"),
	},
	VswitchId: pulumi.String("string"),
})

var exampleinstanceResourceResourceFromEcsinstance = new Instance("exampleinstanceResourceResourceFromEcsinstance", InstanceArgs.builder()        
    .autoReleaseTime("string")
    .autoRenewPeriod(0)
    .availabilityZone("string")
    .creditSpecification("string")
    .dataDisks(InstanceDataDiskArgs.builder()
        .size(0)
        .autoSnapshotPolicyId("string")
        .category("string")
        .deleteWithInstance(false)
        .description("string")
        .device("string")
        .encrypted(false)
        .kmsKeyId("string")
        .name("string")
        .performanceLevel("string")
        .snapshotId("string")
        .build())
    .dedicatedHostId("string")
    .deletionProtection(false)
    .deploymentSetId("string")
    .description("string")
    .dryRun(false)
    .forceDelete(false)
    .hostName("string")
    .hpcClusterId("string")
    .httpEndpoint("string")
    .httpPutResponseHopLimit(0)
    .httpTokens("string")
    .imageId("string")
    .includeDataDisks(false)
    .instanceChargeType("string")
    .instanceName("string")
    .instanceType("string")
    .internetChargeType("string")
    .internetMaxBandwidthOut(0)
    .ipv6AddressCount(0)
    .ipv6Addresses("string")
    .isOutdated(false)
    .keyName("string")
    .kmsEncryptedPassword("string")
    .kmsEncryptionContext(Map.of("string", "any"))
    .launchTemplateId("string")
    .launchTemplateName("string")
    .launchTemplateVersion("string")
    .maintenanceAction("string")
    .maintenanceNotify(false)
    .maintenanceTime(InstanceMaintenanceTimeArgs.builder()
        .endTime("string")
        .startTime("string")
        .build())
    .networkInterfaces(InstanceNetworkInterfacesArgs.builder()
        .networkInterfaceId("string")
        .build())
    .operatorType("string")
    .password("string")
    .period(0)
    .periodUnit("string")
    .privateIp("string")
    .renewalStatus("string")
    .resourceGroupId("string")
    .roleName("string")
    .secondaryPrivateIpAddressCount(0)
    .secondaryPrivateIps("string")
    .securityEnhancementStrategy("string")
    .securityGroups("string")
    .spotDuration(0)
    .spotPriceLimit(0)
    .spotStrategy("string")
    .status("string")
    .stoppedMode("string")
    .systemDiskAutoSnapshotPolicyId("string")
    .systemDiskCategory("string")
    .systemDiskDescription("string")
    .systemDiskEncryptAlgorithm("string")
    .systemDiskEncrypted(false)
    .systemDiskKmsKeyId("string")
    .systemDiskName("string")
    .systemDiskPerformanceLevel("string")
    .systemDiskSize(0)
    .systemDiskStorageClusterId("string")
    .tags(Map.of("string", "string"))
    .userData("string")
    .volumeTags(Map.of("string", "any"))
    .vswitchId("string")
    .build());

exampleinstance_resource_resource_from_ecsinstance = alicloud.ecs.Instance("exampleinstanceResourceResourceFromEcsinstance",
    auto_release_time="string",
    auto_renew_period=0,
    availability_zone="string",
    credit_specification="string",
    data_disks=[alicloud.ecs.InstanceDataDiskArgs(
        size=0,
        auto_snapshot_policy_id="string",
        category="string",
        delete_with_instance=False,
        description="string",
        device="string",
        encrypted=False,
        kms_key_id="string",
        name="string",
        performance_level="string",
        snapshot_id="string",
    )],
    dedicated_host_id="string",
    deletion_protection=False,
    deployment_set_id="string",
    description="string",
    dry_run=False,
    force_delete=False,
    host_name="string",
    hpc_cluster_id="string",
    http_endpoint="string",
    http_put_response_hop_limit=0,
    http_tokens="string",
    image_id="string",
    include_data_disks=False,
    instance_charge_type="string",
    instance_name="string",
    instance_type="string",
    internet_charge_type="string",
    internet_max_bandwidth_out=0,
    ipv6_address_count=0,
    ipv6_addresses=["string"],
    is_outdated=False,
    key_name="string",
    kms_encrypted_password="string",
    kms_encryption_context={
        "string": "any",
    },
    launch_template_id="string",
    launch_template_name="string",
    launch_template_version="string",
    maintenance_action="string",
    maintenance_notify=False,
    maintenance_time=alicloud.ecs.InstanceMaintenanceTimeArgs(
        end_time="string",
        start_time="string",
    ),
    network_interfaces=alicloud.ecs.InstanceNetworkInterfacesArgs(
        network_interface_id="string",
    ),
    operator_type="string",
    password="string",
    period=0,
    period_unit="string",
    private_ip="string",
    renewal_status="string",
    resource_group_id="string",
    role_name="string",
    secondary_private_ip_address_count=0,
    secondary_private_ips=["string"],
    security_enhancement_strategy="string",
    security_groups=["string"],
    spot_duration=0,
    spot_price_limit=0,
    spot_strategy="string",
    status="string",
    stopped_mode="string",
    system_disk_auto_snapshot_policy_id="string",
    system_disk_category="string",
    system_disk_description="string",
    system_disk_encrypt_algorithm="string",
    system_disk_encrypted=False,
    system_disk_kms_key_id="string",
    system_disk_name="string",
    system_disk_performance_level="string",
    system_disk_size=0,
    system_disk_storage_cluster_id="string",
    tags={
        "string": "string",
    },
    user_data="string",
    volume_tags={
        "string": "any",
    },
    vswitch_id="string")

const exampleinstanceResourceResourceFromEcsinstance = new alicloud.ecs.Instance("exampleinstanceResourceResourceFromEcsinstance", {
    autoReleaseTime: "string",
    autoRenewPeriod: 0,
    availabilityZone: "string",
    creditSpecification: "string",
    dataDisks: [{
        size: 0,
        autoSnapshotPolicyId: "string",
        category: "string",
        deleteWithInstance: false,
        description: "string",
        device: "string",
        encrypted: false,
        kmsKeyId: "string",
        name: "string",
        performanceLevel: "string",
        snapshotId: "string",
    }],
    dedicatedHostId: "string",
    deletionProtection: false,
    deploymentSetId: "string",
    description: "string",
    dryRun: false,
    forceDelete: false,
    hostName: "string",
    hpcClusterId: "string",
    httpEndpoint: "string",
    httpPutResponseHopLimit: 0,
    httpTokens: "string",
    imageId: "string",
    includeDataDisks: false,
    instanceChargeType: "string",
    instanceName: "string",
    instanceType: "string",
    internetChargeType: "string",
    internetMaxBandwidthOut: 0,
    ipv6AddressCount: 0,
    ipv6Addresses: ["string"],
    isOutdated: false,
    keyName: "string",
    kmsEncryptedPassword: "string",
    kmsEncryptionContext: {
        string: "any",
    },
    launchTemplateId: "string",
    launchTemplateName: "string",
    launchTemplateVersion: "string",
    maintenanceAction: "string",
    maintenanceNotify: false,
    maintenanceTime: {
        endTime: "string",
        startTime: "string",
    },
    networkInterfaces: {
        networkInterfaceId: "string",
    },
    operatorType: "string",
    password: "string",
    period: 0,
    periodUnit: "string",
    privateIp: "string",
    renewalStatus: "string",
    resourceGroupId: "string",
    roleName: "string",
    secondaryPrivateIpAddressCount: 0,
    secondaryPrivateIps: ["string"],
    securityEnhancementStrategy: "string",
    securityGroups: ["string"],
    spotDuration: 0,
    spotPriceLimit: 0,
    spotStrategy: "string",
    status: "string",
    stoppedMode: "string",
    systemDiskAutoSnapshotPolicyId: "string",
    systemDiskCategory: "string",
    systemDiskDescription: "string",
    systemDiskEncryptAlgorithm: "string",
    systemDiskEncrypted: false,
    systemDiskKmsKeyId: "string",
    systemDiskName: "string",
    systemDiskPerformanceLevel: "string",
    systemDiskSize: 0,
    systemDiskStorageClusterId: "string",
    tags: {
        string: "string",
    },
    userData: "string",
    volumeTags: {
        string: "any",
    },
    vswitchId: "string",
});

type: alicloud:ecs:Instance
properties:
    autoReleaseTime: string
    autoRenewPeriod: 0
    availabilityZone: string
    creditSpecification: string
    dataDisks:
        - autoSnapshotPolicyId: string
          category: string
          deleteWithInstance: false
          description: string
          device: string
          encrypted: false
          kmsKeyId: string
          name: string
          performanceLevel: string
          size: 0
          snapshotId: string
    dedicatedHostId: string
    deletionProtection: false
    deploymentSetId: string
    description: string
    dryRun: false
    forceDelete: false
    hostName: string
    hpcClusterId: string
    httpEndpoint: string
    httpPutResponseHopLimit: 0
    httpTokens: string
    imageId: string
    includeDataDisks: false
    instanceChargeType: string
    instanceName: string
    instanceType: string
    internetChargeType: string
    internetMaxBandwidthOut: 0
    ipv6AddressCount: 0
    ipv6Addresses:
        - string
    isOutdated: false
    keyName: string
    kmsEncryptedPassword: string
    kmsEncryptionContext:
        string: any
    launchTemplateId: string
    launchTemplateName: string
    launchTemplateVersion: string
    maintenanceAction: string
    maintenanceNotify: false
    maintenanceTime:
        endTime: string
        startTime: string
    networkInterfaces:
        networkInterfaceId: string
    operatorType: string
    password: string
    period: 0
    periodUnit: string
    privateIp: string
    renewalStatus: string
    resourceGroupId: string
    roleName: string
    secondaryPrivateIpAddressCount: 0
    secondaryPrivateIps:
        - string
    securityEnhancementStrategy: string
    securityGroups:
        - string
    spotDuration: 0
    spotPriceLimit: 0
    spotStrategy: string
    status: string
    stoppedMode: string
    systemDiskAutoSnapshotPolicyId: string
    systemDiskCategory: string
    systemDiskDescription: string
    systemDiskEncryptAlgorithm: string
    systemDiskEncrypted: false
    systemDiskKmsKeyId: string
    systemDiskName: string
    systemDiskPerformanceLevel: string
    systemDiskSize: 0
    systemDiskStorageClusterId: string
    tags:
        string: string
    userData: string
    volumeTags:
        string: any
    vswitchId: string

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

AllocatePublicIp bool

It has been deprecated from version "1.7.0". Setting "internet_max_bandwidth_out" larger than 0 can allocate a public ip address for an instance.

Deprecated: Field 'allocate_public_ip' has been deprecated from provider version 1.6.1. Setting 'internet_max_bandwidth_out' larger than 0 will allocate public ip for instance.

AutoReleaseTime string

The automatic release time of the PostPaid instance. The time follows the ISO 8601 standard and is in UTC time. Format: yyyy-MM-ddTHH:mm:ssZ. It must be at least half an hour later than the current time and less than 3 years since the current time. Setting it to null can cancel automatic release feature, and the ECS instance will not be released automatically.

AutoRenewPeriod int

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid value:

[1, 2, 3, 6, 12] when period_unit in "Month"
[1, 2, 3] when period_unit in "Week"

AvailabilityZone string

The Zone to start the instance in. It is ignored and will be computed when set vswitch_id.

CreditSpecification string

Performance mode of the t5 burstable instance. Valid values: 'Standard', 'Unlimited'.

DataDisks List<Pulumi.AliCloud.Ecs.Inputs.InstanceDataDisk>

The list of data disks created with instance. See data_disks below.

DedicatedHostId string

The ID of the dedicated host on which to create the instance. If you set the DedicatedHostId parameter, the spot_strategy and spot_price_limit parameters cannot be set. This is because preemptible instances cannot be created on dedicated hosts.

DeletionProtection bool

Whether enable the deletion protection or not. It does not work when the instance is spot. Default value: false.

true: Enable deletion protection.
false: Disable deletion protection.

DeploymentSetId string

The ID of the deployment set to which to deploy the instance. NOTE: From version 1.176.0, instance's deploymentSetId can be removed when 'deployment_set_id' = "".

Description string

Description of the instance, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.

DryRun bool

Specifies whether to send a dry-run request. Default to false.

true: Only a dry-run request is sent and no instance is created. The system checks whether the required parameters are set, and validates the request format, service permissions, and available ECS instances. If the validation fails, the corresponding error code is returned. If the validation succeeds, the DryRunOperation error code is returned.
false: A request is sent. If the validation succeeds, the instance is created.

ForceDelete bool

If it is true, the "PrePaid" instance will be change to "PostPaid" and then deleted forcibly. However, because of changing instance charge type has CPU core count quota limitation, so strongly recommand that "Don't modify instance charge type frequentlly in one month".

HostName string

Host name of the ECS, which is a string of at least two characters. “hostname” cannot start or end with “.” or “-“. In addition, two or more consecutive “.” or “-“ symbols are not allowed. On Windows, the host name can contain a maximum of 15 characters, which can be a combination of uppercase/lowercase letters, numerals, and “-“. The host name cannot contain dots (“.”) or contain only numeric characters. When it is changed, the instance will reboot to make the change take effect. On other OSs such as Linux, the host name can contain a maximum of 64 characters, which can be segments separated by dots (“.”), where each segment can contain uppercase/lowercase letters, numerals, or “_“. When it is changed, the instance will reboot to make the change take effect.

HpcClusterId string

The ID of the Elastic High Performance Computing (E-HPC) cluster to which to assign the instance.

HttpEndpoint string

Specifies whether to enable the access channel for instance metadata. Valid values: enabled, disabled. Default value: enabled.

HttpPutResponseHopLimit int

The HTTP PUT response hop limit for accessing instance metadata. Valid values: 1 to 64. Default value: 1.

HttpTokens string

Specifies whether to forcefully use the security-enhanced mode (IMDSv2) to access instance metadata. Default value: optional. Valid values:

optional: does not forcefully use the security-enhanced mode (IMDSv2).
required: forcefully uses the security-enhanced mode (IMDSv2). After you set this parameter to required, you cannot access instance metadata in normal mode.

ImageId string

The Image to use for the instance. ECS instance's image can be replaced via changing image_id. When it is changed, the instance will reboot to make the change take effect. If you do not use launch_template_id or launch_template_name to specify a launch template, you must specify image_id.

IncludeDataDisks bool

Whether to change instance disks charge type when changing instance charge type.

InstanceChargeType string

Valid values are PrePaid, PostPaid, The default is PostPaid. NOTE: Since 1.9.6, it can be changed each other between PostPaid and PrePaid. However, since some limitation about CPU core count in one month, there strongly recommends that Don't change instance_charge_type frequentlly in one month.

InstanceName string

InstanceType string

The type of instance to start. When it is changed, the instance will reboot to make the change take effect. If you do not use launch_template_id or launch_template_name to specify a launch template, you must specify instance_type.

InternetChargeType string

Internet charge type of the instance, Valid values are PayByBandwidth, PayByTraffic. Default is PayByTraffic. At present, 'PrePaid' instance cannot change the value to "PayByBandwidth" from "PayByTraffic".

InternetMaxBandwidthIn int

Maximum incoming bandwidth from the public network, measured in Mbps (Mega bit per second). Value range: [1, 200]. If this value is not specified, then automatically sets it to 200 Mbps.

Deprecated: The attribute is invalid and no any affect for the instance. So it has been deprecated since version v1.121.2.

InternetMaxBandwidthOut int

Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value range: [0, 100]. Default to 0 Mbps.

Ipv6AddressCount int

The number of IPv6 addresses to randomly generate for the primary ENI. Valid values: 1 to 10. NOTE: You cannot specify both the ipv6_addresses and ipv6_address_count parameters.

Ipv6Addresses List<string>

A list of IPv6 address to be assigned to the primary ENI. Support up to 10.

IsOutdated bool

Whether to use outdated instance type. Default to false.

KeyName string

The name of key pair that can login ECS instance successfully without password. If it is specified, the password would be invalid.

KmsEncryptedPassword string

An KMS encrypts password used to an instance. If the password is filled in, this field will be ignored. When it is changed, the instance will reboot to make the change take effect.

KmsEncryptionContext Dictionary<string, object>

An KMS encryption context used to decrypt kms_encrypted_password before creating or updating an instance with kms_encrypted_password. See Encryption Context. It is valid when kms_encrypted_password is set. When it is changed, the instance will reboot to make the change take effect.

LaunchTemplateId string

The ID of the launch template. For more information, see DescribeLaunchTemplates.To use a launch template to create an instance, you must use the launch_template_id or launch_template_name parameter to specify the launch template.

LaunchTemplateName string

The name of the launch template.

LaunchTemplateVersion string

The version of the launch template. If you set launch_template_id or launch_template_name parameter but do not set the version number of the launch template, the default template version is used.

NOTE: System 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.

NOTE: From version 1.5.0, instance's charge type can be changed to "PrePaid" by specifying period and period_unit, but it is irreversible.

NOTE: From version 1.5.0, instance's private IP address can be specified when creating VPC network instance.

NOTE: From version 1.5.0, instance's vswitch and private IP can be changed in the same availability zone. When they are changed, the instance will reboot to make the change take effect.

NOTE: From version 1.7.0, setting "internet_max_bandwidth_out" larger than 0 can allocate a public IP for an instance. Setting "internet_max_bandwidth_out" to 0 can release allocated public IP for VPC instance(For Classic instnace, its public IP cannot be release once it allocated, even thougth its bandwidth out is 0). However, at present, 'PrePaid' instance cannot narrow its max bandwidth out when its 'internet_charge_type' is "PayByBandwidth".

NOTE: From version 1.7.0, instance's type can be changed. When it is changed, the instance will reboot to make the change take effect.

MaintenanceAction string

The maintenance action. Valid values: Stop, AutoRecover and AutoRedeploy.

MaintenanceNotify bool

Specifies whether to send an event notification before instance shutdown. Valid values: true, false. Default value: false.

MaintenanceTime Pulumi.AliCloud.Ecs.Inputs.InstanceMaintenanceTime

The time of maintenance. See maintenance_time below.

NetworkInterfaces Pulumi.AliCloud.Ecs.Inputs.InstanceNetworkInterfaces

The list of network interfaces created with instance. See network_interfaces below.

OperatorType string

The operation type. It is valid when instance_charge_type is PrePaid. Default value: upgrade. Valid values: upgrade, downgrade. NOTE: When the new instance type specified by the instance_type parameter has lower specifications than the current instance type, you must set operator_type to downgrade.

Password string

Password to an instance is a string of 8 to 30 characters. It must contain uppercase/lowercase letters and numerals, but cannot contain special symbols. When it is changed, the instance will reboot to make the change take effect.

Period int

The duration that you will buy the resource, in month. It is valid and required when instance_charge_type is PrePaid. Valid values:

[1-9, 12, 24, 36, 48, 60] when period_unit in "Month"
[1-3] when period_unit in "Week"

NOTE: The attribute period is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running pulumi up will not effect the resource.

PeriodUnit string

The duration unit that you will buy the resource. It is valid when instance_charge_type is 'PrePaid'. Valid value: ["Week", "Month"]. Default to "Month".

PrivateIp string

Instance private IP address can be specified when you creating new instance. It is valid when vswitch_id is specified. When it is changed, the instance will reboot to make the change take effect.

RenewalStatus string

Whether to renew an ECS instance automatically or not. It is valid when instance_charge_type is PrePaid. Default to "Normal". Valid values:

ResourceGroupId string

The Id of resource group which the instance belongs.

RoleName string

Instance RAM role name. The name is provided and maintained by RAM. You can use alicloud.ram.Role to create a new one.

SecondaryPrivateIpAddressCount int

The number of private IP addresses to be automatically assigned from within the CIDR block of the vswitch. NOTE: To assign secondary private IP addresses, you must specify secondary_private_ips or secondary_private_ip_address_count but not both.

SecondaryPrivateIps List<string>

A list of Secondary private IP addresses which is selected from within the CIDR block of the VSwitch.

SecurityEnhancementStrategy string

The security enhancement strategy.

Active: Enable security enhancement strategy, it only works on system images.
Deactive: Disable security enhancement strategy, it works on all images.

SecurityGroups List<string>

A list of security group ids to associate with. If you do not use launch_template_id or launch_template_name to specify a launch template, you must specify security_groups.

SpotDuration int

The retention time of the preemptive instance in hours. Valid values: 0, 1, 2, 3, 4, 5, 6. Retention duration 2~6 is under invitation test, please submit a work order if you need to open. If the value is 0, the mode is no protection period. Default value is 1.

SpotPriceLimit double

The hourly price threshold of a instance, and it takes effect only when parameter 'spot_strategy' is 'SpotWithPriceLimit'. Three decimals is allowed at most.

SpotStrategy string

The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter instance_charge_type is 'PostPaid'. Value range:

NoSpot: A regular Pay-As-You-Go instance.
SpotWithPriceLimit: A price threshold for a spot instance
SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go instance

Default to NoSpot. Note: Currently, the spot instance only supports domestic site account.

Status string

The instance status. Valid values: ["Running", "Stopped"]. You can control the instance start and stop through this parameter. Default to Running.

StoppedMode string

The stop mode of the pay-as-you-go instance. Valid values: StopCharging,KeepCharging, Not-applicable. Default value: If the prerequisites required for enabling the economical mode are met, and you have enabled this mode in the ECS console, the default value is StopCharging. For more information, see "Enable the economical mode" in Economical mode. Otherwise, the default value is KeepCharging. Note: Not-applicable: Economical mode is not applicable to the instance.`

SystemDiskAutoSnapshotPolicyId string

The ID of the automatic snapshot policy applied to the system disk.

SystemDiskCategory string

Valid values are ephemeral_ssd, cloud_efficiency, cloud_ssd, cloud_essd, cloud, cloud_auto, cloud_essd_entry. only is used to some none I/O optimized instance. Valid values cloud_auto Available since 1.184.0+.

SystemDiskDescription string

The description of the system disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

SystemDiskEncryptAlgorithm string

The algorithm to be used to encrypt the system disk. Valid values are aes-256, sm4-128. Default value is aes-256.

SystemDiskEncrypted bool

Specifies whether to encrypt the system disk. Valid values: true,false. Default value: false.

SystemDiskKmsKeyId string

The ID of the Key Management Service (KMS) key to be used for the system disk.

SystemDiskName string

The name of the system disk. The name must be 2 to 128 characters in length and can contain letters, digits, periods (.), colons (:), underscores (_), and hyphens (-). It must start with a letter and cannot start with http:// or https://.

SystemDiskPerformanceLevel string

The performance level of the ESSD used as the system disk, Valid values: PL0, PL1, PL2, PL3, Default to PL1;For more information about ESSD, See Encryption Context.

SystemDiskSize int

Size of the system disk, measured in GiB. Value range: [20, 500]. The specified value must be equal to or greater than max{20, Imagesize}. Default value: max{40, ImageSize}.

SystemDiskStorageClusterId string

The ID of the dedicated block storage cluster. If you want to use disks in a dedicated block storage cluster as system disks when you create instances, you must specify this parameter. For more information about dedicated block storage clusters.

Tags Dictionary<string, string>

A mapping of tags to assign to the resource.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

UserData string

User-defined data to customize the startup behaviors of an ECS instance and to pass data into an ECS instance. It supports to setting a base64-encoded value, and it is the recommended usage. From version 1.60.0, it can be updated in-place. If updated, the instance will reboot to make the change take effect. Note: Not all changes will take effect, and it depends on cloud-init module type.

VolumeTags Dictionary<string, object>

A mapping of tags to assign to the devices created by the instance at launch time.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

VswitchId string

The virtual switch ID to launch in VPC. This parameter must be set unless you can create classic network instances. When it is changed, the instance will reboot to make the change take effect.

AllocatePublicIp bool

It has been deprecated from version "1.7.0". Setting "internet_max_bandwidth_out" larger than 0 can allocate a public ip address for an instance.

Deprecated: Field 'allocate_public_ip' has been deprecated from provider version 1.6.1. Setting 'internet_max_bandwidth_out' larger than 0 will allocate public ip for instance.

AutoReleaseTime string

AutoRenewPeriod int

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid value:

[1, 2, 3, 6, 12] when period_unit in "Month"
[1, 2, 3] when period_unit in "Week"

AvailabilityZone string

The Zone to start the instance in. It is ignored and will be computed when set vswitch_id.

CreditSpecification string

Performance mode of the t5 burstable instance. Valid values: 'Standard', 'Unlimited'.

DataDisks []InstanceDataDiskArgs

The list of data disks created with instance. See data_disks below.

DedicatedHostId string

DeletionProtection bool

Whether enable the deletion protection or not. It does not work when the instance is spot. Default value: false.

true: Enable deletion protection.
false: Disable deletion protection.

DeploymentSetId string

The ID of the deployment set to which to deploy the instance. NOTE: From version 1.176.0, instance's deploymentSetId can be removed when 'deployment_set_id' = "".

Description string

Description of the instance, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.

DryRun bool

Specifies whether to send a dry-run request. Default to false.

true: Only a dry-run request is sent and no instance is created. The system checks whether the required parameters are set, and validates the request format, service permissions, and available ECS instances. If the validation fails, the corresponding error code is returned. If the validation succeeds, the DryRunOperation error code is returned.
false: A request is sent. If the validation succeeds, the instance is created.

ForceDelete bool

HostName string

HpcClusterId string

The ID of the Elastic High Performance Computing (E-HPC) cluster to which to assign the instance.

HttpEndpoint string

Specifies whether to enable the access channel for instance metadata. Valid values: enabled, disabled. Default value: enabled.

HttpPutResponseHopLimit int

The HTTP PUT response hop limit for accessing instance metadata. Valid values: 1 to 64. Default value: 1.

HttpTokens string

Specifies whether to forcefully use the security-enhanced mode (IMDSv2) to access instance metadata. Default value: optional. Valid values:

optional: does not forcefully use the security-enhanced mode (IMDSv2).
required: forcefully uses the security-enhanced mode (IMDSv2). After you set this parameter to required, you cannot access instance metadata in normal mode.

ImageId string

IncludeDataDisks bool

Whether to change instance disks charge type when changing instance charge type.

InstanceChargeType string

InstanceName string

InstanceType string

InternetChargeType string

InternetMaxBandwidthIn int

Maximum incoming bandwidth from the public network, measured in Mbps (Mega bit per second). Value range: [1, 200]. If this value is not specified, then automatically sets it to 200 Mbps.

Deprecated: The attribute is invalid and no any affect for the instance. So it has been deprecated since version v1.121.2.

InternetMaxBandwidthOut int

Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value range: [0, 100]. Default to 0 Mbps.

Ipv6AddressCount int

The number of IPv6 addresses to randomly generate for the primary ENI. Valid values: 1 to 10. NOTE: You cannot specify both the ipv6_addresses and ipv6_address_count parameters.

Ipv6Addresses []string

A list of IPv6 address to be assigned to the primary ENI. Support up to 10.

IsOutdated bool

Whether to use outdated instance type. Default to false.

KeyName string

The name of key pair that can login ECS instance successfully without password. If it is specified, the password would be invalid.

KmsEncryptedPassword string

An KMS encrypts password used to an instance. If the password is filled in, this field will be ignored. When it is changed, the instance will reboot to make the change take effect.

KmsEncryptionContext map[string]interface{}

LaunchTemplateId string

LaunchTemplateName string

The name of the launch template.

LaunchTemplateVersion string

The version of the launch template. If you set launch_template_id or launch_template_name parameter but do not set the version number of the launch template, the default template version is used.

NOTE: System 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.

NOTE: From version 1.5.0, instance's charge type can be changed to "PrePaid" by specifying period and period_unit, but it is irreversible.

NOTE: From version 1.5.0, instance's private IP address can be specified when creating VPC network instance.

NOTE: From version 1.5.0, instance's vswitch and private IP can be changed in the same availability zone. When they are changed, the instance will reboot to make the change take effect.

NOTE: From version 1.7.0, setting "internet_max_bandwidth_out" larger than 0 can allocate a public IP for an instance. Setting "internet_max_bandwidth_out" to 0 can release allocated public IP for VPC instance(For Classic instnace, its public IP cannot be release once it allocated, even thougth its bandwidth out is 0). However, at present, 'PrePaid' instance cannot narrow its max bandwidth out when its 'internet_charge_type' is "PayByBandwidth".

NOTE: From version 1.7.0, instance's type can be changed. When it is changed, the instance will reboot to make the change take effect.

MaintenanceAction string

The maintenance action. Valid values: Stop, AutoRecover and AutoRedeploy.

MaintenanceNotify bool

Specifies whether to send an event notification before instance shutdown. Valid values: true, false. Default value: false.

MaintenanceTime InstanceMaintenanceTimeArgs

The time of maintenance. See maintenance_time below.

NetworkInterfaces InstanceNetworkInterfacesArgs

The list of network interfaces created with instance. See network_interfaces below.

OperatorType string

Password string

Period int

The duration that you will buy the resource, in month. It is valid and required when instance_charge_type is PrePaid. Valid values:

[1-9, 12, 24, 36, 48, 60] when period_unit in "Month"
[1-3] when period_unit in "Week"

NOTE: The attribute period is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running pulumi up will not effect the resource.

PeriodUnit string

The duration unit that you will buy the resource. It is valid when instance_charge_type is 'PrePaid'. Valid value: ["Week", "Month"]. Default to "Month".

PrivateIp string

Instance private IP address can be specified when you creating new instance. It is valid when vswitch_id is specified. When it is changed, the instance will reboot to make the change take effect.

RenewalStatus string

Whether to renew an ECS instance automatically or not. It is valid when instance_charge_type is PrePaid. Default to "Normal". Valid values:

ResourceGroupId string

The Id of resource group which the instance belongs.

RoleName string

Instance RAM role name. The name is provided and maintained by RAM. You can use alicloud.ram.Role to create a new one.

SecondaryPrivateIpAddressCount int

SecondaryPrivateIps []string

A list of Secondary private IP addresses which is selected from within the CIDR block of the VSwitch.

SecurityEnhancementStrategy string

The security enhancement strategy.

Active: Enable security enhancement strategy, it only works on system images.
Deactive: Disable security enhancement strategy, it works on all images.

SecurityGroups []string

A list of security group ids to associate with. If you do not use launch_template_id or launch_template_name to specify a launch template, you must specify security_groups.

SpotDuration int

SpotPriceLimit float64

The hourly price threshold of a instance, and it takes effect only when parameter 'spot_strategy' is 'SpotWithPriceLimit'. Three decimals is allowed at most.

SpotStrategy string

The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter instance_charge_type is 'PostPaid'. Value range:

NoSpot: A regular Pay-As-You-Go instance.
SpotWithPriceLimit: A price threshold for a spot instance
SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go instance

Default to NoSpot. Note: Currently, the spot instance only supports domestic site account.

Status string

The instance status. Valid values: ["Running", "Stopped"]. You can control the instance start and stop through this parameter. Default to Running.

StoppedMode string

SystemDiskAutoSnapshotPolicyId string

The ID of the automatic snapshot policy applied to the system disk.

SystemDiskCategory string

SystemDiskDescription string

The description of the system disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

SystemDiskEncryptAlgorithm string

The algorithm to be used to encrypt the system disk. Valid values are aes-256, sm4-128. Default value is aes-256.

SystemDiskEncrypted bool

Specifies whether to encrypt the system disk. Valid values: true,false. Default value: false.

SystemDiskKmsKeyId string

The ID of the Key Management Service (KMS) key to be used for the system disk.

SystemDiskName string

SystemDiskPerformanceLevel string

The performance level of the ESSD used as the system disk, Valid values: PL0, PL1, PL2, PL3, Default to PL1;For more information about ESSD, See Encryption Context.

SystemDiskSize int

Size of the system disk, measured in GiB. Value range: [20, 500]. The specified value must be equal to or greater than max{20, Imagesize}. Default value: max{40, ImageSize}.

SystemDiskStorageClusterId string

Tags map[string]string

A mapping of tags to assign to the resource.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

UserData string

VolumeTags map[string]interface{}

A mapping of tags to assign to the devices created by the instance at launch time.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

VswitchId string

The virtual switch ID to launch in VPC. This parameter must be set unless you can create classic network instances. When it is changed, the instance will reboot to make the change take effect.

allocatePublicIp Boolean

It has been deprecated from version "1.7.0". Setting "internet_max_bandwidth_out" larger than 0 can allocate a public ip address for an instance.

Deprecated: Field 'allocate_public_ip' has been deprecated from provider version 1.6.1. Setting 'internet_max_bandwidth_out' larger than 0 will allocate public ip for instance.

autoReleaseTime String

autoRenewPeriod Integer

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid value:

[1, 2, 3, 6, 12] when period_unit in "Month"
[1, 2, 3] when period_unit in "Week"

availabilityZone String

The Zone to start the instance in. It is ignored and will be computed when set vswitch_id.

creditSpecification String

Performance mode of the t5 burstable instance. Valid values: 'Standard', 'Unlimited'.

dataDisks List<InstanceDataDisk>

The list of data disks created with instance. See data_disks below.

dedicatedHostId String

deletionProtection Boolean

Whether enable the deletion protection or not. It does not work when the instance is spot. Default value: false.

true: Enable deletion protection.
false: Disable deletion protection.

deploymentSetId String

The ID of the deployment set to which to deploy the instance. NOTE: From version 1.176.0, instance's deploymentSetId can be removed when 'deployment_set_id' = "".

description String

Description of the instance, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.

dryRun Boolean

Specifies whether to send a dry-run request. Default to false.

true: Only a dry-run request is sent and no instance is created. The system checks whether the required parameters are set, and validates the request format, service permissions, and available ECS instances. If the validation fails, the corresponding error code is returned. If the validation succeeds, the DryRunOperation error code is returned.
false: A request is sent. If the validation succeeds, the instance is created.

forceDelete Boolean

hostName String

hpcClusterId String

The ID of the Elastic High Performance Computing (E-HPC) cluster to which to assign the instance.

httpEndpoint String

Specifies whether to enable the access channel for instance metadata. Valid values: enabled, disabled. Default value: enabled.

httpPutResponseHopLimit Integer

The HTTP PUT response hop limit for accessing instance metadata. Valid values: 1 to 64. Default value: 1.

httpTokens String

Specifies whether to forcefully use the security-enhanced mode (IMDSv2) to access instance metadata. Default value: optional. Valid values:

optional: does not forcefully use the security-enhanced mode (IMDSv2).
required: forcefully uses the security-enhanced mode (IMDSv2). After you set this parameter to required, you cannot access instance metadata in normal mode.

imageId String

includeDataDisks Boolean

Whether to change instance disks charge type when changing instance charge type.

instanceChargeType String

instanceName String

instanceType String

internetChargeType String

internetMaxBandwidthIn Integer

Maximum incoming bandwidth from the public network, measured in Mbps (Mega bit per second). Value range: [1, 200]. If this value is not specified, then automatically sets it to 200 Mbps.

Deprecated: The attribute is invalid and no any affect for the instance. So it has been deprecated since version v1.121.2.

internetMaxBandwidthOut Integer

Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value range: [0, 100]. Default to 0 Mbps.

ipv6AddressCount Integer

The number of IPv6 addresses to randomly generate for the primary ENI. Valid values: 1 to 10. NOTE: You cannot specify both the ipv6_addresses and ipv6_address_count parameters.

ipv6Addresses List<String>

A list of IPv6 address to be assigned to the primary ENI. Support up to 10.

isOutdated Boolean

Whether to use outdated instance type. Default to false.

keyName String

The name of key pair that can login ECS instance successfully without password. If it is specified, the password would be invalid.

kmsEncryptedPassword String

An KMS encrypts password used to an instance. If the password is filled in, this field will be ignored. When it is changed, the instance will reboot to make the change take effect.

kmsEncryptionContext Map<String,Object>

launchTemplateId String

launchTemplateName String

The name of the launch template.

launchTemplateVersion String

The version of the launch template. If you set launch_template_id or launch_template_name parameter but do not set the version number of the launch template, the default template version is used.

NOTE: System 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.

NOTE: From version 1.5.0, instance's charge type can be changed to "PrePaid" by specifying period and period_unit, but it is irreversible.

NOTE: From version 1.5.0, instance's private IP address can be specified when creating VPC network instance.

NOTE: From version 1.5.0, instance's vswitch and private IP can be changed in the same availability zone. When they are changed, the instance will reboot to make the change take effect.

NOTE: From version 1.7.0, setting "internet_max_bandwidth_out" larger than 0 can allocate a public IP for an instance. Setting "internet_max_bandwidth_out" to 0 can release allocated public IP for VPC instance(For Classic instnace, its public IP cannot be release once it allocated, even thougth its bandwidth out is 0). However, at present, 'PrePaid' instance cannot narrow its max bandwidth out when its 'internet_charge_type' is "PayByBandwidth".

NOTE: From version 1.7.0, instance's type can be changed. When it is changed, the instance will reboot to make the change take effect.

maintenanceAction String

The maintenance action. Valid values: Stop, AutoRecover and AutoRedeploy.

maintenanceNotify Boolean

Specifies whether to send an event notification before instance shutdown. Valid values: true, false. Default value: false.

maintenanceTime InstanceMaintenanceTime

The time of maintenance. See maintenance_time below.

networkInterfaces InstanceNetworkInterfaces

The list of network interfaces created with instance. See network_interfaces below.

operatorType String

password String

period Integer

The duration that you will buy the resource, in month. It is valid and required when instance_charge_type is PrePaid. Valid values:

[1-9, 12, 24, 36, 48, 60] when period_unit in "Month"
[1-3] when period_unit in "Week"

NOTE: The attribute period is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running pulumi up will not effect the resource.

periodUnit String

The duration unit that you will buy the resource. It is valid when instance_charge_type is 'PrePaid'. Valid value: ["Week", "Month"]. Default to "Month".

privateIp String

Instance private IP address can be specified when you creating new instance. It is valid when vswitch_id is specified. When it is changed, the instance will reboot to make the change take effect.

renewalStatus String

Whether to renew an ECS instance automatically or not. It is valid when instance_charge_type is PrePaid. Default to "Normal". Valid values:

resourceGroupId String

The Id of resource group which the instance belongs.

roleName String

Instance RAM role name. The name is provided and maintained by RAM. You can use alicloud.ram.Role to create a new one.

secondaryPrivateIpAddressCount Integer

secondaryPrivateIps List<String>

A list of Secondary private IP addresses which is selected from within the CIDR block of the VSwitch.

securityEnhancementStrategy String

The security enhancement strategy.

Active: Enable security enhancement strategy, it only works on system images.
Deactive: Disable security enhancement strategy, it works on all images.

securityGroups List<String>

A list of security group ids to associate with. If you do not use launch_template_id or launch_template_name to specify a launch template, you must specify security_groups.

spotDuration Integer

spotPriceLimit Double

The hourly price threshold of a instance, and it takes effect only when parameter 'spot_strategy' is 'SpotWithPriceLimit'. Three decimals is allowed at most.

spotStrategy String

The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter instance_charge_type is 'PostPaid'. Value range:

NoSpot: A regular Pay-As-You-Go instance.
SpotWithPriceLimit: A price threshold for a spot instance
SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go instance

Default to NoSpot. Note: Currently, the spot instance only supports domestic site account.

status String

The instance status. Valid values: ["Running", "Stopped"]. You can control the instance start and stop through this parameter. Default to Running.

stoppedMode String

systemDiskAutoSnapshotPolicyId String

The ID of the automatic snapshot policy applied to the system disk.

systemDiskCategory String

systemDiskDescription String

The description of the system disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

systemDiskEncryptAlgorithm String

The algorithm to be used to encrypt the system disk. Valid values are aes-256, sm4-128. Default value is aes-256.

systemDiskEncrypted Boolean

Specifies whether to encrypt the system disk. Valid values: true,false. Default value: false.

systemDiskKmsKeyId String

The ID of the Key Management Service (KMS) key to be used for the system disk.

systemDiskName String

systemDiskPerformanceLevel String

The performance level of the ESSD used as the system disk, Valid values: PL0, PL1, PL2, PL3, Default to PL1;For more information about ESSD, See Encryption Context.

systemDiskSize Integer

Size of the system disk, measured in GiB. Value range: [20, 500]. The specified value must be equal to or greater than max{20, Imagesize}. Default value: max{40, ImageSize}.

systemDiskStorageClusterId String

tags Map<String,String>

A mapping of tags to assign to the resource.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

userData String

volumeTags Map<String,Object>

A mapping of tags to assign to the devices created by the instance at launch time.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

vswitchId String

The virtual switch ID to launch in VPC. This parameter must be set unless you can create classic network instances. When it is changed, the instance will reboot to make the change take effect.

allocatePublicIp boolean

It has been deprecated from version "1.7.0". Setting "internet_max_bandwidth_out" larger than 0 can allocate a public ip address for an instance.

Deprecated: Field 'allocate_public_ip' has been deprecated from provider version 1.6.1. Setting 'internet_max_bandwidth_out' larger than 0 will allocate public ip for instance.

autoReleaseTime string

autoRenewPeriod number

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid value:

[1, 2, 3, 6, 12] when period_unit in "Month"
[1, 2, 3] when period_unit in "Week"

availabilityZone string

The Zone to start the instance in. It is ignored and will be computed when set vswitch_id.

creditSpecification string

Performance mode of the t5 burstable instance. Valid values: 'Standard', 'Unlimited'.

dataDisks InstanceDataDisk[]

The list of data disks created with instance. See data_disks below.

dedicatedHostId string

deletionProtection boolean

Whether enable the deletion protection or not. It does not work when the instance is spot. Default value: false.

true: Enable deletion protection.
false: Disable deletion protection.

deploymentSetId string

The ID of the deployment set to which to deploy the instance. NOTE: From version 1.176.0, instance's deploymentSetId can be removed when 'deployment_set_id' = "".

description string

Description of the instance, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.

dryRun boolean

Specifies whether to send a dry-run request. Default to false.

true: Only a dry-run request is sent and no instance is created. The system checks whether the required parameters are set, and validates the request format, service permissions, and available ECS instances. If the validation fails, the corresponding error code is returned. If the validation succeeds, the DryRunOperation error code is returned.
false: A request is sent. If the validation succeeds, the instance is created.

forceDelete boolean

hostName string

hpcClusterId string

The ID of the Elastic High Performance Computing (E-HPC) cluster to which to assign the instance.

httpEndpoint string

Specifies whether to enable the access channel for instance metadata. Valid values: enabled, disabled. Default value: enabled.

httpPutResponseHopLimit number

The HTTP PUT response hop limit for accessing instance metadata. Valid values: 1 to 64. Default value: 1.

httpTokens string

Specifies whether to forcefully use the security-enhanced mode (IMDSv2) to access instance metadata. Default value: optional. Valid values:

optional: does not forcefully use the security-enhanced mode (IMDSv2).
required: forcefully uses the security-enhanced mode (IMDSv2). After you set this parameter to required, you cannot access instance metadata in normal mode.

imageId string

includeDataDisks boolean

Whether to change instance disks charge type when changing instance charge type.

instanceChargeType string

instanceName string

instanceType string

internetChargeType string

internetMaxBandwidthIn number

Maximum incoming bandwidth from the public network, measured in Mbps (Mega bit per second). Value range: [1, 200]. If this value is not specified, then automatically sets it to 200 Mbps.

Deprecated: The attribute is invalid and no any affect for the instance. So it has been deprecated since version v1.121.2.

internetMaxBandwidthOut number

Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value range: [0, 100]. Default to 0 Mbps.

ipv6AddressCount number

The number of IPv6 addresses to randomly generate for the primary ENI. Valid values: 1 to 10. NOTE: You cannot specify both the ipv6_addresses and ipv6_address_count parameters.

ipv6Addresses string[]

A list of IPv6 address to be assigned to the primary ENI. Support up to 10.

isOutdated boolean

Whether to use outdated instance type. Default to false.

keyName string

The name of key pair that can login ECS instance successfully without password. If it is specified, the password would be invalid.

kmsEncryptedPassword string

An KMS encrypts password used to an instance. If the password is filled in, this field will be ignored. When it is changed, the instance will reboot to make the change take effect.

kmsEncryptionContext {[key: string]: any}

launchTemplateId string

launchTemplateName string

The name of the launch template.

launchTemplateVersion string

The version of the launch template. If you set launch_template_id or launch_template_name parameter but do not set the version number of the launch template, the default template version is used.

NOTE: System 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.

NOTE: From version 1.5.0, instance's charge type can be changed to "PrePaid" by specifying period and period_unit, but it is irreversible.

NOTE: From version 1.5.0, instance's private IP address can be specified when creating VPC network instance.

NOTE: From version 1.5.0, instance's vswitch and private IP can be changed in the same availability zone. When they are changed, the instance will reboot to make the change take effect.

NOTE: From version 1.7.0, setting "internet_max_bandwidth_out" larger than 0 can allocate a public IP for an instance. Setting "internet_max_bandwidth_out" to 0 can release allocated public IP for VPC instance(For Classic instnace, its public IP cannot be release once it allocated, even thougth its bandwidth out is 0). However, at present, 'PrePaid' instance cannot narrow its max bandwidth out when its 'internet_charge_type' is "PayByBandwidth".

NOTE: From version 1.7.0, instance's type can be changed. When it is changed, the instance will reboot to make the change take effect.

maintenanceAction string

The maintenance action. Valid values: Stop, AutoRecover and AutoRedeploy.

maintenanceNotify boolean

Specifies whether to send an event notification before instance shutdown. Valid values: true, false. Default value: false.

maintenanceTime InstanceMaintenanceTime

The time of maintenance. See maintenance_time below.

networkInterfaces InstanceNetworkInterfaces

The list of network interfaces created with instance. See network_interfaces below.

operatorType string

password string

period number

The duration that you will buy the resource, in month. It is valid and required when instance_charge_type is PrePaid. Valid values:

[1-9, 12, 24, 36, 48, 60] when period_unit in "Month"
[1-3] when period_unit in "Week"

NOTE: The attribute period is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running pulumi up will not effect the resource.

periodUnit string

The duration unit that you will buy the resource. It is valid when instance_charge_type is 'PrePaid'. Valid value: ["Week", "Month"]. Default to "Month".

privateIp string

Instance private IP address can be specified when you creating new instance. It is valid when vswitch_id is specified. When it is changed, the instance will reboot to make the change take effect.

renewalStatus string

Whether to renew an ECS instance automatically or not. It is valid when instance_charge_type is PrePaid. Default to "Normal". Valid values:

resourceGroupId string

The Id of resource group which the instance belongs.

roleName string

Instance RAM role name. The name is provided and maintained by RAM. You can use alicloud.ram.Role to create a new one.

secondaryPrivateIpAddressCount number

secondaryPrivateIps string[]

A list of Secondary private IP addresses which is selected from within the CIDR block of the VSwitch.

securityEnhancementStrategy string

The security enhancement strategy.

Active: Enable security enhancement strategy, it only works on system images.
Deactive: Disable security enhancement strategy, it works on all images.

securityGroups string[]

A list of security group ids to associate with. If you do not use launch_template_id or launch_template_name to specify a launch template, you must specify security_groups.

spotDuration number

spotPriceLimit number

The hourly price threshold of a instance, and it takes effect only when parameter 'spot_strategy' is 'SpotWithPriceLimit'. Three decimals is allowed at most.

spotStrategy string

The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter instance_charge_type is 'PostPaid'. Value range:

NoSpot: A regular Pay-As-You-Go instance.
SpotWithPriceLimit: A price threshold for a spot instance
SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go instance

Default to NoSpot. Note: Currently, the spot instance only supports domestic site account.

status string

The instance status. Valid values: ["Running", "Stopped"]. You can control the instance start and stop through this parameter. Default to Running.

stoppedMode string

systemDiskAutoSnapshotPolicyId string

The ID of the automatic snapshot policy applied to the system disk.

systemDiskCategory string

systemDiskDescription string

The description of the system disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

systemDiskEncryptAlgorithm string

The algorithm to be used to encrypt the system disk. Valid values are aes-256, sm4-128. Default value is aes-256.

systemDiskEncrypted boolean

Specifies whether to encrypt the system disk. Valid values: true,false. Default value: false.

systemDiskKmsKeyId string

The ID of the Key Management Service (KMS) key to be used for the system disk.

systemDiskName string

systemDiskPerformanceLevel string

The performance level of the ESSD used as the system disk, Valid values: PL0, PL1, PL2, PL3, Default to PL1;For more information about ESSD, See Encryption Context.

systemDiskSize number

Size of the system disk, measured in GiB. Value range: [20, 500]. The specified value must be equal to or greater than max{20, Imagesize}. Default value: max{40, ImageSize}.

systemDiskStorageClusterId string

tags {[key: string]: string}

A mapping of tags to assign to the resource.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

userData string

volumeTags {[key: string]: any}

A mapping of tags to assign to the devices created by the instance at launch time.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

vswitchId string

The virtual switch ID to launch in VPC. This parameter must be set unless you can create classic network instances. When it is changed, the instance will reboot to make the change take effect.

allocate_public_ip bool

It has been deprecated from version "1.7.0". Setting "internet_max_bandwidth_out" larger than 0 can allocate a public ip address for an instance.

Deprecated: Field 'allocate_public_ip' has been deprecated from provider version 1.6.1. Setting 'internet_max_bandwidth_out' larger than 0 will allocate public ip for instance.

auto_release_time str

auto_renew_period int

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid value:

[1, 2, 3, 6, 12] when period_unit in "Month"
[1, 2, 3] when period_unit in "Week"

availability_zone str

The Zone to start the instance in. It is ignored and will be computed when set vswitch_id.

credit_specification str

Performance mode of the t5 burstable instance. Valid values: 'Standard', 'Unlimited'.

data_disks Sequence[InstanceDataDiskArgs]

The list of data disks created with instance. See data_disks below.

dedicated_host_id str

deletion_protection bool

Whether enable the deletion protection or not. It does not work when the instance is spot. Default value: false.

true: Enable deletion protection.
false: Disable deletion protection.

deployment_set_id str

The ID of the deployment set to which to deploy the instance. NOTE: From version 1.176.0, instance's deploymentSetId can be removed when 'deployment_set_id' = "".

description str

Description of the instance, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.

dry_run bool

Specifies whether to send a dry-run request. Default to false.

true: Only a dry-run request is sent and no instance is created. The system checks whether the required parameters are set, and validates the request format, service permissions, and available ECS instances. If the validation fails, the corresponding error code is returned. If the validation succeeds, the DryRunOperation error code is returned.
false: A request is sent. If the validation succeeds, the instance is created.

force_delete bool

host_name str

hpc_cluster_id str

The ID of the Elastic High Performance Computing (E-HPC) cluster to which to assign the instance.

http_endpoint str

Specifies whether to enable the access channel for instance metadata. Valid values: enabled, disabled. Default value: enabled.

http_put_response_hop_limit int

The HTTP PUT response hop limit for accessing instance metadata. Valid values: 1 to 64. Default value: 1.

http_tokens str

Specifies whether to forcefully use the security-enhanced mode (IMDSv2) to access instance metadata. Default value: optional. Valid values:

optional: does not forcefully use the security-enhanced mode (IMDSv2).
required: forcefully uses the security-enhanced mode (IMDSv2). After you set this parameter to required, you cannot access instance metadata in normal mode.

image_id str

include_data_disks bool

Whether to change instance disks charge type when changing instance charge type.

instance_charge_type str

instance_name str

instance_type str

internet_charge_type str

internet_max_bandwidth_in int

Maximum incoming bandwidth from the public network, measured in Mbps (Mega bit per second). Value range: [1, 200]. If this value is not specified, then automatically sets it to 200 Mbps.

Deprecated: The attribute is invalid and no any affect for the instance. So it has been deprecated since version v1.121.2.

internet_max_bandwidth_out int

Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value range: [0, 100]. Default to 0 Mbps.

ipv6_address_count int

The number of IPv6 addresses to randomly generate for the primary ENI. Valid values: 1 to 10. NOTE: You cannot specify both the ipv6_addresses and ipv6_address_count parameters.

ipv6_addresses Sequence[str]

A list of IPv6 address to be assigned to the primary ENI. Support up to 10.

is_outdated bool

Whether to use outdated instance type. Default to false.

key_name str

The name of key pair that can login ECS instance successfully without password. If it is specified, the password would be invalid.

kms_encrypted_password str

An KMS encrypts password used to an instance. If the password is filled in, this field will be ignored. When it is changed, the instance will reboot to make the change take effect.

kms_encryption_context Mapping[str, Any]

launch_template_id str

launch_template_name str

The name of the launch template.

launch_template_version str

The version of the launch template. If you set launch_template_id or launch_template_name parameter but do not set the version number of the launch template, the default template version is used.

NOTE: System 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.

NOTE: From version 1.5.0, instance's charge type can be changed to "PrePaid" by specifying period and period_unit, but it is irreversible.

NOTE: From version 1.5.0, instance's private IP address can be specified when creating VPC network instance.

NOTE: From version 1.5.0, instance's vswitch and private IP can be changed in the same availability zone. When they are changed, the instance will reboot to make the change take effect.

NOTE: From version 1.7.0, setting "internet_max_bandwidth_out" larger than 0 can allocate a public IP for an instance. Setting "internet_max_bandwidth_out" to 0 can release allocated public IP for VPC instance(For Classic instnace, its public IP cannot be release once it allocated, even thougth its bandwidth out is 0). However, at present, 'PrePaid' instance cannot narrow its max bandwidth out when its 'internet_charge_type' is "PayByBandwidth".

NOTE: From version 1.7.0, instance's type can be changed. When it is changed, the instance will reboot to make the change take effect.

maintenance_action str

The maintenance action. Valid values: Stop, AutoRecover and AutoRedeploy.

maintenance_notify bool

Specifies whether to send an event notification before instance shutdown. Valid values: true, false. Default value: false.

maintenance_time InstanceMaintenanceTimeArgs

The time of maintenance. See maintenance_time below.

network_interfaces InstanceNetworkInterfacesArgs

The list of network interfaces created with instance. See network_interfaces below.

operator_type str

password str

period int

The duration that you will buy the resource, in month. It is valid and required when instance_charge_type is PrePaid. Valid values:

[1-9, 12, 24, 36, 48, 60] when period_unit in "Month"
[1-3] when period_unit in "Week"

NOTE: The attribute period is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running pulumi up will not effect the resource.

period_unit str

The duration unit that you will buy the resource. It is valid when instance_charge_type is 'PrePaid'. Valid value: ["Week", "Month"]. Default to "Month".

private_ip str

Instance private IP address can be specified when you creating new instance. It is valid when vswitch_id is specified. When it is changed, the instance will reboot to make the change take effect.

renewal_status str

Whether to renew an ECS instance automatically or not. It is valid when instance_charge_type is PrePaid. Default to "Normal". Valid values:

resource_group_id str

The Id of resource group which the instance belongs.

role_name str

Instance RAM role name. The name is provided and maintained by RAM. You can use alicloud.ram.Role to create a new one.

secondary_private_ip_address_count int

secondary_private_ips Sequence[str]

A list of Secondary private IP addresses which is selected from within the CIDR block of the VSwitch.

security_enhancement_strategy str

The security enhancement strategy.

Active: Enable security enhancement strategy, it only works on system images.
Deactive: Disable security enhancement strategy, it works on all images.

security_groups Sequence[str]

A list of security group ids to associate with. If you do not use launch_template_id or launch_template_name to specify a launch template, you must specify security_groups.

spot_duration int

spot_price_limit float

The hourly price threshold of a instance, and it takes effect only when parameter 'spot_strategy' is 'SpotWithPriceLimit'. Three decimals is allowed at most.

spot_strategy str

The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter instance_charge_type is 'PostPaid'. Value range:

NoSpot: A regular Pay-As-You-Go instance.
SpotWithPriceLimit: A price threshold for a spot instance
SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go instance

Default to NoSpot. Note: Currently, the spot instance only supports domestic site account.

status str

The instance status. Valid values: ["Running", "Stopped"]. You can control the instance start and stop through this parameter. Default to Running.

stopped_mode str

system_disk_auto_snapshot_policy_id str

The ID of the automatic snapshot policy applied to the system disk.

system_disk_category str

system_disk_description str

The description of the system disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

system_disk_encrypt_algorithm str

The algorithm to be used to encrypt the system disk. Valid values are aes-256, sm4-128. Default value is aes-256.

system_disk_encrypted bool

Specifies whether to encrypt the system disk. Valid values: true,false. Default value: false.

system_disk_kms_key_id str

The ID of the Key Management Service (KMS) key to be used for the system disk.

system_disk_name str

system_disk_performance_level str

The performance level of the ESSD used as the system disk, Valid values: PL0, PL1, PL2, PL3, Default to PL1;For more information about ESSD, See Encryption Context.

system_disk_size int

Size of the system disk, measured in GiB. Value range: [20, 500]. The specified value must be equal to or greater than max{20, Imagesize}. Default value: max{40, ImageSize}.

system_disk_storage_cluster_id str

tags Mapping[str, str]

A mapping of tags to assign to the resource.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

user_data str

volume_tags Mapping[str, Any]

A mapping of tags to assign to the devices created by the instance at launch time.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

vswitch_id str

The virtual switch ID to launch in VPC. This parameter must be set unless you can create classic network instances. When it is changed, the instance will reboot to make the change take effect.

allocatePublicIp Boolean

It has been deprecated from version "1.7.0". Setting "internet_max_bandwidth_out" larger than 0 can allocate a public ip address for an instance.

Deprecated: Field 'allocate_public_ip' has been deprecated from provider version 1.6.1. Setting 'internet_max_bandwidth_out' larger than 0 will allocate public ip for instance.

autoReleaseTime String

autoRenewPeriod Number

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid value:

[1, 2, 3, 6, 12] when period_unit in "Month"
[1, 2, 3] when period_unit in "Week"

availabilityZone String

The Zone to start the instance in. It is ignored and will be computed when set vswitch_id.

creditSpecification String

Performance mode of the t5 burstable instance. Valid values: 'Standard', 'Unlimited'.

dataDisks List<Property Map>

The list of data disks created with instance. See data_disks below.

dedicatedHostId String

deletionProtection Boolean

Whether enable the deletion protection or not. It does not work when the instance is spot. Default value: false.

true: Enable deletion protection.
false: Disable deletion protection.

deploymentSetId String

The ID of the deployment set to which to deploy the instance. NOTE: From version 1.176.0, instance's deploymentSetId can be removed when 'deployment_set_id' = "".

description String

Description of the instance, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.

dryRun Boolean

Specifies whether to send a dry-run request. Default to false.

true: Only a dry-run request is sent and no instance is created. The system checks whether the required parameters are set, and validates the request format, service permissions, and available ECS instances. If the validation fails, the corresponding error code is returned. If the validation succeeds, the DryRunOperation error code is returned.
false: A request is sent. If the validation succeeds, the instance is created.

forceDelete Boolean

hostName String

hpcClusterId String

The ID of the Elastic High Performance Computing (E-HPC) cluster to which to assign the instance.

httpEndpoint String

Specifies whether to enable the access channel for instance metadata. Valid values: enabled, disabled. Default value: enabled.

httpPutResponseHopLimit Number

The HTTP PUT response hop limit for accessing instance metadata. Valid values: 1 to 64. Default value: 1.

httpTokens String

Specifies whether to forcefully use the security-enhanced mode (IMDSv2) to access instance metadata. Default value: optional. Valid values:

optional: does not forcefully use the security-enhanced mode (IMDSv2).
required: forcefully uses the security-enhanced mode (IMDSv2). After you set this parameter to required, you cannot access instance metadata in normal mode.

imageId String

includeDataDisks Boolean

Whether to change instance disks charge type when changing instance charge type.

instanceChargeType String

instanceName String

instanceType String

internetChargeType String

internetMaxBandwidthIn Number

Maximum incoming bandwidth from the public network, measured in Mbps (Mega bit per second). Value range: [1, 200]. If this value is not specified, then automatically sets it to 200 Mbps.

Deprecated: The attribute is invalid and no any affect for the instance. So it has been deprecated since version v1.121.2.

internetMaxBandwidthOut Number

Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value range: [0, 100]. Default to 0 Mbps.

ipv6AddressCount Number

The number of IPv6 addresses to randomly generate for the primary ENI. Valid values: 1 to 10. NOTE: You cannot specify both the ipv6_addresses and ipv6_address_count parameters.

ipv6Addresses List<String>

A list of IPv6 address to be assigned to the primary ENI. Support up to 10.

isOutdated Boolean

Whether to use outdated instance type. Default to false.

keyName String

The name of key pair that can login ECS instance successfully without password. If it is specified, the password would be invalid.

kmsEncryptedPassword String

An KMS encrypts password used to an instance. If the password is filled in, this field will be ignored. When it is changed, the instance will reboot to make the change take effect.

kmsEncryptionContext Map<Any>

launchTemplateId String

launchTemplateName String

The name of the launch template.

launchTemplateVersion String

The version of the launch template. If you set launch_template_id or launch_template_name parameter but do not set the version number of the launch template, the default template version is used.

NOTE: System 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.

NOTE: From version 1.5.0, instance's charge type can be changed to "PrePaid" by specifying period and period_unit, but it is irreversible.

NOTE: From version 1.5.0, instance's private IP address can be specified when creating VPC network instance.

NOTE: From version 1.5.0, instance's vswitch and private IP can be changed in the same availability zone. When they are changed, the instance will reboot to make the change take effect.

NOTE: From version 1.7.0, setting "internet_max_bandwidth_out" larger than 0 can allocate a public IP for an instance. Setting "internet_max_bandwidth_out" to 0 can release allocated public IP for VPC instance(For Classic instnace, its public IP cannot be release once it allocated, even thougth its bandwidth out is 0). However, at present, 'PrePaid' instance cannot narrow its max bandwidth out when its 'internet_charge_type' is "PayByBandwidth".

NOTE: From version 1.7.0, instance's type can be changed. When it is changed, the instance will reboot to make the change take effect.

maintenanceAction String

The maintenance action. Valid values: Stop, AutoRecover and AutoRedeploy.

maintenanceNotify Boolean

Specifies whether to send an event notification before instance shutdown. Valid values: true, false. Default value: false.

maintenanceTime Property Map

The time of maintenance. See maintenance_time below.

networkInterfaces Property Map

The list of network interfaces created with instance. See network_interfaces below.

operatorType String

password String

period Number

The duration that you will buy the resource, in month. It is valid and required when instance_charge_type is PrePaid. Valid values:

[1-9, 12, 24, 36, 48, 60] when period_unit in "Month"
[1-3] when period_unit in "Week"

NOTE: The attribute period is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running pulumi up will not effect the resource.

periodUnit String

The duration unit that you will buy the resource. It is valid when instance_charge_type is 'PrePaid'. Valid value: ["Week", "Month"]. Default to "Month".

privateIp String

Instance private IP address can be specified when you creating new instance. It is valid when vswitch_id is specified. When it is changed, the instance will reboot to make the change take effect.

renewalStatus String

Whether to renew an ECS instance automatically or not. It is valid when instance_charge_type is PrePaid. Default to "Normal". Valid values:

resourceGroupId String

The Id of resource group which the instance belongs.

roleName String

Instance RAM role name. The name is provided and maintained by RAM. You can use alicloud.ram.Role to create a new one.

secondaryPrivateIpAddressCount Number

secondaryPrivateIps List<String>

A list of Secondary private IP addresses which is selected from within the CIDR block of the VSwitch.

securityEnhancementStrategy String

The security enhancement strategy.

Active: Enable security enhancement strategy, it only works on system images.
Deactive: Disable security enhancement strategy, it works on all images.

securityGroups List<String>

A list of security group ids to associate with. If you do not use launch_template_id or launch_template_name to specify a launch template, you must specify security_groups.

spotDuration Number

spotPriceLimit Number

The hourly price threshold of a instance, and it takes effect only when parameter 'spot_strategy' is 'SpotWithPriceLimit'. Three decimals is allowed at most.

spotStrategy String

The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter instance_charge_type is 'PostPaid'. Value range:

NoSpot: A regular Pay-As-You-Go instance.
SpotWithPriceLimit: A price threshold for a spot instance
SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go instance

Default to NoSpot. Note: Currently, the spot instance only supports domestic site account.

status String

The instance status. Valid values: ["Running", "Stopped"]. You can control the instance start and stop through this parameter. Default to Running.

stoppedMode String

systemDiskAutoSnapshotPolicyId String

The ID of the automatic snapshot policy applied to the system disk.

systemDiskCategory String

systemDiskDescription String

The description of the system disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

systemDiskEncryptAlgorithm String

The algorithm to be used to encrypt the system disk. Valid values are aes-256, sm4-128. Default value is aes-256.

systemDiskEncrypted Boolean

Specifies whether to encrypt the system disk. Valid values: true,false. Default value: false.

systemDiskKmsKeyId String

The ID of the Key Management Service (KMS) key to be used for the system disk.

systemDiskName String

systemDiskPerformanceLevel String

The performance level of the ESSD used as the system disk, Valid values: PL0, PL1, PL2, PL3, Default to PL1;For more information about ESSD, See Encryption Context.

systemDiskSize Number

Size of the system disk, measured in GiB. Value range: [20, 500]. The specified value must be equal to or greater than max{20, Imagesize}. Default value: max{40, ImageSize}.

systemDiskStorageClusterId String

tags Map<String>

A mapping of tags to assign to the resource.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

userData String

volumeTags Map<Any>

A mapping of tags to assign to the devices created by the instance at launch time.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

vswitchId String

The virtual switch ID to launch in VPC. This parameter must be set unless you can create classic network instances. When it is changed, the instance will reboot to make the change take effect.

Outputs

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

Cpu int: The number of vCPUs.
DeploymentSetGroupNo string: The group number of the instance in a deployment set when the deployment set is use.
Id string: The provider-assigned unique ID for this managed resource.
Memory int: The memory size of the instance. Unit: MiB.
NetworkInterfaceId string: The ID of the secondary ENI.
OsName string: The name of the operating system of the instance.
OsType string: The type of the operating system of the instance.
PrimaryIpAddress string: The primary private IP address of the ENI.
PublicIp string: The instance public ip.
SystemDiskId string: (Available since v1.210.0) The ID of system disk.

Cpu int: The number of vCPUs.
DeploymentSetGroupNo string: The group number of the instance in a deployment set when the deployment set is use.
Id string: The provider-assigned unique ID for this managed resource.
Memory int: The memory size of the instance. Unit: MiB.
NetworkInterfaceId string: The ID of the secondary ENI.
OsName string: The name of the operating system of the instance.
OsType string: The type of the operating system of the instance.
PrimaryIpAddress string: The primary private IP address of the ENI.
PublicIp string: The instance public ip.
SystemDiskId string: (Available since v1.210.0) The ID of system disk.

cpu Integer: The number of vCPUs.
deploymentSetGroupNo String: The group number of the instance in a deployment set when the deployment set is use.
id String: The provider-assigned unique ID for this managed resource.
memory Integer: The memory size of the instance. Unit: MiB.
networkInterfaceId String: The ID of the secondary ENI.
osName String: The name of the operating system of the instance.
osType String: The type of the operating system of the instance.
primaryIpAddress String: The primary private IP address of the ENI.
publicIp String: The instance public ip.
systemDiskId String: (Available since v1.210.0) The ID of system disk.

cpu number: The number of vCPUs.
deploymentSetGroupNo string: The group number of the instance in a deployment set when the deployment set is use.
id string: The provider-assigned unique ID for this managed resource.
memory number: The memory size of the instance. Unit: MiB.
networkInterfaceId string: The ID of the secondary ENI.
osName string: The name of the operating system of the instance.
osType string: The type of the operating system of the instance.
primaryIpAddress string: The primary private IP address of the ENI.
publicIp string: The instance public ip.
systemDiskId string: (Available since v1.210.0) The ID of system disk.

cpu int: The number of vCPUs.
deployment_set_group_no str: The group number of the instance in a deployment set when the deployment set is use.
id str: The provider-assigned unique ID for this managed resource.
memory int: The memory size of the instance. Unit: MiB.
network_interface_id str: The ID of the secondary ENI.
os_name str: The name of the operating system of the instance.
os_type str: The type of the operating system of the instance.
primary_ip_address str: The primary private IP address of the ENI.
public_ip str: The instance public ip.
system_disk_id str: (Available since v1.210.0) The ID of system disk.

cpu Number: The number of vCPUs.
deploymentSetGroupNo String: The group number of the instance in a deployment set when the deployment set is use.
id String: The provider-assigned unique ID for this managed resource.
memory Number: The memory size of the instance. Unit: MiB.
networkInterfaceId String: The ID of the secondary ENI.
osName String: The name of the operating system of the instance.
osType String: The type of the operating system of the instance.
primaryIpAddress String: The primary private IP address of the ENI.
publicIp String: The instance public ip.
systemDiskId String: (Available since v1.210.0) The ID of system disk.

Look up Existing Instance Resource

Get an existing Instance 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?: InstanceState, opts?: CustomResourceOptions): Instance

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        allocate_public_ip: Optional[bool] = None,
        auto_release_time: Optional[str] = None,
        auto_renew_period: Optional[int] = None,
        availability_zone: Optional[str] = None,
        cpu: Optional[int] = None,
        credit_specification: Optional[str] = None,
        data_disks: Optional[Sequence[InstanceDataDiskArgs]] = None,
        dedicated_host_id: Optional[str] = None,
        deletion_protection: Optional[bool] = None,
        deployment_set_group_no: Optional[str] = None,
        deployment_set_id: Optional[str] = None,
        description: Optional[str] = None,
        dry_run: Optional[bool] = None,
        force_delete: Optional[bool] = None,
        host_name: Optional[str] = None,
        hpc_cluster_id: Optional[str] = None,
        http_endpoint: Optional[str] = None,
        http_put_response_hop_limit: Optional[int] = None,
        http_tokens: Optional[str] = None,
        image_id: Optional[str] = None,
        include_data_disks: Optional[bool] = None,
        instance_charge_type: Optional[str] = None,
        instance_name: Optional[str] = None,
        instance_type: Optional[str] = None,
        internet_charge_type: Optional[str] = None,
        internet_max_bandwidth_in: Optional[int] = None,
        internet_max_bandwidth_out: Optional[int] = None,
        ipv6_address_count: Optional[int] = None,
        ipv6_addresses: Optional[Sequence[str]] = None,
        is_outdated: Optional[bool] = None,
        key_name: Optional[str] = None,
        kms_encrypted_password: Optional[str] = None,
        kms_encryption_context: Optional[Mapping[str, Any]] = None,
        launch_template_id: Optional[str] = None,
        launch_template_name: Optional[str] = None,
        launch_template_version: Optional[str] = None,
        maintenance_action: Optional[str] = None,
        maintenance_notify: Optional[bool] = None,
        maintenance_time: Optional[InstanceMaintenanceTimeArgs] = None,
        memory: Optional[int] = None,
        network_interface_id: Optional[str] = None,
        network_interfaces: Optional[InstanceNetworkInterfacesArgs] = None,
        operator_type: Optional[str] = None,
        os_name: Optional[str] = None,
        os_type: Optional[str] = None,
        password: Optional[str] = None,
        period: Optional[int] = None,
        period_unit: Optional[str] = None,
        primary_ip_address: Optional[str] = None,
        private_ip: Optional[str] = None,
        public_ip: Optional[str] = None,
        renewal_status: Optional[str] = None,
        resource_group_id: Optional[str] = None,
        role_name: Optional[str] = None,
        secondary_private_ip_address_count: Optional[int] = None,
        secondary_private_ips: Optional[Sequence[str]] = None,
        security_enhancement_strategy: Optional[str] = None,
        security_groups: Optional[Sequence[str]] = None,
        spot_duration: Optional[int] = None,
        spot_price_limit: Optional[float] = None,
        spot_strategy: Optional[str] = None,
        status: Optional[str] = None,
        stopped_mode: Optional[str] = None,
        system_disk_auto_snapshot_policy_id: Optional[str] = None,
        system_disk_category: Optional[str] = None,
        system_disk_description: Optional[str] = None,
        system_disk_encrypt_algorithm: Optional[str] = None,
        system_disk_encrypted: Optional[bool] = None,
        system_disk_id: Optional[str] = None,
        system_disk_kms_key_id: Optional[str] = None,
        system_disk_name: Optional[str] = None,
        system_disk_performance_level: Optional[str] = None,
        system_disk_size: Optional[int] = None,
        system_disk_storage_cluster_id: Optional[str] = None,
        tags: Optional[Mapping[str, str]] = None,
        user_data: Optional[str] = None,
        volume_tags: Optional[Mapping[str, Any]] = None,
        vswitch_id: Optional[str] = None) -> Instance

func GetInstance(ctx *Context, name string, id IDInput, state *InstanceState, opts ...ResourceOption) (*Instance, error)

public static Instance Get(string name, Input<string> id, InstanceState? state, CustomResourceOptions? opts = null)

public static Instance get(String name, Output<String> id, InstanceState 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:

AllocatePublicIp bool

It has been deprecated from version "1.7.0". Setting "internet_max_bandwidth_out" larger than 0 can allocate a public ip address for an instance.

Deprecated: Field 'allocate_public_ip' has been deprecated from provider version 1.6.1. Setting 'internet_max_bandwidth_out' larger than 0 will allocate public ip for instance.

AutoReleaseTime string

AutoRenewPeriod int

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid value:

[1, 2, 3, 6, 12] when period_unit in "Month"
[1, 2, 3] when period_unit in "Week"

AvailabilityZone string

The Zone to start the instance in. It is ignored and will be computed when set vswitch_id.

Cpu int

The number of vCPUs.

CreditSpecification string

Performance mode of the t5 burstable instance. Valid values: 'Standard', 'Unlimited'.

DataDisks List<Pulumi.AliCloud.Ecs.Inputs.InstanceDataDisk>

The list of data disks created with instance. See data_disks below.

DedicatedHostId string

DeletionProtection bool

Whether enable the deletion protection or not. It does not work when the instance is spot. Default value: false.

true: Enable deletion protection.
false: Disable deletion protection.

DeploymentSetGroupNo string

The group number of the instance in a deployment set when the deployment set is use.

DeploymentSetId string

The ID of the deployment set to which to deploy the instance. NOTE: From version 1.176.0, instance's deploymentSetId can be removed when 'deployment_set_id' = "".

Description string

Description of the instance, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.

DryRun bool

Specifies whether to send a dry-run request. Default to false.

true: Only a dry-run request is sent and no instance is created. The system checks whether the required parameters are set, and validates the request format, service permissions, and available ECS instances. If the validation fails, the corresponding error code is returned. If the validation succeeds, the DryRunOperation error code is returned.
false: A request is sent. If the validation succeeds, the instance is created.

ForceDelete bool

HostName string

HpcClusterId string

The ID of the Elastic High Performance Computing (E-HPC) cluster to which to assign the instance.

HttpEndpoint string

Specifies whether to enable the access channel for instance metadata. Valid values: enabled, disabled. Default value: enabled.

HttpPutResponseHopLimit int

The HTTP PUT response hop limit for accessing instance metadata. Valid values: 1 to 64. Default value: 1.

HttpTokens string

Specifies whether to forcefully use the security-enhanced mode (IMDSv2) to access instance metadata. Default value: optional. Valid values:

optional: does not forcefully use the security-enhanced mode (IMDSv2).
required: forcefully uses the security-enhanced mode (IMDSv2). After you set this parameter to required, you cannot access instance metadata in normal mode.

ImageId string

IncludeDataDisks bool

Whether to change instance disks charge type when changing instance charge type.

InstanceChargeType string

InstanceName string

InstanceType string

InternetChargeType string

InternetMaxBandwidthIn int

Maximum incoming bandwidth from the public network, measured in Mbps (Mega bit per second). Value range: [1, 200]. If this value is not specified, then automatically sets it to 200 Mbps.

Deprecated: The attribute is invalid and no any affect for the instance. So it has been deprecated since version v1.121.2.

InternetMaxBandwidthOut int

Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value range: [0, 100]. Default to 0 Mbps.

Ipv6AddressCount int

The number of IPv6 addresses to randomly generate for the primary ENI. Valid values: 1 to 10. NOTE: You cannot specify both the ipv6_addresses and ipv6_address_count parameters.

Ipv6Addresses List<string>

A list of IPv6 address to be assigned to the primary ENI. Support up to 10.

IsOutdated bool

Whether to use outdated instance type. Default to false.

KeyName string

The name of key pair that can login ECS instance successfully without password. If it is specified, the password would be invalid.

KmsEncryptedPassword string

An KMS encrypts password used to an instance. If the password is filled in, this field will be ignored. When it is changed, the instance will reboot to make the change take effect.

KmsEncryptionContext Dictionary<string, object>

LaunchTemplateId string

LaunchTemplateName string

The name of the launch template.

LaunchTemplateVersion string

The version of the launch template. If you set launch_template_id or launch_template_name parameter but do not set the version number of the launch template, the default template version is used.

NOTE: System 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.

NOTE: From version 1.5.0, instance's charge type can be changed to "PrePaid" by specifying period and period_unit, but it is irreversible.

NOTE: From version 1.5.0, instance's private IP address can be specified when creating VPC network instance.

NOTE: From version 1.5.0, instance's vswitch and private IP can be changed in the same availability zone. When they are changed, the instance will reboot to make the change take effect.

NOTE: From version 1.7.0, setting "internet_max_bandwidth_out" larger than 0 can allocate a public IP for an instance. Setting "internet_max_bandwidth_out" to 0 can release allocated public IP for VPC instance(For Classic instnace, its public IP cannot be release once it allocated, even thougth its bandwidth out is 0). However, at present, 'PrePaid' instance cannot narrow its max bandwidth out when its 'internet_charge_type' is "PayByBandwidth".

NOTE: From version 1.7.0, instance's type can be changed. When it is changed, the instance will reboot to make the change take effect.

MaintenanceAction string

The maintenance action. Valid values: Stop, AutoRecover and AutoRedeploy.

MaintenanceNotify bool

Specifies whether to send an event notification before instance shutdown. Valid values: true, false. Default value: false.

MaintenanceTime Pulumi.AliCloud.Ecs.Inputs.InstanceMaintenanceTime

The time of maintenance. See maintenance_time below.

Memory int

The memory size of the instance. Unit: MiB.

NetworkInterfaceId string

The ID of the secondary ENI.

NetworkInterfaces Pulumi.AliCloud.Ecs.Inputs.InstanceNetworkInterfaces

The list of network interfaces created with instance. See network_interfaces below.

OperatorType string

OsName string

The name of the operating system of the instance.

OsType string

The type of the operating system of the instance.

Password string

Period int

The duration that you will buy the resource, in month. It is valid and required when instance_charge_type is PrePaid. Valid values:

[1-9, 12, 24, 36, 48, 60] when period_unit in "Month"
[1-3] when period_unit in "Week"

NOTE: The attribute period is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running pulumi up will not effect the resource.

PeriodUnit string

The duration unit that you will buy the resource. It is valid when instance_charge_type is 'PrePaid'. Valid value: ["Week", "Month"]. Default to "Month".

PrimaryIpAddress string

The primary private IP address of the ENI.

PrivateIp string

Instance private IP address can be specified when you creating new instance. It is valid when vswitch_id is specified. When it is changed, the instance will reboot to make the change take effect.

PublicIp string

The instance public ip.

RenewalStatus string

Whether to renew an ECS instance automatically or not. It is valid when instance_charge_type is PrePaid. Default to "Normal". Valid values:

ResourceGroupId string

The Id of resource group which the instance belongs.

RoleName string

Instance RAM role name. The name is provided and maintained by RAM. You can use alicloud.ram.Role to create a new one.

SecondaryPrivateIpAddressCount int

SecondaryPrivateIps List<string>

A list of Secondary private IP addresses which is selected from within the CIDR block of the VSwitch.

SecurityEnhancementStrategy string

The security enhancement strategy.

Active: Enable security enhancement strategy, it only works on system images.
Deactive: Disable security enhancement strategy, it works on all images.

SecurityGroups List<string>

A list of security group ids to associate with. If you do not use launch_template_id or launch_template_name to specify a launch template, you must specify security_groups.

SpotDuration int

SpotPriceLimit double

The hourly price threshold of a instance, and it takes effect only when parameter 'spot_strategy' is 'SpotWithPriceLimit'. Three decimals is allowed at most.

SpotStrategy string

The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter instance_charge_type is 'PostPaid'. Value range:

NoSpot: A regular Pay-As-You-Go instance.
SpotWithPriceLimit: A price threshold for a spot instance
SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go instance

Default to NoSpot. Note: Currently, the spot instance only supports domestic site account.

Status string

The instance status. Valid values: ["Running", "Stopped"]. You can control the instance start and stop through this parameter. Default to Running.

StoppedMode string

SystemDiskAutoSnapshotPolicyId string

The ID of the automatic snapshot policy applied to the system disk.

SystemDiskCategory string

SystemDiskDescription string

The description of the system disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

SystemDiskEncryptAlgorithm string

The algorithm to be used to encrypt the system disk. Valid values are aes-256, sm4-128. Default value is aes-256.

SystemDiskEncrypted bool

Specifies whether to encrypt the system disk. Valid values: true,false. Default value: false.

SystemDiskId string

(Available since v1.210.0) The ID of system disk.

SystemDiskKmsKeyId string

The ID of the Key Management Service (KMS) key to be used for the system disk.

SystemDiskName string

SystemDiskPerformanceLevel string

The performance level of the ESSD used as the system disk, Valid values: PL0, PL1, PL2, PL3, Default to PL1;For more information about ESSD, See Encryption Context.

SystemDiskSize int

Size of the system disk, measured in GiB. Value range: [20, 500]. The specified value must be equal to or greater than max{20, Imagesize}. Default value: max{40, ImageSize}.

SystemDiskStorageClusterId string

Tags Dictionary<string, string>

A mapping of tags to assign to the resource.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

UserData string

VolumeTags Dictionary<string, object>

A mapping of tags to assign to the devices created by the instance at launch time.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

VswitchId string

The virtual switch ID to launch in VPC. This parameter must be set unless you can create classic network instances. When it is changed, the instance will reboot to make the change take effect.

AllocatePublicIp bool

It has been deprecated from version "1.7.0". Setting "internet_max_bandwidth_out" larger than 0 can allocate a public ip address for an instance.

Deprecated: Field 'allocate_public_ip' has been deprecated from provider version 1.6.1. Setting 'internet_max_bandwidth_out' larger than 0 will allocate public ip for instance.

AutoReleaseTime string

AutoRenewPeriod int

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid value:

[1, 2, 3, 6, 12] when period_unit in "Month"
[1, 2, 3] when period_unit in "Week"

AvailabilityZone string

The Zone to start the instance in. It is ignored and will be computed when set vswitch_id.

Cpu int

The number of vCPUs.

CreditSpecification string

Performance mode of the t5 burstable instance. Valid values: 'Standard', 'Unlimited'.

DataDisks []InstanceDataDiskArgs

The list of data disks created with instance. See data_disks below.

DedicatedHostId string

DeletionProtection bool

Whether enable the deletion protection or not. It does not work when the instance is spot. Default value: false.

true: Enable deletion protection.
false: Disable deletion protection.

DeploymentSetGroupNo string

The group number of the instance in a deployment set when the deployment set is use.

DeploymentSetId string

The ID of the deployment set to which to deploy the instance. NOTE: From version 1.176.0, instance's deploymentSetId can be removed when 'deployment_set_id' = "".

Description string

Description of the instance, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.

DryRun bool

Specifies whether to send a dry-run request. Default to false.

true: Only a dry-run request is sent and no instance is created. The system checks whether the required parameters are set, and validates the request format, service permissions, and available ECS instances. If the validation fails, the corresponding error code is returned. If the validation succeeds, the DryRunOperation error code is returned.
false: A request is sent. If the validation succeeds, the instance is created.

ForceDelete bool

HostName string

HpcClusterId string

The ID of the Elastic High Performance Computing (E-HPC) cluster to which to assign the instance.

HttpEndpoint string

Specifies whether to enable the access channel for instance metadata. Valid values: enabled, disabled. Default value: enabled.

HttpPutResponseHopLimit int

The HTTP PUT response hop limit for accessing instance metadata. Valid values: 1 to 64. Default value: 1.

HttpTokens string

Specifies whether to forcefully use the security-enhanced mode (IMDSv2) to access instance metadata. Default value: optional. Valid values:

optional: does not forcefully use the security-enhanced mode (IMDSv2).
required: forcefully uses the security-enhanced mode (IMDSv2). After you set this parameter to required, you cannot access instance metadata in normal mode.

ImageId string

IncludeDataDisks bool

Whether to change instance disks charge type when changing instance charge type.

InstanceChargeType string

InstanceName string

InstanceType string

InternetChargeType string

InternetMaxBandwidthIn int

Maximum incoming bandwidth from the public network, measured in Mbps (Mega bit per second). Value range: [1, 200]. If this value is not specified, then automatically sets it to 200 Mbps.

Deprecated: The attribute is invalid and no any affect for the instance. So it has been deprecated since version v1.121.2.

InternetMaxBandwidthOut int

Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value range: [0, 100]. Default to 0 Mbps.

Ipv6AddressCount int

The number of IPv6 addresses to randomly generate for the primary ENI. Valid values: 1 to 10. NOTE: You cannot specify both the ipv6_addresses and ipv6_address_count parameters.

Ipv6Addresses []string

A list of IPv6 address to be assigned to the primary ENI. Support up to 10.

IsOutdated bool

Whether to use outdated instance type. Default to false.

KeyName string

The name of key pair that can login ECS instance successfully without password. If it is specified, the password would be invalid.

KmsEncryptedPassword string

An KMS encrypts password used to an instance. If the password is filled in, this field will be ignored. When it is changed, the instance will reboot to make the change take effect.

KmsEncryptionContext map[string]interface{}

LaunchTemplateId string

LaunchTemplateName string

The name of the launch template.

LaunchTemplateVersion string

The version of the launch template. If you set launch_template_id or launch_template_name parameter but do not set the version number of the launch template, the default template version is used.

NOTE: System 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.

NOTE: From version 1.5.0, instance's charge type can be changed to "PrePaid" by specifying period and period_unit, but it is irreversible.

NOTE: From version 1.5.0, instance's private IP address can be specified when creating VPC network instance.

NOTE: From version 1.5.0, instance's vswitch and private IP can be changed in the same availability zone. When they are changed, the instance will reboot to make the change take effect.

NOTE: From version 1.7.0, setting "internet_max_bandwidth_out" larger than 0 can allocate a public IP for an instance. Setting "internet_max_bandwidth_out" to 0 can release allocated public IP for VPC instance(For Classic instnace, its public IP cannot be release once it allocated, even thougth its bandwidth out is 0). However, at present, 'PrePaid' instance cannot narrow its max bandwidth out when its 'internet_charge_type' is "PayByBandwidth".

NOTE: From version 1.7.0, instance's type can be changed. When it is changed, the instance will reboot to make the change take effect.

MaintenanceAction string

The maintenance action. Valid values: Stop, AutoRecover and AutoRedeploy.

MaintenanceNotify bool

Specifies whether to send an event notification before instance shutdown. Valid values: true, false. Default value: false.

MaintenanceTime InstanceMaintenanceTimeArgs

The time of maintenance. See maintenance_time below.

Memory int

The memory size of the instance. Unit: MiB.

NetworkInterfaceId string

The ID of the secondary ENI.

NetworkInterfaces InstanceNetworkInterfacesArgs

The list of network interfaces created with instance. See network_interfaces below.

OperatorType string

OsName string

The name of the operating system of the instance.

OsType string

The type of the operating system of the instance.

Password string

Period int

The duration that you will buy the resource, in month. It is valid and required when instance_charge_type is PrePaid. Valid values:

[1-9, 12, 24, 36, 48, 60] when period_unit in "Month"
[1-3] when period_unit in "Week"

NOTE: The attribute period is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running pulumi up will not effect the resource.

PeriodUnit string

The duration unit that you will buy the resource. It is valid when instance_charge_type is 'PrePaid'. Valid value: ["Week", "Month"]. Default to "Month".

PrimaryIpAddress string

The primary private IP address of the ENI.

PrivateIp string

Instance private IP address can be specified when you creating new instance. It is valid when vswitch_id is specified. When it is changed, the instance will reboot to make the change take effect.

PublicIp string

The instance public ip.

RenewalStatus string

Whether to renew an ECS instance automatically or not. It is valid when instance_charge_type is PrePaid. Default to "Normal". Valid values:

ResourceGroupId string

The Id of resource group which the instance belongs.

RoleName string

Instance RAM role name. The name is provided and maintained by RAM. You can use alicloud.ram.Role to create a new one.

SecondaryPrivateIpAddressCount int

SecondaryPrivateIps []string

A list of Secondary private IP addresses which is selected from within the CIDR block of the VSwitch.

SecurityEnhancementStrategy string

The security enhancement strategy.

Active: Enable security enhancement strategy, it only works on system images.
Deactive: Disable security enhancement strategy, it works on all images.

SecurityGroups []string

A list of security group ids to associate with. If you do not use launch_template_id or launch_template_name to specify a launch template, you must specify security_groups.

SpotDuration int

SpotPriceLimit float64

The hourly price threshold of a instance, and it takes effect only when parameter 'spot_strategy' is 'SpotWithPriceLimit'. Three decimals is allowed at most.

SpotStrategy string

The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter instance_charge_type is 'PostPaid'. Value range:

NoSpot: A regular Pay-As-You-Go instance.
SpotWithPriceLimit: A price threshold for a spot instance
SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go instance

Default to NoSpot. Note: Currently, the spot instance only supports domestic site account.

Status string

The instance status. Valid values: ["Running", "Stopped"]. You can control the instance start and stop through this parameter. Default to Running.

StoppedMode string

SystemDiskAutoSnapshotPolicyId string

The ID of the automatic snapshot policy applied to the system disk.

SystemDiskCategory string

SystemDiskDescription string

The description of the system disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

SystemDiskEncryptAlgorithm string

The algorithm to be used to encrypt the system disk. Valid values are aes-256, sm4-128. Default value is aes-256.

SystemDiskEncrypted bool

Specifies whether to encrypt the system disk. Valid values: true,false. Default value: false.

SystemDiskId string

(Available since v1.210.0) The ID of system disk.

SystemDiskKmsKeyId string

The ID of the Key Management Service (KMS) key to be used for the system disk.

SystemDiskName string

SystemDiskPerformanceLevel string

The performance level of the ESSD used as the system disk, Valid values: PL0, PL1, PL2, PL3, Default to PL1;For more information about ESSD, See Encryption Context.

SystemDiskSize int

Size of the system disk, measured in GiB. Value range: [20, 500]. The specified value must be equal to or greater than max{20, Imagesize}. Default value: max{40, ImageSize}.

SystemDiskStorageClusterId string

Tags map[string]string

A mapping of tags to assign to the resource.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

UserData string

VolumeTags map[string]interface{}

A mapping of tags to assign to the devices created by the instance at launch time.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

VswitchId string

The virtual switch ID to launch in VPC. This parameter must be set unless you can create classic network instances. When it is changed, the instance will reboot to make the change take effect.

allocatePublicIp Boolean

It has been deprecated from version "1.7.0". Setting "internet_max_bandwidth_out" larger than 0 can allocate a public ip address for an instance.

Deprecated: Field 'allocate_public_ip' has been deprecated from provider version 1.6.1. Setting 'internet_max_bandwidth_out' larger than 0 will allocate public ip for instance.

autoReleaseTime String

autoRenewPeriod Integer

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid value:

[1, 2, 3, 6, 12] when period_unit in "Month"
[1, 2, 3] when period_unit in "Week"

availabilityZone String

The Zone to start the instance in. It is ignored and will be computed when set vswitch_id.

cpu Integer

The number of vCPUs.

creditSpecification String

Performance mode of the t5 burstable instance. Valid values: 'Standard', 'Unlimited'.

dataDisks List<InstanceDataDisk>

The list of data disks created with instance. See data_disks below.

dedicatedHostId String

deletionProtection Boolean

Whether enable the deletion protection or not. It does not work when the instance is spot. Default value: false.

true: Enable deletion protection.
false: Disable deletion protection.

deploymentSetGroupNo String

The group number of the instance in a deployment set when the deployment set is use.

deploymentSetId String

The ID of the deployment set to which to deploy the instance. NOTE: From version 1.176.0, instance's deploymentSetId can be removed when 'deployment_set_id' = "".

description String

Description of the instance, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.

dryRun Boolean

Specifies whether to send a dry-run request. Default to false.

true: Only a dry-run request is sent and no instance is created. The system checks whether the required parameters are set, and validates the request format, service permissions, and available ECS instances. If the validation fails, the corresponding error code is returned. If the validation succeeds, the DryRunOperation error code is returned.
false: A request is sent. If the validation succeeds, the instance is created.

forceDelete Boolean

hostName String

hpcClusterId String

The ID of the Elastic High Performance Computing (E-HPC) cluster to which to assign the instance.

httpEndpoint String

Specifies whether to enable the access channel for instance metadata. Valid values: enabled, disabled. Default value: enabled.

httpPutResponseHopLimit Integer

The HTTP PUT response hop limit for accessing instance metadata. Valid values: 1 to 64. Default value: 1.

httpTokens String

Specifies whether to forcefully use the security-enhanced mode (IMDSv2) to access instance metadata. Default value: optional. Valid values:

optional: does not forcefully use the security-enhanced mode (IMDSv2).
required: forcefully uses the security-enhanced mode (IMDSv2). After you set this parameter to required, you cannot access instance metadata in normal mode.

imageId String

includeDataDisks Boolean

Whether to change instance disks charge type when changing instance charge type.

instanceChargeType String

instanceName String

instanceType String

internetChargeType String

internetMaxBandwidthIn Integer

Maximum incoming bandwidth from the public network, measured in Mbps (Mega bit per second). Value range: [1, 200]. If this value is not specified, then automatically sets it to 200 Mbps.

Deprecated: The attribute is invalid and no any affect for the instance. So it has been deprecated since version v1.121.2.

internetMaxBandwidthOut Integer

Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value range: [0, 100]. Default to 0 Mbps.

ipv6AddressCount Integer

The number of IPv6 addresses to randomly generate for the primary ENI. Valid values: 1 to 10. NOTE: You cannot specify both the ipv6_addresses and ipv6_address_count parameters.

ipv6Addresses List<String>

A list of IPv6 address to be assigned to the primary ENI. Support up to 10.

isOutdated Boolean

Whether to use outdated instance type. Default to false.

keyName String

The name of key pair that can login ECS instance successfully without password. If it is specified, the password would be invalid.

kmsEncryptedPassword String

An KMS encrypts password used to an instance. If the password is filled in, this field will be ignored. When it is changed, the instance will reboot to make the change take effect.

kmsEncryptionContext Map<String,Object>

launchTemplateId String

launchTemplateName String

The name of the launch template.

launchTemplateVersion String

The version of the launch template. If you set launch_template_id or launch_template_name parameter but do not set the version number of the launch template, the default template version is used.

NOTE: System 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.

NOTE: From version 1.5.0, instance's charge type can be changed to "PrePaid" by specifying period and period_unit, but it is irreversible.

NOTE: From version 1.5.0, instance's private IP address can be specified when creating VPC network instance.

NOTE: From version 1.5.0, instance's vswitch and private IP can be changed in the same availability zone. When they are changed, the instance will reboot to make the change take effect.

NOTE: From version 1.7.0, setting "internet_max_bandwidth_out" larger than 0 can allocate a public IP for an instance. Setting "internet_max_bandwidth_out" to 0 can release allocated public IP for VPC instance(For Classic instnace, its public IP cannot be release once it allocated, even thougth its bandwidth out is 0). However, at present, 'PrePaid' instance cannot narrow its max bandwidth out when its 'internet_charge_type' is "PayByBandwidth".

NOTE: From version 1.7.0, instance's type can be changed. When it is changed, the instance will reboot to make the change take effect.

maintenanceAction String

The maintenance action. Valid values: Stop, AutoRecover and AutoRedeploy.

maintenanceNotify Boolean

Specifies whether to send an event notification before instance shutdown. Valid values: true, false. Default value: false.

maintenanceTime InstanceMaintenanceTime

The time of maintenance. See maintenance_time below.

memory Integer

The memory size of the instance. Unit: MiB.

networkInterfaceId String

The ID of the secondary ENI.

networkInterfaces InstanceNetworkInterfaces

The list of network interfaces created with instance. See network_interfaces below.

operatorType String

osName String

The name of the operating system of the instance.

osType String

The type of the operating system of the instance.

password String

period Integer

The duration that you will buy the resource, in month. It is valid and required when instance_charge_type is PrePaid. Valid values:

[1-9, 12, 24, 36, 48, 60] when period_unit in "Month"
[1-3] when period_unit in "Week"

NOTE: The attribute period is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running pulumi up will not effect the resource.

periodUnit String

The duration unit that you will buy the resource. It is valid when instance_charge_type is 'PrePaid'. Valid value: ["Week", "Month"]. Default to "Month".

primaryIpAddress String

The primary private IP address of the ENI.

privateIp String

Instance private IP address can be specified when you creating new instance. It is valid when vswitch_id is specified. When it is changed, the instance will reboot to make the change take effect.

publicIp String

The instance public ip.

renewalStatus String

Whether to renew an ECS instance automatically or not. It is valid when instance_charge_type is PrePaid. Default to "Normal". Valid values:

resourceGroupId String

The Id of resource group which the instance belongs.

roleName String

Instance RAM role name. The name is provided and maintained by RAM. You can use alicloud.ram.Role to create a new one.

secondaryPrivateIpAddressCount Integer

secondaryPrivateIps List<String>

A list of Secondary private IP addresses which is selected from within the CIDR block of the VSwitch.

securityEnhancementStrategy String

The security enhancement strategy.

Active: Enable security enhancement strategy, it only works on system images.
Deactive: Disable security enhancement strategy, it works on all images.

securityGroups List<String>

A list of security group ids to associate with. If you do not use launch_template_id or launch_template_name to specify a launch template, you must specify security_groups.

spotDuration Integer

spotPriceLimit Double

The hourly price threshold of a instance, and it takes effect only when parameter 'spot_strategy' is 'SpotWithPriceLimit'. Three decimals is allowed at most.

spotStrategy String

The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter instance_charge_type is 'PostPaid'. Value range:

NoSpot: A regular Pay-As-You-Go instance.
SpotWithPriceLimit: A price threshold for a spot instance
SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go instance

Default to NoSpot. Note: Currently, the spot instance only supports domestic site account.

status String

The instance status. Valid values: ["Running", "Stopped"]. You can control the instance start and stop through this parameter. Default to Running.

stoppedMode String

systemDiskAutoSnapshotPolicyId String

The ID of the automatic snapshot policy applied to the system disk.

systemDiskCategory String

systemDiskDescription String

The description of the system disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

systemDiskEncryptAlgorithm String

The algorithm to be used to encrypt the system disk. Valid values are aes-256, sm4-128. Default value is aes-256.

systemDiskEncrypted Boolean

Specifies whether to encrypt the system disk. Valid values: true,false. Default value: false.

systemDiskId String

(Available since v1.210.0) The ID of system disk.

systemDiskKmsKeyId String

The ID of the Key Management Service (KMS) key to be used for the system disk.

systemDiskName String

systemDiskPerformanceLevel String

The performance level of the ESSD used as the system disk, Valid values: PL0, PL1, PL2, PL3, Default to PL1;For more information about ESSD, See Encryption Context.

systemDiskSize Integer

Size of the system disk, measured in GiB. Value range: [20, 500]. The specified value must be equal to or greater than max{20, Imagesize}. Default value: max{40, ImageSize}.

systemDiskStorageClusterId String

tags Map<String,String>

A mapping of tags to assign to the resource.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

userData String

volumeTags Map<String,Object>

A mapping of tags to assign to the devices created by the instance at launch time.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

vswitchId String

The virtual switch ID to launch in VPC. This parameter must be set unless you can create classic network instances. When it is changed, the instance will reboot to make the change take effect.

allocatePublicIp boolean

It has been deprecated from version "1.7.0". Setting "internet_max_bandwidth_out" larger than 0 can allocate a public ip address for an instance.

Deprecated: Field 'allocate_public_ip' has been deprecated from provider version 1.6.1. Setting 'internet_max_bandwidth_out' larger than 0 will allocate public ip for instance.

autoReleaseTime string

autoRenewPeriod number

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid value:

[1, 2, 3, 6, 12] when period_unit in "Month"
[1, 2, 3] when period_unit in "Week"

availabilityZone string

The Zone to start the instance in. It is ignored and will be computed when set vswitch_id.

cpu number

The number of vCPUs.

creditSpecification string

Performance mode of the t5 burstable instance. Valid values: 'Standard', 'Unlimited'.

dataDisks InstanceDataDisk[]

The list of data disks created with instance. See data_disks below.

dedicatedHostId string

deletionProtection boolean

Whether enable the deletion protection or not. It does not work when the instance is spot. Default value: false.

true: Enable deletion protection.
false: Disable deletion protection.

deploymentSetGroupNo string

The group number of the instance in a deployment set when the deployment set is use.

deploymentSetId string

The ID of the deployment set to which to deploy the instance. NOTE: From version 1.176.0, instance's deploymentSetId can be removed when 'deployment_set_id' = "".

description string

Description of the instance, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.

dryRun boolean

Specifies whether to send a dry-run request. Default to false.

true: Only a dry-run request is sent and no instance is created. The system checks whether the required parameters are set, and validates the request format, service permissions, and available ECS instances. If the validation fails, the corresponding error code is returned. If the validation succeeds, the DryRunOperation error code is returned.
false: A request is sent. If the validation succeeds, the instance is created.

forceDelete boolean

hostName string

hpcClusterId string

The ID of the Elastic High Performance Computing (E-HPC) cluster to which to assign the instance.

httpEndpoint string

Specifies whether to enable the access channel for instance metadata. Valid values: enabled, disabled. Default value: enabled.

httpPutResponseHopLimit number

The HTTP PUT response hop limit for accessing instance metadata. Valid values: 1 to 64. Default value: 1.

httpTokens string

Specifies whether to forcefully use the security-enhanced mode (IMDSv2) to access instance metadata. Default value: optional. Valid values:

optional: does not forcefully use the security-enhanced mode (IMDSv2).
required: forcefully uses the security-enhanced mode (IMDSv2). After you set this parameter to required, you cannot access instance metadata in normal mode.

imageId string

includeDataDisks boolean

Whether to change instance disks charge type when changing instance charge type.

instanceChargeType string

instanceName string

instanceType string

internetChargeType string

internetMaxBandwidthIn number

Maximum incoming bandwidth from the public network, measured in Mbps (Mega bit per second). Value range: [1, 200]. If this value is not specified, then automatically sets it to 200 Mbps.

Deprecated: The attribute is invalid and no any affect for the instance. So it has been deprecated since version v1.121.2.

internetMaxBandwidthOut number

Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value range: [0, 100]. Default to 0 Mbps.

ipv6AddressCount number

The number of IPv6 addresses to randomly generate for the primary ENI. Valid values: 1 to 10. NOTE: You cannot specify both the ipv6_addresses and ipv6_address_count parameters.

ipv6Addresses string[]

A list of IPv6 address to be assigned to the primary ENI. Support up to 10.

isOutdated boolean

Whether to use outdated instance type. Default to false.

keyName string

The name of key pair that can login ECS instance successfully without password. If it is specified, the password would be invalid.

kmsEncryptedPassword string

An KMS encrypts password used to an instance. If the password is filled in, this field will be ignored. When it is changed, the instance will reboot to make the change take effect.

kmsEncryptionContext {[key: string]: any}

launchTemplateId string

launchTemplateName string

The name of the launch template.

launchTemplateVersion string

The version of the launch template. If you set launch_template_id or launch_template_name parameter but do not set the version number of the launch template, the default template version is used.

NOTE: System 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.

NOTE: From version 1.5.0, instance's charge type can be changed to "PrePaid" by specifying period and period_unit, but it is irreversible.

NOTE: From version 1.5.0, instance's private IP address can be specified when creating VPC network instance.

NOTE: From version 1.5.0, instance's vswitch and private IP can be changed in the same availability zone. When they are changed, the instance will reboot to make the change take effect.

NOTE: From version 1.7.0, setting "internet_max_bandwidth_out" larger than 0 can allocate a public IP for an instance. Setting "internet_max_bandwidth_out" to 0 can release allocated public IP for VPC instance(For Classic instnace, its public IP cannot be release once it allocated, even thougth its bandwidth out is 0). However, at present, 'PrePaid' instance cannot narrow its max bandwidth out when its 'internet_charge_type' is "PayByBandwidth".

NOTE: From version 1.7.0, instance's type can be changed. When it is changed, the instance will reboot to make the change take effect.

maintenanceAction string

The maintenance action. Valid values: Stop, AutoRecover and AutoRedeploy.

maintenanceNotify boolean

Specifies whether to send an event notification before instance shutdown. Valid values: true, false. Default value: false.

maintenanceTime InstanceMaintenanceTime

The time of maintenance. See maintenance_time below.

memory number

The memory size of the instance. Unit: MiB.

networkInterfaceId string

The ID of the secondary ENI.

networkInterfaces InstanceNetworkInterfaces

The list of network interfaces created with instance. See network_interfaces below.

operatorType string

osName string

The name of the operating system of the instance.

osType string

The type of the operating system of the instance.

password string

period number

The duration that you will buy the resource, in month. It is valid and required when instance_charge_type is PrePaid. Valid values:

[1-9, 12, 24, 36, 48, 60] when period_unit in "Month"
[1-3] when period_unit in "Week"

NOTE: The attribute period is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running pulumi up will not effect the resource.

periodUnit string

The duration unit that you will buy the resource. It is valid when instance_charge_type is 'PrePaid'. Valid value: ["Week", "Month"]. Default to "Month".

primaryIpAddress string

The primary private IP address of the ENI.

privateIp string

Instance private IP address can be specified when you creating new instance. It is valid when vswitch_id is specified. When it is changed, the instance will reboot to make the change take effect.

publicIp string

The instance public ip.

renewalStatus string

Whether to renew an ECS instance automatically or not. It is valid when instance_charge_type is PrePaid. Default to "Normal". Valid values:

resourceGroupId string

The Id of resource group which the instance belongs.

roleName string

Instance RAM role name. The name is provided and maintained by RAM. You can use alicloud.ram.Role to create a new one.

secondaryPrivateIpAddressCount number

secondaryPrivateIps string[]

A list of Secondary private IP addresses which is selected from within the CIDR block of the VSwitch.

securityEnhancementStrategy string

The security enhancement strategy.

Active: Enable security enhancement strategy, it only works on system images.
Deactive: Disable security enhancement strategy, it works on all images.

securityGroups string[]

A list of security group ids to associate with. If you do not use launch_template_id or launch_template_name to specify a launch template, you must specify security_groups.

spotDuration number

spotPriceLimit number

The hourly price threshold of a instance, and it takes effect only when parameter 'spot_strategy' is 'SpotWithPriceLimit'. Three decimals is allowed at most.

spotStrategy string

The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter instance_charge_type is 'PostPaid'. Value range:

NoSpot: A regular Pay-As-You-Go instance.
SpotWithPriceLimit: A price threshold for a spot instance
SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go instance

Default to NoSpot. Note: Currently, the spot instance only supports domestic site account.

status string

The instance status. Valid values: ["Running", "Stopped"]. You can control the instance start and stop through this parameter. Default to Running.

stoppedMode string

systemDiskAutoSnapshotPolicyId string

The ID of the automatic snapshot policy applied to the system disk.

systemDiskCategory string

systemDiskDescription string

The description of the system disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

systemDiskEncryptAlgorithm string

The algorithm to be used to encrypt the system disk. Valid values are aes-256, sm4-128. Default value is aes-256.

systemDiskEncrypted boolean

Specifies whether to encrypt the system disk. Valid values: true,false. Default value: false.

systemDiskId string

(Available since v1.210.0) The ID of system disk.

systemDiskKmsKeyId string

The ID of the Key Management Service (KMS) key to be used for the system disk.

systemDiskName string

systemDiskPerformanceLevel string

The performance level of the ESSD used as the system disk, Valid values: PL0, PL1, PL2, PL3, Default to PL1;For more information about ESSD, See Encryption Context.

systemDiskSize number

Size of the system disk, measured in GiB. Value range: [20, 500]. The specified value must be equal to or greater than max{20, Imagesize}. Default value: max{40, ImageSize}.

systemDiskStorageClusterId string

tags {[key: string]: string}

A mapping of tags to assign to the resource.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

userData string

volumeTags {[key: string]: any}

A mapping of tags to assign to the devices created by the instance at launch time.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

vswitchId string

The virtual switch ID to launch in VPC. This parameter must be set unless you can create classic network instances. When it is changed, the instance will reboot to make the change take effect.

allocate_public_ip bool

It has been deprecated from version "1.7.0". Setting "internet_max_bandwidth_out" larger than 0 can allocate a public ip address for an instance.

Deprecated: Field 'allocate_public_ip' has been deprecated from provider version 1.6.1. Setting 'internet_max_bandwidth_out' larger than 0 will allocate public ip for instance.

auto_release_time str

auto_renew_period int

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid value:

[1, 2, 3, 6, 12] when period_unit in "Month"
[1, 2, 3] when period_unit in "Week"

availability_zone str

The Zone to start the instance in. It is ignored and will be computed when set vswitch_id.

cpu int

The number of vCPUs.

credit_specification str

Performance mode of the t5 burstable instance. Valid values: 'Standard', 'Unlimited'.

data_disks Sequence[InstanceDataDiskArgs]

The list of data disks created with instance. See data_disks below.

dedicated_host_id str

deletion_protection bool

Whether enable the deletion protection or not. It does not work when the instance is spot. Default value: false.

true: Enable deletion protection.
false: Disable deletion protection.

deployment_set_group_no str

The group number of the instance in a deployment set when the deployment set is use.

deployment_set_id str

The ID of the deployment set to which to deploy the instance. NOTE: From version 1.176.0, instance's deploymentSetId can be removed when 'deployment_set_id' = "".

description str

Description of the instance, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.

dry_run bool

Specifies whether to send a dry-run request. Default to false.

true: Only a dry-run request is sent and no instance is created. The system checks whether the required parameters are set, and validates the request format, service permissions, and available ECS instances. If the validation fails, the corresponding error code is returned. If the validation succeeds, the DryRunOperation error code is returned.
false: A request is sent. If the validation succeeds, the instance is created.

force_delete bool

host_name str

hpc_cluster_id str

The ID of the Elastic High Performance Computing (E-HPC) cluster to which to assign the instance.

http_endpoint str

Specifies whether to enable the access channel for instance metadata. Valid values: enabled, disabled. Default value: enabled.

http_put_response_hop_limit int

The HTTP PUT response hop limit for accessing instance metadata. Valid values: 1 to 64. Default value: 1.

http_tokens str

Specifies whether to forcefully use the security-enhanced mode (IMDSv2) to access instance metadata. Default value: optional. Valid values:

optional: does not forcefully use the security-enhanced mode (IMDSv2).
required: forcefully uses the security-enhanced mode (IMDSv2). After you set this parameter to required, you cannot access instance metadata in normal mode.

image_id str

include_data_disks bool

Whether to change instance disks charge type when changing instance charge type.

instance_charge_type str

instance_name str

instance_type str

internet_charge_type str

internet_max_bandwidth_in int

Maximum incoming bandwidth from the public network, measured in Mbps (Mega bit per second). Value range: [1, 200]. If this value is not specified, then automatically sets it to 200 Mbps.

Deprecated: The attribute is invalid and no any affect for the instance. So it has been deprecated since version v1.121.2.

internet_max_bandwidth_out int

Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value range: [0, 100]. Default to 0 Mbps.

ipv6_address_count int

The number of IPv6 addresses to randomly generate for the primary ENI. Valid values: 1 to 10. NOTE: You cannot specify both the ipv6_addresses and ipv6_address_count parameters.

ipv6_addresses Sequence[str]

A list of IPv6 address to be assigned to the primary ENI. Support up to 10.

is_outdated bool

Whether to use outdated instance type. Default to false.

key_name str

The name of key pair that can login ECS instance successfully without password. If it is specified, the password would be invalid.

kms_encrypted_password str

An KMS encrypts password used to an instance. If the password is filled in, this field will be ignored. When it is changed, the instance will reboot to make the change take effect.

kms_encryption_context Mapping[str, Any]

launch_template_id str

launch_template_name str

The name of the launch template.

launch_template_version str

The version of the launch template. If you set launch_template_id or launch_template_name parameter but do not set the version number of the launch template, the default template version is used.

NOTE: System 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.

NOTE: From version 1.5.0, instance's charge type can be changed to "PrePaid" by specifying period and period_unit, but it is irreversible.

NOTE: From version 1.5.0, instance's private IP address can be specified when creating VPC network instance.

NOTE: From version 1.5.0, instance's vswitch and private IP can be changed in the same availability zone. When they are changed, the instance will reboot to make the change take effect.

NOTE: From version 1.7.0, setting "internet_max_bandwidth_out" larger than 0 can allocate a public IP for an instance. Setting "internet_max_bandwidth_out" to 0 can release allocated public IP for VPC instance(For Classic instnace, its public IP cannot be release once it allocated, even thougth its bandwidth out is 0). However, at present, 'PrePaid' instance cannot narrow its max bandwidth out when its 'internet_charge_type' is "PayByBandwidth".

NOTE: From version 1.7.0, instance's type can be changed. When it is changed, the instance will reboot to make the change take effect.

maintenance_action str

The maintenance action. Valid values: Stop, AutoRecover and AutoRedeploy.

maintenance_notify bool

Specifies whether to send an event notification before instance shutdown. Valid values: true, false. Default value: false.

maintenance_time InstanceMaintenanceTimeArgs

The time of maintenance. See maintenance_time below.

memory int

The memory size of the instance. Unit: MiB.

network_interface_id str

The ID of the secondary ENI.

network_interfaces InstanceNetworkInterfacesArgs

The list of network interfaces created with instance. See network_interfaces below.

operator_type str

os_name str

The name of the operating system of the instance.

os_type str

The type of the operating system of the instance.

password str

period int

The duration that you will buy the resource, in month. It is valid and required when instance_charge_type is PrePaid. Valid values:

[1-9, 12, 24, 36, 48, 60] when period_unit in "Month"
[1-3] when period_unit in "Week"

NOTE: The attribute period is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running pulumi up will not effect the resource.

period_unit str

The duration unit that you will buy the resource. It is valid when instance_charge_type is 'PrePaid'. Valid value: ["Week", "Month"]. Default to "Month".

primary_ip_address str

The primary private IP address of the ENI.

private_ip str

Instance private IP address can be specified when you creating new instance. It is valid when vswitch_id is specified. When it is changed, the instance will reboot to make the change take effect.

public_ip str

The instance public ip.

renewal_status str

Whether to renew an ECS instance automatically or not. It is valid when instance_charge_type is PrePaid. Default to "Normal". Valid values:

resource_group_id str

The Id of resource group which the instance belongs.

role_name str

Instance RAM role name. The name is provided and maintained by RAM. You can use alicloud.ram.Role to create a new one.

secondary_private_ip_address_count int

secondary_private_ips Sequence[str]

A list of Secondary private IP addresses which is selected from within the CIDR block of the VSwitch.

security_enhancement_strategy str

The security enhancement strategy.

Active: Enable security enhancement strategy, it only works on system images.
Deactive: Disable security enhancement strategy, it works on all images.

security_groups Sequence[str]

A list of security group ids to associate with. If you do not use launch_template_id or launch_template_name to specify a launch template, you must specify security_groups.

spot_duration int

spot_price_limit float

The hourly price threshold of a instance, and it takes effect only when parameter 'spot_strategy' is 'SpotWithPriceLimit'. Three decimals is allowed at most.

spot_strategy str

The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter instance_charge_type is 'PostPaid'. Value range:

NoSpot: A regular Pay-As-You-Go instance.
SpotWithPriceLimit: A price threshold for a spot instance
SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go instance

Default to NoSpot. Note: Currently, the spot instance only supports domestic site account.

status str

The instance status. Valid values: ["Running", "Stopped"]. You can control the instance start and stop through this parameter. Default to Running.

stopped_mode str

system_disk_auto_snapshot_policy_id str

The ID of the automatic snapshot policy applied to the system disk.

system_disk_category str

system_disk_description str

The description of the system disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

system_disk_encrypt_algorithm str

The algorithm to be used to encrypt the system disk. Valid values are aes-256, sm4-128. Default value is aes-256.

system_disk_encrypted bool

Specifies whether to encrypt the system disk. Valid values: true,false. Default value: false.

system_disk_id str

(Available since v1.210.0) The ID of system disk.

system_disk_kms_key_id str

The ID of the Key Management Service (KMS) key to be used for the system disk.

system_disk_name str

system_disk_performance_level str

The performance level of the ESSD used as the system disk, Valid values: PL0, PL1, PL2, PL3, Default to PL1;For more information about ESSD, See Encryption Context.

system_disk_size int

Size of the system disk, measured in GiB. Value range: [20, 500]. The specified value must be equal to or greater than max{20, Imagesize}. Default value: max{40, ImageSize}.

system_disk_storage_cluster_id str

tags Mapping[str, str]

A mapping of tags to assign to the resource.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

user_data str

volume_tags Mapping[str, Any]

A mapping of tags to assign to the devices created by the instance at launch time.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

vswitch_id str

The virtual switch ID to launch in VPC. This parameter must be set unless you can create classic network instances. When it is changed, the instance will reboot to make the change take effect.

allocatePublicIp Boolean

It has been deprecated from version "1.7.0". Setting "internet_max_bandwidth_out" larger than 0 can allocate a public ip address for an instance.

Deprecated: Field 'allocate_public_ip' has been deprecated from provider version 1.6.1. Setting 'internet_max_bandwidth_out' larger than 0 will allocate public ip for instance.

autoReleaseTime String

autoRenewPeriod Number

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid. Default to 1. Valid value:

[1, 2, 3, 6, 12] when period_unit in "Month"
[1, 2, 3] when period_unit in "Week"

availabilityZone String

The Zone to start the instance in. It is ignored and will be computed when set vswitch_id.

cpu Number

The number of vCPUs.

creditSpecification String

Performance mode of the t5 burstable instance. Valid values: 'Standard', 'Unlimited'.

dataDisks List<Property Map>

The list of data disks created with instance. See data_disks below.

dedicatedHostId String

deletionProtection Boolean

Whether enable the deletion protection or not. It does not work when the instance is spot. Default value: false.

true: Enable deletion protection.
false: Disable deletion protection.

deploymentSetGroupNo String

The group number of the instance in a deployment set when the deployment set is use.

deploymentSetId String

The ID of the deployment set to which to deploy the instance. NOTE: From version 1.176.0, instance's deploymentSetId can be removed when 'deployment_set_id' = "".

description String

Description of the instance, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.

dryRun Boolean

Specifies whether to send a dry-run request. Default to false.

true: Only a dry-run request is sent and no instance is created. The system checks whether the required parameters are set, and validates the request format, service permissions, and available ECS instances. If the validation fails, the corresponding error code is returned. If the validation succeeds, the DryRunOperation error code is returned.
false: A request is sent. If the validation succeeds, the instance is created.

forceDelete Boolean

hostName String

hpcClusterId String

The ID of the Elastic High Performance Computing (E-HPC) cluster to which to assign the instance.

httpEndpoint String

Specifies whether to enable the access channel for instance metadata. Valid values: enabled, disabled. Default value: enabled.

httpPutResponseHopLimit Number

The HTTP PUT response hop limit for accessing instance metadata. Valid values: 1 to 64. Default value: 1.

httpTokens String

Specifies whether to forcefully use the security-enhanced mode (IMDSv2) to access instance metadata. Default value: optional. Valid values:

optional: does not forcefully use the security-enhanced mode (IMDSv2).
required: forcefully uses the security-enhanced mode (IMDSv2). After you set this parameter to required, you cannot access instance metadata in normal mode.

imageId String

includeDataDisks Boolean

Whether to change instance disks charge type when changing instance charge type.

instanceChargeType String

instanceName String

instanceType String

internetChargeType String

internetMaxBandwidthIn Number

Maximum incoming bandwidth from the public network, measured in Mbps (Mega bit per second). Value range: [1, 200]. If this value is not specified, then automatically sets it to 200 Mbps.

Deprecated: The attribute is invalid and no any affect for the instance. So it has been deprecated since version v1.121.2.

internetMaxBandwidthOut Number

Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value range: [0, 100]. Default to 0 Mbps.

ipv6AddressCount Number

The number of IPv6 addresses to randomly generate for the primary ENI. Valid values: 1 to 10. NOTE: You cannot specify both the ipv6_addresses and ipv6_address_count parameters.

ipv6Addresses List<String>

A list of IPv6 address to be assigned to the primary ENI. Support up to 10.

isOutdated Boolean

Whether to use outdated instance type. Default to false.

keyName String

The name of key pair that can login ECS instance successfully without password. If it is specified, the password would be invalid.

kmsEncryptedPassword String

An KMS encrypts password used to an instance. If the password is filled in, this field will be ignored. When it is changed, the instance will reboot to make the change take effect.

kmsEncryptionContext Map<Any>

launchTemplateId String

launchTemplateName String

The name of the launch template.

launchTemplateVersion String

The version of the launch template. If you set launch_template_id or launch_template_name parameter but do not set the version number of the launch template, the default template version is used.

NOTE: System 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.

NOTE: From version 1.5.0, instance's charge type can be changed to "PrePaid" by specifying period and period_unit, but it is irreversible.

NOTE: From version 1.5.0, instance's private IP address can be specified when creating VPC network instance.

NOTE: From version 1.5.0, instance's vswitch and private IP can be changed in the same availability zone. When they are changed, the instance will reboot to make the change take effect.

NOTE: From version 1.7.0, setting "internet_max_bandwidth_out" larger than 0 can allocate a public IP for an instance. Setting "internet_max_bandwidth_out" to 0 can release allocated public IP for VPC instance(For Classic instnace, its public IP cannot be release once it allocated, even thougth its bandwidth out is 0). However, at present, 'PrePaid' instance cannot narrow its max bandwidth out when its 'internet_charge_type' is "PayByBandwidth".

NOTE: From version 1.7.0, instance's type can be changed. When it is changed, the instance will reboot to make the change take effect.

maintenanceAction String

The maintenance action. Valid values: Stop, AutoRecover and AutoRedeploy.

maintenanceNotify Boolean

Specifies whether to send an event notification before instance shutdown. Valid values: true, false. Default value: false.

maintenanceTime Property Map

The time of maintenance. See maintenance_time below.

memory Number

The memory size of the instance. Unit: MiB.

networkInterfaceId String

The ID of the secondary ENI.

networkInterfaces Property Map

The list of network interfaces created with instance. See network_interfaces below.

operatorType String

osName String

The name of the operating system of the instance.

osType String

The type of the operating system of the instance.

password String

period Number

The duration that you will buy the resource, in month. It is valid and required when instance_charge_type is PrePaid. Valid values:

[1-9, 12, 24, 36, 48, 60] when period_unit in "Month"
[1-3] when period_unit in "Week"

NOTE: The attribute period is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running pulumi up will not effect the resource.

periodUnit String

The duration unit that you will buy the resource. It is valid when instance_charge_type is 'PrePaid'. Valid value: ["Week", "Month"]. Default to "Month".

primaryIpAddress String

The primary private IP address of the ENI.

privateIp String

Instance private IP address can be specified when you creating new instance. It is valid when vswitch_id is specified. When it is changed, the instance will reboot to make the change take effect.

publicIp String

The instance public ip.

renewalStatus String

Whether to renew an ECS instance automatically or not. It is valid when instance_charge_type is PrePaid. Default to "Normal". Valid values:

resourceGroupId String

The Id of resource group which the instance belongs.

roleName String

Instance RAM role name. The name is provided and maintained by RAM. You can use alicloud.ram.Role to create a new one.

secondaryPrivateIpAddressCount Number

secondaryPrivateIps List<String>

A list of Secondary private IP addresses which is selected from within the CIDR block of the VSwitch.

securityEnhancementStrategy String

The security enhancement strategy.

Active: Enable security enhancement strategy, it only works on system images.
Deactive: Disable security enhancement strategy, it works on all images.

securityGroups List<String>

A list of security group ids to associate with. If you do not use launch_template_id or launch_template_name to specify a launch template, you must specify security_groups.

spotDuration Number

spotPriceLimit Number

The hourly price threshold of a instance, and it takes effect only when parameter 'spot_strategy' is 'SpotWithPriceLimit'. Three decimals is allowed at most.

spotStrategy String

The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter instance_charge_type is 'PostPaid'. Value range:

NoSpot: A regular Pay-As-You-Go instance.
SpotWithPriceLimit: A price threshold for a spot instance
SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go instance

Default to NoSpot. Note: Currently, the spot instance only supports domestic site account.

status String

The instance status. Valid values: ["Running", "Stopped"]. You can control the instance start and stop through this parameter. Default to Running.

stoppedMode String

systemDiskAutoSnapshotPolicyId String

The ID of the automatic snapshot policy applied to the system disk.

systemDiskCategory String

systemDiskDescription String

The description of the system disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

systemDiskEncryptAlgorithm String

The algorithm to be used to encrypt the system disk. Valid values are aes-256, sm4-128. Default value is aes-256.

systemDiskEncrypted Boolean

Specifies whether to encrypt the system disk. Valid values: true,false. Default value: false.

systemDiskId String

(Available since v1.210.0) The ID of system disk.

systemDiskKmsKeyId String

The ID of the Key Management Service (KMS) key to be used for the system disk.

systemDiskName String

systemDiskPerformanceLevel String

The performance level of the ESSD used as the system disk, Valid values: PL0, PL1, PL2, PL3, Default to PL1;For more information about ESSD, See Encryption Context.

systemDiskSize Number

Size of the system disk, measured in GiB. Value range: [20, 500]. The specified value must be equal to or greater than max{20, Imagesize}. Default value: max{40, ImageSize}.

systemDiskStorageClusterId String

tags Map<String>

A mapping of tags to assign to the resource.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

userData String

volumeTags Map<Any>

A mapping of tags to assign to the devices created by the instance at launch time.

Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

vswitchId String

The virtual switch ID to launch in VPC. This parameter must be set unless you can create classic network instances. When it is changed, the instance will reboot to make the change take effect.

Supporting Types

InstanceDataDisk, InstanceDataDiskArgs

Size int

The size of the data disk.

cloud：[5, 2000]
cloud_efficiency：[20, 32768]
cloud_ssd：[20, 32768]
cloud_essd：[20, 32768]
ephemeral_ssd: [5, 800]

AutoSnapshotPolicyId string

The ID of the automatic snapshot policy applied to the system disk.

Category string

The category of the disk:

DeleteWithInstance bool

Delete this data disk when the instance is destroyed. It only works on cloud, cloud_efficiency, cloud_essd, cloud_ssd disk. If the category of this data disk was ephemeral_ssd, please don't set this param. Default value: true.

Description string

The description of the data disk.

Device string

The mount point of the data disk.

Encrypted bool

Encrypted the data in this disk. Default value: false.

KmsKeyId string

The KMS key ID corresponding to the Nth data disk.

Name string

The name of the data disk.

PerformanceLevel string

The performance level of the ESSD used as data disk:

SnapshotId string

The snapshot ID used to initialize the data disk. If the size specified by snapshot is greater that the size of the disk, use the size specified by snapshot as the size of the data disk.

Size int

The size of the data disk.

cloud：[5, 2000]
cloud_efficiency：[20, 32768]
cloud_ssd：[20, 32768]
cloud_essd：[20, 32768]
ephemeral_ssd: [5, 800]

AutoSnapshotPolicyId string

The ID of the automatic snapshot policy applied to the system disk.

Category string

The category of the disk:

DeleteWithInstance bool

Description string

The description of the data disk.

Device string

The mount point of the data disk.

Encrypted bool

Encrypted the data in this disk. Default value: false.

KmsKeyId string

The KMS key ID corresponding to the Nth data disk.

Name string

The name of the data disk.

PerformanceLevel string

The performance level of the ESSD used as data disk:

SnapshotId string

The snapshot ID used to initialize the data disk. If the size specified by snapshot is greater that the size of the disk, use the size specified by snapshot as the size of the data disk.

size Integer

The size of the data disk.

cloud：[5, 2000]
cloud_efficiency：[20, 32768]
cloud_ssd：[20, 32768]
cloud_essd：[20, 32768]
ephemeral_ssd: [5, 800]

autoSnapshotPolicyId String

The ID of the automatic snapshot policy applied to the system disk.

category String

The category of the disk:

deleteWithInstance Boolean

description String

The description of the data disk.

device String

The mount point of the data disk.

encrypted Boolean

Encrypted the data in this disk. Default value: false.

kmsKeyId String

The KMS key ID corresponding to the Nth data disk.

name String

The name of the data disk.

performanceLevel String

The performance level of the ESSD used as data disk:

snapshotId String

The snapshot ID used to initialize the data disk. If the size specified by snapshot is greater that the size of the disk, use the size specified by snapshot as the size of the data disk.

size number

The size of the data disk.

cloud：[5, 2000]
cloud_efficiency：[20, 32768]
cloud_ssd：[20, 32768]
cloud_essd：[20, 32768]
ephemeral_ssd: [5, 800]

autoSnapshotPolicyId string

The ID of the automatic snapshot policy applied to the system disk.

category string

The category of the disk:

deleteWithInstance boolean

description string

The description of the data disk.

device string

The mount point of the data disk.

encrypted boolean

Encrypted the data in this disk. Default value: false.

kmsKeyId string

The KMS key ID corresponding to the Nth data disk.

name string

The name of the data disk.

performanceLevel string

The performance level of the ESSD used as data disk:

snapshotId string

The snapshot ID used to initialize the data disk. If the size specified by snapshot is greater that the size of the disk, use the size specified by snapshot as the size of the data disk.

size int

The size of the data disk.

cloud：[5, 2000]
cloud_efficiency：[20, 32768]
cloud_ssd：[20, 32768]
cloud_essd：[20, 32768]
ephemeral_ssd: [5, 800]

auto_snapshot_policy_id str

The ID of the automatic snapshot policy applied to the system disk.

category str

The category of the disk:

delete_with_instance bool

description str

The description of the data disk.

device str

The mount point of the data disk.

encrypted bool

Encrypted the data in this disk. Default value: false.

kms_key_id str

The KMS key ID corresponding to the Nth data disk.

name str

The name of the data disk.

performance_level str

The performance level of the ESSD used as data disk:

snapshot_id str

The snapshot ID used to initialize the data disk. If the size specified by snapshot is greater that the size of the disk, use the size specified by snapshot as the size of the data disk.

size Number

The size of the data disk.

cloud：[5, 2000]
cloud_efficiency：[20, 32768]
cloud_ssd：[20, 32768]
cloud_essd：[20, 32768]
ephemeral_ssd: [5, 800]

autoSnapshotPolicyId String

The ID of the automatic snapshot policy applied to the system disk.

category String

The category of the disk:

deleteWithInstance Boolean

description String

The description of the data disk.

device String

The mount point of the data disk.

encrypted Boolean

Encrypted the data in this disk. Default value: false.

kmsKeyId String

The KMS key ID corresponding to the Nth data disk.

name String

The name of the data disk.

performanceLevel String

The performance level of the ESSD used as data disk:

snapshotId String

The snapshot ID used to initialize the data disk. If the size specified by snapshot is greater that the size of the disk, use the size specified by snapshot as the size of the data disk.

InstanceMaintenanceTime, InstanceMaintenanceTimeArgs

EndTime string: The end time of maintenance. The time must be on the hour at exactly 0 minute and 0 second. The start_time and end_time parameters must be specified at the same time. The end_time value must be 1 to 23 hours later than the start_time value. Specify the time in the HH:mm:ss format. The time must be in UTC+8.
StartTime string: The start time of maintenance. The time must be on the hour at exactly 0 minute and 0 second. The start_time and end_time parameters must be specified at the same time. The end_time value must be 1 to 23 hours later than the start_time value. Specify the time in the HH:mm:ss format. The time must be in UTC+8.

EndTime string: The end time of maintenance. The time must be on the hour at exactly 0 minute and 0 second. The start_time and end_time parameters must be specified at the same time. The end_time value must be 1 to 23 hours later than the start_time value. Specify the time in the HH:mm:ss format. The time must be in UTC+8.
StartTime string: The start time of maintenance. The time must be on the hour at exactly 0 minute and 0 second. The start_time and end_time parameters must be specified at the same time. The end_time value must be 1 to 23 hours later than the start_time value. Specify the time in the HH:mm:ss format. The time must be in UTC+8.

endTime String: The end time of maintenance. The time must be on the hour at exactly 0 minute and 0 second. The start_time and end_time parameters must be specified at the same time. The end_time value must be 1 to 23 hours later than the start_time value. Specify the time in the HH:mm:ss format. The time must be in UTC+8.
startTime String: The start time of maintenance. The time must be on the hour at exactly 0 minute and 0 second. The start_time and end_time parameters must be specified at the same time. The end_time value must be 1 to 23 hours later than the start_time value. Specify the time in the HH:mm:ss format. The time must be in UTC+8.

endTime string: The end time of maintenance. The time must be on the hour at exactly 0 minute and 0 second. The start_time and end_time parameters must be specified at the same time. The end_time value must be 1 to 23 hours later than the start_time value. Specify the time in the HH:mm:ss format. The time must be in UTC+8.
startTime string: The start time of maintenance. The time must be on the hour at exactly 0 minute and 0 second. The start_time and end_time parameters must be specified at the same time. The end_time value must be 1 to 23 hours later than the start_time value. Specify the time in the HH:mm:ss format. The time must be in UTC+8.

end_time str: The end time of maintenance. The time must be on the hour at exactly 0 minute and 0 second. The start_time and end_time parameters must be specified at the same time. The end_time value must be 1 to 23 hours later than the start_time value. Specify the time in the HH:mm:ss format. The time must be in UTC+8.
start_time str: The start time of maintenance. The time must be on the hour at exactly 0 minute and 0 second. The start_time and end_time parameters must be specified at the same time. The end_time value must be 1 to 23 hours later than the start_time value. Specify the time in the HH:mm:ss format. The time must be in UTC+8.

endTime String: The end time of maintenance. The time must be on the hour at exactly 0 minute and 0 second. The start_time and end_time parameters must be specified at the same time. The end_time value must be 1 to 23 hours later than the start_time value. Specify the time in the HH:mm:ss format. The time must be in UTC+8.
startTime String: The start time of maintenance. The time must be on the hour at exactly 0 minute and 0 second. The start_time and end_time parameters must be specified at the same time. The end_time value must be 1 to 23 hours later than the start_time value. Specify the time in the HH:mm:ss format. The time must be in UTC+8.

InstanceNetworkInterfaces, InstanceNetworkInterfacesArgs

NetworkInterfaceId string: The ID of the secondary ENI.

NetworkInterfaceId string: The ID of the secondary ENI.

networkInterfaceId String: The ID of the secondary ENI.

networkInterfaceId string: The ID of the secondary ENI.

network_interface_id str: The ID of the secondary ENI.

networkInterfaceId String: The ID of the secondary ENI.

Import

Instance can be imported using the id, e.g.

$ pulumi import alicloud:ecs/instance:Instance example i-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.

Alibaba Cloud v3.53.0 published on Wednesday, Apr 17, 2024 by Pulumi

pulumi/pulumi-alicloud

alicloud.ecs.Instance

On this page

On this page

Example Usage

Module Support

Create Instance Resource

Constructor syntax

Parameters

Example

Instance Resource Properties

Inputs

Outputs

Look up Existing Instance Resource

Supporting Types

InstanceDataDisk, InstanceDataDiskArgs

InstanceMaintenanceTime, InstanceMaintenanceTimeArgs

InstanceNetworkInterfaces, InstanceNetworkInterfacesArgs

Import

Package Details

On this page

On this page