数据类型

最近更新时间:2023-08-09 11:44:20

我的收藏
说明:
当前页面接口为旧版 API,未来可能停止维护,目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范,访问时延下降显著,建议使用 云服务器 API 3.0

Placement

说明:
描述了实例的抽象位置,包括其所在的可用区,所属的项目,宿主机等(仅CDH产品可用)。
名称
类型
是否必选
描述
Zone
String
实例所属的可用区 ID。该参数也可以通过调用 DescribeZones 的返回值中的 Zone 字段来获取。
ProjectId
Integer
实例所属项目ID。该参数可以通过调用 DescribeProject 的返回值中的 projectId 字段来获取。不填为默认项目。
HostIds.N
Array of Strings
实例所属的专用宿主机 ID 列表。如果您有购买专用宿主机并且指定了该参数,则您购买的实例就会随机的部署在这些专用宿主机上。当前暂不支持。

SystemDisk

说明:
描述了操作系统所在块设备即系统盘的信息。
名称
类型
是否必选
描述
DiskType
String
系统盘类型。系统盘类型限制详见 CVM 实例配置。取值范围:
LOCAL_BASIC:本地硬盘
LOCAL_SSD:本地SSD硬盘
CLOUD_BASIC:普通云硬盘
CLOUD_SSD:SSD云硬盘
默认取值:LOCAL_BASIC。
DiskId
String
系统盘ID。LOCAL_BASIC 和 LOCAL_SSD 类型没有 ID。暂时不支持该参数。
DiskSize
Integer
系统盘大小,单位:GB。默认值为 50。

DataDisk

说明:
描述了数据盘的信息。
名称
类型
是否必选
描述
DiskType
String
数据盘类型。数据盘类型限制详见 CVM 实例配置。取值范围:
LOCAL_BASIC:本地硬盘
LOCAL_SSD:本地SSD硬盘
CLOUD_BASIC:普通云硬盘
CLOUD_PREMIUM:高性能云硬盘
CLOUD_SSD:SSD云硬盘
默认取值:LOCAL_BASIC。
该参数对ResizeInstanceDisk接口无效。
DiskId
String
数据盘 ID。LOCAL_BASIC 和 LOCAL_SSD 类型没有 ID。暂时不支持该参数。
DiskSize
Integer
数据盘大小,单位:GB。最小调整步长为10G,不同数据盘类型取值范围不同,具体限制请参见:CVM 实例配置。默认值为0,表示不购买数据盘。

VirtualPrivateCloud

说明:
描述了 VPC 相关信息,包括子网,IP 信息等。
名称
类型
是否必选
描述
VpcId
String
私有网络ID,形如vpc-xxx。有效的VpcId可通过登录 控制台 查询;也可以调用接口 DescribeVpcEx ,从接口返回中的unVpcId字段获取。
SubnetId
String
私有网络子网ID,形如subnet-xxx。有效的私有网络子网ID可通过登录 控制台 查询;也可以调用接口 DescribeSubnetEx ,从接口返回中的unSubnetId字段获取。
AsVpcGateway
Boolean
是否用作公网网关。公网网关只有在实例拥有公网IP以及处于私有网络下时才能正常使用。取值范围:
TRUE:表示用作公网网关
FALSE:表示不用作公网网关
默认取值:FALSE。
PrivateIpAddresses.N
Array of Strings
私有子网 IP 数组,目前只支持一个 IP。在创建实例、修改实例 VPC 属性操作中可使用此参数。

InternetAccessible

说明:
描述了实例的公网可访问性,声明了实例的公网使用计费模式,最大带宽等。
名称
类型
是否必选
描述
InternetChargeType
String
网络计费类型。取值范围:
BANDWIDTH_PREPAID:预付费按带宽结算
TRAFFIC_POSTPAID_BY_HOUR:流量按小时后付费
BANDWIDTH_POSTPAID_BY_HOUR:带宽按小时后付费
BANDWIDTH_PACKAGE:带宽包用户
默认取值:TRAFFIC_POSTPAID_BY_HOUR。
InternetMaxBandwidthOut
Integer
公网出带宽上限,单位:Mbps。默认值:0Mbps。不同机型带宽上限范围不一致,具体限制详见 购买网络带宽
PublicIpAssigned
Boolean
是否分配公网IP。取值范围:
TRUE:表示分配公网 IP
FALSE:表示不分配公网 IP
当公网带宽大于 0Mbps 时,可自由选择开通与否,默认开通公网 IP;当公网带宽为0,则不允许分配公网 IP。

InstanceChargePrepaid

说明:
描述了实例的计费模式。
名称
类型
是否必选
描述
Period
Integer
购买实例的时长,单位:月。取值范围:1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 24, 36。
RenewFlag
String
自动续费标识。取值范围:
NOTIFY_AND_AUTO_RENEW:通知过期且自动续费
NOTIFY_AND_MANUAL_RENEW:通知过期不自动续费
DISABLE_NOTIFY_AND_MANUAL_RENEW:不通知过期不自动续费
默认取值:NOTIFY_AND_AUTO_RENEW。若该参数指定为NOTIFY_AND_AUTO_RENEW,在账户余额充足的情况下,实例到期后将按月自动续费。

LoginSettings

说明:
描述了实例登录相关配置与信息。
名称
类型
是否必选
描述
Password
String
实例登录密码。不同操作系统类型密码复杂度限制不一样,具体如下:
Linux 实例密码必须8到16位,至少包括两项[a-z,A-Z]、[0-9] 和 [( ) ` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ' , . ? / ]中的特殊符号。
Windows 实例密码必须12到16位,至少包括三项[a-z],[A-Z],[0-9] 和 [( ) ` ~ ! @ # $ % ^ & * - + = { } [ ] : ; ' , . ? /]中的特殊符号。
若不指定该参数,则由系统随机生成密码,并通过站内信方式通知到用户。
KeyIds.N
Array of Strings
密钥 ID 列表。关联密钥后,就可以通过对应的私钥来访问实例;KeyId 可通过接口 DescribeKeyPairs 获取,密钥与密码不能同时指定,同时 Windows 操作系统不支持指定密钥。当前仅支持购买的时候指定一个密钥。
KeepImageLogin
String
保持镜像的原始设置。该参数与Password或KeyIds.N不能同时指定。只有使用自定义镜像、共享镜像或外部导入镜像创建实例时才能指定该参数为TRUE。取值范围:
TRUE:表示保持镜像的登录设置
FALSE:表示不保持镜像的登录设置
默认取值:FALSE。

RunSecurityServiceEnabled

说明:
描述了 “云安全” 服务相关的信息。
名称
类型
是否必选
描述
Enabled
Boolean
是否开启 云安全 服务。取值范围:
TRUE:表示开启云安全服务
FALSE:表示不开启云安全服务
默认取值:TRUE。

RunMonitorServiceEnabled

说明:
描述了 “腾讯云可观测平台” 服务相关的信息。
名称
类型
是否必选
描述
Enabled
Boolean
是否开启 腾讯云可观测平台 服务。取值范围:
TRUE:表示开启腾讯云可观测平台服务
FALSE:表示不开启腾讯云可观测平台服务
默认取值:TRUE。

EnhancedService

说明:
描述了实例的增强服务启用情况与其设置,如云安全,腾讯云可观测平台等实例 Agent。
名称
类型
是否必选
描述
SecurityService
开启云安全服务。若不指定该参数,则默认开启云安全服务。
MonitorService
开启云安全服务。若不指定该参数,则默认开启腾讯云可观测平台服务。

ItemPrice

说明:
描述了单项的价格信息。
名称
类型
是否必选
描述
UnitPrice
Float
后续单价,单位:元。
ChargeUnit
String
后续计价单元,可取值范围:
HOUR:表示计价单元是按每小时来计算。当前涉及该计价单元的场景有:实例按小时后付费(POSTPAID_BY_HOUR)、带宽按小时后付费(BANDWIDTH_POSTPAID_BY_HOUR)。
GB:表示计价单元是按每GB来计算。当前涉及该计价单元的场景有:流量按小时后付费(TRAFFIC_POSTPAID_BY_HOUR)。
OriginalPrice
Float
预支费用的原价,单位:元。
DiscountPrice
Float
预支费用的折扣价,单位:元。

Price

说明:
价格
名称
类型
是否必选
描述
InstancePrice
ItemPrice object
描述了实例价格。
BandwidthPrice
ItemPrice object
描述了网络价格。

Filter

说明:
描述键值对过滤器,用于条件过滤查询。例如过滤ID、名称、状态等。
若存在多个Filter时,Filter间的关系为逻辑与(AND)关系。
若同一个Filter存在多个Values,同一FilterValues间的关系为逻辑或(OR)关系。
DescribeInstances 接口的Filter为例。若我们需要查询可用区(zone)为广州一区并且实例计费模式(instance-charge-type)为包年包月或者按量计费的实例时,可如下实现:
Filters.1.Name=zone
&Filters.1.Values.1=ap-guangzhou-1
&Filters.2.Name=instance-charge-type
&Filters.2.Values.1=PREPAID
&Filters.2.Values.2=POSTPAID_BY_HOUR
名称
类型
是否必选
描述
Name
String
过滤键的名称。
Values.N
Array of Strings
一个或者多个过滤值。

InstanceStatus

说明:
描述实例的状态。状态类型详见 实例状态表
名称
类型
是否必选
描述
InstanceId
String
实例ID
InstanceState
String

Instance

说明:
描述实例的信息。
名称
类型
是否必选
描述
Placement
Placement
实例所在的位置。
InstanceId
String
实例ID
InstanceType
String
实例机型。
CPU
Integer
实例的CPU核数,单位:核。
Memory
Integer
实例内存容量,单位:GB
RestrictState
String
实例业务状态。取值范围:
NORMAL:表示正常状态的实例
EXPIRED:表示过期的实例
PROTECTIVELY_ISOLATED:表示被安全隔离的实例。
InstanceName
String
实例名称。
InstanceChargeType
String
实例计费模式。取值范围:
PREPAID:表示预付费,即包年包月
POSTPAID_BY_HOUR:表示后付费,即按量计费
CDHPAIDCDH付费,即只对CDH计费,不对CDH上的实例计费。
SystemDisk
实例系统盘信息。
DataDisks
Array of DataDisk objects
实例数据盘信息。只包含随实例购买的数据盘。
PrivateIpAddresses
Array of Strings
实例主网卡的内网IP列表。
PublicIpAddresses
Array of Strings
实例主网卡的公网IP列表。
InternetAccessible
实例带宽信息。
VirtualPrivateCloud
实例所属虚拟私有网络信息。
ImageId
String
生产实例所使用的镜像ID
RenewFlag
String
自动续费标识。取值范围:
NOTIFY_AND_MANUAL_RENEW:表示通知即将过期,但不自动续费
NOTIFY_AND_AUTO_RENEW:表示通知即将过期,而且自动续费
DISABLE_NOTIFY_AND_MANUAL_RENEW:表示不通知即将过期,也不自动续费。
CreatedTime
Timestamp
创建时间。按照ISO8601标准表示,并且使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ
ExpiredTime
Timestamp
到期时间。按照ISO8601标准表示,并且使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ

InstanceTypeConfig

说明:
描述实例机型配置信息。
名称
类型
是否必选
描述
Zone
String
可用区。
InstanceType
String
实例机型。
InstanceFamily
String
实例机型系列。
CPU
Integer
CPU核数,单位:核。
GPU
Integer
GPU核数,单位:核。
FPGA
Integer
FPGA核数,单位:核。
Memory
Integer
内存容量,单位:GB

ImageSharedAccount

说明:
描述了指定的账号能够使用该共享镜像。
名称
类型
是否必选
描述
ImageId
String
镜像ID
AccountId
String
账户ID

Quota

说明:
描述了配额信息。
名称
类型
是否必选
描述
QuotaId
String
配额名称,取值范围:
TOTAL_EIP_QUOTA:用户当前地域下EIP的配额数
DAILY_EIP_APPLY:用户当前地域下今日申购次数
DAILY_PUBLIC_IP_ASSIGN:用户当前地域下,重新分配公网 IP次数
QuotaCurrent
Integer
当前数量
QuotaLimit
Integer
配额数量

Image

说明:
描述了一个镜像。
名称
类型
是否必选
描述
ImageId
String
镜像ID。
OsName
String
操作系统名称。
ImageSize
String
操作系统容量(GiB)。
ImageType
Integer
镜像类型。
CreatedTime
String
创建时间。
ImageState
String
镜像状态。
ImageName
String
镜像名称。
ImageDescription
String
镜像详细描述。
ImageSource
String
镜像来源。
ImageCreator
String
镜像创建者。

AvailabilityZone

说明:
描述可用区信息。
名称
类型
是否必选
描述
RegionId
String
地域ID。
Zone
String
可用区ID。
ZoneName
String
可用区名称。
ZoneState
String
可用区状态。

KeyPair

说明:
描述密钥对信息。
名称
类型
是否必选
描述
KeyId
String
密钥对的ID,是密钥对的唯一标识。
KeyName
String
密钥对名称。
ProjectId
String
密钥对所属的项目ID
Description
String
密钥对描述信息。
PublicKey
String
密钥对的纯文本公钥。
PrivateKey
String
密钥对的纯文本私钥。腾讯云不会保管私钥,请用户自行妥善保存。
AssociatedInstanceIds
Array of Strings
密钥关联的实例ID列表。
CreatedTime
Timestamp
创建时间。按照ISO8601标准表示,并且使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ

KeyPairInstancesinternetaccessible

说明:
描述密钥对和实例的关联关系。
名称
类型
是否必选
描述
KeyId
String
密钥对的ID,是密钥对的唯一标识。
AssociatedInstanceIdSet
Array of Strings
密钥对关联的实例ID列表。

Address

说明:
描述 EIP 信息。
名称
类型
是否必选
描述
AddressId
String
EIPID,是EIP的唯一标识。
AddressName
String
EIP名称。
AddressState
String
EIP状态。
AddressIp
String
弹性外网IP
BindedResourceId
String
绑定的资源实例ID。可能是一个CVMNAT,或是弹性网卡。
CreatedTime
Timestamp
创建时间。按照ISO8601标准表示,并且使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ

InstanceChargeTypeConfig

说明:
描述了实例计费。
名称
类型
是否必选
描述
InstanceChargeType
String
实例计费模式。
Description
String
实例计费模式描述信息。

InternetChargeTypeConfig

说明:
描述了网络计费。
名称
类型
是否必选
描述
InternetChargeType
String
网络计费模式。
Description
String
网络计费模式描述信息。

InternetBandwidthConfig

说明:
描述了按带宽计费的相关信息。
名称
类型
是否必选
描述
StartTime
Timestamp
开始时间。按照ISO8601标准表示,并且使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ
EndTime
Timestamp
结束时间。按照ISO8601标准表示,并且使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ
InternetAccessible
实例带宽信息。

如果遇到产品相关问题,您可咨询 在线客服寻求帮助。