文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>云应用>服务商指南>参考手册>资源类型手册>tencentcloud_instance

tencentcloud_instance

最近更新时间：2025-09-04 14:56:13

我的收藏

本页目录：

描述

腾讯云云服务器，产品介绍。
支持的购买方式：
后付费
预付费（用户余额支付）

示例

resource "tencentcloud_instance" "main" {
  instance_name     = "${var.short_name}_instance"
  availability_zone = "${var.availability_zone}"
  image_id          = "img-eb30mz89"
  instance_type     = "S6.MEDIUM4"
  password          = "${var.password}"

  vpc_id            = "${tencentcloud_vpc.main.id}"
  subnet_id         = "${tencentcloud_subnet.main.id}"
  system_disk_size  = 50

  instance_charge_type = "PREPAID"
  instance_charge_type_prepaid_period = 1
  cam_role_name     = var.cloudapp_cam_role

  data_disks {
    data_disk_type = "CLOUD_PREMIUM"
    data_disk_size = 200
  }

  count = 1
}

参数说明

类型
名称
数据类型
说明
必填
region
string
地域，如：ap-guangzhou，默认使用 provider 中定义的 region 也可以在 resource 中指定地域，覆盖默认设置
availability_zone
string
可用区
image_id
string
指定有效的镜像 ID，格式形如 img-xxx。
可选
count
int
资源数量，默认为 1 如果为 0 则不创建资源
activity_id
int
计费活动 ID，保留字段
instance_type
string
实例机型。不同实例机型指定了不同的资源规格。详见参数定义
instance_charge_type
enum
实例计费类型。默认按量付费
枚举值：
PREPAID：预付费
POSTPAID_BY_HOUR：按量付费
instance_charge_type_prepaid_period
int
预付费时长，单位为月，取值范围：1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 24, 36。
instance_charge_type_prepaid_renew_flag
enum
自动续费标识 枚举值：
NOTIFY_AND_AUTO_RENEW：通知过期且自动续费
NOTIFY_AND_MANUAL_RENEW：通知过期不自动续费
DISABLE_NOTIFY_AND_MANUAL_RENEW：不通知过期不自动续费
internet_charge_type
enum
网络计费类型。默认取值：非带宽包用户默认与子机付费类型保持一致。 查看参数定义
枚举值：
BANDWIDTH_PREPAID：预付费按带宽结算
BANDWIDTH_POSTPAID_BY_HOUR：带宽按小时后付费
BANDWIDTH_PACKAGE：带宽包用户
TRAFFIC_POSTPAID_BY_HOUR：流量按小时后付费
bandwidth_package_id
string
带宽包 ID
查看参数定义
internet_max_bandwidth_out
int
公网出带宽上限，单位：Mbps。 查看参数定义
allocate_public_ip
boolean
是否分配公网 IP，与 internet_max_bandwidth_out 参数一同出现
当公网带宽大于0Mbps时，可自由选择开通与否，默认开通公网 IP；当公网带宽为0，则不允许分配公网 IP
vpc_id
string
VPC ID
subnet_id
string
子网 ID
security_groups
string[]
安全组 ID 列表
system_disk_type
enum
系统盘类型。系统盘类型限制详见存储概述。
枚举值：
LOCAL_BASIC：本地硬盘
LOCAL_SSD：本地 SSD 硬盘
CLOUD_BASIC：普通云硬盘
CLOUD_SSD：SSD 云硬盘
CLOUD_PREMIUM：高性能云硬盘
CLOUD_BSSD：通用型 SSD 云硬盘
CLOUD_HSSD：增强型 SSD 云硬盘
CLOUD_TSSD：极速型 SSD 云硬盘
system_disk_size
int
系统盘大小，单位：GB。
system_disk_id
string
系统盘 ID
password
string
实例登录密码
user_data
string
推荐使用 user_data_raw，避免自己转义出现的异常，也更有可读性和可维护性 提供给实例使用的用户数据，已经过 base64 编码
user_data_raw
string
提供给实例使用的用户数据，未经过 base64 编码
data_disks
Schema[]
实例数据盘配置信息。若不指定该参数，则默认不购买数据盘。
支持购买的时候指定 21 块数据盘，最多包含 1 块 LOCAL_BASIC 数据盘或者 LOCAL_SSD 数据盘，最多包含 20 块 CLOUD_BASIC 数据盘、CLOUD_PREMIUM 数据盘或者 CLOUD_SSD 数据盘
Schema 类型详见：DataDiskSchema
cam_role_name
string
CAM 角色名称
key_ids
string[]
SSH 密钥 ID 列表
关联密钥后，可以通过对应的私钥来访问实例；密钥 与 密码 不能同时指定，同时 Windows 操作系统不支持指定密钥。
keep_image_login
boolean
保持镜像的原始设置。该参数与 password 或 key_ids 不能同时指定。
只有使用自定义镜像、共享镜像或外部导入镜像创建实例时才能指定该参数为 true。
取值范围：
true：表示保持镜像的登录设置
false：表示不保持镜像的登录设置
生成
id
string
资源实例 ID
create_time
string
资源创建时间
private_ip
string
内网 IP
public_ip
string
公网 IP
instance_name
string
实例名称，由服务统一生成

数据结构

DataDiskSchema

参数说明

类型
名称
数据类型
说明
必填
data_disk_type
string
数据盘类型，数据盘类型限制详见存储概述。
data_disk_size
int
数据盘大小，单位：GB。最小调整步长为10G
可选
data_disk_snapshot_id
string
快照 ID，如果传入则根据此快照创建云硬盘，快照类型必须为数据盘快照
delete_with_instance
boolean
数据盘是否随子机销毁，默认为 true
true：子机销毁时，销毁数据盘，只支持按小时后付费云盘 false：子机销毁时，保留数据盘
encrypt
boolean
数据盘是否加密，默认为 false
throughput_performance
int
云硬盘性能，单位：MB/s
生成
data_disk_id
string
数据盘 ID，自动生成，只读
LOCAL_BASIC 和 LOCAL_SSD 类型没有 ID，暂时不支持该参数
中国站
目录