volcenginecc.ecs.LaunchTemplate

volcenginecc v0.0.32, Apr 23 26

Viewing docs for volcenginecc v0.0.32
published on Thursday, Apr 23, 2026 by Volcengine

Schema (JSON)

volcengine/pulumi-volcenginecc

Viewing docs for volcenginecc v0.0.32
published on Thursday, Apr 23, 2026 by Volcengine

Schema (JSON)

volcengine/pulumi-volcenginecc

An instance launch template is a collection of instance configuration information for quickly purchasing instances. You can store all configuration information except passwords in the template, including key pairs, compute specifications, cloud disks, networks, etc. If all configuration information is valid, you can purchase instances with one click without repeated configuration.

Example Usage

Example coming soon!

Example coming soon!

Example coming soon!

Example coming soon!

Example coming soon!

resources:
  ecsLaunchTemplateDemo:
    type: volcenginecc:ecs:LaunchTemplate
    name: EcsLaunchTemplateDemo
    properties:
      launchTemplateVersion:
        deployment_set_group_number: 0
        deployment_set_id: dps-ydzc5xxxxxxkak3c5b9vu
        description: ecs_launch_template test
        eip:
          bandwidth: 1
          bandwidthPackageId: bwp-1a1fvbxxxxxxvepl9jzfmf
          billingType: 0
          isp: BGP
          releaseWithInstance: true
          securityProtectionInstanceId: 0
          securityProtectionTypes:
            - AntiDDoS_Enhanced
        host_name: myname
        hpc_cluster_id: ""
        image_id: image-yzpvmk9xxxxxxgqcsdamq
        image_name: Ubuntu 24.04 with LLM Knowledge Base 64 bit
        instance_charge_type: PostPaid
        instance_name: ccapi-dx-0
        instance_type_id: ecs.g4i.large
        keep_image_credential: false
        key_pair_name: MigrationKey-job-yecd7dromy38dfaxgxt8
        network_interfaces:
          - securityGroupIds:
              - sg-1jolcljxxxxxxpe70vpx
            subnetId: subnet-btd4nhxxxxxxb2tl1jdsb
        project_name: default
        scheduled_instance:
          scheduledInstanceDescription: test
          scheduledInstanceName: test-template
        security_enhancement_strategy: Active
        spot_price_limit: 0
        spot_strategy: NoSpot
        suffix_index: 1
        tags:
          - key: env
            value: test
        unique_suffix: false
        user_data: ZWNobyBoZWxsbyBlY3Mh
        version_description: test
        volumes:
          - deleteWithInstance: true
            extraPerformanceIops: 0
            extraPerformanceThroughputMb: 0
            extraPerformanceTypeId: ""
            size: 50
            snapshotId: ""
            volumeType: ESSD_PL0
        vpc_id: vpc-1jolcldhxxxxxxq7yms
        zone_id: cn-beijing-a
      launchTemplateName: test
      launchTemplateProjectName: default
      launchTemplateTags:
        - key: env
          value: test

Create LaunchTemplate Resource

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

Constructor syntax

new LaunchTemplate(name: string, args: LaunchTemplateArgs, opts?: CustomResourceOptions);

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

@overload
def LaunchTemplate(resource_name: str,
                   opts: Optional[ResourceOptions] = None,
                   launch_template_name: Optional[str] = None,
                   default_version_number: Optional[int] = None,
                   launch_template_project_name: Optional[str] = None,
                   launch_template_tags: Optional[Sequence[LaunchTemplateLaunchTemplateTagArgs]] = None,
                   launch_template_version: Optional[LaunchTemplateLaunchTemplateVersionArgs] = None)

func NewLaunchTemplate(ctx *Context, name string, args LaunchTemplateArgs, opts ...ResourceOption) (*LaunchTemplate, error)

public LaunchTemplate(string name, LaunchTemplateArgs args, CustomResourceOptions? opts = null)

public LaunchTemplate(String name, LaunchTemplateArgs args)
public LaunchTemplate(String name, LaunchTemplateArgs args, CustomResourceOptions options)

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

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

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

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

LaunchTemplateName string: Instance launch template name.
DefaultVersionNumber int: Instance launch template default version number
LaunchTemplateProjectName string: Project associated with the instance launch template.
LaunchTemplateTags List<Volcengine.LaunchTemplateLaunchTemplateTag>
LaunchTemplateVersion Volcengine.LaunchTemplateLaunchTemplateVersion: Instance launch template version information

LaunchTemplateName string: Instance launch template name.
DefaultVersionNumber int: Instance launch template default version number
LaunchTemplateProjectName string: Project associated with the instance launch template.
LaunchTemplateTags []LaunchTemplateLaunchTemplateTagArgs
LaunchTemplateVersion LaunchTemplateLaunchTemplateVersionArgs: Instance launch template version information

launchTemplateName String: Instance launch template name.
defaultVersionNumber Integer: Instance launch template default version number
launchTemplateProjectName String: Project associated with the instance launch template.
launchTemplateTags List<LaunchTemplateLaunchTemplateTag>
launchTemplateVersion LaunchTemplateLaunchTemplateVersion: Instance launch template version information

launchTemplateName string: Instance launch template name.
defaultVersionNumber number: Instance launch template default version number
launchTemplateProjectName string: Project associated with the instance launch template.
launchTemplateTags LaunchTemplateLaunchTemplateTag[]
launchTemplateVersion LaunchTemplateLaunchTemplateVersion: Instance launch template version information

launch_template_name str: Instance launch template name.
default_version_number int: Instance launch template default version number
launch_template_project_name str: Project associated with the instance launch template.
launch_template_tags Sequence[LaunchTemplateLaunchTemplateTagArgs]
launch_template_version LaunchTemplateLaunchTemplateVersionArgs: Instance launch template version information

launchTemplateName String: Instance launch template name.
defaultVersionNumber Number: Instance launch template default version number
launchTemplateProjectName String: Project associated with the instance launch template.
launchTemplateTags List<Property Map>
launchTemplateVersion Property Map: Instance launch template version information

Outputs

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

CreatedAt string: Instance launch template creation time
Id string: The provider-assigned unique ID for this managed resource.
LatestVersionNumber int: Latest version number of the instance launch template.
LaunchTemplateId string: Instance launch template ID
UpdatedAt string: Instance launch template update time

CreatedAt string: Instance launch template creation time
Id string: The provider-assigned unique ID for this managed resource.
LatestVersionNumber int: Latest version number of the instance launch template.
LaunchTemplateId string: Instance launch template ID
UpdatedAt string: Instance launch template update time

createdAt String: Instance launch template creation time
id String: The provider-assigned unique ID for this managed resource.
latestVersionNumber Integer: Latest version number of the instance launch template.
launchTemplateId String: Instance launch template ID
updatedAt String: Instance launch template update time

createdAt string: Instance launch template creation time
id string: The provider-assigned unique ID for this managed resource.
latestVersionNumber number: Latest version number of the instance launch template.
launchTemplateId string: Instance launch template ID
updatedAt string: Instance launch template update time

created_at str: Instance launch template creation time
id str: The provider-assigned unique ID for this managed resource.
latest_version_number int: Latest version number of the instance launch template.
launch_template_id str: Instance launch template ID
updated_at str: Instance launch template update time

createdAt String: Instance launch template creation time
id String: The provider-assigned unique ID for this managed resource.
latestVersionNumber Number: Latest version number of the instance launch template.
launchTemplateId String: Instance launch template ID
updatedAt String: Instance launch template update time

Look up Existing LaunchTemplate Resource

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

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        created_at: Optional[str] = None,
        default_version_number: Optional[int] = None,
        latest_version_number: Optional[int] = None,
        launch_template_id: Optional[str] = None,
        launch_template_name: Optional[str] = None,
        launch_template_project_name: Optional[str] = None,
        launch_template_tags: Optional[Sequence[LaunchTemplateLaunchTemplateTagArgs]] = None,
        launch_template_version: Optional[LaunchTemplateLaunchTemplateVersionArgs] = None,
        updated_at: Optional[str] = None) -> LaunchTemplate

func GetLaunchTemplate(ctx *Context, name string, id IDInput, state *LaunchTemplateState, opts ...ResourceOption) (*LaunchTemplate, error)

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

public static LaunchTemplate get(String name, Output<String> id, LaunchTemplateState state, CustomResourceOptions options)

resources:  _:    type: volcenginecc:ecs:LaunchTemplate    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:

CreatedAt string: Instance launch template creation time
DefaultVersionNumber int: Instance launch template default version number
LatestVersionNumber int: Latest version number of the instance launch template.
LaunchTemplateId string: Instance launch template ID
LaunchTemplateName string: Instance launch template name.
LaunchTemplateProjectName string: Project associated with the instance launch template.
LaunchTemplateTags List<Volcengine.LaunchTemplateLaunchTemplateTag>
LaunchTemplateVersion Volcengine.LaunchTemplateLaunchTemplateVersion: Instance launch template version information
UpdatedAt string: Instance launch template update time

CreatedAt string: Instance launch template creation time
DefaultVersionNumber int: Instance launch template default version number
LatestVersionNumber int: Latest version number of the instance launch template.
LaunchTemplateId string: Instance launch template ID
LaunchTemplateName string: Instance launch template name.
LaunchTemplateProjectName string: Project associated with the instance launch template.
LaunchTemplateTags []LaunchTemplateLaunchTemplateTagArgs
LaunchTemplateVersion LaunchTemplateLaunchTemplateVersionArgs: Instance launch template version information
UpdatedAt string: Instance launch template update time

createdAt String: Instance launch template creation time
defaultVersionNumber Integer: Instance launch template default version number
latestVersionNumber Integer: Latest version number of the instance launch template.
launchTemplateId String: Instance launch template ID
launchTemplateName String: Instance launch template name.
launchTemplateProjectName String: Project associated with the instance launch template.
launchTemplateTags List<LaunchTemplateLaunchTemplateTag>
launchTemplateVersion LaunchTemplateLaunchTemplateVersion: Instance launch template version information
updatedAt String: Instance launch template update time

createdAt string: Instance launch template creation time
defaultVersionNumber number: Instance launch template default version number
latestVersionNumber number: Latest version number of the instance launch template.
launchTemplateId string: Instance launch template ID
launchTemplateName string: Instance launch template name.
launchTemplateProjectName string: Project associated with the instance launch template.
launchTemplateTags LaunchTemplateLaunchTemplateTag[]
launchTemplateVersion LaunchTemplateLaunchTemplateVersion: Instance launch template version information
updatedAt string: Instance launch template update time

created_at str: Instance launch template creation time
default_version_number int: Instance launch template default version number
latest_version_number int: Latest version number of the instance launch template.
launch_template_id str: Instance launch template ID
launch_template_name str: Instance launch template name.
launch_template_project_name str: Project associated with the instance launch template.
launch_template_tags Sequence[LaunchTemplateLaunchTemplateTagArgs]
launch_template_version LaunchTemplateLaunchTemplateVersionArgs: Instance launch template version information
updated_at str: Instance launch template update time

createdAt String: Instance launch template creation time
defaultVersionNumber Number: Instance launch template default version number
latestVersionNumber Number: Latest version number of the instance launch template.
launchTemplateId String: Instance launch template ID
launchTemplateName String: Instance launch template name.
launchTemplateProjectName String: Project associated with the instance launch template.
launchTemplateTags List<Property Map>
launchTemplateVersion Property Map: Instance launch template version information
updatedAt String: Instance launch template update time

Supporting Types

LaunchTemplateLaunchTemplateTag, LaunchTemplateLaunchTemplateTagArgs

Key string: Tag key for user tags added to the resource.
Value string: User tag value added to the resource

Key string: Tag key for user tags added to the resource.
Value string: User tag value added to the resource

key String: Tag key for user tags added to the resource.
value String: User tag value added to the resource

key string: Tag key for user tags added to the resource.
value string: User tag value added to the resource

key str: Tag key for user tags added to the resource.
value str: User tag value added to the resource

key String: Tag key for user tags added to the resource.
value String: User tag value added to the resource

LaunchTemplateLaunchTemplateVersion, LaunchTemplateLaunchTemplateVersionArgs

DeploymentSetGroupNumber int: When the ECS instance needs to join or adjust the deployment set strategy to the deployment set group high availability strategy (AvailabilityGroup), you can use this parameter to specify the group number of the instance in the deployment set.
DeploymentSetId string: Deployment set ID the instance needs to join.
Description string: Instance description
Eip Volcengine.LaunchTemplateLaunchTemplateVersionEip: Public IP information bound to the instance
HostName string: Instance hostname. For Linux, the hostname length must be 2–59 characters. For Windows, the hostname length must be 2–10 characters.
HpcClusterId string: When creating a high-performance computing GPU instance, please specify the high-performance computing cluster ID.
ImageId string: Image ID.
ImageName string: Image name.
InstanceChargeType string: Billing type for the instance and cloud disk. Options: PostPaid: Pay-as-you-go. PrePaid: Yearly/monthly subscription. Esi: Elastic reservation instance. Segmented: Time-based elastic reservation instance.
InstanceName string: Instance name.
InstanceTypeId string: Instance specification
KeepImageCredential bool: Whether to retain image settings. Values: true: Retain image settings. If retained, the instance will use the preset password or key pair from the image for login. false (default): Do not retain image settings.
KeyPairName string: Key pair bound to the instance.
NetworkInterfaces List<Volcengine.LaunchTemplateLaunchTemplateVersionNetworkInterface>
ProjectName string: Project associated with the instance.
ScheduledInstance Volcengine.LaunchTemplateLaunchTemplateVersionScheduledInstance: Elastic reservation order information
SecurityEnhancementStrategy string: Enable security hardening. Active: Enable security hardening, applies only to public images. InActive: Disable security hardening, applies to all images.
SpotPriceLimit double: Maximum hourly price for preemptible instances
SpotStrategy string: Preemptible strategy for pay-as-you-go billing. Options: NoSpot: Create a regular pay-as-you-go instance. SpotAsPriceGo: System automatically bids, follows the current market price for preemptible instances. SpotWithPriceLimit: Preemptible instance with a bid limit.
SuffixIndex int: Starting number for the sequential suffix
Tags List<Volcengine.LaunchTemplateLaunchTemplateVersionTag>
UniqueSuffix bool: Indicates whether to automatically add sequential suffixes to Hostname and InstanceName when creating multiple instances
UserData string: Custom data for the instance.
VersionDescription string: Template version description.
Volumes List<Volcengine.LaunchTemplateLaunchTemplateVersionVolume>
VpcId string: Private network ID.
ZoneId string: Instance availability zone ID

DeploymentSetGroupNumber int: When the ECS instance needs to join or adjust the deployment set strategy to the deployment set group high availability strategy (AvailabilityGroup), you can use this parameter to specify the group number of the instance in the deployment set.
DeploymentSetId string: Deployment set ID the instance needs to join.
Description string: Instance description
Eip LaunchTemplateLaunchTemplateVersionEip: Public IP information bound to the instance
HostName string: Instance hostname. For Linux, the hostname length must be 2–59 characters. For Windows, the hostname length must be 2–10 characters.
HpcClusterId string: When creating a high-performance computing GPU instance, please specify the high-performance computing cluster ID.
ImageId string: Image ID.
ImageName string: Image name.
InstanceChargeType string: Billing type for the instance and cloud disk. Options: PostPaid: Pay-as-you-go. PrePaid: Yearly/monthly subscription. Esi: Elastic reservation instance. Segmented: Time-based elastic reservation instance.
InstanceName string: Instance name.
InstanceTypeId string: Instance specification
KeepImageCredential bool: Whether to retain image settings. Values: true: Retain image settings. If retained, the instance will use the preset password or key pair from the image for login. false (default): Do not retain image settings.
KeyPairName string: Key pair bound to the instance.
NetworkInterfaces []LaunchTemplateLaunchTemplateVersionNetworkInterface
ProjectName string: Project associated with the instance.
ScheduledInstance LaunchTemplateLaunchTemplateVersionScheduledInstance: Elastic reservation order information
SecurityEnhancementStrategy string: Enable security hardening. Active: Enable security hardening, applies only to public images. InActive: Disable security hardening, applies to all images.
SpotPriceLimit float64: Maximum hourly price for preemptible instances
SpotStrategy string: Preemptible strategy for pay-as-you-go billing. Options: NoSpot: Create a regular pay-as-you-go instance. SpotAsPriceGo: System automatically bids, follows the current market price for preemptible instances. SpotWithPriceLimit: Preemptible instance with a bid limit.
SuffixIndex int: Starting number for the sequential suffix
Tags []LaunchTemplateLaunchTemplateVersionTag
UniqueSuffix bool: Indicates whether to automatically add sequential suffixes to Hostname and InstanceName when creating multiple instances
UserData string: Custom data for the instance.
VersionDescription string: Template version description.
Volumes []LaunchTemplateLaunchTemplateVersionVolume
VpcId string: Private network ID.
ZoneId string: Instance availability zone ID

deploymentSetGroupNumber Integer: When the ECS instance needs to join or adjust the deployment set strategy to the deployment set group high availability strategy (AvailabilityGroup), you can use this parameter to specify the group number of the instance in the deployment set.
deploymentSetId String: Deployment set ID the instance needs to join.
description String: Instance description
eip LaunchTemplateLaunchTemplateVersionEip: Public IP information bound to the instance
hostName String: Instance hostname. For Linux, the hostname length must be 2–59 characters. For Windows, the hostname length must be 2–10 characters.
hpcClusterId String: When creating a high-performance computing GPU instance, please specify the high-performance computing cluster ID.
imageId String: Image ID.
imageName String: Image name.
instanceChargeType String: Billing type for the instance and cloud disk. Options: PostPaid: Pay-as-you-go. PrePaid: Yearly/monthly subscription. Esi: Elastic reservation instance. Segmented: Time-based elastic reservation instance.
instanceName String: Instance name.
instanceTypeId String: Instance specification
keepImageCredential Boolean: Whether to retain image settings. Values: true: Retain image settings. If retained, the instance will use the preset password or key pair from the image for login. false (default): Do not retain image settings.
keyPairName String: Key pair bound to the instance.
networkInterfaces List<LaunchTemplateLaunchTemplateVersionNetworkInterface>
projectName String: Project associated with the instance.
scheduledInstance LaunchTemplateLaunchTemplateVersionScheduledInstance: Elastic reservation order information
securityEnhancementStrategy String: Enable security hardening. Active: Enable security hardening, applies only to public images. InActive: Disable security hardening, applies to all images.
spotPriceLimit Double: Maximum hourly price for preemptible instances
spotStrategy String: Preemptible strategy for pay-as-you-go billing. Options: NoSpot: Create a regular pay-as-you-go instance. SpotAsPriceGo: System automatically bids, follows the current market price for preemptible instances. SpotWithPriceLimit: Preemptible instance with a bid limit.
suffixIndex Integer: Starting number for the sequential suffix
tags List<LaunchTemplateLaunchTemplateVersionTag>
uniqueSuffix Boolean: Indicates whether to automatically add sequential suffixes to Hostname and InstanceName when creating multiple instances
userData String: Custom data for the instance.
versionDescription String: Template version description.
volumes List<LaunchTemplateLaunchTemplateVersionVolume>
vpcId String: Private network ID.
zoneId String: Instance availability zone ID

deploymentSetGroupNumber number: When the ECS instance needs to join or adjust the deployment set strategy to the deployment set group high availability strategy (AvailabilityGroup), you can use this parameter to specify the group number of the instance in the deployment set.
deploymentSetId string: Deployment set ID the instance needs to join.
description string: Instance description
eip LaunchTemplateLaunchTemplateVersionEip: Public IP information bound to the instance
hostName string: Instance hostname. For Linux, the hostname length must be 2–59 characters. For Windows, the hostname length must be 2–10 characters.
hpcClusterId string: When creating a high-performance computing GPU instance, please specify the high-performance computing cluster ID.
imageId string: Image ID.
imageName string: Image name.
instanceChargeType string: Billing type for the instance and cloud disk. Options: PostPaid: Pay-as-you-go. PrePaid: Yearly/monthly subscription. Esi: Elastic reservation instance. Segmented: Time-based elastic reservation instance.
instanceName string: Instance name.
instanceTypeId string: Instance specification
keepImageCredential boolean: Whether to retain image settings. Values: true: Retain image settings. If retained, the instance will use the preset password or key pair from the image for login. false (default): Do not retain image settings.
keyPairName string: Key pair bound to the instance.
networkInterfaces LaunchTemplateLaunchTemplateVersionNetworkInterface[]
projectName string: Project associated with the instance.
scheduledInstance LaunchTemplateLaunchTemplateVersionScheduledInstance: Elastic reservation order information
securityEnhancementStrategy string: Enable security hardening. Active: Enable security hardening, applies only to public images. InActive: Disable security hardening, applies to all images.
spotPriceLimit number: Maximum hourly price for preemptible instances
spotStrategy string: Preemptible strategy for pay-as-you-go billing. Options: NoSpot: Create a regular pay-as-you-go instance. SpotAsPriceGo: System automatically bids, follows the current market price for preemptible instances. SpotWithPriceLimit: Preemptible instance with a bid limit.
suffixIndex number: Starting number for the sequential suffix
tags LaunchTemplateLaunchTemplateVersionTag[]
uniqueSuffix boolean: Indicates whether to automatically add sequential suffixes to Hostname and InstanceName when creating multiple instances
userData string: Custom data for the instance.
versionDescription string: Template version description.
volumes LaunchTemplateLaunchTemplateVersionVolume[]
vpcId string: Private network ID.
zoneId string: Instance availability zone ID

deployment_set_group_number int: When the ECS instance needs to join or adjust the deployment set strategy to the deployment set group high availability strategy (AvailabilityGroup), you can use this parameter to specify the group number of the instance in the deployment set.
deployment_set_id str: Deployment set ID the instance needs to join.
description str: Instance description
eip LaunchTemplateLaunchTemplateVersionEip: Public IP information bound to the instance
host_name str: Instance hostname. For Linux, the hostname length must be 2–59 characters. For Windows, the hostname length must be 2–10 characters.
hpc_cluster_id str: When creating a high-performance computing GPU instance, please specify the high-performance computing cluster ID.
image_id str: Image ID.
image_name str: Image name.
instance_charge_type str: Billing type for the instance and cloud disk. Options: PostPaid: Pay-as-you-go. PrePaid: Yearly/monthly subscription. Esi: Elastic reservation instance. Segmented: Time-based elastic reservation instance.
instance_name str: Instance name.
instance_type_id str: Instance specification
keep_image_credential bool: Whether to retain image settings. Values: true: Retain image settings. If retained, the instance will use the preset password or key pair from the image for login. false (default): Do not retain image settings.
key_pair_name str: Key pair bound to the instance.
network_interfaces Sequence[LaunchTemplateLaunchTemplateVersionNetworkInterface]
project_name str: Project associated with the instance.
scheduled_instance LaunchTemplateLaunchTemplateVersionScheduledInstance: Elastic reservation order information
security_enhancement_strategy str: Enable security hardening. Active: Enable security hardening, applies only to public images. InActive: Disable security hardening, applies to all images.
spot_price_limit float: Maximum hourly price for preemptible instances
spot_strategy str: Preemptible strategy for pay-as-you-go billing. Options: NoSpot: Create a regular pay-as-you-go instance. SpotAsPriceGo: System automatically bids, follows the current market price for preemptible instances. SpotWithPriceLimit: Preemptible instance with a bid limit.
suffix_index int: Starting number for the sequential suffix
tags Sequence[LaunchTemplateLaunchTemplateVersionTag]
unique_suffix bool: Indicates whether to automatically add sequential suffixes to Hostname and InstanceName when creating multiple instances
user_data str: Custom data for the instance.
version_description str: Template version description.
volumes Sequence[LaunchTemplateLaunchTemplateVersionVolume]
vpc_id str: Private network ID.
zone_id str: Instance availability zone ID

deploymentSetGroupNumber Number: When the ECS instance needs to join or adjust the deployment set strategy to the deployment set group high availability strategy (AvailabilityGroup), you can use this parameter to specify the group number of the instance in the deployment set.
deploymentSetId String: Deployment set ID the instance needs to join.
description String: Instance description
eip Property Map: Public IP information bound to the instance
hostName String: Instance hostname. For Linux, the hostname length must be 2–59 characters. For Windows, the hostname length must be 2–10 characters.
hpcClusterId String: When creating a high-performance computing GPU instance, please specify the high-performance computing cluster ID.
imageId String: Image ID.
imageName String: Image name.
instanceChargeType String: Billing type for the instance and cloud disk. Options: PostPaid: Pay-as-you-go. PrePaid: Yearly/monthly subscription. Esi: Elastic reservation instance. Segmented: Time-based elastic reservation instance.
instanceName String: Instance name.
instanceTypeId String: Instance specification
keepImageCredential Boolean: Whether to retain image settings. Values: true: Retain image settings. If retained, the instance will use the preset password or key pair from the image for login. false (default): Do not retain image settings.
keyPairName String: Key pair bound to the instance.
networkInterfaces List<Property Map>
projectName String: Project associated with the instance.
scheduledInstance Property Map: Elastic reservation order information
securityEnhancementStrategy String: Enable security hardening. Active: Enable security hardening, applies only to public images. InActive: Disable security hardening, applies to all images.
spotPriceLimit Number: Maximum hourly price for preemptible instances
spotStrategy String: Preemptible strategy for pay-as-you-go billing. Options: NoSpot: Create a regular pay-as-you-go instance. SpotAsPriceGo: System automatically bids, follows the current market price for preemptible instances. SpotWithPriceLimit: Preemptible instance with a bid limit.
suffixIndex Number: Starting number for the sequential suffix
tags List<Property Map>
uniqueSuffix Boolean: Indicates whether to automatically add sequential suffixes to Hostname and InstanceName when creating multiple instances
userData String: Custom data for the instance.
versionDescription String: Template version description.
volumes List<Property Map>
vpcId String: Private network ID.
zoneId String: Instance availability zone ID

LaunchTemplateLaunchTemplateVersionEip, LaunchTemplateLaunchTemplateVersionEipArgs

Bandwidth int: Public IP bandwidth cap, unit: Mbps. Value range: 1–200. Default: 1.
BandwidthPackageId string: Shared bandwidth package ID, indicates adding the public IP to the shared bandwidth package.
BillingType int: Billing method for public IP. Values: 2: Pay-as-you-go—by bandwidth cap. 3: Pay-as-you-go—by actual traffic.
Isp string: Line type for the public IP. Options: BGP: BGP (multi-line). ChinaMobile: China Mobile static single line. ChinaTelecom: China Telecom static single line. ChinaUnicom: China Unicom static single line.
ReleaseWithInstance bool: Whether the public IP is released with the instance; only applies to pay-as-you-go public IPs
SecurityProtectionInstanceId int: Security protection package ID
SecurityProtectionTypes List<string>: Security protection type for public IP. Value: AntiDDoS_Enhanced: Apply for a public IP with enhanced protection, which can be added to a DDoS Native Protection (Enterprise Edition) instance.

Bandwidth int: Public IP bandwidth cap, unit: Mbps. Value range: 1–200. Default: 1.
BandwidthPackageId string: Shared bandwidth package ID, indicates adding the public IP to the shared bandwidth package.
BillingType int: Billing method for public IP. Values: 2: Pay-as-you-go—by bandwidth cap. 3: Pay-as-you-go—by actual traffic.
Isp string: Line type for the public IP. Options: BGP: BGP (multi-line). ChinaMobile: China Mobile static single line. ChinaTelecom: China Telecom static single line. ChinaUnicom: China Unicom static single line.
ReleaseWithInstance bool: Whether the public IP is released with the instance; only applies to pay-as-you-go public IPs
SecurityProtectionInstanceId int: Security protection package ID
SecurityProtectionTypes []string: Security protection type for public IP. Value: AntiDDoS_Enhanced: Apply for a public IP with enhanced protection, which can be added to a DDoS Native Protection (Enterprise Edition) instance.

bandwidth Integer: Public IP bandwidth cap, unit: Mbps. Value range: 1–200. Default: 1.
bandwidthPackageId String: Shared bandwidth package ID, indicates adding the public IP to the shared bandwidth package.
billingType Integer: Billing method for public IP. Values: 2: Pay-as-you-go—by bandwidth cap. 3: Pay-as-you-go—by actual traffic.
isp String: Line type for the public IP. Options: BGP: BGP (multi-line). ChinaMobile: China Mobile static single line. ChinaTelecom: China Telecom static single line. ChinaUnicom: China Unicom static single line.
releaseWithInstance Boolean: Whether the public IP is released with the instance; only applies to pay-as-you-go public IPs
securityProtectionInstanceId Integer: Security protection package ID
securityProtectionTypes List<String>: Security protection type for public IP. Value: AntiDDoS_Enhanced: Apply for a public IP with enhanced protection, which can be added to a DDoS Native Protection (Enterprise Edition) instance.

bandwidth number: Public IP bandwidth cap, unit: Mbps. Value range: 1–200. Default: 1.
bandwidthPackageId string: Shared bandwidth package ID, indicates adding the public IP to the shared bandwidth package.
billingType number: Billing method for public IP. Values: 2: Pay-as-you-go—by bandwidth cap. 3: Pay-as-you-go—by actual traffic.
isp string: Line type for the public IP. Options: BGP: BGP (multi-line). ChinaMobile: China Mobile static single line. ChinaTelecom: China Telecom static single line. ChinaUnicom: China Unicom static single line.
releaseWithInstance boolean: Whether the public IP is released with the instance; only applies to pay-as-you-go public IPs
securityProtectionInstanceId number: Security protection package ID
securityProtectionTypes string[]: Security protection type for public IP. Value: AntiDDoS_Enhanced: Apply for a public IP with enhanced protection, which can be added to a DDoS Native Protection (Enterprise Edition) instance.

bandwidth int: Public IP bandwidth cap, unit: Mbps. Value range: 1–200. Default: 1.
bandwidth_package_id str: Shared bandwidth package ID, indicates adding the public IP to the shared bandwidth package.
billing_type int: Billing method for public IP. Values: 2: Pay-as-you-go—by bandwidth cap. 3: Pay-as-you-go—by actual traffic.
isp str: Line type for the public IP. Options: BGP: BGP (multi-line). ChinaMobile: China Mobile static single line. ChinaTelecom: China Telecom static single line. ChinaUnicom: China Unicom static single line.
release_with_instance bool: Whether the public IP is released with the instance; only applies to pay-as-you-go public IPs
security_protection_instance_id int: Security protection package ID
security_protection_types Sequence[str]: Security protection type for public IP. Value: AntiDDoS_Enhanced: Apply for a public IP with enhanced protection, which can be added to a DDoS Native Protection (Enterprise Edition) instance.

bandwidth Number: Public IP bandwidth cap, unit: Mbps. Value range: 1–200. Default: 1.
bandwidthPackageId String: Shared bandwidth package ID, indicates adding the public IP to the shared bandwidth package.
billingType Number: Billing method for public IP. Values: 2: Pay-as-you-go—by bandwidth cap. 3: Pay-as-you-go—by actual traffic.
isp String: Line type for the public IP. Options: BGP: BGP (multi-line). ChinaMobile: China Mobile static single line. ChinaTelecom: China Telecom static single line. ChinaUnicom: China Unicom static single line.
releaseWithInstance Boolean: Whether the public IP is released with the instance; only applies to pay-as-you-go public IPs
securityProtectionInstanceId Number: Security protection package ID
securityProtectionTypes List<String>: Security protection type for public IP. Value: AntiDDoS_Enhanced: Apply for a public IP with enhanced protection, which can be added to a DDoS Native Protection (Enterprise Edition) instance.

LaunchTemplateLaunchTemplateVersionNetworkInterface, LaunchTemplateLaunchTemplateVersionNetworkInterfaceArgs

SecurityGroupIds List<string>: Security group ID associated with the network interface.
SubnetId string: Instance VPC subnet ID

SecurityGroupIds []string: Security group ID associated with the network interface.
SubnetId string: Instance VPC subnet ID

securityGroupIds List<String>: Security group ID associated with the network interface.
subnetId String: Instance VPC subnet ID

securityGroupIds string[]: Security group ID associated with the network interface.
subnetId string: Instance VPC subnet ID

security_group_ids Sequence[str]: Security group ID associated with the network interface.
subnet_id str: Instance VPC subnet ID

securityGroupIds List<String>: Security group ID associated with the network interface.
subnetId String: Instance VPC subnet ID

LaunchTemplateLaunchTemplateVersionScheduledInstance, LaunchTemplateLaunchTemplateVersionScheduledInstanceArgs

ScheduledInstanceDescription string: Description of the elastic reservation order
ScheduledInstanceName string: Name of the elastic reservation order

ScheduledInstanceDescription string: Description of the elastic reservation order
ScheduledInstanceName string: Name of the elastic reservation order

scheduledInstanceDescription String: Description of the elastic reservation order
scheduledInstanceName String: Name of the elastic reservation order

scheduledInstanceDescription string: Description of the elastic reservation order
scheduledInstanceName string: Name of the elastic reservation order

scheduled_instance_description str: Description of the elastic reservation order
scheduled_instance_name str: Name of the elastic reservation order

scheduledInstanceDescription String: Description of the elastic reservation order
scheduledInstanceName String: Name of the elastic reservation order

LaunchTemplateLaunchTemplateVersionTag, LaunchTemplateLaunchTemplateVersionTagArgs

Key string: Tag key for user tags added to the resource.
Value string: User tag value added to the resource

Key string: Tag key for user tags added to the resource.
Value string: User tag value added to the resource

key String: Tag key for user tags added to the resource.
value String: User tag value added to the resource

key string: Tag key for user tags added to the resource.
value string: User tag value added to the resource

key str: Tag key for user tags added to the resource.
value str: User tag value added to the resource

key String: Tag key for user tags added to the resource.
value String: User tag value added to the resource

LaunchTemplateLaunchTemplateVersionVolume, LaunchTemplateLaunchTemplateVersionVolumeArgs

DeleteWithInstance bool: Whether the cloud disk is released with the instance
ExtraPerformanceIops int: Cloud disk extra IOPS performance size, supported only by ESSD FlexPL data disks, unit: operations/second. This parameter must be set when ExtraPerformanceTypeId is Balance or IOPS. The value ranges for each extra performance type are as follows: IOPS type: 1–50000. Balance type: 1–50000.
ExtraPerformanceThroughputMb int: Extra throughput performance size for the cloud disk, in MB/s. Only supported by ESSD FlexPL data disks. This parameter must be set when ExtraPerformanceTypeId is Throughput. Value range: 1–650.
ExtraPerformanceTypeId string: Type of cloud disk extra performance, supported only by ESSD FlexPL data disks. For more information about extra performance, see Cloud Disk Extra Performance. Values: Balance: Balanced extra performance. IOPS: IOPS extra performance. Throughput: Throughput extra performance.
Size int: Cloud disk size, unit: GB. System disk: ESSDPL0: 20–2048, PTSSD: 10–500. Data disk: ESSDPL0: 10–32768, PTSSD: 20–8192
SnapshotId string: Create a cloud disk using a snapshot, only supports creating data disks. You can call the DescribeSnapshots API to query the snapshot ID.
VolumeType string: Cloud disk type. ESSD_PL0: Ultra-fast SSD PL0. PTSSD: Performance SSD.

DeleteWithInstance bool: Whether the cloud disk is released with the instance
ExtraPerformanceIops int: Cloud disk extra IOPS performance size, supported only by ESSD FlexPL data disks, unit: operations/second. This parameter must be set when ExtraPerformanceTypeId is Balance or IOPS. The value ranges for each extra performance type are as follows: IOPS type: 1–50000. Balance type: 1–50000.
ExtraPerformanceThroughputMb int: Extra throughput performance size for the cloud disk, in MB/s. Only supported by ESSD FlexPL data disks. This parameter must be set when ExtraPerformanceTypeId is Throughput. Value range: 1–650.
ExtraPerformanceTypeId string: Type of cloud disk extra performance, supported only by ESSD FlexPL data disks. For more information about extra performance, see Cloud Disk Extra Performance. Values: Balance: Balanced extra performance. IOPS: IOPS extra performance. Throughput: Throughput extra performance.
Size int: Cloud disk size, unit: GB. System disk: ESSDPL0: 20–2048, PTSSD: 10–500. Data disk: ESSDPL0: 10–32768, PTSSD: 20–8192
SnapshotId string: Create a cloud disk using a snapshot, only supports creating data disks. You can call the DescribeSnapshots API to query the snapshot ID.
VolumeType string: Cloud disk type. ESSD_PL0: Ultra-fast SSD PL0. PTSSD: Performance SSD.

deleteWithInstance Boolean: Whether the cloud disk is released with the instance
extraPerformanceIops Integer: Cloud disk extra IOPS performance size, supported only by ESSD FlexPL data disks, unit: operations/second. This parameter must be set when ExtraPerformanceTypeId is Balance or IOPS. The value ranges for each extra performance type are as follows: IOPS type: 1–50000. Balance type: 1–50000.
extraPerformanceThroughputMb Integer: Extra throughput performance size for the cloud disk, in MB/s. Only supported by ESSD FlexPL data disks. This parameter must be set when ExtraPerformanceTypeId is Throughput. Value range: 1–650.
extraPerformanceTypeId String: Type of cloud disk extra performance, supported only by ESSD FlexPL data disks. For more information about extra performance, see Cloud Disk Extra Performance. Values: Balance: Balanced extra performance. IOPS: IOPS extra performance. Throughput: Throughput extra performance.
size Integer: Cloud disk size, unit: GB. System disk: ESSDPL0: 20–2048, PTSSD: 10–500. Data disk: ESSDPL0: 10–32768, PTSSD: 20–8192
snapshotId String: Create a cloud disk using a snapshot, only supports creating data disks. You can call the DescribeSnapshots API to query the snapshot ID.
volumeType String: Cloud disk type. ESSD_PL0: Ultra-fast SSD PL0. PTSSD: Performance SSD.

deleteWithInstance boolean: Whether the cloud disk is released with the instance
extraPerformanceIops number: Cloud disk extra IOPS performance size, supported only by ESSD FlexPL data disks, unit: operations/second. This parameter must be set when ExtraPerformanceTypeId is Balance or IOPS. The value ranges for each extra performance type are as follows: IOPS type: 1–50000. Balance type: 1–50000.
extraPerformanceThroughputMb number: Extra throughput performance size for the cloud disk, in MB/s. Only supported by ESSD FlexPL data disks. This parameter must be set when ExtraPerformanceTypeId is Throughput. Value range: 1–650.
extraPerformanceTypeId string: Type of cloud disk extra performance, supported only by ESSD FlexPL data disks. For more information about extra performance, see Cloud Disk Extra Performance. Values: Balance: Balanced extra performance. IOPS: IOPS extra performance. Throughput: Throughput extra performance.
size number: Cloud disk size, unit: GB. System disk: ESSDPL0: 20–2048, PTSSD: 10–500. Data disk: ESSDPL0: 10–32768, PTSSD: 20–8192
snapshotId string: Create a cloud disk using a snapshot, only supports creating data disks. You can call the DescribeSnapshots API to query the snapshot ID.
volumeType string: Cloud disk type. ESSD_PL0: Ultra-fast SSD PL0. PTSSD: Performance SSD.

delete_with_instance bool: Whether the cloud disk is released with the instance
extra_performance_iops int: Cloud disk extra IOPS performance size, supported only by ESSD FlexPL data disks, unit: operations/second. This parameter must be set when ExtraPerformanceTypeId is Balance or IOPS. The value ranges for each extra performance type are as follows: IOPS type: 1–50000. Balance type: 1–50000.
extra_performance_throughput_mb int: Extra throughput performance size for the cloud disk, in MB/s. Only supported by ESSD FlexPL data disks. This parameter must be set when ExtraPerformanceTypeId is Throughput. Value range: 1–650.
extra_performance_type_id str: Type of cloud disk extra performance, supported only by ESSD FlexPL data disks. For more information about extra performance, see Cloud Disk Extra Performance. Values: Balance: Balanced extra performance. IOPS: IOPS extra performance. Throughput: Throughput extra performance.
size int: Cloud disk size, unit: GB. System disk: ESSDPL0: 20–2048, PTSSD: 10–500. Data disk: ESSDPL0: 10–32768, PTSSD: 20–8192
snapshot_id str: Create a cloud disk using a snapshot, only supports creating data disks. You can call the DescribeSnapshots API to query the snapshot ID.
volume_type str: Cloud disk type. ESSD_PL0: Ultra-fast SSD PL0. PTSSD: Performance SSD.

deleteWithInstance Boolean: Whether the cloud disk is released with the instance
extraPerformanceIops Number: Cloud disk extra IOPS performance size, supported only by ESSD FlexPL data disks, unit: operations/second. This parameter must be set when ExtraPerformanceTypeId is Balance or IOPS. The value ranges for each extra performance type are as follows: IOPS type: 1–50000. Balance type: 1–50000.
extraPerformanceThroughputMb Number: Extra throughput performance size for the cloud disk, in MB/s. Only supported by ESSD FlexPL data disks. This parameter must be set when ExtraPerformanceTypeId is Throughput. Value range: 1–650.
extraPerformanceTypeId String: Type of cloud disk extra performance, supported only by ESSD FlexPL data disks. For more information about extra performance, see Cloud Disk Extra Performance. Values: Balance: Balanced extra performance. IOPS: IOPS extra performance. Throughput: Throughput extra performance.
size Number: Cloud disk size, unit: GB. System disk: ESSDPL0: 20–2048, PTSSD: 10–500. Data disk: ESSDPL0: 10–32768, PTSSD: 20–8192
snapshotId String: Create a cloud disk using a snapshot, only supports creating data disks. You can call the DescribeSnapshots API to query the snapshot ID.
volumeType String: Cloud disk type. ESSD_PL0: Ultra-fast SSD PL0. PTSSD: Performance SSD.

Import

$ pulumi import volcenginecc:ecs/launchTemplate:LaunchTemplate example "launch_template_id"

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

Package Details

Repository: volcenginecc volcengine/pulumi-volcenginecc
License: MPL-2.0
Notes: This Pulumi package is based on the volcenginecc Terraform Provider.

Viewing docs for volcenginecc v0.0.32
published on Thursday, Apr 23, 2026 by Volcengine

Schema (JSON)

volcengine/pulumi-volcenginecc

volcenginecc.ecs.LaunchTemplate

On this page

On this page

Example Usage

Create LaunchTemplate Resource

Constructor syntax

Parameters

LaunchTemplate Resource Properties

Inputs

Outputs

Look up Existing LaunchTemplate Resource

Supporting Types

LaunchTemplateLaunchTemplateTag, LaunchTemplateLaunchTemplateTagArgs

LaunchTemplateLaunchTemplateVersion, LaunchTemplateLaunchTemplateVersionArgs

LaunchTemplateLaunchTemplateVersionEip, LaunchTemplateLaunchTemplateVersionEipArgs

LaunchTemplateLaunchTemplateVersionNetworkInterface, LaunchTemplateLaunchTemplateVersionNetworkInterfaceArgs

LaunchTemplateLaunchTemplateVersionScheduledInstance, LaunchTemplateLaunchTemplateVersionScheduledInstanceArgs

LaunchTemplateLaunchTemplateVersionTag, LaunchTemplateLaunchTemplateVersionTagArgs

LaunchTemplateLaunchTemplateVersionVolume, LaunchTemplateLaunchTemplateVersionVolumeArgs

Import

Package Details

On this page

On this page