后付费时长。
单位：月。
可选值范围：\[1.0, +)
默认值：0
| ## ChargePrepaid 预付费模式，即包年包月相关参数设置。 被如下接口引用：InquiryPriceCreateDisks, CreateDisks, CreateInstances, InquiryPriceCreateInstance | 参数名称 | 类型 | 必选 | 描述 | | ------ | ------- | -- | ----------------------------------------------- | | period | Integer | 是 |购买实例的时长。
单位：月。
可选值范围：\[1, +)
| ## ChargeType 描述付费类型。 被如下接口引用：InquiryPriceCreateDisks, CreateDisks, CreateInstances, DescribeInstances, DescribeZoneInstanceConfigInfos, DescribeDiskCategory, InquiryPriceCreateInstance, DescribeDisks | 值 | 值说明 | | -------- | -------- | | PREPAID | 预付费计费方式。 | | POSTPAID | 后付费计费方式。 | ## DataDisk 数据盘的基本信息。 被如下接口引用：CreateInstances, DescribeInstances, InquiryPriceCreateInstance | 参数名称 | 类型 | 必选 | 描述 | | ------------ | ----------------------- | -- | ----------------------------------------------------------------------------- | | diskSize | Integer | 是 |数据盘大小，单位GB。
可选值范围：\[1, +)
| | diskId | String | 否 | 磁盘ID。 | | diskName | String | 否 | 磁盘名称。 | | diskAmount | Integer | 否 |数据盘数量。
可选值范围：\[1, +)
默认值：1
| | portable | Boolean | 否 | 是否可拔插。 | | diskCategory | String | 否 |磁盘种类。
STANDARD：标准云盘。
SSD：固态硬盘。
默认为SSD。
默认值：SSD
| | diskPrice | [PriceItem](#priceitem) | 否 | 数据盘价格。 | ## DescribeInstanceCpuMonitorData 描述CPU数据的信息。 被如下接口引用：DescribeInstanceCpuMonitor | 参数名称 | 类型 | 描述 | | ---- | ------ | ------- | | cpu | String | CPU使用率。 | | time | String | 时间。 | ## DiskCategory 云盘类型。 被如下接口引用：DescribeDiskCategory | 参数名称 | 类型 | 描述 | | ----------- | --------------- | --------------- | | zoneId | String | 可用区ID。 | | categorySet | Array of String | 该可用区支持的云硬盘种类集合。 | ## DiskInfo 云硬盘信息。 被如下接口引用：DescribeDisks | 参数名称 | 类型 | 描述 | | ------------ | ------------------------- | --------------------------------------------------- | | diskId | String | 云硬盘ID。 | | diskName | String | 云硬盘名称。 | | zoneId | String | 云盘所属区域。 | | diskType | [DiskType](#disktype) |云盘类型。
SYSTEM：系统盘。
DATA：数据盘。
| | portable | Boolean |是否可拔插。
默认值：false
| | diskCategory | String |云硬盘种类。
STANDARD：标准云盘。
SSD：固态硬盘。
| | diskSize | Integer | 云盘大小，单位GB。 | | diskStatus | [DiskStatus](#diskstatus) | 云盘状态。 | | instanceId | String | 所绑定的实例ID。 | | instanceName | String | 所绑定的实例名字。 | | chargeType | [ChargeType](#chargetype) |付费类型。
PREPAID：预付费。
POSTPAID：后付费。
| | createTime | String |创建时间。
格式为：YYYY-MM-DDThh:mm:ssZ。
| | expiredTime | String |到期时间。
格式为：YYYY-MM-DDThh:mm:ssZ。
| | period | Integer |购买实例的时长，单位：月。
后付费实例该字段为null。
| | autoRenew | Boolean |是否自动续费。
对于预付费实例，取消订阅后，该字段值将返回false。
| | tags | [Tags](#tags) | 资源关联的标签信息。 | ## DiskStatus 云硬盘的状态值。 被如下接口引用：DescribeDisks | 值 | 值说明 | | --------- | --------- | | CREATING | 创建中。 | | IN\_USE | 使用中（已挂载）。 | | AVAILABLE | 未挂载状态。 | | CHANGING | 变更中 | | ATTACHING | 挂载中。 | | DETACHING | 卸载中。 | | DELETING | 删除中。 | | RECYCLED | 在回收站中 | | RECYCLING | 回收中。 | ## DiskType 描述云盘类型的值。 被如下接口引用：DescribeDisks | 值 | 值说明 | | ------ | ---- | | SYSTEM | 系统盘。 | | DATA | 数据盘。 | ## DiskWithInstance 实例与关联的云盘信息。 被如下接口引用：CreateInstances | 参数名称 | 类型 | 描述 | | ---------- | --------------- | -------------- | | instanceId | String | 实例ID。 | | diskIdSet | Array of String | 随机器创建的数据盘ID集合。 | ## ImageCategory 镜像分类。 被如下接口引用：DescribeImages | 值 | 值说明 | | ------------- | -------------- | | Windows | Windows | | Ubuntu | Ubuntu | | CentOS | CentOS | | Debian | Debian | | ARCH\_LINUX | Arch Linux | | COREOS | CoreOS | | FEDORA | Fedora | | FreeBSD | FreeBSD | | KYLIN | Kylin | | ORACLE\_LINUX | Oracle Linux | | REDHAT | Red Hat | | SUSE | SUSE | | TencentOS | TencentOS | | OTHERS | 其他 | ## ImageInfo 镜像相关信息。 被如下接口引用：DescribeImages | 参数名称 | 类型 | 描述 | | ---------------- | --------------------------- | --------------------------------------------------------------------------- | | imageId | String | 镜像ID。 | | imageName | String | 镜像名称。 | | imageType | String |镜像类型。
PUBLIC\_IMAGE：公共镜像。
CUSTOM\_IMAGE：自定义镜像。
| | imageSize | String | 镜像大小，单位为GB。 | | imageDescription | String | 镜像描述。 | | imageVersion | String | 镜像版本。 | | imageStatus | [ImageStatus](#imagestatus) |镜像状态。
CREATING：创建中。
AVAILABLE：可用。
UNAVAILABLE：不可用。
| | category | String | 镜像所属分类。 | | osType | String |操作系统类型。
可能值：windows、linux。
| ## ImageQuotaInfo 镜像的配额信息。 被如下接口引用：DescribeImageQuota | 参数名称 | 类型 | 描述 | | -------- | ------- | ------------- | | zoneId | String | 支持创建镜像的区域。 | | count | Integer | 当前已配置镜像数。 | | maxCount | Integer | 本区域可配置的最大镜像数。 | ## ImageSourceType 镜像来源。 被如下接口引用：DescribeImages | 值 | 值说明 | | ------------- | ------ | | PUBLIC\_IMAGE | 公共镜像 | | CUSTOM\_IMAGE | 自定义镜像。 | ## ImageStatus 描述镜像状态的值。 被如下接口引用：DescribeImages | 值 | 值说明 | | ----------- | ------- | | CREATING | 创建中 | | AVAILABLE | 正常可用状态。 | | UNAVAILABLE | 不可用。 | ## ImageType 镜像的类型。 被如下接口引用：DescribeImages | 值 | 值说明 | | ------- | ------- | | linux | Linux | | windows | Windows | ## InstanceAvailableSecurityGroup 描述实例可绑定的安全组信息。 被如下接口引用：DescribeInstanceAvailableSecurityGroupResources | 参数名称 | 类型 | 描述 | | ----------------- | ------- | -------- | | securityGroupId | String | 安全组ID。 | | securityGroupName | String | 安全组名称。 | | isDefault | Boolean | 安全组是否默认。 | ## InstanceInfo 实例相关信息。 被如下接口引用：DescribeInstances | 参数名称 | 类型 | 描述 | | ----------------------- | ------------------------------------------- | -------------------------------------------------------------------- | | instanceId | String | 实例唯一ID。 | | zoneId | String | 实例所属的可用区ID。 | | instanceName | String | 实例显示名称。 | | instanceType | String | 实例机型ID。 | | cpuCount | Integer | CPU核数，单位：核。 | | memory | Integer | 实例内存容量，单位：GiB。 | | imageId | String | 镜像ID。 | | imageName | String | 镜像名称。 | | instanceChargeType | [ChargeType](#chargetype) |实例计费类型。
PREPAID：预付费，即包年包月。
POSTPAID：后付费。
| | internetMaxBandwidthOut | Integer |公网出口带宽，单位：Mbps。
0代表无限制，但是不会超过机型的最大上限。
| | internetChargeType | [InternetChargeType](#internetchargetype) | 网络计费类型。 | | period | Integer |购买实例的时长，单位：月。
后付费实例该字段为null。
| | publicIpAddresses | Array of String |实例公网IPv4列表。
如果机器的主IP未加入到公网组网接口，那么主IP将无法使用，且该字段也不会返回该IP。
| | publicIpv6Addresses | Array of String | 实例公网IPv6列表。 | | privateIpAddresses | Array of String | 实例内网IP列表。 | | subnetId | String | 实例所属的内网子网ID。 | | createTime | String |创建时间。
格式为：YYYY-MM-DDThh:mm:ssZ。
| | expiredTime | String |到期时间。
格式为：YYYY-MM-DDThh:mm:ssZ。
| | resourceGroupId | String | 实例所属资源组的ID。 | | resourceGroupName | String | 实例所属资源组的名称。 | | instanceStatus | [InstanceStatusValue](#instancestatusvalue) | 实例状态。 | | trafficPackageSize | Float | 流量包订购大小，单位为TB。 | | securityGroupIds | Array of String | 实例加入的安全组列表。 | | systemDisk | [SystemDisk](#systemdisk) | 实例系统盘信息。 | | dataDisks | Array of [DataDisk](#datadisk) | 实例数据盘信息。 | | autoRenew | Boolean |是否自动续费。
对于预付费实例，取消订阅后，该字段值将返回false。
| | keyId | String |密钥ID。
注意：此字段可能返回null，表示取不到有效值。
| | nic | [Nic](#nic) | 网卡配置。 | | tags | [Tags](#tags) | 资源关联的标签信息。 | ## InstancePlanStatus 描述实例计划变更的状态。 被如下接口引用：DescribeInstanceTypeStatus | 值 | 值说明 | | ------------ | --------- | | Processing | 处理中。 | | WaitToEnable | 等待计划变更生效。 | | Disable | 不支持计划变更。 | ## InstanceStatus 描述实例的状态。 被如下接口引用：DescribeInstancesStatus | 参数名称 | 类型 | 描述 | | -------------- | ------------------------------------------- | ----- | | instanceId | String | 实例ID。 | | instanceStatus | [InstanceStatusValue](#instancestatusvalue) | 实例状态。 | ## InstanceStatusValue 描述实例的状态。 被如下接口引用：DescribeInstancesStatus, DescribeInstances | 值 | 值说明 | | -------------- | ------ | | PENDING | 待创建 | | DEPLOYING | 部署中 | | REBUILDING | 重建中。 | | REBOOT | 重启中 | | RUNNING | 运行中。 | | STOPPED | 已关机。 | | BOOTING | 开机中。 | | RELEASING | 释放中。 | | STOPPING | 关机中。 | | RECYCLE | 回收中。 | | RECYCLING | 回收中。 | | CREATE\_FAILED | 创建失败。 | | IMAGING | 制作镜像中。 | ## InstanceTrafficData 实例的带宽数据。 被如下接口引用：DescribeInstanceTraffic | 参数名称 | 类型 | 描述 | | ---------- | ------- | ----------- | | internetRX | Integer | 入口流量，单位bps。 | | internetTX | Integer | 出口流量，单位bps。 | | time | String | 时间。 | ## InstanceTypeQuotaItem 描述可用区的机型配置信息。 被如下接口引用：DescribeZoneInstanceConfigInfos | 参数名称 | 类型 | 描述 | | ---------------------------- | -------------------------------------------------- | ------------ | | zoneId | String | 可用区ID。 | | instanceType | String | 实例机型。 | | instanceTypeName | String | 实例机型名称。 | | cpuCount | Integer | CPU核数。 | | memory | Integer | 内存大小，单位GiB。 | | internetMaxBandwidthOutLimit | Integer | 公网出口带宽上限。 | | frequency | String | CPU主频。 | | internetChargeTypes | Array of [InternetChargeType](#internetchargetype) | 支持的网络计费类型列表。 | ## InternetChargeType 网络计费类型。 被如下接口引用：CreateInstances, DescribeInstances, DescribeZoneInstanceConfigInfos, InquiryPriceCreateInstance | 值 | 值说明 | | -------------------- | --------------- | | ByBandwidth | 按固定带宽计费。 | | ByTrafficPackage | 购买流量包计费。 | | ByClusterBandwidth95 | 单产品合并95计费城市带宽组。 | | BandwidthCluster | 共享带宽包计费。 | ## MarketingInfo 描述市场活动的相关信息。 被如下接口引用：CreateDisks, CreateInstances | 参数名称 | 类型 | 必选 | 描述 | | ------------- | ------- | -- | ------------------------------------------------- | | discountCode | String | 否 |使用市场发放的折扣码。
如果折扣码不存在，最终折扣将不会生效。
| | usePocVoucher | Boolean | 否 |是否使用POC代金券。
如果系统不存在POC代金券，相关创建流程会失败。
| ## NetworkLineType 网络线路信息。 被如下接口引用：DescribeZones | 值 | 值说明 | | ------ | ----------------- | | BGP | 优质 BGP，高性能网络。 | | CN2 | 回国优化线路。 | | Cogent | 标准 BGP，通用网络，成本优化。 | ## NetworkMode 描述网卡模式的值。 被如下接口引用：CreateInstances | 值 | 值说明 | | ------ | ------- | | Virtio | 软件模拟模式。 | | Vf | 物理直通模式。 | ## Nic 网络接口卡配置，包括公网和内网网卡名称设置。 被如下接口引用：CreateInstances, DescribeInstances | 参数名称 | 类型 | 必选 | 描述 | | ------- | ------ | -- | ------- | | wanName | String | 否 | 公网网卡名称。 | | lanName | String | 否 | 内网网卡名称。 | ## PriceCategory 描述价格类型。 被如下接口引用：InquiryPriceCreateInstance | 值 | 值说明 | | ---------- | ----- | | STANDARD | 标准价格。 | | CUSTOMIZED | 一口价格。 | ## PriceItem 描述价格的信息。 被如下接口引用：InquiryPriceInstanceTrafficPackage, InquiryPriceInstanceBandwidth, InquiryPriceCreateDisks, InquiryPriceCreateInstance | 参数名称 | 类型 | 必选 | 描述 | | ----------------------- | -------------------------------- | -- | -------------------------------------------------------------------------------------------------------------------------- | | discount | Float | 否 |折扣大小。
如80.0代表8折。
| | discountPrice | Float | 否 |后付费的单元折后价格。
后付费模式使用，如果价格为阶梯价格，该项为null。
| | originalPrice | Float | 否 |预付费的原价。
预付费模式使用，后付费该值为 null。
| | unitPrice | Float | 否 |后付费的单元原始价格。
后付费模式使用，如果价格为阶梯价格，该项为null。
| | discountUnitPrice | Float | 否 |后付费的单元折后价格。
后付费模式使用，如果价格为阶梯价格，该项为null。
| | chargeUnit | String | 否 |后付费计价单元。
后付费模式使用，可取值范围：
HOUR: 表示计价单元是按每小时来计算。
DAY: 表示计价单元是按天来计算。
MONTH: 表示计价单元是按月来计算，95计费则是这种。
| | stepPrices | Array of [StepPrice](#stepprice) | 否 |后付费阶梯价格。
后付费模式使用，如果非阶梯价格，该项为null。
| | amountUnit | String | 否 |用量单位。
比如Mbps, LCU等。
如果为null, 代表取不到值。
| | excessUnitPrice | Float | 否 | 超量原始价格。 | | excessDiscountUnitPrice | Float | 否 | 超量折扣后价格。 | | excessAmountUnit | String | 否 |超量用量单位。
如果为null, 代表取不到值。
| | category | [PriceCategory](#pricecategory) | 否 | 价格所属类别。 | ## RuleInfo 安全组规则信息。 被如下接口引用：CreateSecurityGroup, RevokeSecurityGroupRules, AuthorizeSecurityGroupRules, DescribeSecurityGroups, ConfigureSecurityGroupRules | 参数名称 | 类型 | 必选 | 描述 | | ----------- | ------- | -- | --------------------------------------------------------------------- | | direction | String | 是 |规则方向。
ingress：入方向。
egress：出方向。
| | ipProtocol | String | 是 |传输层协议。
取值范围：tcp、udp、icmp、all。
| | portRange | String | 是 | 目的端安全组开放的传输层协议相关的端口范围。 | | cidrIp | String | 是 |源端IP地址范围。
支持CIDR格式和IPv4格式的IP地址范围。
| | policy | String | 否 |设置访问权限。
accept：接受访问。
目前只支持accept。
默认值：accept
| | priority | Integer | 否 |规则优先级。
默认值：1
| | description | String | 否 | 规则描述。 | ## SecurityGroupInfo 安全组信息。 被如下接口引用：DescribeSecurityGroups | 参数名称 | 类型 | 描述 | | ------------------- | ------------------------------ | -------------------------------------------- | | securityGroupId | String | 安全组ID。 | | securityGroupName | String | 安全组名称。 | | securityGroupStatus | String | 安全组状态。 | | createTime | String |创建时间。
格式为：YYYY-MM-DDThh:mm:ssZ。
| | description | String | 安全组描述。 | | instanceIds | Array of String | 已绑定实例ID集合。 | | ruleInfos | Array of [RuleInfo](#ruleinfo) | 安全组规则。 | | isDefault | Boolean | 是否默认。 | ## StepPrice 描述阶梯价格的信息。 被如下接口引用：InquiryPriceCreateInstance | 参数名称 | 类型 | 必选 | 描述 | | ----------------- | ----- | -- | ----------------------------------- | | stepStart | Float | 否 | 阶梯的起始值。 | | stepEnd | Float | 否 |阶梯的到达值。
为null代表最后一级阶梯。
| | unitPrice | Float | 否 | 阶梯单价。 | | discountUnitPrice | Float | 否 | 阶梯折后价。 | ## SubnetInfo 子网信息。 被如下接口引用：DescribeSubnets | 参数名称 | 类型 | 描述 | | ----------------- | --------------- | --------------- | | subnetId | String | Subnet的ID。 | | zoneId | String | Subnet的机房ID。 | | subnetName | String | Subnet的名称。 | | subnetStatus | String | Subnet的状态。 | | cidrBlockList | Array of String | Subnet的CIDR列表。 | | usageIpCount | Integer | Subnet的已用IP数。 | | totalIpCount | Integer | Subnet的总IP数。 | | createTime | String | Subnet的创建时间。 | | instanceIdList | Array of String | Subnet下绑定的实例列表。 | | subnetDescription | String | Subnet的描述信息。 | | cidrBlock | String | Subnet的CIDR。 | | isDefault | Boolean | Subnet是否为默认。 | ## SystemDisk 描述系统盘的基本信息。 被如下接口引用：CreateInstances, DescribeInstances, InquiryPriceCreateInstance | 参数名称 | 类型 | 必选 | 描述 | | ------------ | ------- | -- | ----------------------------------------------------------------------------- | | diskSize | Integer | 是 |系统盘大小，单位GB。
可选值范围：\[1, +)
| | diskId | String | 否 | 磁盘ID。 | | diskCategory | String | 否 |磁盘种类。
STANDARD：标准云盘。
SSD：固态硬盘。
默认为SSD。
默认值：SSD
| ## Tag 描述一个标签键值对的信息。 被如下接口引用：CreateInstances, DescribeInstances, DescribeDisks | 参数名称 | 类型 | 必选 | 描述 | | ----- | ------ | -- | ------------------------------- | | key | String | 是 |标签键。
长度限制：1～64个字符。
| | value | String | 否 |标签值。
长度限制：1～64个字符。
| ## TagAssociation 描述创建资源时同时绑定的标签对的信息。 被如下接口引用：CreateDisks, CreateInstances | 参数名称 | 类型 | 必选 | 描述 | | ---- | -------------------- | -- | ------ | | tags | Array of [Tag](#tag) | 是 | 标签对列表。 | ## Tags 描述资源关联的标签信息。 被如下接口引用：DescribeInstances, DescribeDisks | 参数名称 | 类型 | 描述 | | ---- | -------------------- | ------ | | tags | Array of [Tag](#tag) | 标签对列表。 | ## VmInventoryCapacityInfo 可用区库存相关信息。 被如下接口引用：DescribeVmInventoryCapacity | 参数名称 | 类型 | 描述 | | -------- | ------------------------------- | ---------------------------------- | | zoneId | String | 可用区ID。 | | capacity | [CapacityValue](#capacityvalue) |档位。
库存容量根据所有机型可售核数定义。
| ## ZoneInfo 可用区的基本信息。 被如下接口引用：DescribeZones | 参数名称 | 类型 | 描述 | | --------------------- | ----------------------------------- | ----------------------------------------------------- | | zoneId | String | 区域ID。 | | zoneName | String | 区域名称。 | | supportSecurityGroup | Boolean | 是否支持安全组。 | | supportNetworkType | String |支持的网络类型。
CLASSICS：经典网络。
VPC：VPC网络。
| | supportIpv6 | Boolean | 是否支持公网IPv6。 | | supportCpuPassThrough | Boolean | 是否支持CPU透传。 | | networkLineType | [NetworkLineType](#networklinetype) | 网络线路信息。 | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.console.zenlayer.com/api-reference/cn/compute/vm/datastructure.md?ask=