Alibaba Cloud

Pulumi Official
Package maintained by Pulumi
v3.26.0 published on Friday, Jul 29, 2022 by Pulumi

EcsInstanceSet

Provides a ECS Instance Set resource.

For information about ECS Instance Set and how to use it, see What is Instance Set.

NOTE: Available in v1.173.0+.

NOTE: This resource is used to batch create a group of instance resources with the same configuration. However, this resource is not recommended. alicloud.ecs.Instance is preferred.

NOTE: In the instances managed by this resource, names are automatically generated based on instance_name and unique_suffix.

NOTE: Only tags support batch modification.

Example Usage

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

class MyStack : Stack
{
    public MyStack()
    {
        var config = new Config();
        var name = config.Get("name") ?? "tf-testaccecsset";
        var defaultZones = Output.Create(AliCloud.GetZones.InvokeAsync(new AliCloud.GetZonesArgs
        {
            AvailableDiskCategory = "cloud_efficiency",
            AvailableResourceCreation = "VSwitch",
        }));
        var defaultInstanceTypes = defaultZones.Apply(defaultZones => Output.Create(AliCloud.Ecs.GetInstanceTypes.InvokeAsync(new AliCloud.Ecs.GetInstanceTypesArgs
        {
            AvailabilityZone = defaultZones.Zones?[0]?.Id,
            CpuCoreCount = 1,
            MemorySize = 2,
        })));
        var defaultImages = Output.Create(AliCloud.Ecs.GetImages.InvokeAsync(new AliCloud.Ecs.GetImagesArgs
        {
            NameRegex = "^ubuntu_[0-9]+_[0-9]+_x64*",
            MostRecent = true,
            Owners = "system",
        }));
        var defaultNetworks = Output.Create(AliCloud.Vpc.GetNetworks.InvokeAsync(new AliCloud.Vpc.GetNetworksArgs
        {
            NameRegex = "default-NODELETING",
        }));
        var defaultSwitches = Output.Tuple(defaultNetworks, defaultZones).Apply(values =>
        {
            var defaultNetworks = values.Item1;
            var defaultZones = values.Item2;
            return Output.Create(AliCloud.Vpc.GetSwitches.InvokeAsync(new AliCloud.Vpc.GetSwitchesArgs
            {
                VpcId = defaultNetworks.Ids?[0],
                ZoneId = defaultZones.Zones?[0]?.Id,
            }));
        });
        var defaultSecurityGroup = new AliCloud.Ecs.SecurityGroup("defaultSecurityGroup", new AliCloud.Ecs.SecurityGroupArgs
        {
            VpcId = defaultNetworks.Apply(defaultNetworks => defaultNetworks.Ids?[0]),
        });
        var beijingK = new AliCloud.Ecs.EcsInstanceSet("beijingK", new AliCloud.Ecs.EcsInstanceSetArgs
        {
            Amount = 100,
            ImageId = defaultImages.Apply(defaultImages => defaultImages.Images?[0]?.Id),
            InstanceType = defaultInstanceTypes.Apply(defaultInstanceTypes => defaultInstanceTypes.InstanceTypes?[0]?.Id),
            InstanceName = name,
            InstanceChargeType = "PostPaid",
            SystemDiskPerformanceLevel = "PL0",
            SystemDiskCategory = "cloud_essd",
            SystemDiskSize = 200,
            VswitchId = defaultSwitches.Apply(defaultSwitches => defaultSwitches.Ids?[0]),
            SecurityGroupIds = 
            {
                defaultSecurityGroup,
            }.Select(__item => __item.Id).ToList(),
            ZoneId = defaultZones.Apply(defaultZones => defaultZones.Zones?[0]?.Id),
        });
    }

}

Coming soon!

Coming soon!

import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "tf-testaccecsset"
default_zones = alicloud.get_zones(available_disk_category="cloud_efficiency",
    available_resource_creation="VSwitch")
default_instance_types = alicloud.ecs.get_instance_types(availability_zone=default_zones.zones[0].id,
    cpu_core_count=1,
    memory_size=2)
default_images = alicloud.ecs.get_images(name_regex="^ubuntu_[0-9]+_[0-9]+_x64*",
    most_recent=True,
    owners="system")
default_networks = alicloud.vpc.get_networks(name_regex="default-NODELETING")
default_switches = alicloud.vpc.get_switches(vpc_id=default_networks.ids[0],
    zone_id=default_zones.zones[0].id)
default_security_group = alicloud.ecs.SecurityGroup("defaultSecurityGroup", vpc_id=default_networks.ids[0])
beijing_k = alicloud.ecs.EcsInstanceSet("beijingK",
    amount=100,
    image_id=default_images.images[0].id,
    instance_type=default_instance_types.instance_types[0].id,
    instance_name=name,
    instance_charge_type="PostPaid",
    system_disk_performance_level="PL0",
    system_disk_category="cloud_essd",
    system_disk_size=200,
    vswitch_id=default_switches.ids[0],
    security_group_ids=[__item.id for __item in [default_security_group]],
    zone_id=default_zones.zones[0].id)
import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";

const config = new pulumi.Config();
const name = config.get("name") || "tf-testaccecsset";
const defaultZones = alicloud.getZones({
    availableDiskCategory: "cloud_efficiency",
    availableResourceCreation: "VSwitch",
});
const defaultInstanceTypes = defaultZones.then(defaultZones => alicloud.ecs.getInstanceTypes({
    availabilityZone: defaultZones.zones?[0]?.id,
    cpuCoreCount: 1,
    memorySize: 2,
}));
const defaultImages = alicloud.ecs.getImages({
    nameRegex: "^ubuntu_[0-9]+_[0-9]+_x64*",
    mostRecent: true,
    owners: "system",
});
const defaultNetworks = alicloud.vpc.getNetworks({
    nameRegex: "default-NODELETING",
});
const defaultSwitches = Promise.all([defaultNetworks, defaultZones]).then(([defaultNetworks, defaultZones]) => alicloud.vpc.getSwitches({
    vpcId: defaultNetworks.ids?[0],
    zoneId: defaultZones.zones?[0]?.id,
}));
const defaultSecurityGroup = new alicloud.ecs.SecurityGroup("defaultSecurityGroup", {vpcId: defaultNetworks.then(defaultNetworks => defaultNetworks.ids?[0])});
const beijingK = new alicloud.ecs.EcsInstanceSet("beijingK", {
    amount: 100,
    imageId: defaultImages.then(defaultImages => defaultImages.images?[0]?.id),
    instanceType: defaultInstanceTypes.then(defaultInstanceTypes => defaultInstanceTypes.instanceTypes?[0]?.id),
    instanceName: name,
    instanceChargeType: "PostPaid",
    systemDiskPerformanceLevel: "PL0",
    systemDiskCategory: "cloud_essd",
    systemDiskSize: 200,
    vswitchId: defaultSwitches.then(defaultSwitches => defaultSwitches.ids?[0]),
    securityGroupIds: [defaultSecurityGroup].map(__item => __item.id),
    zoneId: defaultZones.then(defaultZones => defaultZones.zones?[0]?.id),
});

Coming soon!

Create a EcsInstanceSet Resource

new EcsInstanceSet(name: string, args: EcsInstanceSetArgs, opts?: CustomResourceOptions);
@overload
def EcsInstanceSet(resource_name: str,
                   opts: Optional[ResourceOptions] = None,
                   amount: Optional[int] = None,
                   auto_release_time: Optional[str] = None,
                   auto_renew: Optional[bool] = None,
                   auto_renew_period: Optional[int] = None,
                   boot_check_os_with_assistant: Optional[bool] = None,
                   data_disks: Optional[Sequence[EcsInstanceSetDataDiskArgs]] = None,
                   dedicated_host_id: Optional[str] = None,
                   deletion_protection: Optional[bool] = None,
                   deployment_set_id: Optional[str] = None,
                   description: Optional[str] = None,
                   exclude_instance_filter: Optional[EcsInstanceSetExcludeInstanceFilterArgs] = None,
                   host_name: Optional[str] = None,
                   hpc_cluster_id: Optional[str] = None,
                   image_id: Optional[str] = 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_out: Optional[int] = None,
                   key_pair_name: Optional[str] = None,
                   launch_template_id: Optional[str] = None,
                   launch_template_name: Optional[str] = None,
                   launch_template_version: Optional[str] = None,
                   network_interfaces: Optional[Sequence[EcsInstanceSetNetworkInterfaceArgs]] = None,
                   password: Optional[str] = None,
                   password_inherit: Optional[bool] = None,
                   period: Optional[int] = None,
                   period_unit: Optional[str] = None,
                   ram_role_name: Optional[str] = None,
                   resource_group_id: Optional[str] = None,
                   security_enhancement_strategy: Optional[str] = None,
                   security_group_ids: Optional[Sequence[str]] = None,
                   spot_price_limit: Optional[float] = None,
                   spot_strategy: 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_name: Optional[str] = None,
                   system_disk_performance_level: Optional[str] = None,
                   system_disk_size: Optional[int] = None,
                   tags: Optional[Mapping[str, str]] = None,
                   unique_suffix: Optional[bool] = None,
                   vswitch_id: Optional[str] = None,
                   zone_id: Optional[str] = None)
@overload
def EcsInstanceSet(resource_name: str,
                   args: EcsInstanceSetArgs,
                   opts: Optional[ResourceOptions] = None)
func NewEcsInstanceSet(ctx *Context, name string, args EcsInstanceSetArgs, opts ...ResourceOption) (*EcsInstanceSet, error)
public EcsInstanceSet(string name, EcsInstanceSetArgs args, CustomResourceOptions? opts = null)
public EcsInstanceSet(String name, EcsInstanceSetArgs args)
public EcsInstanceSet(String name, EcsInstanceSetArgs args, CustomResourceOptions options)
type: alicloud:ecs:EcsInstanceSet
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string
The unique name of the resource.
args EcsInstanceSetArgs
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 EcsInstanceSetArgs
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 EcsInstanceSetArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args EcsInstanceSetArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name String
The unique name of the resource.
args EcsInstanceSetArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

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

ImageId string

The Image to use for the instance.

InstanceType string

The type of instance to start.

SecurityGroupIds List<string>

A list of security group ids to associate with.

Amount int

The number of instances that you want to create. Valid values: 1 to 100.

AutoReleaseTime string

The automatic release time of the PostPaid instance.

AutoRenew bool

Whether to enable auto-renewal for the instance. This parameter is valid only when the instance_charge_type is set to PrePaid.

AutoRenewPeriod int

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 6, 12.
  • When period_unit is Week, Valid values: 1, 2, 3.
BootCheckOsWithAssistant bool

Indicate how to check instance ready to use.

  • false: Default value. Means that the instances are ready when their DescribeInstances status is Running, at which time guestOS(Ecs os) may not be ready yet.
  • true: Checking instance ready with Ecs assistant, which means guestOs boots successfully. Premise is that the specified image image_id has built-in Ecs assistant. Most of the public images have assistant installed already.
DataDisks List<Pulumi.AliCloud.Ecs.Inputs.EcsInstanceSetDataDiskArgs>

The list of data disks created with instance. See the following Block data_disks.

DedicatedHostId string

The ID of the dedicated host on which to create the instance. If the dedicated_host_id is specified, the spot_strategy and spot_price_limit are ignored. This is because preemptible instances cannot be created on dedicated hosts.

DeletionProtection bool

Whether to enable release protection for the instance.

DeploymentSetId string

The ID of the deployment set to which to deploy the instance.

Description string

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

ExcludeInstanceFilter Pulumi.AliCloud.Ecs.Inputs.EcsInstanceSetExcludeInstanceFilterArgs

The instances that need to be excluded from the Instance Set. See the following Block exclude_instance_filter.

HostName string

The hostname of instance.

HpcClusterId string

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

InstanceChargeType string

The billing method of the instance. Valid values: PrePaid, PostPaid.

InstanceName string

The name of the ECS. This instance_name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin with a hyphen, and must not begin with http:// or https://.

InternetChargeType string

The Internet charge type of the instance. Valid values are PayByBandwidth, PayByTraffic.

InternetMaxBandwidthOut int

The Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value values: 1 to 100.

KeyPairName string

The name of key pair that can login ECS instance successfully without password.

LaunchTemplateId string

The ID of the launch template.

LaunchTemplateName string

The name of the launch template. 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.

LaunchTemplateVersion string

The version of the launch template.

NetworkInterfaces List<Pulumi.AliCloud.Ecs.Inputs.EcsInstanceSetNetworkInterfaceArgs>

A list of NetworkInterface. See the following Block network_interfaces.

Password string

The 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.

PasswordInherit bool

Whether to use the password preset in the image.

Period int

The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60.
  • When period_unit is Week, Valid values: 1, 2, 3.
PeriodUnit string

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

RamRoleName string

The Instance RAM role name.

ResourceGroupId string

The ID of resource group which the instance belongs.

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.
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'.

  • 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
SystemDiskAutoSnapshotPolicyId string

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

SystemDiskCategory string

The category of the system disk. Valid values are cloud_efficiency, cloud_ssd, cloud_essd, cloud.

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://.

SystemDiskName string

The name of the system disk.

SystemDiskPerformanceLevel string

The performance level of the ESSD used as the system disk. Valid values: PL0, PL1, PL2, PL3.

SystemDiskSize int

The size of the system disk, measured in GiB. Value range: values: 20 to 500.

Tags Dictionary<string, string>

A mapping of tags to assign to the resource.

UniqueSuffix bool

Whether to automatically append incremental suffixes to the hostname specified by the HostName parameter and to the instance name specified by the InstanceName parameter when you batch create instances. The incremental suffixes can range from 001 to 999.

VswitchId string

The virtual switch ID to launch in VPC.

ZoneId string

The ID of the zone in which to create the instance.

ImageId string

The Image to use for the instance.

InstanceType string

The type of instance to start.

SecurityGroupIds []string

A list of security group ids to associate with.

Amount int

The number of instances that you want to create. Valid values: 1 to 100.

AutoReleaseTime string

The automatic release time of the PostPaid instance.

AutoRenew bool

Whether to enable auto-renewal for the instance. This parameter is valid only when the instance_charge_type is set to PrePaid.

AutoRenewPeriod int

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 6, 12.
  • When period_unit is Week, Valid values: 1, 2, 3.
BootCheckOsWithAssistant bool

Indicate how to check instance ready to use.

  • false: Default value. Means that the instances are ready when their DescribeInstances status is Running, at which time guestOS(Ecs os) may not be ready yet.
  • true: Checking instance ready with Ecs assistant, which means guestOs boots successfully. Premise is that the specified image image_id has built-in Ecs assistant. Most of the public images have assistant installed already.
DataDisks []EcsInstanceSetDataDiskArgs

The list of data disks created with instance. See the following Block data_disks.

DedicatedHostId string

The ID of the dedicated host on which to create the instance. If the dedicated_host_id is specified, the spot_strategy and spot_price_limit are ignored. This is because preemptible instances cannot be created on dedicated hosts.

DeletionProtection bool

Whether to enable release protection for the instance.

DeploymentSetId string

The ID of the deployment set to which to deploy the instance.

Description string

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

ExcludeInstanceFilter EcsInstanceSetExcludeInstanceFilterArgs

The instances that need to be excluded from the Instance Set. See the following Block exclude_instance_filter.

HostName string

The hostname of instance.

HpcClusterId string

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

InstanceChargeType string

The billing method of the instance. Valid values: PrePaid, PostPaid.

InstanceName string

The name of the ECS. This instance_name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin with a hyphen, and must not begin with http:// or https://.

InternetChargeType string

The Internet charge type of the instance. Valid values are PayByBandwidth, PayByTraffic.

InternetMaxBandwidthOut int

The Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value values: 1 to 100.

KeyPairName string

The name of key pair that can login ECS instance successfully without password.

LaunchTemplateId string

The ID of the launch template.

LaunchTemplateName string

The name of the launch template. 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.

LaunchTemplateVersion string

The version of the launch template.

NetworkInterfaces []EcsInstanceSetNetworkInterfaceArgs

A list of NetworkInterface. See the following Block network_interfaces.

Password string

The 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.

PasswordInherit bool

Whether to use the password preset in the image.

Period int

The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60.
  • When period_unit is Week, Valid values: 1, 2, 3.
PeriodUnit string

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

RamRoleName string

The Instance RAM role name.

ResourceGroupId string

The ID of resource group which the instance belongs.

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.
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'.

  • 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
SystemDiskAutoSnapshotPolicyId string

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

SystemDiskCategory string

The category of the system disk. Valid values are cloud_efficiency, cloud_ssd, cloud_essd, cloud.

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://.

SystemDiskName string

The name of the system disk.

SystemDiskPerformanceLevel string

The performance level of the ESSD used as the system disk. Valid values: PL0, PL1, PL2, PL3.

SystemDiskSize int

The size of the system disk, measured in GiB. Value range: values: 20 to 500.

Tags map[string]string

A mapping of tags to assign to the resource.

UniqueSuffix bool

Whether to automatically append incremental suffixes to the hostname specified by the HostName parameter and to the instance name specified by the InstanceName parameter when you batch create instances. The incremental suffixes can range from 001 to 999.

VswitchId string

The virtual switch ID to launch in VPC.

ZoneId string

The ID of the zone in which to create the instance.

imageId String

The Image to use for the instance.

instanceType String

The type of instance to start.

securityGroupIds List<String>

A list of security group ids to associate with.

amount Integer

The number of instances that you want to create. Valid values: 1 to 100.

autoReleaseTime String

The automatic release time of the PostPaid instance.

autoRenew Boolean

Whether to enable auto-renewal for the instance. This parameter is valid only when the instance_charge_type is set to PrePaid.

autoRenewPeriod Integer

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 6, 12.
  • When period_unit is Week, Valid values: 1, 2, 3.
bootCheckOsWithAssistant Boolean

Indicate how to check instance ready to use.

  • false: Default value. Means that the instances are ready when their DescribeInstances status is Running, at which time guestOS(Ecs os) may not be ready yet.
  • true: Checking instance ready with Ecs assistant, which means guestOs boots successfully. Premise is that the specified image image_id has built-in Ecs assistant. Most of the public images have assistant installed already.
dataDisks List<EcsInstanceSetDataDiskArgs>

The list of data disks created with instance. See the following Block data_disks.

dedicatedHostId String

The ID of the dedicated host on which to create the instance. If the dedicated_host_id is specified, the spot_strategy and spot_price_limit are ignored. This is because preemptible instances cannot be created on dedicated hosts.

deletionProtection Boolean

Whether to enable release protection for the instance.

deploymentSetId String

The ID of the deployment set to which to deploy the instance.

description String

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

excludeInstanceFilter EcsInstanceSetExcludeInstanceFilterArgs

The instances that need to be excluded from the Instance Set. See the following Block exclude_instance_filter.

hostName String

The hostname of instance.

hpcClusterId String

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

instanceChargeType String

The billing method of the instance. Valid values: PrePaid, PostPaid.

instanceName String

The name of the ECS. This instance_name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin with a hyphen, and must not begin with http:// or https://.

internetChargeType String

The Internet charge type of the instance. Valid values are PayByBandwidth, PayByTraffic.

internetMaxBandwidthOut Integer

The Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value values: 1 to 100.

keyPairName String

The name of key pair that can login ECS instance successfully without password.

launchTemplateId String

The ID of the launch template.

launchTemplateName String

The name of the launch template. 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.

launchTemplateVersion String

The version of the launch template.

networkInterfaces List<EcsInstanceSetNetworkInterfaceArgs>

A list of NetworkInterface. See the following Block network_interfaces.

password String

The 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.

passwordInherit Boolean

Whether to use the password preset in the image.

period Integer

The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60.
  • When period_unit is Week, Valid values: 1, 2, 3.
periodUnit String

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

ramRoleName String

The Instance RAM role name.

resourceGroupId String

The ID of resource group which the instance belongs.

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.
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'.

  • 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
systemDiskAutoSnapshotPolicyId String

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

systemDiskCategory String

The category of the system disk. Valid values are cloud_efficiency, cloud_ssd, cloud_essd, cloud.

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://.

systemDiskName String

The name of the system disk.

systemDiskPerformanceLevel String

The performance level of the ESSD used as the system disk. Valid values: PL0, PL1, PL2, PL3.

systemDiskSize Integer

The size of the system disk, measured in GiB. Value range: values: 20 to 500.

tags Map<String,String>

A mapping of tags to assign to the resource.

uniqueSuffix Boolean

Whether to automatically append incremental suffixes to the hostname specified by the HostName parameter and to the instance name specified by the InstanceName parameter when you batch create instances. The incremental suffixes can range from 001 to 999.

vswitchId String

The virtual switch ID to launch in VPC.

zoneId String

The ID of the zone in which to create the instance.

imageId string

The Image to use for the instance.

instanceType string

The type of instance to start.

securityGroupIds string[]

A list of security group ids to associate with.

amount number

The number of instances that you want to create. Valid values: 1 to 100.

autoReleaseTime string

The automatic release time of the PostPaid instance.

autoRenew boolean

Whether to enable auto-renewal for the instance. This parameter is valid only when the instance_charge_type is set to PrePaid.

autoRenewPeriod number

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 6, 12.
  • When period_unit is Week, Valid values: 1, 2, 3.
bootCheckOsWithAssistant boolean

Indicate how to check instance ready to use.

  • false: Default value. Means that the instances are ready when their DescribeInstances status is Running, at which time guestOS(Ecs os) may not be ready yet.
  • true: Checking instance ready with Ecs assistant, which means guestOs boots successfully. Premise is that the specified image image_id has built-in Ecs assistant. Most of the public images have assistant installed already.
dataDisks EcsInstanceSetDataDiskArgs[]

The list of data disks created with instance. See the following Block data_disks.

dedicatedHostId string

The ID of the dedicated host on which to create the instance. If the dedicated_host_id is specified, the spot_strategy and spot_price_limit are ignored. This is because preemptible instances cannot be created on dedicated hosts.

deletionProtection boolean

Whether to enable release protection for the instance.

deploymentSetId string

The ID of the deployment set to which to deploy the instance.

description string

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

excludeInstanceFilter EcsInstanceSetExcludeInstanceFilterArgs

The instances that need to be excluded from the Instance Set. See the following Block exclude_instance_filter.

hostName string

The hostname of instance.

hpcClusterId string

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

instanceChargeType string

The billing method of the instance. Valid values: PrePaid, PostPaid.

instanceName string

The name of the ECS. This instance_name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin with a hyphen, and must not begin with http:// or https://.

internetChargeType string

The Internet charge type of the instance. Valid values are PayByBandwidth, PayByTraffic.

internetMaxBandwidthOut number

The Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value values: 1 to 100.

keyPairName string

The name of key pair that can login ECS instance successfully without password.

launchTemplateId string

The ID of the launch template.

launchTemplateName string

The name of the launch template. 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.

launchTemplateVersion string

The version of the launch template.

networkInterfaces EcsInstanceSetNetworkInterfaceArgs[]

A list of NetworkInterface. See the following Block network_interfaces.

password string

The 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.

passwordInherit boolean

Whether to use the password preset in the image.

period number

The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60.
  • When period_unit is Week, Valid values: 1, 2, 3.
periodUnit string

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

ramRoleName string

The Instance RAM role name.

resourceGroupId string

The ID of resource group which the instance belongs.

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.
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'.

  • 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
systemDiskAutoSnapshotPolicyId string

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

systemDiskCategory string

The category of the system disk. Valid values are cloud_efficiency, cloud_ssd, cloud_essd, cloud.

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://.

systemDiskName string

The name of the system disk.

systemDiskPerformanceLevel string

The performance level of the ESSD used as the system disk. Valid values: PL0, PL1, PL2, PL3.

systemDiskSize number

The size of the system disk, measured in GiB. Value range: values: 20 to 500.

tags {[key: string]: string}

A mapping of tags to assign to the resource.

uniqueSuffix boolean

Whether to automatically append incremental suffixes to the hostname specified by the HostName parameter and to the instance name specified by the InstanceName parameter when you batch create instances. The incremental suffixes can range from 001 to 999.

vswitchId string

The virtual switch ID to launch in VPC.

zoneId string

The ID of the zone in which to create the instance.

image_id str

The Image to use for the instance.

instance_type str

The type of instance to start.

security_group_ids Sequence[str]

A list of security group ids to associate with.

amount int

The number of instances that you want to create. Valid values: 1 to 100.

auto_release_time str

The automatic release time of the PostPaid instance.

auto_renew bool

Whether to enable auto-renewal for the instance. This parameter is valid only when the instance_charge_type is set to PrePaid.

auto_renew_period int

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 6, 12.
  • When period_unit is Week, Valid values: 1, 2, 3.
boot_check_os_with_assistant bool

Indicate how to check instance ready to use.

  • false: Default value. Means that the instances are ready when their DescribeInstances status is Running, at which time guestOS(Ecs os) may not be ready yet.
  • true: Checking instance ready with Ecs assistant, which means guestOs boots successfully. Premise is that the specified image image_id has built-in Ecs assistant. Most of the public images have assistant installed already.
data_disks Sequence[EcsInstanceSetDataDiskArgs]

The list of data disks created with instance. See the following Block data_disks.

dedicated_host_id str

The ID of the dedicated host on which to create the instance. If the dedicated_host_id is specified, the spot_strategy and spot_price_limit are ignored. This is because preemptible instances cannot be created on dedicated hosts.

deletion_protection bool

Whether to enable release protection for the instance.

deployment_set_id str

The ID of the deployment set to which to deploy the instance.

description str

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

exclude_instance_filter EcsInstanceSetExcludeInstanceFilterArgs

The instances that need to be excluded from the Instance Set. See the following Block exclude_instance_filter.

host_name str

The hostname of instance.

hpc_cluster_id str

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

instance_charge_type str

The billing method of the instance. Valid values: PrePaid, PostPaid.

instance_name str

The name of the ECS. This instance_name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin with a hyphen, and must not begin with http:// or https://.

internet_charge_type str

The Internet charge type of the instance. Valid values are PayByBandwidth, PayByTraffic.

internet_max_bandwidth_out int

The Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value values: 1 to 100.

key_pair_name str

The name of key pair that can login ECS instance successfully without password.

launch_template_id str

The ID of the launch template.

launch_template_name str

The name of the launch template. 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.

launch_template_version str

The version of the launch template.

network_interfaces Sequence[EcsInstanceSetNetworkInterfaceArgs]

A list of NetworkInterface. See the following Block network_interfaces.

password str

The 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.

password_inherit bool

Whether to use the password preset in the image.

period int

The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60.
  • When period_unit is Week, Valid values: 1, 2, 3.
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.

ram_role_name str

The Instance RAM role name.

resource_group_id str

The ID of resource group which the instance belongs.

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.
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'.

  • 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
system_disk_auto_snapshot_policy_id str

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

system_disk_category str

The category of the system disk. Valid values are cloud_efficiency, cloud_ssd, cloud_essd, cloud.

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_name str

The name of the system disk.

system_disk_performance_level str

The performance level of the ESSD used as the system disk. Valid values: PL0, PL1, PL2, PL3.

system_disk_size int

The size of the system disk, measured in GiB. Value range: values: 20 to 500.

tags Mapping[str, str]

A mapping of tags to assign to the resource.

unique_suffix bool

Whether to automatically append incremental suffixes to the hostname specified by the HostName parameter and to the instance name specified by the InstanceName parameter when you batch create instances. The incremental suffixes can range from 001 to 999.

vswitch_id str

The virtual switch ID to launch in VPC.

zone_id str

The ID of the zone in which to create the instance.

imageId String

The Image to use for the instance.

instanceType String

The type of instance to start.

securityGroupIds List<String>

A list of security group ids to associate with.

amount Number

The number of instances that you want to create. Valid values: 1 to 100.

autoReleaseTime String

The automatic release time of the PostPaid instance.

autoRenew Boolean

Whether to enable auto-renewal for the instance. This parameter is valid only when the instance_charge_type is set to PrePaid.

autoRenewPeriod Number

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 6, 12.
  • When period_unit is Week, Valid values: 1, 2, 3.
bootCheckOsWithAssistant Boolean

Indicate how to check instance ready to use.

  • false: Default value. Means that the instances are ready when their DescribeInstances status is Running, at which time guestOS(Ecs os) may not be ready yet.
  • true: Checking instance ready with Ecs assistant, which means guestOs boots successfully. Premise is that the specified image image_id has built-in Ecs assistant. Most of the public images have assistant installed already.
dataDisks List<Property Map>

The list of data disks created with instance. See the following Block data_disks.

dedicatedHostId String

The ID of the dedicated host on which to create the instance. If the dedicated_host_id is specified, the spot_strategy and spot_price_limit are ignored. This is because preemptible instances cannot be created on dedicated hosts.

deletionProtection Boolean

Whether to enable release protection for the instance.

deploymentSetId String

The ID of the deployment set to which to deploy the instance.

description String

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

excludeInstanceFilter Property Map

The instances that need to be excluded from the Instance Set. See the following Block exclude_instance_filter.

hostName String

The hostname of instance.

hpcClusterId String

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

instanceChargeType String

The billing method of the instance. Valid values: PrePaid, PostPaid.

instanceName String

The name of the ECS. This instance_name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin with a hyphen, and must not begin with http:// or https://.

internetChargeType String

The Internet charge type of the instance. Valid values are PayByBandwidth, PayByTraffic.

internetMaxBandwidthOut Number

The Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value values: 1 to 100.

keyPairName String

The name of key pair that can login ECS instance successfully without password.

launchTemplateId String

The ID of the launch template.

launchTemplateName String

The name of the launch template. 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.

launchTemplateVersion String

The version of the launch template.

networkInterfaces List<Property Map>

A list of NetworkInterface. See the following Block network_interfaces.

password String

The 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.

passwordInherit Boolean

Whether to use the password preset in the image.

period Number

The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60.
  • When period_unit is Week, Valid values: 1, 2, 3.
periodUnit String

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

ramRoleName String

The Instance RAM role name.

resourceGroupId String

The ID of resource group which the instance belongs.

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.
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'.

  • 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
systemDiskAutoSnapshotPolicyId String

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

systemDiskCategory String

The category of the system disk. Valid values are cloud_efficiency, cloud_ssd, cloud_essd, cloud.

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://.

systemDiskName String

The name of the system disk.

systemDiskPerformanceLevel String

The performance level of the ESSD used as the system disk. Valid values: PL0, PL1, PL2, PL3.

systemDiskSize Number

The size of the system disk, measured in GiB. Value range: values: 20 to 500.

tags Map<String>

A mapping of tags to assign to the resource.

uniqueSuffix Boolean

Whether to automatically append incremental suffixes to the hostname specified by the HostName parameter and to the instance name specified by the InstanceName parameter when you batch create instances. The incremental suffixes can range from 001 to 999.

vswitchId String

The virtual switch ID to launch in VPC.

zoneId String

The ID of the zone in which to create the instance.

Outputs

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

Id string

The provider-assigned unique ID for this managed resource.

InstanceIds List<string>

A list of ECS Instance ID.

Id string

The provider-assigned unique ID for this managed resource.

InstanceIds []string

A list of ECS Instance ID.

id String

The provider-assigned unique ID for this managed resource.

instanceIds List<String>

A list of ECS Instance ID.

id string

The provider-assigned unique ID for this managed resource.

instanceIds string[]

A list of ECS Instance ID.

id str

The provider-assigned unique ID for this managed resource.

instance_ids Sequence[str]

A list of ECS Instance ID.

id String

The provider-assigned unique ID for this managed resource.

instanceIds List<String>

A list of ECS Instance ID.

Look up an Existing EcsInstanceSet Resource

Get an existing EcsInstanceSet 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?: EcsInstanceSetState, opts?: CustomResourceOptions): EcsInstanceSet
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        amount: Optional[int] = None,
        auto_release_time: Optional[str] = None,
        auto_renew: Optional[bool] = None,
        auto_renew_period: Optional[int] = None,
        boot_check_os_with_assistant: Optional[bool] = None,
        data_disks: Optional[Sequence[EcsInstanceSetDataDiskArgs]] = None,
        dedicated_host_id: Optional[str] = None,
        deletion_protection: Optional[bool] = None,
        deployment_set_id: Optional[str] = None,
        description: Optional[str] = None,
        exclude_instance_filter: Optional[EcsInstanceSetExcludeInstanceFilterArgs] = None,
        host_name: Optional[str] = None,
        hpc_cluster_id: Optional[str] = None,
        image_id: Optional[str] = None,
        instance_charge_type: Optional[str] = None,
        instance_ids: Optional[Sequence[str]] = None,
        instance_name: Optional[str] = None,
        instance_type: Optional[str] = None,
        internet_charge_type: Optional[str] = None,
        internet_max_bandwidth_out: Optional[int] = None,
        key_pair_name: Optional[str] = None,
        launch_template_id: Optional[str] = None,
        launch_template_name: Optional[str] = None,
        launch_template_version: Optional[str] = None,
        network_interfaces: Optional[Sequence[EcsInstanceSetNetworkInterfaceArgs]] = None,
        password: Optional[str] = None,
        password_inherit: Optional[bool] = None,
        period: Optional[int] = None,
        period_unit: Optional[str] = None,
        ram_role_name: Optional[str] = None,
        resource_group_id: Optional[str] = None,
        security_enhancement_strategy: Optional[str] = None,
        security_group_ids: Optional[Sequence[str]] = None,
        spot_price_limit: Optional[float] = None,
        spot_strategy: 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_name: Optional[str] = None,
        system_disk_performance_level: Optional[str] = None,
        system_disk_size: Optional[int] = None,
        tags: Optional[Mapping[str, str]] = None,
        unique_suffix: Optional[bool] = None,
        vswitch_id: Optional[str] = None,
        zone_id: Optional[str] = None) -> EcsInstanceSet
func GetEcsInstanceSet(ctx *Context, name string, id IDInput, state *EcsInstanceSetState, opts ...ResourceOption) (*EcsInstanceSet, error)
public static EcsInstanceSet Get(string name, Input<string> id, EcsInstanceSetState? state, CustomResourceOptions? opts = null)
public static EcsInstanceSet get(String name, Output<String> id, EcsInstanceSetState 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:
Amount int

The number of instances that you want to create. Valid values: 1 to 100.

AutoReleaseTime string

The automatic release time of the PostPaid instance.

AutoRenew bool

Whether to enable auto-renewal for the instance. This parameter is valid only when the instance_charge_type is set to PrePaid.

AutoRenewPeriod int

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 6, 12.
  • When period_unit is Week, Valid values: 1, 2, 3.
BootCheckOsWithAssistant bool

Indicate how to check instance ready to use.

  • false: Default value. Means that the instances are ready when their DescribeInstances status is Running, at which time guestOS(Ecs os) may not be ready yet.
  • true: Checking instance ready with Ecs assistant, which means guestOs boots successfully. Premise is that the specified image image_id has built-in Ecs assistant. Most of the public images have assistant installed already.
DataDisks List<Pulumi.AliCloud.Ecs.Inputs.EcsInstanceSetDataDiskArgs>

The list of data disks created with instance. See the following Block data_disks.

DedicatedHostId string

The ID of the dedicated host on which to create the instance. If the dedicated_host_id is specified, the spot_strategy and spot_price_limit are ignored. This is because preemptible instances cannot be created on dedicated hosts.

DeletionProtection bool

Whether to enable release protection for the instance.

DeploymentSetId string

The ID of the deployment set to which to deploy the instance.

Description string

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

ExcludeInstanceFilter Pulumi.AliCloud.Ecs.Inputs.EcsInstanceSetExcludeInstanceFilterArgs

The instances that need to be excluded from the Instance Set. See the following Block exclude_instance_filter.

HostName string

The hostname of instance.

HpcClusterId string

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

ImageId string

The Image to use for the instance.

InstanceChargeType string

The billing method of the instance. Valid values: PrePaid, PostPaid.

InstanceIds List<string>

A list of ECS Instance ID.

InstanceName string

The name of the ECS. This instance_name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin with a hyphen, and must not begin with http:// or https://.

InstanceType string

The type of instance to start.

InternetChargeType string

The Internet charge type of the instance. Valid values are PayByBandwidth, PayByTraffic.

InternetMaxBandwidthOut int

The Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value values: 1 to 100.

KeyPairName string

The name of key pair that can login ECS instance successfully without password.

LaunchTemplateId string

The ID of the launch template.

LaunchTemplateName string

The name of the launch template. 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.

LaunchTemplateVersion string

The version of the launch template.

NetworkInterfaces List<Pulumi.AliCloud.Ecs.Inputs.EcsInstanceSetNetworkInterfaceArgs>

A list of NetworkInterface. See the following Block network_interfaces.

Password string

The 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.

PasswordInherit bool

Whether to use the password preset in the image.

Period int

The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60.
  • When period_unit is Week, Valid values: 1, 2, 3.
PeriodUnit string

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

RamRoleName string

The Instance RAM role name.

ResourceGroupId string

The ID of resource group which the instance belongs.

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.
SecurityGroupIds List<string>

A list of security group ids to associate with.

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'.

  • 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
SystemDiskAutoSnapshotPolicyId string

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

SystemDiskCategory string

The category of the system disk. Valid values are cloud_efficiency, cloud_ssd, cloud_essd, cloud.

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://.

SystemDiskName string

The name of the system disk.

SystemDiskPerformanceLevel string

The performance level of the ESSD used as the system disk. Valid values: PL0, PL1, PL2, PL3.

SystemDiskSize int

The size of the system disk, measured in GiB. Value range: values: 20 to 500.

Tags Dictionary<string, string>

A mapping of tags to assign to the resource.

UniqueSuffix bool

Whether to automatically append incremental suffixes to the hostname specified by the HostName parameter and to the instance name specified by the InstanceName parameter when you batch create instances. The incremental suffixes can range from 001 to 999.

VswitchId string

The virtual switch ID to launch in VPC.

ZoneId string

The ID of the zone in which to create the instance.

Amount int

The number of instances that you want to create. Valid values: 1 to 100.

AutoReleaseTime string

The automatic release time of the PostPaid instance.

AutoRenew bool

Whether to enable auto-renewal for the instance. This parameter is valid only when the instance_charge_type is set to PrePaid.

AutoRenewPeriod int

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 6, 12.
  • When period_unit is Week, Valid values: 1, 2, 3.
BootCheckOsWithAssistant bool

Indicate how to check instance ready to use.

  • false: Default value. Means that the instances are ready when their DescribeInstances status is Running, at which time guestOS(Ecs os) may not be ready yet.
  • true: Checking instance ready with Ecs assistant, which means guestOs boots successfully. Premise is that the specified image image_id has built-in Ecs assistant. Most of the public images have assistant installed already.
DataDisks []EcsInstanceSetDataDiskArgs

The list of data disks created with instance. See the following Block data_disks.

DedicatedHostId string

The ID of the dedicated host on which to create the instance. If the dedicated_host_id is specified, the spot_strategy and spot_price_limit are ignored. This is because preemptible instances cannot be created on dedicated hosts.

DeletionProtection bool

Whether to enable release protection for the instance.

DeploymentSetId string

The ID of the deployment set to which to deploy the instance.

Description string

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

ExcludeInstanceFilter EcsInstanceSetExcludeInstanceFilterArgs

The instances that need to be excluded from the Instance Set. See the following Block exclude_instance_filter.

HostName string

The hostname of instance.

HpcClusterId string

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

ImageId string

The Image to use for the instance.

InstanceChargeType string

The billing method of the instance. Valid values: PrePaid, PostPaid.

InstanceIds []string

A list of ECS Instance ID.

InstanceName string

The name of the ECS. This instance_name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin with a hyphen, and must not begin with http:// or https://.

InstanceType string

The type of instance to start.

InternetChargeType string

The Internet charge type of the instance. Valid values are PayByBandwidth, PayByTraffic.

InternetMaxBandwidthOut int

The Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value values: 1 to 100.

KeyPairName string

The name of key pair that can login ECS instance successfully without password.

LaunchTemplateId string

The ID of the launch template.

LaunchTemplateName string

The name of the launch template. 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.

LaunchTemplateVersion string

The version of the launch template.

NetworkInterfaces []EcsInstanceSetNetworkInterfaceArgs

A list of NetworkInterface. See the following Block network_interfaces.

Password string

The 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.

PasswordInherit bool

Whether to use the password preset in the image.

Period int

The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60.
  • When period_unit is Week, Valid values: 1, 2, 3.
PeriodUnit string

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

RamRoleName string

The Instance RAM role name.

ResourceGroupId string

The ID of resource group which the instance belongs.

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.
SecurityGroupIds []string

A list of security group ids to associate with.

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'.

  • 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
SystemDiskAutoSnapshotPolicyId string

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

SystemDiskCategory string

The category of the system disk. Valid values are cloud_efficiency, cloud_ssd, cloud_essd, cloud.

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://.

SystemDiskName string

The name of the system disk.

SystemDiskPerformanceLevel string

The performance level of the ESSD used as the system disk. Valid values: PL0, PL1, PL2, PL3.

SystemDiskSize int

The size of the system disk, measured in GiB. Value range: values: 20 to 500.

Tags map[string]string

A mapping of tags to assign to the resource.

UniqueSuffix bool

Whether to automatically append incremental suffixes to the hostname specified by the HostName parameter and to the instance name specified by the InstanceName parameter when you batch create instances. The incremental suffixes can range from 001 to 999.

VswitchId string

The virtual switch ID to launch in VPC.

ZoneId string

The ID of the zone in which to create the instance.

amount Integer

The number of instances that you want to create. Valid values: 1 to 100.

autoReleaseTime String

The automatic release time of the PostPaid instance.

autoRenew Boolean

Whether to enable auto-renewal for the instance. This parameter is valid only when the instance_charge_type is set to PrePaid.

autoRenewPeriod Integer

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 6, 12.
  • When period_unit is Week, Valid values: 1, 2, 3.
bootCheckOsWithAssistant Boolean

Indicate how to check instance ready to use.

  • false: Default value. Means that the instances are ready when their DescribeInstances status is Running, at which time guestOS(Ecs os) may not be ready yet.
  • true: Checking instance ready with Ecs assistant, which means guestOs boots successfully. Premise is that the specified image image_id has built-in Ecs assistant. Most of the public images have assistant installed already.
dataDisks List<EcsInstanceSetDataDiskArgs>

The list of data disks created with instance. See the following Block data_disks.

dedicatedHostId String

The ID of the dedicated host on which to create the instance. If the dedicated_host_id is specified, the spot_strategy and spot_price_limit are ignored. This is because preemptible instances cannot be created on dedicated hosts.

deletionProtection Boolean

Whether to enable release protection for the instance.

deploymentSetId String

The ID of the deployment set to which to deploy the instance.

description String

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

excludeInstanceFilter EcsInstanceSetExcludeInstanceFilterArgs

The instances that need to be excluded from the Instance Set. See the following Block exclude_instance_filter.

hostName String

The hostname of instance.

hpcClusterId String

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

imageId String

The Image to use for the instance.

instanceChargeType String

The billing method of the instance. Valid values: PrePaid, PostPaid.

instanceIds List<String>

A list of ECS Instance ID.

instanceName String

The name of the ECS. This instance_name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin with a hyphen, and must not begin with http:// or https://.

instanceType String

The type of instance to start.

internetChargeType String

The Internet charge type of the instance. Valid values are PayByBandwidth, PayByTraffic.

internetMaxBandwidthOut Integer

The Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value values: 1 to 100.

keyPairName String

The name of key pair that can login ECS instance successfully without password.

launchTemplateId String

The ID of the launch template.

launchTemplateName String

The name of the launch template. 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.

launchTemplateVersion String

The version of the launch template.

networkInterfaces List<EcsInstanceSetNetworkInterfaceArgs>

A list of NetworkInterface. See the following Block network_interfaces.

password String

The 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.

passwordInherit Boolean

Whether to use the password preset in the image.

period Integer

The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60.
  • When period_unit is Week, Valid values: 1, 2, 3.
periodUnit String

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

ramRoleName String

The Instance RAM role name.

resourceGroupId String

The ID of resource group which the instance belongs.

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.
securityGroupIds List<String>

A list of security group ids to associate with.

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'.

  • 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
systemDiskAutoSnapshotPolicyId String

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

systemDiskCategory String

The category of the system disk. Valid values are cloud_efficiency, cloud_ssd, cloud_essd, cloud.

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://.

systemDiskName String

The name of the system disk.

systemDiskPerformanceLevel String

The performance level of the ESSD used as the system disk. Valid values: PL0, PL1, PL2, PL3.

systemDiskSize Integer

The size of the system disk, measured in GiB. Value range: values: 20 to 500.

tags Map<String,String>

A mapping of tags to assign to the resource.

uniqueSuffix Boolean

Whether to automatically append incremental suffixes to the hostname specified by the HostName parameter and to the instance name specified by the InstanceName parameter when you batch create instances. The incremental suffixes can range from 001 to 999.

vswitchId String

The virtual switch ID to launch in VPC.

zoneId String

The ID of the zone in which to create the instance.

amount number

The number of instances that you want to create. Valid values: 1 to 100.

autoReleaseTime string

The automatic release time of the PostPaid instance.

autoRenew boolean

Whether to enable auto-renewal for the instance. This parameter is valid only when the instance_charge_type is set to PrePaid.

autoRenewPeriod number

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 6, 12.
  • When period_unit is Week, Valid values: 1, 2, 3.
bootCheckOsWithAssistant boolean

Indicate how to check instance ready to use.

  • false: Default value. Means that the instances are ready when their DescribeInstances status is Running, at which time guestOS(Ecs os) may not be ready yet.
  • true: Checking instance ready with Ecs assistant, which means guestOs boots successfully. Premise is that the specified image image_id has built-in Ecs assistant. Most of the public images have assistant installed already.
dataDisks EcsInstanceSetDataDiskArgs[]

The list of data disks created with instance. See the following Block data_disks.

dedicatedHostId string

The ID of the dedicated host on which to create the instance. If the dedicated_host_id is specified, the spot_strategy and spot_price_limit are ignored. This is because preemptible instances cannot be created on dedicated hosts.

deletionProtection boolean

Whether to enable release protection for the instance.

deploymentSetId string

The ID of the deployment set to which to deploy the instance.

description string

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

excludeInstanceFilter EcsInstanceSetExcludeInstanceFilterArgs

The instances that need to be excluded from the Instance Set. See the following Block exclude_instance_filter.

hostName string

The hostname of instance.

hpcClusterId string

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

imageId string

The Image to use for the instance.

instanceChargeType string

The billing method of the instance. Valid values: PrePaid, PostPaid.

instanceIds string[]

A list of ECS Instance ID.

instanceName string

The name of the ECS. This instance_name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin with a hyphen, and must not begin with http:// or https://.

instanceType string

The type of instance to start.

internetChargeType string

The Internet charge type of the instance. Valid values are PayByBandwidth, PayByTraffic.

internetMaxBandwidthOut number

The Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value values: 1 to 100.

keyPairName string

The name of key pair that can login ECS instance successfully without password.

launchTemplateId string

The ID of the launch template.

launchTemplateName string

The name of the launch template. 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.

launchTemplateVersion string

The version of the launch template.

networkInterfaces EcsInstanceSetNetworkInterfaceArgs[]

A list of NetworkInterface. See the following Block network_interfaces.

password string

The 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.

passwordInherit boolean

Whether to use the password preset in the image.

period number

The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60.
  • When period_unit is Week, Valid values: 1, 2, 3.
periodUnit string

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

ramRoleName string

The Instance RAM role name.

resourceGroupId string

The ID of resource group which the instance belongs.

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.
securityGroupIds string[]

A list of security group ids to associate with.

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'.

  • 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
systemDiskAutoSnapshotPolicyId string

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

systemDiskCategory string

The category of the system disk. Valid values are cloud_efficiency, cloud_ssd, cloud_essd, cloud.

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://.

systemDiskName string

The name of the system disk.

systemDiskPerformanceLevel string

The performance level of the ESSD used as the system disk. Valid values: PL0, PL1, PL2, PL3.

systemDiskSize number

The size of the system disk, measured in GiB. Value range: values: 20 to 500.

tags {[key: string]: string}

A mapping of tags to assign to the resource.

uniqueSuffix boolean

Whether to automatically append incremental suffixes to the hostname specified by the HostName parameter and to the instance name specified by the InstanceName parameter when you batch create instances. The incremental suffixes can range from 001 to 999.

vswitchId string

The virtual switch ID to launch in VPC.

zoneId string

The ID of the zone in which to create the instance.

amount int

The number of instances that you want to create. Valid values: 1 to 100.

auto_release_time str

The automatic release time of the PostPaid instance.

auto_renew bool

Whether to enable auto-renewal for the instance. This parameter is valid only when the instance_charge_type is set to PrePaid.

auto_renew_period int

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 6, 12.
  • When period_unit is Week, Valid values: 1, 2, 3.
boot_check_os_with_assistant bool

Indicate how to check instance ready to use.

  • false: Default value. Means that the instances are ready when their DescribeInstances status is Running, at which time guestOS(Ecs os) may not be ready yet.
  • true: Checking instance ready with Ecs assistant, which means guestOs boots successfully. Premise is that the specified image image_id has built-in Ecs assistant. Most of the public images have assistant installed already.
data_disks Sequence[EcsInstanceSetDataDiskArgs]

The list of data disks created with instance. See the following Block data_disks.

dedicated_host_id str

The ID of the dedicated host on which to create the instance. If the dedicated_host_id is specified, the spot_strategy and spot_price_limit are ignored. This is because preemptible instances cannot be created on dedicated hosts.

deletion_protection bool

Whether to enable release protection for the instance.

deployment_set_id str

The ID of the deployment set to which to deploy the instance.

description str

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

exclude_instance_filter EcsInstanceSetExcludeInstanceFilterArgs

The instances that need to be excluded from the Instance Set. See the following Block exclude_instance_filter.

host_name str

The hostname of instance.

hpc_cluster_id str

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

image_id str

The Image to use for the instance.

instance_charge_type str

The billing method of the instance. Valid values: PrePaid, PostPaid.

instance_ids Sequence[str]

A list of ECS Instance ID.

instance_name str

The name of the ECS. This instance_name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin with a hyphen, and must not begin with http:// or https://.

instance_type str

The type of instance to start.

internet_charge_type str

The Internet charge type of the instance. Valid values are PayByBandwidth, PayByTraffic.

internet_max_bandwidth_out int

The Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value values: 1 to 100.

key_pair_name str

The name of key pair that can login ECS instance successfully without password.

launch_template_id str

The ID of the launch template.

launch_template_name str

The name of the launch template. 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.

launch_template_version str

The version of the launch template.

network_interfaces Sequence[EcsInstanceSetNetworkInterfaceArgs]

A list of NetworkInterface. See the following Block network_interfaces.

password str

The 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.

password_inherit bool

Whether to use the password preset in the image.

period int

The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60.
  • When period_unit is Week, Valid values: 1, 2, 3.
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.

ram_role_name str

The Instance RAM role name.

resource_group_id str

The ID of resource group which the instance belongs.

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_group_ids Sequence[str]

A list of security group ids to associate with.

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'.

  • 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
system_disk_auto_snapshot_policy_id str

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

system_disk_category str

The category of the system disk. Valid values are cloud_efficiency, cloud_ssd, cloud_essd, cloud.

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_name str

The name of the system disk.

system_disk_performance_level str

The performance level of the ESSD used as the system disk. Valid values: PL0, PL1, PL2, PL3.

system_disk_size int

The size of the system disk, measured in GiB. Value range: values: 20 to 500.

tags Mapping[str, str]

A mapping of tags to assign to the resource.

unique_suffix bool

Whether to automatically append incremental suffixes to the hostname specified by the HostName parameter and to the instance name specified by the InstanceName parameter when you batch create instances. The incremental suffixes can range from 001 to 999.

vswitch_id str

The virtual switch ID to launch in VPC.

zone_id str

The ID of the zone in which to create the instance.

amount Number

The number of instances that you want to create. Valid values: 1 to 100.

autoReleaseTime String

The automatic release time of the PostPaid instance.

autoRenew Boolean

Whether to enable auto-renewal for the instance. This parameter is valid only when the instance_charge_type is set to PrePaid.

autoRenewPeriod Number

Auto renewal period of an instance, in the unit of month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 6, 12.
  • When period_unit is Week, Valid values: 1, 2, 3.
bootCheckOsWithAssistant Boolean

Indicate how to check instance ready to use.

  • false: Default value. Means that the instances are ready when their DescribeInstances status is Running, at which time guestOS(Ecs os) may not be ready yet.
  • true: Checking instance ready with Ecs assistant, which means guestOs boots successfully. Premise is that the specified image image_id has built-in Ecs assistant. Most of the public images have assistant installed already.
dataDisks List<Property Map>

The list of data disks created with instance. See the following Block data_disks.

dedicatedHostId String

The ID of the dedicated host on which to create the instance. If the dedicated_host_id is specified, the spot_strategy and spot_price_limit are ignored. This is because preemptible instances cannot be created on dedicated hosts.

deletionProtection Boolean

Whether to enable release protection for the instance.

deploymentSetId String

The ID of the deployment set to which to deploy the instance.

description String

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

excludeInstanceFilter Property Map

The instances that need to be excluded from the Instance Set. See the following Block exclude_instance_filter.

hostName String

The hostname of instance.

hpcClusterId String

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

imageId String

The Image to use for the instance.

instanceChargeType String

The billing method of the instance. Valid values: PrePaid, PostPaid.

instanceIds List<String>

A list of ECS Instance ID.

instanceName String

The name of the ECS. This instance_name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin with a hyphen, and must not begin with http:// or https://.

instanceType String

The type of instance to start.

internetChargeType String

The Internet charge type of the instance. Valid values are PayByBandwidth, PayByTraffic.

internetMaxBandwidthOut Number

The Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value values: 1 to 100.

keyPairName String

The name of key pair that can login ECS instance successfully without password.

launchTemplateId String

The ID of the launch template.

launchTemplateName String

The name of the launch template. 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.

launchTemplateVersion String

The version of the launch template.

networkInterfaces List<Property Map>

A list of NetworkInterface. See the following Block network_interfaces.

password String

The 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.

passwordInherit Boolean

Whether to use the password preset in the image.

period Number

The duration that you will buy the resource, in month. It is valid when instance_charge_type is PrePaid.

  • When period_unit is Month, Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60.
  • When period_unit is Week, Valid values: 1, 2, 3.
periodUnit String

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

ramRoleName String

The Instance RAM role name.

resourceGroupId String

The ID of resource group which the instance belongs.

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.
securityGroupIds List<String>

A list of security group ids to associate with.

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'.

  • 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
systemDiskAutoSnapshotPolicyId String

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

systemDiskCategory String

The category of the system disk. Valid values are cloud_efficiency, cloud_ssd, cloud_essd, cloud.

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://.

systemDiskName String

The name of the system disk.

systemDiskPerformanceLevel String

The performance level of the ESSD used as the system disk. Valid values: PL0, PL1, PL2, PL3.

systemDiskSize Number

The size of the system disk, measured in GiB. Value range: values: 20 to 500.

tags Map<String>

A mapping of tags to assign to the resource.

uniqueSuffix Boolean

Whether to automatically append incremental suffixes to the hostname specified by the HostName parameter and to the instance name specified by the InstanceName parameter when you batch create instances. The incremental suffixes can range from 001 to 999.

vswitchId String

The virtual switch ID to launch in VPC.

zoneId String

The ID of the zone in which to create the instance.

Supporting Types

EcsInstanceSetDataDisk

DiskSize int

The size of the data disk. Unit: GiB.

  • When disk_category is cloud_efficiency, Valid values: 20 to 32768.
  • When disk_category is cloud_ssd, Valid values: 20 to 32768.
  • When disk_category is cloud_essd, Valid values: 20 to 32768.
  • When disk_category is cloud, Valid values: 5 to 200.
AutoSnapshotPolicyId string

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

DiskCategory string

The category of the disk. Valid values: cloud_efficiency, cloud_ssd, cloud_essd, cloud.

DiskDescription string

The description of the data disk.

DiskName string

The name of the data disk.

Encrypted bool
KmsKeyId string

The KMS key ID corresponding to the data disk.

PerformanceLevel string

The performance level of the ESSD used as data disk. Valid values: PL0, PL1, PL2, PL3.

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.

DiskSize int

The size of the data disk. Unit: GiB.

  • When disk_category is cloud_efficiency, Valid values: 20 to 32768.
  • When disk_category is cloud_ssd, Valid values: 20 to 32768.
  • When disk_category is cloud_essd, Valid values: 20 to 32768.
  • When disk_category is cloud, Valid values: 5 to 200.
AutoSnapshotPolicyId string

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

DiskCategory string

The category of the disk. Valid values: cloud_efficiency, cloud_ssd, cloud_essd, cloud.

DiskDescription string

The description of the data disk.

DiskName string

The name of the data disk.

Encrypted bool
KmsKeyId string

The KMS key ID corresponding to the data disk.

PerformanceLevel string

The performance level of the ESSD used as data disk. Valid values: PL0, PL1, PL2, PL3.

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.

diskSize Integer

The size of the data disk. Unit: GiB.

  • When disk_category is cloud_efficiency, Valid values: 20 to 32768.
  • When disk_category is cloud_ssd, Valid values: 20 to 32768.
  • When disk_category is cloud_essd, Valid values: 20 to 32768.
  • When disk_category is cloud, Valid values: 5 to 200.
autoSnapshotPolicyId String

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

diskCategory String

The category of the disk. Valid values: cloud_efficiency, cloud_ssd, cloud_essd, cloud.

diskDescription String

The description of the data disk.

diskName String

The name of the data disk.

encrypted Boolean
kmsKeyId String

The KMS key ID corresponding to the data disk.

performanceLevel String

The performance level of the ESSD used as data disk. Valid values: PL0, PL1, PL2, PL3.

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.

diskSize number

The size of the data disk. Unit: GiB.

  • When disk_category is cloud_efficiency, Valid values: 20 to 32768.
  • When disk_category is cloud_ssd, Valid values: 20 to 32768.
  • When disk_category is cloud_essd, Valid values: 20 to 32768.
  • When disk_category is cloud, Valid values: 5 to 200.
autoSnapshotPolicyId string

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

diskCategory string

The category of the disk. Valid values: cloud_efficiency, cloud_ssd, cloud_essd, cloud.

diskDescription string

The description of the data disk.

diskName string

The name of the data disk.

encrypted boolean
kmsKeyId string

The KMS key ID corresponding to the data disk.

performanceLevel string

The performance level of the ESSD used as data disk. Valid values: PL0, PL1, PL2, PL3.

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.

disk_size int

The size of the data disk. Unit: GiB.

  • When disk_category is cloud_efficiency, Valid values: 20 to 32768.
  • When disk_category is cloud_ssd, Valid values: 20 to 32768.
  • When disk_category is cloud_essd, Valid values: 20 to 32768.
  • When disk_category is cloud, Valid values: 5 to 200.
auto_snapshot_policy_id str

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

disk_category str

The category of the disk. Valid values: cloud_efficiency, cloud_ssd, cloud_essd, cloud.

disk_description str

The description of the data disk.

disk_name str

The name of the data disk.

encrypted bool
kms_key_id str

The KMS key ID corresponding to the data disk.

performance_level str

The performance level of the ESSD used as data disk. Valid values: PL0, PL1, PL2, PL3.

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.

diskSize Number

The size of the data disk. Unit: GiB.

  • When disk_category is cloud_efficiency, Valid values: 20 to 32768.
  • When disk_category is cloud_ssd, Valid values: 20 to 32768.
  • When disk_category is cloud_essd, Valid values: 20 to 32768.
  • When disk_category is cloud, Valid values: 5 to 200.
autoSnapshotPolicyId String

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

diskCategory String

The category of the disk. Valid values: cloud_efficiency, cloud_ssd, cloud_essd, cloud.

diskDescription String

The description of the data disk.

diskName String

The name of the data disk.

encrypted Boolean
kmsKeyId String

The KMS key ID corresponding to the data disk.

performanceLevel String

The performance level of the ESSD used as data disk. Valid values: PL0, PL1, PL2, PL3.

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.

EcsInstanceSetExcludeInstanceFilter

Key string

The type of the excluded. Valid values: InstanceId, InstanceName.

Values List<string>

The value of the excluded. The identification of the excluded instances. It is a list of instance Ids or names.

Key string

The type of the excluded. Valid values: InstanceId, InstanceName.

Values []string

The value of the excluded. The identification of the excluded instances. It is a list of instance Ids or names.

key String

The type of the excluded. Valid values: InstanceId, InstanceName.

values List<String>

The value of the excluded. The identification of the excluded instances. It is a list of instance Ids or names.

key string

The type of the excluded. Valid values: InstanceId, InstanceName.

values string[]

The value of the excluded. The identification of the excluded instances. It is a list of instance Ids or names.

key str

The type of the excluded. Valid values: InstanceId, InstanceName.

values Sequence[str]

The value of the excluded. The identification of the excluded instances. It is a list of instance Ids or names.

key String

The type of the excluded. Valid values: InstanceId, InstanceName.

values List<String>

The value of the excluded. The identification of the excluded instances. It is a list of instance Ids or names.

EcsInstanceSetNetworkInterface

SecurityGroupId string

-(Required, ForceNew) The ID of the security group to which to assign secondary ENI.

Description string

The description of ENI.

NetworkInterfaceName string

The name of ENI.

PrimaryIpAddress string

The primary private IP address of ENI.

VswitchId string

The ID of the vSwitch to which to connect ENI.

SecurityGroupId string

-(Required, ForceNew) The ID of the security group to which to assign secondary ENI.

Description string

The description of ENI.

NetworkInterfaceName string

The name of ENI.

PrimaryIpAddress string

The primary private IP address of ENI.

VswitchId string

The ID of the vSwitch to which to connect ENI.

securityGroupId String

-(Required, ForceNew) The ID of the security group to which to assign secondary ENI.

description String

The description of ENI.

networkInterfaceName String

The name of ENI.

primaryIpAddress String

The primary private IP address of ENI.

vswitchId String

The ID of the vSwitch to which to connect ENI.

securityGroupId string

-(Required, ForceNew) The ID of the security group to which to assign secondary ENI.

description string

The description of ENI.

networkInterfaceName string

The name of ENI.

primaryIpAddress string

The primary private IP address of ENI.

vswitchId string

The ID of the vSwitch to which to connect ENI.

security_group_id str

-(Required, ForceNew) The ID of the security group to which to assign secondary ENI.

description str

The description of ENI.

network_interface_name str

The name of ENI.

primary_ip_address str

The primary private IP address of ENI.

vswitch_id str

The ID of the vSwitch to which to connect ENI.

securityGroupId String

-(Required, ForceNew) The ID of the security group to which to assign secondary ENI.

description String

The description of ENI.

networkInterfaceName String

The name of ENI.

primaryIpAddress String

The primary private IP address of ENI.

vswitchId String

The ID of the vSwitch to which to connect ENI.

Package Details

Repository
https://github.com/pulumi/pulumi-alicloud
License
Apache-2.0
Notes

This Pulumi package is based on the alicloud Terraform Provider.