Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Tencentcloud Provider
  3. API Docs
  4. InstanceSet
tencentcloud 1.81.189 published on Wednesday, Apr 30, 2025 by tencentcloudstack
tencentcloudstack/terraform-provider-tencentcloud

tencentcloud.InstanceSet

Explore with Pulumi AI

tencentcloud logo
tencentcloud 1.81.189 published on Wednesday, Apr 30, 2025 by tencentcloudstack
tencentcloudstack/terraform-provider-tencentcloud

    Provides a CVM instance set resource.

    NOTE: You can launch an CVM instance for a VPC network via specifying parameter vpc_id. One instance can only belong to one VPC.

    NOTE: This resource is designed to cater for the scenario of creating CVM in large batches.

    NOTE: After run command pulumi up, must wait all cvms is ready, then run command pulumi preview, either it will cause state change.

    Example Usage

    Coming soon!

    Coming soon!

    Coming soon!

    Coming soon!

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.tencentcloud.TencentcloudFunctions;
import com.pulumi.tencentcloud.inputs.GetImagesArgs;
import com.pulumi.tencentcloud.inputs.GetInstanceTypesArgs;
import com.pulumi.tencentcloud.inputs.GetAvailabilityZonesArgs;
import com.pulumi.tencentcloud.Vpc;
import com.pulumi.tencentcloud.VpcArgs;
import com.pulumi.tencentcloud.Subnet;
import com.pulumi.tencentcloud.SubnetArgs;
import com.pulumi.tencentcloud.InstanceSet;
import com.pulumi.tencentcloud.InstanceSetArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var myFavoriteImage = TencentcloudFunctions.getImages(GetImagesArgs.builder()
            .imageTypes("PUBLIC_IMAGE")
            .osName("Tencent Linux release 3.2 (Final)")
            .build());

        final var myFavoriteInstanceTypes = TencentcloudFunctions.getInstanceTypes(GetInstanceTypesArgs.builder()
            .filters(GetInstanceTypesFilterArgs.builder()
                .name("instance-family")
                .values("S3")
                .build())
            .cpuCoreCount(1)
            .memorySize(1)
            .build());

        final var myFavoriteZones = TencentcloudFunctions.getAvailabilityZones();

        // Create VPC resource
        var appVpc = new Vpc("appVpc", VpcArgs.builder()
            .cidrBlock("10.0.0.0/16")
            .build());

        var appSubnet = new Subnet("appSubnet", SubnetArgs.builder()
            .vpcId(appVpc.vpcId())
            .availabilityZone(myFavoriteZones.applyValue(getAvailabilityZonesResult -> getAvailabilityZonesResult.zones()[0].name()))
            .cidrBlock("10.0.1.0/24")
            .build());

        // Create 10 CVM instances to host awesome_app
        var myAwesomeApp = new InstanceSet("myAwesomeApp", InstanceSetArgs.builder()
            .timeouts(InstanceSetTimeoutsArgs.builder()
                .create("5m")
                .read("20s")
                .delete("1h")
                .build())
            .instanceCount(10)
            .instanceName("awesome_app")
            .availabilityZone(myFavoriteZones.applyValue(getAvailabilityZonesResult -> getAvailabilityZonesResult.zones()[0].name()))
            .imageId(myFavoriteImage.applyValue(getImagesResult -> getImagesResult.images()[0].imageId()))
            .instanceType(myFavoriteInstanceTypes.applyValue(getInstanceTypesResult -> getInstanceTypesResult.instanceTypes()[0].instanceType()))
            .systemDiskType("CLOUD_PREMIUM")
            .systemDiskSize(50)
            .hostname("user")
            .projectId(0)
            .vpcId(appVpc.vpcId())
            .subnetId(appSubnet.subnetId())
            .build());

    }
}

    resources:
  # Create VPC resource
  appVpc:
    type: tencentcloud:Vpc
    properties:
      cidrBlock: 10.0.0.0/16
  appSubnet:
    type: tencentcloud:Subnet
    properties:
      vpcId: ${appVpc.vpcId}
      availabilityZone: ${myFavoriteZones.zones[0].name}
      cidrBlock: 10.0.1.0/24
  # Create 10 CVM instances to host awesome_app
  myAwesomeApp:
    type: tencentcloud:InstanceSet
    properties:
      timeouts:
        - create: 5m
          read: 20s
          delete: 1h
      instanceCount: 10
      instanceName: awesome_app
      availabilityZone: ${myFavoriteZones.zones[0].name}
      imageId: ${myFavoriteImage.images[0].imageId}
      instanceType: ${myFavoriteInstanceTypes.instanceTypes[0].instanceType}
      systemDiskType: CLOUD_PREMIUM
      systemDiskSize: 50
      hostname: user
      projectId: 0
      vpcId: ${appVpc.vpcId}
      subnetId: ${appSubnet.subnetId}
variables:
  myFavoriteImage:
    fn::invoke:
      function: tencentcloud:getImages
      arguments:
        imageTypes:
          - PUBLIC_IMAGE
        osName: Tencent Linux release 3.2 (Final)
  myFavoriteInstanceTypes:
    fn::invoke:
      function: tencentcloud:getInstanceTypes
      arguments:
        filters:
          - name: instance-family
            values:
              - S3
        cpuCoreCount: 1
        memorySize: 1
  myFavoriteZones:
    fn::invoke:
      function: tencentcloud:getAvailabilityZones
      arguments: {}

    Create InstanceSet Resource

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

    Constructor syntax

    new InstanceSet(name: string, args: InstanceSetArgs, opts?: CustomResourceOptions);
    @overload
def InstanceSet(resource_name: str,
                args: InstanceSetArgs,
                opts: Optional[ResourceOptions] = None)

@overload
def InstanceSet(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                image_id: Optional[str] = None,
                availability_zone: Optional[str] = None,
                internet_charge_type: Optional[str] = None,
                project_id: Optional[float] = None,
                disable_monitor_service: Optional[bool] = None,
                disable_security_service: Optional[bool] = None,
                exclude_instance_ids: Optional[Sequence[str]] = None,
                hostname: Optional[str] = None,
                bandwidth_package_id: Optional[str] = None,
                instance_charge_type: Optional[str] = None,
                instance_count: Optional[float] = None,
                instance_name: Optional[str] = None,
                instance_set_id: Optional[str] = None,
                instance_type: Optional[str] = None,
                allocate_public_ip: Optional[bool] = None,
                internet_max_bandwidth_out: Optional[float] = None,
                cam_role_name: Optional[str] = None,
                password: Optional[str] = None,
                keep_image_login: Optional[bool] = None,
                placement_group_id: Optional[str] = None,
                private_ip: Optional[str] = None,
                key_name: Optional[str] = None,
                security_groups: Optional[Sequence[str]] = None,
                subnet_id: Optional[str] = None,
                system_disk_id: Optional[str] = None,
                system_disk_size: Optional[float] = None,
                system_disk_type: Optional[str] = None,
                timeouts: Optional[InstanceSetTimeoutsArgs] = None,
                user_data: Optional[str] = None,
                user_data_raw: Optional[str] = None,
                vpc_id: Optional[str] = None)
    func NewInstanceSet(ctx *Context, name string, args InstanceSetArgs, opts ...ResourceOption) (*InstanceSet, error)
    public InstanceSet(string name, InstanceSetArgs args, CustomResourceOptions? opts = null)
    public InstanceSet(String name, InstanceSetArgs args)
public InstanceSet(String name, InstanceSetArgs args, CustomResourceOptions options)

    type: tencentcloud:InstanceSet
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

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

    InstanceSet Resource Properties

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

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The InstanceSet resource accepts the following input properties:

    AvailabilityZone string
    The available zone for the CVM instance.
    ImageId string
    The image to use for the instance. Changing image_id will cause the instance reset.
    AllocatePublicIp bool
    Associate a public IP address with an instance in a VPC or Classic. Boolean value, Default is false.
    BandwidthPackageId string
    bandwidth package id. if user is standard user, then the bandwidth_package_id is needed, or default has bandwidth_package_id.
    CamRoleName string
    CAM role name authorized to access.
    DisableMonitorService bool
    Disable enhance service for monitor, it is enabled by default. When this options is set, monitor agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    DisableSecurityService bool
    Disable enhance service for security, it is enabled by default. When this options is set, security agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    ExcludeInstanceIds List<string>
    instance ids list to exclude.
    Hostname string
    The hostname of the instance. Windows instance: The name should be a combination of 2 to 15 characters comprised of letters (case insensitive), numbers, and hyphens (-). Period (.) is not supported, and the name cannot be a string of pure numbers. Other types (such as Linux) of instances: The name should be a combination of 2 to 60 characters, supporting multiple periods (.). The piece between two periods is composed of letters (case insensitive), numbers, and hyphens (-). Modifications may lead to the reinstallation of the instance's operating system..
    InstanceChargeType string
    The charge type of instance. Only support POSTPAID_BY_HOUR.
    InstanceCount double
    The number of instances to be purchased. Value range:[1,100]; default value: 1.
    InstanceName string
    InstanceSetId string
    ID of the resource.
    InstanceType string
    The type of the instance.
    InternetChargeType string
    Internet charge type of the instance, Valid values are BANDWIDTH_PREPAID, TRAFFIC_POSTPAID_BY_HOUR, BANDWIDTH_POSTPAID_BY_HOUR and BANDWIDTH_PACKAGE. This value does not need to be set when allocate_public_ip is false.
    InternetMaxBandwidthOut double
    Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bits per second). This value does not need to be set when allocate_public_ip is false.
    KeepImageLogin bool
    Whether to keep image login or not, default is false. When the image type is private or shared or imported, this parameter can be set true. Modifications may lead to the reinstallation of the instance's operating system.
    KeyName string
    The key pair to use for the instance, it looks like skey-16jig7tx. Modifications may lead to the reinstallation of the instance's operating system.
    Password string
    Password for the instance. In order for the new password to take effect, the instance will be restarted after the password change. Modifications may lead to the reinstallation of the instance's operating system.
    PlacementGroupId string
    The ID of a placement group.
    PrivateIp string
    The private IP to be assigned to this instance, must be in the provided subnet and available.
    ProjectId double
    The project the instance belongs to, default to 0.
    SecurityGroups List<string>
    A list of security group IDs to associate with.
    SubnetId string
    The ID of a VPC subnet. If you want to create instances in a VPC network, this parameter must be set.
    SystemDiskId string
    System disk snapshot ID used to initialize the system disk. When system disk type is LOCAL_BASIC and LOCAL_SSD, disk id is not supported.
    SystemDiskSize double
    Size of the system disk. Valid value ranges: (50~1000). and unit is GB. Default is 50GB. If modified, the instance may force stop.
    SystemDiskType string
    System disk type. For more information on limits of system disk types, see Storage Overview. Valid values: LOCAL_BASIC: local disk, LOCAL_SSD: local SSD disk, CLOUD_SSD: SSD, CLOUD_PREMIUM: Premium Cloud Storage, CLOUD_BSSD: Basic SSD. NOTE: If modified, the instance may force stop.
    Timeouts InstanceSetTimeouts
    UserData string
    The user data to be injected into this instance. Must be base64 encoded and up to 16 KB.
    UserDataRaw string
    The user data to be injected into this instance, in plain text. Conflicts with user_data. Up to 16 KB after base64 encoded.
    VpcId string
    The ID of a VPC network. If you want to create instances in a VPC network, this parameter must be set.
    AvailabilityZone string
    The available zone for the CVM instance.
    ImageId string
    The image to use for the instance. Changing image_id will cause the instance reset.
    AllocatePublicIp bool
    Associate a public IP address with an instance in a VPC or Classic. Boolean value, Default is false.
    BandwidthPackageId string
    bandwidth package id. if user is standard user, then the bandwidth_package_id is needed, or default has bandwidth_package_id.
    CamRoleName string
    CAM role name authorized to access.
    DisableMonitorService bool
    Disable enhance service for monitor, it is enabled by default. When this options is set, monitor agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    DisableSecurityService bool
    Disable enhance service for security, it is enabled by default. When this options is set, security agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    ExcludeInstanceIds []string
    instance ids list to exclude.
    Hostname string
    The hostname of the instance. Windows instance: The name should be a combination of 2 to 15 characters comprised of letters (case insensitive), numbers, and hyphens (-). Period (.) is not supported, and the name cannot be a string of pure numbers. Other types (such as Linux) of instances: The name should be a combination of 2 to 60 characters, supporting multiple periods (.). The piece between two periods is composed of letters (case insensitive), numbers, and hyphens (-). Modifications may lead to the reinstallation of the instance's operating system..
    InstanceChargeType string
    The charge type of instance. Only support POSTPAID_BY_HOUR.
    InstanceCount float64
    The number of instances to be purchased. Value range:[1,100]; default value: 1.
    InstanceName string
    InstanceSetId string
    ID of the resource.
    InstanceType string
    The type of the instance.
    InternetChargeType string
    Internet charge type of the instance, Valid values are BANDWIDTH_PREPAID, TRAFFIC_POSTPAID_BY_HOUR, BANDWIDTH_POSTPAID_BY_HOUR and BANDWIDTH_PACKAGE. This value does not need to be set when allocate_public_ip is false.
    InternetMaxBandwidthOut float64
    Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bits per second). This value does not need to be set when allocate_public_ip is false.
    KeepImageLogin bool
    Whether to keep image login or not, default is false. When the image type is private or shared or imported, this parameter can be set true. Modifications may lead to the reinstallation of the instance's operating system.
    KeyName string
    The key pair to use for the instance, it looks like skey-16jig7tx. Modifications may lead to the reinstallation of the instance's operating system.
    Password string
    Password for the instance. In order for the new password to take effect, the instance will be restarted after the password change. Modifications may lead to the reinstallation of the instance's operating system.
    PlacementGroupId string
    The ID of a placement group.
    PrivateIp string
    The private IP to be assigned to this instance, must be in the provided subnet and available.
    ProjectId float64
    The project the instance belongs to, default to 0.
    SecurityGroups []string
    A list of security group IDs to associate with.
    SubnetId string
    The ID of a VPC subnet. If you want to create instances in a VPC network, this parameter must be set.
    SystemDiskId string
    System disk snapshot ID used to initialize the system disk. When system disk type is LOCAL_BASIC and LOCAL_SSD, disk id is not supported.
    SystemDiskSize float64
    Size of the system disk. Valid value ranges: (50~1000). and unit is GB. Default is 50GB. If modified, the instance may force stop.
    SystemDiskType string
    System disk type. For more information on limits of system disk types, see Storage Overview. Valid values: LOCAL_BASIC: local disk, LOCAL_SSD: local SSD disk, CLOUD_SSD: SSD, CLOUD_PREMIUM: Premium Cloud Storage, CLOUD_BSSD: Basic SSD. NOTE: If modified, the instance may force stop.
    Timeouts InstanceSetTimeoutsArgs
    UserData string
    The user data to be injected into this instance. Must be base64 encoded and up to 16 KB.
    UserDataRaw string
    The user data to be injected into this instance, in plain text. Conflicts with user_data. Up to 16 KB after base64 encoded.
    VpcId string
    The ID of a VPC network. If you want to create instances in a VPC network, this parameter must be set.
    availabilityZone String
    The available zone for the CVM instance.
    imageId String
    The image to use for the instance. Changing image_id will cause the instance reset.
    allocatePublicIp Boolean
    Associate a public IP address with an instance in a VPC or Classic. Boolean value, Default is false.
    bandwidthPackageId String
    bandwidth package id. if user is standard user, then the bandwidth_package_id is needed, or default has bandwidth_package_id.
    camRoleName String
    CAM role name authorized to access.
    disableMonitorService Boolean
    Disable enhance service for monitor, it is enabled by default. When this options is set, monitor agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    disableSecurityService Boolean
    Disable enhance service for security, it is enabled by default. When this options is set, security agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    excludeInstanceIds List<String>
    instance ids list to exclude.
    hostname String
    The hostname of the instance. Windows instance: The name should be a combination of 2 to 15 characters comprised of letters (case insensitive), numbers, and hyphens (-). Period (.) is not supported, and the name cannot be a string of pure numbers. Other types (such as Linux) of instances: The name should be a combination of 2 to 60 characters, supporting multiple periods (.). The piece between two periods is composed of letters (case insensitive), numbers, and hyphens (-). Modifications may lead to the reinstallation of the instance's operating system..
    instanceChargeType String
    The charge type of instance. Only support POSTPAID_BY_HOUR.
    instanceCount Double
    The number of instances to be purchased. Value range:[1,100]; default value: 1.
    instanceName String
    instanceSetId String
    ID of the resource.
    instanceType String
    The type of the instance.
    internetChargeType String
    Internet charge type of the instance, Valid values are BANDWIDTH_PREPAID, TRAFFIC_POSTPAID_BY_HOUR, BANDWIDTH_POSTPAID_BY_HOUR and BANDWIDTH_PACKAGE. This value does not need to be set when allocate_public_ip is false.
    internetMaxBandwidthOut Double
    Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bits per second). This value does not need to be set when allocate_public_ip is false.
    keepImageLogin Boolean
    Whether to keep image login or not, default is false. When the image type is private or shared or imported, this parameter can be set true. Modifications may lead to the reinstallation of the instance's operating system.
    keyName String
    The key pair to use for the instance, it looks like skey-16jig7tx. Modifications may lead to the reinstallation of the instance's operating system.
    password String
    Password for the instance. In order for the new password to take effect, the instance will be restarted after the password change. Modifications may lead to the reinstallation of the instance's operating system.
    placementGroupId String
    The ID of a placement group.
    privateIp String
    The private IP to be assigned to this instance, must be in the provided subnet and available.
    projectId Double
    The project the instance belongs to, default to 0.
    securityGroups List<String>
    A list of security group IDs to associate with.
    subnetId String
    The ID of a VPC subnet. If you want to create instances in a VPC network, this parameter must be set.
    systemDiskId String
    System disk snapshot ID used to initialize the system disk. When system disk type is LOCAL_BASIC and LOCAL_SSD, disk id is not supported.
    systemDiskSize Double
    Size of the system disk. Valid value ranges: (50~1000). and unit is GB. Default is 50GB. If modified, the instance may force stop.
    systemDiskType String
    System disk type. For more information on limits of system disk types, see Storage Overview. Valid values: LOCAL_BASIC: local disk, LOCAL_SSD: local SSD disk, CLOUD_SSD: SSD, CLOUD_PREMIUM: Premium Cloud Storage, CLOUD_BSSD: Basic SSD. NOTE: If modified, the instance may force stop.
    timeouts InstanceSetTimeouts
    userData String
    The user data to be injected into this instance. Must be base64 encoded and up to 16 KB.
    userDataRaw String
    The user data to be injected into this instance, in plain text. Conflicts with user_data. Up to 16 KB after base64 encoded.
    vpcId String
    The ID of a VPC network. If you want to create instances in a VPC network, this parameter must be set.
    availabilityZone string
    The available zone for the CVM instance.
    imageId string
    The image to use for the instance. Changing image_id will cause the instance reset.
    allocatePublicIp boolean
    Associate a public IP address with an instance in a VPC or Classic. Boolean value, Default is false.
    bandwidthPackageId string
    bandwidth package id. if user is standard user, then the bandwidth_package_id is needed, or default has bandwidth_package_id.
    camRoleName string
    CAM role name authorized to access.
    disableMonitorService boolean
    Disable enhance service for monitor, it is enabled by default. When this options is set, monitor agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    disableSecurityService boolean
    Disable enhance service for security, it is enabled by default. When this options is set, security agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    excludeInstanceIds string[]
    instance ids list to exclude.
    hostname string
    The hostname of the instance. Windows instance: The name should be a combination of 2 to 15 characters comprised of letters (case insensitive), numbers, and hyphens (-). Period (.) is not supported, and the name cannot be a string of pure numbers. Other types (such as Linux) of instances: The name should be a combination of 2 to 60 characters, supporting multiple periods (.). The piece between two periods is composed of letters (case insensitive), numbers, and hyphens (-). Modifications may lead to the reinstallation of the instance's operating system..
    instanceChargeType string
    The charge type of instance. Only support POSTPAID_BY_HOUR.
    instanceCount number
    The number of instances to be purchased. Value range:[1,100]; default value: 1.
    instanceName string
    instanceSetId string
    ID of the resource.
    instanceType string
    The type of the instance.
    internetChargeType string
    Internet charge type of the instance, Valid values are BANDWIDTH_PREPAID, TRAFFIC_POSTPAID_BY_HOUR, BANDWIDTH_POSTPAID_BY_HOUR and BANDWIDTH_PACKAGE. This value does not need to be set when allocate_public_ip is false.
    internetMaxBandwidthOut number
    Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bits per second). This value does not need to be set when allocate_public_ip is false.
    keepImageLogin boolean
    Whether to keep image login or not, default is false. When the image type is private or shared or imported, this parameter can be set true. Modifications may lead to the reinstallation of the instance's operating system.
    keyName string
    The key pair to use for the instance, it looks like skey-16jig7tx. Modifications may lead to the reinstallation of the instance's operating system.
    password string
    Password for the instance. In order for the new password to take effect, the instance will be restarted after the password change. Modifications may lead to the reinstallation of the instance's operating system.
    placementGroupId string
    The ID of a placement group.
    privateIp string
    The private IP to be assigned to this instance, must be in the provided subnet and available.
    projectId number
    The project the instance belongs to, default to 0.
    securityGroups string[]
    A list of security group IDs to associate with.
    subnetId string
    The ID of a VPC subnet. If you want to create instances in a VPC network, this parameter must be set.
    systemDiskId string
    System disk snapshot ID used to initialize the system disk. When system disk type is LOCAL_BASIC and LOCAL_SSD, disk id is not supported.
    systemDiskSize number
    Size of the system disk. Valid value ranges: (50~1000). and unit is GB. Default is 50GB. If modified, the instance may force stop.
    systemDiskType string
    System disk type. For more information on limits of system disk types, see Storage Overview. Valid values: LOCAL_BASIC: local disk, LOCAL_SSD: local SSD disk, CLOUD_SSD: SSD, CLOUD_PREMIUM: Premium Cloud Storage, CLOUD_BSSD: Basic SSD. NOTE: If modified, the instance may force stop.
    timeouts InstanceSetTimeouts
    userData string
    The user data to be injected into this instance. Must be base64 encoded and up to 16 KB.
    userDataRaw string
    The user data to be injected into this instance, in plain text. Conflicts with user_data. Up to 16 KB after base64 encoded.
    vpcId string
    The ID of a VPC network. If you want to create instances in a VPC network, this parameter must be set.
    availability_zone str
    The available zone for the CVM instance.
    image_id str
    The image to use for the instance. Changing image_id will cause the instance reset.
    allocate_public_ip bool
    Associate a public IP address with an instance in a VPC or Classic. Boolean value, Default is false.
    bandwidth_package_id str
    bandwidth package id. if user is standard user, then the bandwidth_package_id is needed, or default has bandwidth_package_id.
    cam_role_name str
    CAM role name authorized to access.
    disable_monitor_service bool
    Disable enhance service for monitor, it is enabled by default. When this options is set, monitor agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    disable_security_service bool
    Disable enhance service for security, it is enabled by default. When this options is set, security agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    exclude_instance_ids Sequence[str]
    instance ids list to exclude.
    hostname str
    The hostname of the instance. Windows instance: The name should be a combination of 2 to 15 characters comprised of letters (case insensitive), numbers, and hyphens (-). Period (.) is not supported, and the name cannot be a string of pure numbers. Other types (such as Linux) of instances: The name should be a combination of 2 to 60 characters, supporting multiple periods (.). The piece between two periods is composed of letters (case insensitive), numbers, and hyphens (-). Modifications may lead to the reinstallation of the instance's operating system..
    instance_charge_type str
    The charge type of instance. Only support POSTPAID_BY_HOUR.
    instance_count float
    The number of instances to be purchased. Value range:[1,100]; default value: 1.
    instance_name str
    instance_set_id str
    ID of the resource.
    instance_type str
    The type of the instance.
    internet_charge_type str
    Internet charge type of the instance, Valid values are BANDWIDTH_PREPAID, TRAFFIC_POSTPAID_BY_HOUR, BANDWIDTH_POSTPAID_BY_HOUR and BANDWIDTH_PACKAGE. This value does not need to be set when allocate_public_ip is false.
    internet_max_bandwidth_out float
    Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bits per second). This value does not need to be set when allocate_public_ip is false.
    keep_image_login bool
    Whether to keep image login or not, default is false. When the image type is private or shared or imported, this parameter can be set true. Modifications may lead to the reinstallation of the instance's operating system.
    key_name str
    The key pair to use for the instance, it looks like skey-16jig7tx. Modifications may lead to the reinstallation of the instance's operating system.
    password str
    Password for the instance. In order for the new password to take effect, the instance will be restarted after the password change. Modifications may lead to the reinstallation of the instance's operating system.
    placement_group_id str
    The ID of a placement group.
    private_ip str
    The private IP to be assigned to this instance, must be in the provided subnet and available.
    project_id float
    The project the instance belongs to, default to 0.
    security_groups Sequence[str]
    A list of security group IDs to associate with.
    subnet_id str
    The ID of a VPC subnet. If you want to create instances in a VPC network, this parameter must be set.
    system_disk_id str
    System disk snapshot ID used to initialize the system disk. When system disk type is LOCAL_BASIC and LOCAL_SSD, disk id is not supported.
    system_disk_size float
    Size of the system disk. Valid value ranges: (50~1000). and unit is GB. Default is 50GB. If modified, the instance may force stop.
    system_disk_type str
    System disk type. For more information on limits of system disk types, see Storage Overview. Valid values: LOCAL_BASIC: local disk, LOCAL_SSD: local SSD disk, CLOUD_SSD: SSD, CLOUD_PREMIUM: Premium Cloud Storage, CLOUD_BSSD: Basic SSD. NOTE: If modified, the instance may force stop.
    timeouts InstanceSetTimeoutsArgs
    user_data str
    The user data to be injected into this instance. Must be base64 encoded and up to 16 KB.
    user_data_raw str
    The user data to be injected into this instance, in plain text. Conflicts with user_data. Up to 16 KB after base64 encoded.
    vpc_id str
    The ID of a VPC network. If you want to create instances in a VPC network, this parameter must be set.
    availabilityZone String
    The available zone for the CVM instance.
    imageId String
    The image to use for the instance. Changing image_id will cause the instance reset.
    allocatePublicIp Boolean
    Associate a public IP address with an instance in a VPC or Classic. Boolean value, Default is false.
    bandwidthPackageId String
    bandwidth package id. if user is standard user, then the bandwidth_package_id is needed, or default has bandwidth_package_id.
    camRoleName String
    CAM role name authorized to access.
    disableMonitorService Boolean
    Disable enhance service for monitor, it is enabled by default. When this options is set, monitor agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    disableSecurityService Boolean
    Disable enhance service for security, it is enabled by default. When this options is set, security agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    excludeInstanceIds List<String>
    instance ids list to exclude.
    hostname String
    The hostname of the instance. Windows instance: The name should be a combination of 2 to 15 characters comprised of letters (case insensitive), numbers, and hyphens (-). Period (.) is not supported, and the name cannot be a string of pure numbers. Other types (such as Linux) of instances: The name should be a combination of 2 to 60 characters, supporting multiple periods (.). The piece between two periods is composed of letters (case insensitive), numbers, and hyphens (-). Modifications may lead to the reinstallation of the instance's operating system..
    instanceChargeType String
    The charge type of instance. Only support POSTPAID_BY_HOUR.
    instanceCount Number
    The number of instances to be purchased. Value range:[1,100]; default value: 1.
    instanceName String
    instanceSetId String
    ID of the resource.
    instanceType String
    The type of the instance.
    internetChargeType String
    Internet charge type of the instance, Valid values are BANDWIDTH_PREPAID, TRAFFIC_POSTPAID_BY_HOUR, BANDWIDTH_POSTPAID_BY_HOUR and BANDWIDTH_PACKAGE. This value does not need to be set when allocate_public_ip is false.
    internetMaxBandwidthOut Number
    Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bits per second). This value does not need to be set when allocate_public_ip is false.
    keepImageLogin Boolean
    Whether to keep image login or not, default is false. When the image type is private or shared or imported, this parameter can be set true. Modifications may lead to the reinstallation of the instance's operating system.
    keyName String
    The key pair to use for the instance, it looks like skey-16jig7tx. Modifications may lead to the reinstallation of the instance's operating system.
    password String
    Password for the instance. In order for the new password to take effect, the instance will be restarted after the password change. Modifications may lead to the reinstallation of the instance's operating system.
    placementGroupId String
    The ID of a placement group.
    privateIp String
    The private IP to be assigned to this instance, must be in the provided subnet and available.
    projectId Number
    The project the instance belongs to, default to 0.
    securityGroups List<String>
    A list of security group IDs to associate with.
    subnetId String
    The ID of a VPC subnet. If you want to create instances in a VPC network, this parameter must be set.
    systemDiskId String
    System disk snapshot ID used to initialize the system disk. When system disk type is LOCAL_BASIC and LOCAL_SSD, disk id is not supported.
    systemDiskSize Number
    Size of the system disk. Valid value ranges: (50~1000). and unit is GB. Default is 50GB. If modified, the instance may force stop.
    systemDiskType String
    System disk type. For more information on limits of system disk types, see Storage Overview. Valid values: LOCAL_BASIC: local disk, LOCAL_SSD: local SSD disk, CLOUD_SSD: SSD, CLOUD_PREMIUM: Premium Cloud Storage, CLOUD_BSSD: Basic SSD. NOTE: If modified, the instance may force stop.
    timeouts Property Map
    userData String
    The user data to be injected into this instance. Must be base64 encoded and up to 16 KB.
    userDataRaw String
    The user data to be injected into this instance, in plain text. Conflicts with user_data. Up to 16 KB after base64 encoded.
    vpcId String
    The ID of a VPC network. If you want to create instances in a VPC network, this parameter must be set.

    Outputs

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

    CreateTime string
    Create time of the instance.
    ExpiredTime string
    Expired time of the instance.
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceIds List<string>
    instance id list.
    InstanceStatus string
    Current status of the instance.
    PublicIp string
    Public IP of the instance.
    CreateTime string
    Create time of the instance.
    ExpiredTime string
    Expired time of the instance.
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceIds []string
    instance id list.
    InstanceStatus string
    Current status of the instance.
    PublicIp string
    Public IP of the instance.
    createTime String
    Create time of the instance.
    expiredTime String
    Expired time of the instance.
    id String
    The provider-assigned unique ID for this managed resource.
    instanceIds List<String>
    instance id list.
    instanceStatus String
    Current status of the instance.
    publicIp String
    Public IP of the instance.
    createTime string
    Create time of the instance.
    expiredTime string
    Expired time of the instance.
    id string
    The provider-assigned unique ID for this managed resource.
    instanceIds string[]
    instance id list.
    instanceStatus string
    Current status of the instance.
    publicIp string
    Public IP of the instance.
    create_time str
    Create time of the instance.
    expired_time str
    Expired time of the instance.
    id str
    The provider-assigned unique ID for this managed resource.
    instance_ids Sequence[str]
    instance id list.
    instance_status str
    Current status of the instance.
    public_ip str
    Public IP of the instance.
    createTime String
    Create time of the instance.
    expiredTime String
    Expired time of the instance.
    id String
    The provider-assigned unique ID for this managed resource.
    instanceIds List<String>
    instance id list.
    instanceStatus String
    Current status of the instance.
    publicIp String
    Public IP of the instance.

    Look up Existing InstanceSet Resource

    Get an existing InstanceSet 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?: InstanceSetState, opts?: CustomResourceOptions): InstanceSet
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        allocate_public_ip: Optional[bool] = None,
        availability_zone: Optional[str] = None,
        bandwidth_package_id: Optional[str] = None,
        cam_role_name: Optional[str] = None,
        create_time: Optional[str] = None,
        disable_monitor_service: Optional[bool] = None,
        disable_security_service: Optional[bool] = None,
        exclude_instance_ids: Optional[Sequence[str]] = None,
        expired_time: Optional[str] = None,
        hostname: Optional[str] = None,
        image_id: Optional[str] = None,
        instance_charge_type: Optional[str] = None,
        instance_count: Optional[float] = None,
        instance_ids: Optional[Sequence[str]] = None,
        instance_name: Optional[str] = None,
        instance_set_id: Optional[str] = None,
        instance_status: Optional[str] = None,
        instance_type: Optional[str] = None,
        internet_charge_type: Optional[str] = None,
        internet_max_bandwidth_out: Optional[float] = None,
        keep_image_login: Optional[bool] = None,
        key_name: Optional[str] = None,
        password: Optional[str] = None,
        placement_group_id: Optional[str] = None,
        private_ip: Optional[str] = None,
        project_id: Optional[float] = None,
        public_ip: Optional[str] = None,
        security_groups: Optional[Sequence[str]] = None,
        subnet_id: Optional[str] = None,
        system_disk_id: Optional[str] = None,
        system_disk_size: Optional[float] = None,
        system_disk_type: Optional[str] = None,
        timeouts: Optional[InstanceSetTimeoutsArgs] = None,
        user_data: Optional[str] = None,
        user_data_raw: Optional[str] = None,
        vpc_id: Optional[str] = None) -> InstanceSet
    func GetInstanceSet(ctx *Context, name string, id IDInput, state *InstanceSetState, opts ...ResourceOption) (*InstanceSet, error)
    public static InstanceSet Get(string name, Input<string> id, InstanceSetState? state, CustomResourceOptions? opts = null)
    public static InstanceSet get(String name, Output<String> id, InstanceSetState state, CustomResourceOptions options)
    resources:  _:    type: tencentcloud:InstanceSet    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AllocatePublicIp bool
    Associate a public IP address with an instance in a VPC or Classic. Boolean value, Default is false.
    AvailabilityZone string
    The available zone for the CVM instance.
    BandwidthPackageId string
    bandwidth package id. if user is standard user, then the bandwidth_package_id is needed, or default has bandwidth_package_id.
    CamRoleName string
    CAM role name authorized to access.
    CreateTime string
    Create time of the instance.
    DisableMonitorService bool
    Disable enhance service for monitor, it is enabled by default. When this options is set, monitor agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    DisableSecurityService bool
    Disable enhance service for security, it is enabled by default. When this options is set, security agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    ExcludeInstanceIds List<string>
    instance ids list to exclude.
    ExpiredTime string
    Expired time of the instance.
    Hostname string
    The hostname of the instance. Windows instance: The name should be a combination of 2 to 15 characters comprised of letters (case insensitive), numbers, and hyphens (-). Period (.) is not supported, and the name cannot be a string of pure numbers. Other types (such as Linux) of instances: The name should be a combination of 2 to 60 characters, supporting multiple periods (.). The piece between two periods is composed of letters (case insensitive), numbers, and hyphens (-). Modifications may lead to the reinstallation of the instance's operating system..
    ImageId string
    The image to use for the instance. Changing image_id will cause the instance reset.
    InstanceChargeType string
    The charge type of instance. Only support POSTPAID_BY_HOUR.
    InstanceCount double
    The number of instances to be purchased. Value range:[1,100]; default value: 1.
    InstanceIds List<string>
    instance id list.
    InstanceName string
    InstanceSetId string
    ID of the resource.
    InstanceStatus string
    Current status of the instance.
    InstanceType string
    The type of the instance.
    InternetChargeType string
    Internet charge type of the instance, Valid values are BANDWIDTH_PREPAID, TRAFFIC_POSTPAID_BY_HOUR, BANDWIDTH_POSTPAID_BY_HOUR and BANDWIDTH_PACKAGE. This value does not need to be set when allocate_public_ip is false.
    InternetMaxBandwidthOut double
    Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bits per second). This value does not need to be set when allocate_public_ip is false.
    KeepImageLogin bool
    Whether to keep image login or not, default is false. When the image type is private or shared or imported, this parameter can be set true. Modifications may lead to the reinstallation of the instance's operating system.
    KeyName string
    The key pair to use for the instance, it looks like skey-16jig7tx. Modifications may lead to the reinstallation of the instance's operating system.
    Password string
    Password for the instance. In order for the new password to take effect, the instance will be restarted after the password change. Modifications may lead to the reinstallation of the instance's operating system.
    PlacementGroupId string
    The ID of a placement group.
    PrivateIp string
    The private IP to be assigned to this instance, must be in the provided subnet and available.
    ProjectId double
    The project the instance belongs to, default to 0.
    PublicIp string
    Public IP of the instance.
    SecurityGroups List<string>
    A list of security group IDs to associate with.
    SubnetId string
    The ID of a VPC subnet. If you want to create instances in a VPC network, this parameter must be set.
    SystemDiskId string
    System disk snapshot ID used to initialize the system disk. When system disk type is LOCAL_BASIC and LOCAL_SSD, disk id is not supported.
    SystemDiskSize double
    Size of the system disk. Valid value ranges: (50~1000). and unit is GB. Default is 50GB. If modified, the instance may force stop.
    SystemDiskType string
    System disk type. For more information on limits of system disk types, see Storage Overview. Valid values: LOCAL_BASIC: local disk, LOCAL_SSD: local SSD disk, CLOUD_SSD: SSD, CLOUD_PREMIUM: Premium Cloud Storage, CLOUD_BSSD: Basic SSD. NOTE: If modified, the instance may force stop.
    Timeouts InstanceSetTimeouts
    UserData string
    The user data to be injected into this instance. Must be base64 encoded and up to 16 KB.
    UserDataRaw string
    The user data to be injected into this instance, in plain text. Conflicts with user_data. Up to 16 KB after base64 encoded.
    VpcId string
    The ID of a VPC network. If you want to create instances in a VPC network, this parameter must be set.
    AllocatePublicIp bool
    Associate a public IP address with an instance in a VPC or Classic. Boolean value, Default is false.
    AvailabilityZone string
    The available zone for the CVM instance.
    BandwidthPackageId string
    bandwidth package id. if user is standard user, then the bandwidth_package_id is needed, or default has bandwidth_package_id.
    CamRoleName string
    CAM role name authorized to access.
    CreateTime string
    Create time of the instance.
    DisableMonitorService bool
    Disable enhance service for monitor, it is enabled by default. When this options is set, monitor agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    DisableSecurityService bool
    Disable enhance service for security, it is enabled by default. When this options is set, security agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    ExcludeInstanceIds []string
    instance ids list to exclude.
    ExpiredTime string
    Expired time of the instance.
    Hostname string
    The hostname of the instance. Windows instance: The name should be a combination of 2 to 15 characters comprised of letters (case insensitive), numbers, and hyphens (-). Period (.) is not supported, and the name cannot be a string of pure numbers. Other types (such as Linux) of instances: The name should be a combination of 2 to 60 characters, supporting multiple periods (.). The piece between two periods is composed of letters (case insensitive), numbers, and hyphens (-). Modifications may lead to the reinstallation of the instance's operating system..
    ImageId string
    The image to use for the instance. Changing image_id will cause the instance reset.
    InstanceChargeType string
    The charge type of instance. Only support POSTPAID_BY_HOUR.
    InstanceCount float64
    The number of instances to be purchased. Value range:[1,100]; default value: 1.
    InstanceIds []string
    instance id list.
    InstanceName string
    InstanceSetId string
    ID of the resource.
    InstanceStatus string
    Current status of the instance.
    InstanceType string
    The type of the instance.
    InternetChargeType string
    Internet charge type of the instance, Valid values are BANDWIDTH_PREPAID, TRAFFIC_POSTPAID_BY_HOUR, BANDWIDTH_POSTPAID_BY_HOUR and BANDWIDTH_PACKAGE. This value does not need to be set when allocate_public_ip is false.
    InternetMaxBandwidthOut float64
    Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bits per second). This value does not need to be set when allocate_public_ip is false.
    KeepImageLogin bool
    Whether to keep image login or not, default is false. When the image type is private or shared or imported, this parameter can be set true. Modifications may lead to the reinstallation of the instance's operating system.
    KeyName string
    The key pair to use for the instance, it looks like skey-16jig7tx. Modifications may lead to the reinstallation of the instance's operating system.
    Password string
    Password for the instance. In order for the new password to take effect, the instance will be restarted after the password change. Modifications may lead to the reinstallation of the instance's operating system.
    PlacementGroupId string
    The ID of a placement group.
    PrivateIp string
    The private IP to be assigned to this instance, must be in the provided subnet and available.
    ProjectId float64
    The project the instance belongs to, default to 0.
    PublicIp string
    Public IP of the instance.
    SecurityGroups []string
    A list of security group IDs to associate with.
    SubnetId string
    The ID of a VPC subnet. If you want to create instances in a VPC network, this parameter must be set.
    SystemDiskId string
    System disk snapshot ID used to initialize the system disk. When system disk type is LOCAL_BASIC and LOCAL_SSD, disk id is not supported.
    SystemDiskSize float64
    Size of the system disk. Valid value ranges: (50~1000). and unit is GB. Default is 50GB. If modified, the instance may force stop.
    SystemDiskType string
    System disk type. For more information on limits of system disk types, see Storage Overview. Valid values: LOCAL_BASIC: local disk, LOCAL_SSD: local SSD disk, CLOUD_SSD: SSD, CLOUD_PREMIUM: Premium Cloud Storage, CLOUD_BSSD: Basic SSD. NOTE: If modified, the instance may force stop.
    Timeouts InstanceSetTimeoutsArgs
    UserData string
    The user data to be injected into this instance. Must be base64 encoded and up to 16 KB.
    UserDataRaw string
    The user data to be injected into this instance, in plain text. Conflicts with user_data. Up to 16 KB after base64 encoded.
    VpcId string
    The ID of a VPC network. If you want to create instances in a VPC network, this parameter must be set.
    allocatePublicIp Boolean
    Associate a public IP address with an instance in a VPC or Classic. Boolean value, Default is false.
    availabilityZone String
    The available zone for the CVM instance.
    bandwidthPackageId String
    bandwidth package id. if user is standard user, then the bandwidth_package_id is needed, or default has bandwidth_package_id.
    camRoleName String
    CAM role name authorized to access.
    createTime String
    Create time of the instance.
    disableMonitorService Boolean
    Disable enhance service for monitor, it is enabled by default. When this options is set, monitor agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    disableSecurityService Boolean
    Disable enhance service for security, it is enabled by default. When this options is set, security agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    excludeInstanceIds List<String>
    instance ids list to exclude.
    expiredTime String
    Expired time of the instance.
    hostname String
    The hostname of the instance. Windows instance: The name should be a combination of 2 to 15 characters comprised of letters (case insensitive), numbers, and hyphens (-). Period (.) is not supported, and the name cannot be a string of pure numbers. Other types (such as Linux) of instances: The name should be a combination of 2 to 60 characters, supporting multiple periods (.). The piece between two periods is composed of letters (case insensitive), numbers, and hyphens (-). Modifications may lead to the reinstallation of the instance's operating system..
    imageId String
    The image to use for the instance. Changing image_id will cause the instance reset.
    instanceChargeType String
    The charge type of instance. Only support POSTPAID_BY_HOUR.
    instanceCount Double
    The number of instances to be purchased. Value range:[1,100]; default value: 1.
    instanceIds List<String>
    instance id list.
    instanceName String
    instanceSetId String
    ID of the resource.
    instanceStatus String
    Current status of the instance.
    instanceType String
    The type of the instance.
    internetChargeType String
    Internet charge type of the instance, Valid values are BANDWIDTH_PREPAID, TRAFFIC_POSTPAID_BY_HOUR, BANDWIDTH_POSTPAID_BY_HOUR and BANDWIDTH_PACKAGE. This value does not need to be set when allocate_public_ip is false.
    internetMaxBandwidthOut Double
    Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bits per second). This value does not need to be set when allocate_public_ip is false.
    keepImageLogin Boolean
    Whether to keep image login or not, default is false. When the image type is private or shared or imported, this parameter can be set true. Modifications may lead to the reinstallation of the instance's operating system.
    keyName String
    The key pair to use for the instance, it looks like skey-16jig7tx. Modifications may lead to the reinstallation of the instance's operating system.
    password String
    Password for the instance. In order for the new password to take effect, the instance will be restarted after the password change. Modifications may lead to the reinstallation of the instance's operating system.
    placementGroupId String
    The ID of a placement group.
    privateIp String
    The private IP to be assigned to this instance, must be in the provided subnet and available.
    projectId Double
    The project the instance belongs to, default to 0.
    publicIp String
    Public IP of the instance.
    securityGroups List<String>
    A list of security group IDs to associate with.
    subnetId String
    The ID of a VPC subnet. If you want to create instances in a VPC network, this parameter must be set.
    systemDiskId String
    System disk snapshot ID used to initialize the system disk. When system disk type is LOCAL_BASIC and LOCAL_SSD, disk id is not supported.
    systemDiskSize Double
    Size of the system disk. Valid value ranges: (50~1000). and unit is GB. Default is 50GB. If modified, the instance may force stop.
    systemDiskType String
    System disk type. For more information on limits of system disk types, see Storage Overview. Valid values: LOCAL_BASIC: local disk, LOCAL_SSD: local SSD disk, CLOUD_SSD: SSD, CLOUD_PREMIUM: Premium Cloud Storage, CLOUD_BSSD: Basic SSD. NOTE: If modified, the instance may force stop.
    timeouts InstanceSetTimeouts
    userData String
    The user data to be injected into this instance. Must be base64 encoded and up to 16 KB.
    userDataRaw String
    The user data to be injected into this instance, in plain text. Conflicts with user_data. Up to 16 KB after base64 encoded.
    vpcId String
    The ID of a VPC network. If you want to create instances in a VPC network, this parameter must be set.
    allocatePublicIp boolean
    Associate a public IP address with an instance in a VPC or Classic. Boolean value, Default is false.
    availabilityZone string
    The available zone for the CVM instance.
    bandwidthPackageId string
    bandwidth package id. if user is standard user, then the bandwidth_package_id is needed, or default has bandwidth_package_id.
    camRoleName string
    CAM role name authorized to access.
    createTime string
    Create time of the instance.
    disableMonitorService boolean
    Disable enhance service for monitor, it is enabled by default. When this options is set, monitor agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    disableSecurityService boolean
    Disable enhance service for security, it is enabled by default. When this options is set, security agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    excludeInstanceIds string[]
    instance ids list to exclude.
    expiredTime string
    Expired time of the instance.
    hostname string
    The hostname of the instance. Windows instance: The name should be a combination of 2 to 15 characters comprised of letters (case insensitive), numbers, and hyphens (-). Period (.) is not supported, and the name cannot be a string of pure numbers. Other types (such as Linux) of instances: The name should be a combination of 2 to 60 characters, supporting multiple periods (.). The piece between two periods is composed of letters (case insensitive), numbers, and hyphens (-). Modifications may lead to the reinstallation of the instance's operating system..
    imageId string
    The image to use for the instance. Changing image_id will cause the instance reset.
    instanceChargeType string
    The charge type of instance. Only support POSTPAID_BY_HOUR.
    instanceCount number
    The number of instances to be purchased. Value range:[1,100]; default value: 1.
    instanceIds string[]
    instance id list.
    instanceName string
    instanceSetId string
    ID of the resource.
    instanceStatus string
    Current status of the instance.
    instanceType string
    The type of the instance.
    internetChargeType string
    Internet charge type of the instance, Valid values are BANDWIDTH_PREPAID, TRAFFIC_POSTPAID_BY_HOUR, BANDWIDTH_POSTPAID_BY_HOUR and BANDWIDTH_PACKAGE. This value does not need to be set when allocate_public_ip is false.
    internetMaxBandwidthOut number
    Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bits per second). This value does not need to be set when allocate_public_ip is false.
    keepImageLogin boolean
    Whether to keep image login or not, default is false. When the image type is private or shared or imported, this parameter can be set true. Modifications may lead to the reinstallation of the instance's operating system.
    keyName string
    The key pair to use for the instance, it looks like skey-16jig7tx. Modifications may lead to the reinstallation of the instance's operating system.
    password string
    Password for the instance. In order for the new password to take effect, the instance will be restarted after the password change. Modifications may lead to the reinstallation of the instance's operating system.
    placementGroupId string
    The ID of a placement group.
    privateIp string
    The private IP to be assigned to this instance, must be in the provided subnet and available.
    projectId number
    The project the instance belongs to, default to 0.
    publicIp string
    Public IP of the instance.
    securityGroups string[]
    A list of security group IDs to associate with.
    subnetId string
    The ID of a VPC subnet. If you want to create instances in a VPC network, this parameter must be set.
    systemDiskId string
    System disk snapshot ID used to initialize the system disk. When system disk type is LOCAL_BASIC and LOCAL_SSD, disk id is not supported.
    systemDiskSize number
    Size of the system disk. Valid value ranges: (50~1000). and unit is GB. Default is 50GB. If modified, the instance may force stop.
    systemDiskType string
    System disk type. For more information on limits of system disk types, see Storage Overview. Valid values: LOCAL_BASIC: local disk, LOCAL_SSD: local SSD disk, CLOUD_SSD: SSD, CLOUD_PREMIUM: Premium Cloud Storage, CLOUD_BSSD: Basic SSD. NOTE: If modified, the instance may force stop.
    timeouts InstanceSetTimeouts
    userData string
    The user data to be injected into this instance. Must be base64 encoded and up to 16 KB.
    userDataRaw string
    The user data to be injected into this instance, in plain text. Conflicts with user_data. Up to 16 KB after base64 encoded.
    vpcId string
    The ID of a VPC network. If you want to create instances in a VPC network, this parameter must be set.
    allocate_public_ip bool
    Associate a public IP address with an instance in a VPC or Classic. Boolean value, Default is false.
    availability_zone str
    The available zone for the CVM instance.
    bandwidth_package_id str
    bandwidth package id. if user is standard user, then the bandwidth_package_id is needed, or default has bandwidth_package_id.
    cam_role_name str
    CAM role name authorized to access.
    create_time str
    Create time of the instance.
    disable_monitor_service bool
    Disable enhance service for monitor, it is enabled by default. When this options is set, monitor agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    disable_security_service bool
    Disable enhance service for security, it is enabled by default. When this options is set, security agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    exclude_instance_ids Sequence[str]
    instance ids list to exclude.
    expired_time str
    Expired time of the instance.
    hostname str
    The hostname of the instance. Windows instance: The name should be a combination of 2 to 15 characters comprised of letters (case insensitive), numbers, and hyphens (-). Period (.) is not supported, and the name cannot be a string of pure numbers. Other types (such as Linux) of instances: The name should be a combination of 2 to 60 characters, supporting multiple periods (.). The piece between two periods is composed of letters (case insensitive), numbers, and hyphens (-). Modifications may lead to the reinstallation of the instance's operating system..
    image_id str
    The image to use for the instance. Changing image_id will cause the instance reset.
    instance_charge_type str
    The charge type of instance. Only support POSTPAID_BY_HOUR.
    instance_count float
    The number of instances to be purchased. Value range:[1,100]; default value: 1.
    instance_ids Sequence[str]
    instance id list.
    instance_name str
    instance_set_id str
    ID of the resource.
    instance_status str
    Current status of the instance.
    instance_type str
    The type of the instance.
    internet_charge_type str
    Internet charge type of the instance, Valid values are BANDWIDTH_PREPAID, TRAFFIC_POSTPAID_BY_HOUR, BANDWIDTH_POSTPAID_BY_HOUR and BANDWIDTH_PACKAGE. This value does not need to be set when allocate_public_ip is false.
    internet_max_bandwidth_out float
    Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bits per second). This value does not need to be set when allocate_public_ip is false.
    keep_image_login bool
    Whether to keep image login or not, default is false. When the image type is private or shared or imported, this parameter can be set true. Modifications may lead to the reinstallation of the instance's operating system.
    key_name str
    The key pair to use for the instance, it looks like skey-16jig7tx. Modifications may lead to the reinstallation of the instance's operating system.
    password str
    Password for the instance. In order for the new password to take effect, the instance will be restarted after the password change. Modifications may lead to the reinstallation of the instance's operating system.
    placement_group_id str
    The ID of a placement group.
    private_ip str
    The private IP to be assigned to this instance, must be in the provided subnet and available.
    project_id float
    The project the instance belongs to, default to 0.
    public_ip str
    Public IP of the instance.
    security_groups Sequence[str]
    A list of security group IDs to associate with.
    subnet_id str
    The ID of a VPC subnet. If you want to create instances in a VPC network, this parameter must be set.
    system_disk_id str
    System disk snapshot ID used to initialize the system disk. When system disk type is LOCAL_BASIC and LOCAL_SSD, disk id is not supported.
    system_disk_size float
    Size of the system disk. Valid value ranges: (50~1000). and unit is GB. Default is 50GB. If modified, the instance may force stop.
    system_disk_type str
    System disk type. For more information on limits of system disk types, see Storage Overview. Valid values: LOCAL_BASIC: local disk, LOCAL_SSD: local SSD disk, CLOUD_SSD: SSD, CLOUD_PREMIUM: Premium Cloud Storage, CLOUD_BSSD: Basic SSD. NOTE: If modified, the instance may force stop.
    timeouts InstanceSetTimeoutsArgs
    user_data str
    The user data to be injected into this instance. Must be base64 encoded and up to 16 KB.
    user_data_raw str
    The user data to be injected into this instance, in plain text. Conflicts with user_data. Up to 16 KB after base64 encoded.
    vpc_id str
    The ID of a VPC network. If you want to create instances in a VPC network, this parameter must be set.
    allocatePublicIp Boolean
    Associate a public IP address with an instance in a VPC or Classic. Boolean value, Default is false.
    availabilityZone String
    The available zone for the CVM instance.
    bandwidthPackageId String
    bandwidth package id. if user is standard user, then the bandwidth_package_id is needed, or default has bandwidth_package_id.
    camRoleName String
    CAM role name authorized to access.
    createTime String
    Create time of the instance.
    disableMonitorService Boolean
    Disable enhance service for monitor, it is enabled by default. When this options is set, monitor agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    disableSecurityService Boolean
    Disable enhance service for security, it is enabled by default. When this options is set, security agent won't be installed. Modifications may lead to the reinstallation of the instance's operating system.
    excludeInstanceIds List<String>
    instance ids list to exclude.
    expiredTime String
    Expired time of the instance.
    hostname String
    The hostname of the instance. Windows instance: The name should be a combination of 2 to 15 characters comprised of letters (case insensitive), numbers, and hyphens (-). Period (.) is not supported, and the name cannot be a string of pure numbers. Other types (such as Linux) of instances: The name should be a combination of 2 to 60 characters, supporting multiple periods (.). The piece between two periods is composed of letters (case insensitive), numbers, and hyphens (-). Modifications may lead to the reinstallation of the instance's operating system..
    imageId String
    The image to use for the instance. Changing image_id will cause the instance reset.
    instanceChargeType String
    The charge type of instance. Only support POSTPAID_BY_HOUR.
    instanceCount Number
    The number of instances to be purchased. Value range:[1,100]; default value: 1.
    instanceIds List<String>
    instance id list.
    instanceName String
    instanceSetId String
    ID of the resource.
    instanceStatus String
    Current status of the instance.
    instanceType String
    The type of the instance.
    internetChargeType String
    Internet charge type of the instance, Valid values are BANDWIDTH_PREPAID, TRAFFIC_POSTPAID_BY_HOUR, BANDWIDTH_POSTPAID_BY_HOUR and BANDWIDTH_PACKAGE. This value does not need to be set when allocate_public_ip is false.
    internetMaxBandwidthOut Number
    Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bits per second). This value does not need to be set when allocate_public_ip is false.
    keepImageLogin Boolean
    Whether to keep image login or not, default is false. When the image type is private or shared or imported, this parameter can be set true. Modifications may lead to the reinstallation of the instance's operating system.
    keyName String
    The key pair to use for the instance, it looks like skey-16jig7tx. Modifications may lead to the reinstallation of the instance's operating system.
    password String
    Password for the instance. In order for the new password to take effect, the instance will be restarted after the password change. Modifications may lead to the reinstallation of the instance's operating system.
    placementGroupId String
    The ID of a placement group.
    privateIp String
    The private IP to be assigned to this instance, must be in the provided subnet and available.
    projectId Number
    The project the instance belongs to, default to 0.
    publicIp String
    Public IP of the instance.
    securityGroups List<String>
    A list of security group IDs to associate with.
    subnetId String
    The ID of a VPC subnet. If you want to create instances in a VPC network, this parameter must be set.
    systemDiskId String
    System disk snapshot ID used to initialize the system disk. When system disk type is LOCAL_BASIC and LOCAL_SSD, disk id is not supported.
    systemDiskSize Number
    Size of the system disk. Valid value ranges: (50~1000). and unit is GB. Default is 50GB. If modified, the instance may force stop.
    systemDiskType String
    System disk type. For more information on limits of system disk types, see Storage Overview. Valid values: LOCAL_BASIC: local disk, LOCAL_SSD: local SSD disk, CLOUD_SSD: SSD, CLOUD_PREMIUM: Premium Cloud Storage, CLOUD_BSSD: Basic SSD. NOTE: If modified, the instance may force stop.
    timeouts Property Map
    userData String
    The user data to be injected into this instance. Must be base64 encoded and up to 16 KB.
    userDataRaw String
    The user data to be injected into this instance, in plain text. Conflicts with user_data. Up to 16 KB after base64 encoded.
    vpcId String
    The ID of a VPC network. If you want to create instances in a VPC network, this parameter must be set.

    Supporting Types

    InstanceSetTimeouts, InstanceSetTimeoutsArgs

    Create string
    Delete string
    Read string
    Update string
    Create string
    Delete string
    Read string
    Update string
    create String
    delete String
    read String
    update String
    create string
    delete string
    read string
    update string
    create str
    delete str
    read str
    update str
    create String
    delete String
    read String
    update String

    Package Details

    Repository
    tencentcloud tencentcloudstack/terraform-provider-tencentcloud
    License
    Notes
    This Pulumi package is based on the tencentcloud Terraform Provider.
    tencentcloud logo
    tencentcloud 1.81.189 published on Wednesday, Apr 30, 2025 by tencentcloudstack
    tencentcloudstack/terraform-provider-tencentcloud