数据类型

最近更新时间: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] 和 [( ) ~ ! @ # $ % ^ &amp; * - + = &#124; { } [ ] : ; ' , . ? / ]中的特殊符号。<br></li><li>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 RunSecurityServiceEnabled object 开启云安全服务。若不指定该参数,则默认开启云安全服务。
    MonitorService RunMonitorServiceEnabled object 开启云安全服务。若不指定该参数,则默认开启腾讯云可观测平台服务。

    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 SystemDisk 实例系统盘信息。
    DataDisks array of DataDisk objects 实例数据盘信息。只包含随实例购买的数据盘。
    PrivateIpAddresses array of Strings 实例主网卡的内网IP列表。
    PublicIpAddresses array of Strings 实例主网卡的公网IP列表。
    InternetAccessible InternetAccessible 实例带宽信息。
    VirtualPrivateCloud 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 InternetAccessible 实例带宽信息。