附录

Model对象定义

InstanceModel

参数名称 类型 描述
id String 实例ID,符合BCE规范,是一个定长字符串,且只允许包含大小写字母、数字、连字号(-)和下划线(_)
name String 实例名称,支持大小写字母、数字、中文以及-_ /.特殊字符,必须以字母开头,长度1-65。
instanceType InstanceType 实例类型,具体可选类型参见InstanceType,DCC(专属服务器)该字段为空
status InstanceStatus 实例状态
desc String 实例描述信息
paymentTiming String 付费方式,付费方式,包括Postpaid(后付费),Prepaid(预付费)两种。
createTime String 创建时间
expireTime String 过期时间
internalIp String 内网IP
publicIp String 外网IP
cpuCount int CPU(Core)个数
gpuCard String 实例所携带的GPU卡信息,具体信息参照GpuType
fpgaCard String 实例所携带的FPGA卡信息,具体信息参照FpgaType
cardCount int 实例所携带的GPU卡或FPGA卡数量,仅在gpuCard或fpgaCard字段不为空时返回该字段
memoryCapacityInGB int 内存容量,单位为GB
localDiskSizeInGB int 本地磁盘大小(不含系统盘,系统盘为免费赠送),单位为GB
imageId String 镜像ID
networkCapacityInMbps int 公网带宽,单位为Mb
placementPolicy String 实例置放策略,取值default、dedicatedHost。
zoneName String 可用区信息
subnetId String 子网ID
vpcId String VPC ID

VolumeModel

参数名称 类型 描述
id String 磁盘ID
name String 磁盘名称,支持大小写字母、数字、中文以及-_ /.特殊字符,必须以字母开头,长度1-65。
diskSizeInGB int 磁盘大小,单位是GB
paymentTiming String 付费方式,付费方式,包括Postpaid(后付费),Prepaid(预付费)两种。
createTime String 创建日期,符合BCE日期规范
expireTime String 过期时间
status VolumeStatus 磁盘状态
type VolumeType 磁盘类型
storageType StorageType CDS磁盘存储类型,包括hp1(高性能云磁盘)和std1(普通云磁盘)。
desc String 描述信息
attachments List<VolumeAttachmentModel> 挂载设备信息列表,磁盘未挂载时该值为空。
zoneName String 可用区信息
autoSnapshotPolicy AutoSnapshotPolicyModel 磁盘当前配置的快照策略(list返回的简化版model无此参数)

EphemeralDisk

参数名称 类型 描述
storageType StorageType 磁盘存储类别
sizeInGB int 磁盘总容量
freeSizeInGB int 可用容量,GB

ZoneModel

参数名称 类型 描述
zoneName String 可用区信息

CreateCdsModel

参数名称 类型 是否必需 描述
cdsSizeInGB int CDS磁盘容量,必须为大于0的整数,单位为GB,大小为0~5120G,当直接创建磁盘时,此属性必需
storageType StorageType CDS磁盘存储类型,默认是hp1(高性能云磁盘)。
snapshotId String 快照ID,当通过快照创建磁盘时,此属性有效,如果cdsSizeInGB为空,默认使用快照大小创建CDS磁盘。如果cdsSizeInGB不为空,则值不能小于快照大小

VolumeAttachmentModel

参数名称 类型 描述
volumeId String 磁盘ID
instanceId String 实例ID
device String 挂载设备路径
serial String 磁盘序列号

SnapshotModel

参数名称 类型 描述
id String 快照ID
name String 快照名称,支持大小写字母、数字、中文以及-_ /.特殊字符,必须以字母开头,长度1-65。
sizeInGB int 快照大小,单位是GB
createTime String 快照创建时间,符合BCE规范的日期格式
status SnapshotStatus 快照状态
createMethod String 快照创建方式,包括手动创建,计划创建
volumeId String 磁盘ID,为空表示相关磁盘已释放
desc String 快照描述信息

ImageModel

参数名称 类型 描述
id String 镜像ID
name String 镜像名称,支持大小写字母、数字、中文以及-_ /.特殊字符,必须以字母开头,长度1-65。
type ImageType 镜像类型
osType String 操作系统类型
osVersion String 操作系统版本
osArch String 操作系统位数
osName String 操作系统名称
osBuild String 镜像操作系统的构建时间
createTime String 镜像的创建时间,符合BCE规范的日期格式
status ImageStatus 镜像状态
desc String 镜像描述信息

SecurityGroupModel

参数名称 类型 描述
id String 安全组ID
name String 名称,支持大小写字母、数字、中文以及-_ /.特殊字符,必须以字母开头,长度1-65。
desc String 描述
vpcId String 私有网络VPC ID
rules List<SecurityGroupRuleModel> 安全组规则

SecurityGroupRuleModel

参数名称 类型 描述 是否必须
remark String 备注
direction String 入站/出站,取值ingress或egress。
ethertype String 网络类型,取值IPv4或IPv6。值为空时表示默认取值IPv4。
portRange String 端口范围,可以指定80等单个端口,值为空时默认取值1-65535。
protocol String 协议类型,tcp、udp或icmp,值为空时默认取值all。
sourceGroupId String 源安全组ID
sourceIp String 源IP地址,与sourceGroupId不能同时设定值。
destGroupId String 目的安全组ID
destIp String 目的IP地址,与destGroupId不能同时设定值。
securityGroupId String 安全组ID

InstanceTypeModel

参数名称 类型 描述
type String 规格分类
name String 规范代码
cpuCount int CPU(Core)个数
memorySizeInGB int 内存(GB)
localDiskSizeInGB int 本地磁盘(GB)

OsModel

参数名称 类型 描述
instanceId String 实例ID
osArch String 操作系统位数
osName String 操作系统名称
osVersion String 操作系统版本
osType String 操作系统类型

AutoSnapshotPolicyModel

参数名称 类型 描述
id String 自动快照策略ID
name String 自动快照策略名称,支持大小写字母、数字、中文以及-_ /.特殊字符,必须以字母开头,长度1-65。
timePoints List<int> 指定自动快照的创建时间点。最小单位为小时,从 00:00~23:00 共 24 个时间点可选,参数为 0~23 的数字,如:1 代表在 01:00 时间点。可以选定多个时间点。 传递参数为一个带有格式的 Json Array:[0, 1, … 23],最多 24 个时间点,用半角逗号字符隔开。
repeatWeekdays List<int> 指定自动快照的重复日期。选定周一到周日中需要创建快照的日期,参数为1~7 的数字,如:1 表示周一。允许选择多个日期。 传递参数为一个带有格式的 Json Array:[ 1,2…7]。
status String 快照状态
retentionDays int 指定自动快照的保留时间,单位为天。 -1:永久保存 1~65536:指定保存天数。
createdTime String 自动快照策略的创建时间,符合BCE规范的日期格式 (自该字段起,及之后字段,在volume的接口中没有返回)
updatedTime String 自动快照策略的最近更新时间,符合BCE规范的日期格式
deletedTime String 自动快照策略的删除时间,符合BCE规范的日期格式
lastExecuteTime String 自动快照策略的最后执行时间,符合BCE规范的日期格式
volumeCount int 关联磁盘数量

类型编码定义

VolumeType

编码 描述
System 系统盘
Ephemeral 本地磁盘
Cds CDS云磁盘

StorageType

编码 描述 可创建CDS数据盘 可创建CDS系统盘
std1 普通型
hp1 高性能型
cloud_hp1 SSD型
local 本地盘
sata sata磁盘,创建DCC子实例专用 - -
ssd ssd磁盘,创建DCC子实例专用 - -

ImageType

编码 描述
System 系统镜像/公共镜像
Custom 自定义镜像
Integration 服务集成镜像

GpuType

编码 描述
V100-32 NVIDIA Tesla V100-32G
V100-16 NVIDIA Tesla V100-16G
P40 NVIDIA Tesla P40
P4 NVIDIA Tesla P4
K40 NVIDIA Tesla K40
DLCard NVIDIA 深度学习开发卡

FpgaType

编码 描述
KU115 xilinx ku115

状态编码定义

ProductType

编码 描述
Prepaid 预付费
Postpaid 后付费

InstanceStatus

编码 描述
Starting 启动中
Running 运行中
Stopping 停止中
Stopped 已停止
Deleted 已释放,该状态为内部状态,API无法查询
Scaling 扩展中
Expired 已过期或欠费
Error 错误
SnapshotProcessing 快照操作中
ImageProcessing 镜像操作中
Recharging 续费中

VolumeStatus

编码 描述
Creating 创建中。卷创建是异步操作,Creating表示系统已收到创建请求,并分配相应卷ID,但尚未创建完成
Available 待挂载。卷已创建完成,状态正常,且未attach到任何虚拟机实例
Attaching 挂载中。卷attach是异步操作,该状态表示正在进行attach操作
NotAvailable 临时不可用状态
InUse 使用中
Detaching 卸载中。卷detach是异步操作,该状态表示正在进行detach操作
Deleting 删除中
Deleted 已删除,该状态为内部状态,API无法查询
Scaling 扩展中
Expired 已过期或欠费
Error 错误
SnapshotProcessing 快照操作中
ImageProcessing 镜像操作中
Recharging 续费中

SnapshotStatus

编码 描述
Creating 创建中
CreatedFailed 创建失败
Available 可用
NotAvailable 不可用

ImageStatus

编码 描述
Creating 创建中
CreatedFailed 创建失败
Available 可用
NotAvailable 不可用
Error 错误

RelatedRenewFlag

编码 描述
CDS 只对BCC实例关联的预付费CDS进行续费
EIP 只对BCC实例关联的预付费EIP进行续费
MKT 只对BCC实例关联的预付费MKT进行续费
CDS_EIP 只对BCC实例关联的预付费CDS、EIP进行续费
CDS_MKT 只对BCC实例关联的预付费CDS、MKT进行续费
EIP_MKT 只对BCC实例关联的预付费EIP、MKT进行续费
CDS_EIP_MKT 只对BCC实例关联的预付费CDS、EIP、MKT进行续费

区域机型以及可选配置

InstanceType

编码 描述
N1 普通型BCC实例
N2 普通型ⅡBCC实例
N3 普通型ⅢBCC实例
C1 计算优化型实例
C2 计算优化Ⅱ型实例
S1 存储优化型实例
G1 GPU型实例
F1 FPGA型实例

GpuType

编码 描述
V100-32 NVIDIA Tesla V100-32G
V100-16 NVIDIA Tesla V100-16G
P40 NVIDIA Tesla P40
P4 NVIDIA Tesla P4
K40 NVIDIA Tesla K40
DLCard NVIDIA 深度学习开发卡

区域可支持实例类型(随产品规划而变化,请以控制台购买页为准)

区域 支持创建实例类型
北京(bj) 普通型BCC(N1),可选配置参考普通型BCC(N1)可选规格配置
普通型ⅡBCC(N2),可选配置参考普通型ⅡBCC(N2)可选规格配置
普通型ⅢBCC(N3),可选配置参考普通型ⅢBCC(N3)可选规格配置
计算优化型实例(C1),可选配置参考计算优化型实例(C1)可选规格配置
存储优化型实例(S1),可选配置参考存储优化型实例(S1)可选规格配置
GPU型实例(G1),可选配置参考GPU型实例(G1)可选规格配置
FPGA型实例(F1),可选配置参考FPGA型实例(F1)可选规格配置
广州(gz) 普通型BCC(N1),可选配置参考普通型BCC(N1)可选规格配置
普通型ⅡBCC(N2),可选配置参考普通型ⅡBCC(N2)可选规格配置
普通型ⅢBCC(N3),可选配置参考普通型ⅢBCC(N3)可选规格配置
计算优化型实例(C1),可选配置参考计算优化型实例(C1)可选规格配置
存储优化型实例(S1),可选配置参考存储优化型实例(S1)可选规格配置
GPU型实例(G1),可选配置参考GPU型实例(G1)可选规格配置
苏州(su) 普通型ⅡBCC(N2),可选配置参考普通型ⅡBCC(N2)可选规格配置
普通型ⅢBCC(N3),可选配置参考普通型ⅢBCC(N3)可选规格配置
计算优化型实例(C1),可选配置参考计算优化型实例(C1)可选规格配置
存储优化型实例(S1),可选配置参考存储优化型实例(S1)可选规格配置
GPU型实例(G1),可选配置参考GPU型实例(G1)可选规格配置

普通型BCC可选规格配置

预付费可选规格配置(CPU核数, 内存GB) 后付费可选规格配置(CPU核数, 内存GB)
[1, 1], [1, 2], [1, 4], [1, 8],
[2, 2], [2, 4], [2, 8], [2, 12], [2, 16],
[4, 4], [4, 8], [4, 12], [4, 16], [4, 32],
[8, 8], [8, 12], [8, 16], [8, 24], [8, 32], [8, 64],
[12, 12], [12, 16], [12, 24], [12, 32], [12, 48], [12, 64],
[16, 16], [16, 24], [16, 32], [16, 48], [16, 64]
同预付费可选规格配置(CPU核数, 内存GB)

普通型BCCⅡ可选规格配置

预付费可选规格配置(CPU核数, 内存GB) 后付费可选规格配置(CPU核数, 内存GB)
[1, 1], [1, 2], [1, 4], [1, 8],
[2, 2], [2, 4], [2, 8], [2, 12], [2, 16],
[4, 4], [4, 8], [4, 12], [4, 16], [4, 32],
[8, 8], [8, 12], [8, 16], [8, 24], [8, 32], [8, 64],
[12, 12], [12, 16], [12, 24], [12, 32], [12, 48], [12, 64],
[16, 16], [16, 24], [16, 32], [16, 48], [16, 64], [16, 128],
[32, 64], [32, 128],
[48, 96], [48, 128], [48, 192]
[1, 1], [1, 2], [1, 4], [1, 8],
[2, 2], [2, 4], [2, 8], [2, 12], [2, 16],
[4, 4], [4, 8], [4, 12], [4, 16], [4, 32],
[8, 8], [8, 12], [8, 16], [8, 24], [8, 32], [8, 64],
[12, 12], [12, 16], [12, 24], [12, 32], [12, 48], [12, 64],
[16, 16], [16, 24], [16, 32], [16, 48], [16, 64], [16, 128]

普通型BCCⅢ可选规格配置

预付费可选规格配置(CPU核数, 内存GB) 后付费可选规格配置(CPU核数, 内存GB)
[1, 1], [1, 2], [1, 4], [1, 8],
[2, 2], [2, 4], [2, 8], [2, 12], [2, 16],
[4, 4], [4, 8], [4, 12], [4, 16], [4, 32],
[8, 8], [8, 12], [8, 16], [8, 24], [8, 32], [8, 64],
[12, 12], [12, 16], [12, 24], [12, 32], [12, 48], [12, 64],
[16, 16], [16, 24], [16, 32], [16, 48], [16, 64], [16, 128],
[24, 48], [24, 96], [24, 128],
[32, 64], [32, 128], [32, 256],
[48, 96], [48, 128], [48, 192], [48, 256],
[64, 128], [64, 256],
[96, 256]
同预付费可选规格配置(CPU核数, 内存GB)

计算优化型实例可选规格配置

预付费可选规格配置(CPU核数, 内存GB) 后付费可选规格配置(CPU核数, 内存GB)
[4, 8], [4, 16], [4, 32],
[8, 16], [8, 32],
[16, 32], [16, 64],
[24, 96]
同预付费可选规格配置(CPU核数, 内存GB)

存储优化型实例可选规格配置

预付费可选规格配置(CPU核数, 内存GB) 后付费可选规格配置(CPU核数, 内存GB)
[1, 1], [1, 2], [1, 4], [1, 8],
[2, 2], [2, 4], [2, 8], [2, 12], [2, 16],
[4, 4], [4, 8], [4, 12], [4, 16], [4, 32],
[8, 8], [8, 12], [8, 16], [8, 24], [8, 32], [8, 64],
[12, 12], [12, 16], [12, 24], [12, 32], [12, 48], [12, 64],
[16, 16], [16, 24], [16, 32], [16, 48], [16, 64]
同预付费可选规格配置(CPU核数, 内存GB)

GPU型BCC可选规格配置

预付费可选规格配置(GPU卡类型,GPU卡数量,CPU核数, 内存GB,本地磁盘大小GB) 后付费可选规格配置(GPU卡类型,GPU卡数量,CPU核数, 内存GB,本地磁盘大小GB)
[P4,1,12,40,450],[P4,2,24,80,900],[P4,4,48,160,1800],
[P40,1,12,40,450],[P40,2,24,80,900],[P40,4,48,160,1800],
[K40,1,6,40,450],[K40,2,12,80,400],[K40,4,24,160,800],
[DLCard,1,6,40,450],[DLCard,2,12,80,400],[DLCard,4,24,160,800]
同预付费可选规格配置(GPU卡类型,GPU卡数量,CPU核数, 内存GB,本地磁盘大小GB)

FPGA型BCC可选规格配置

预付费可选规格配置(FPGA卡类型,FPGA卡数量,CPU核数, 内存GB,本地磁盘大小GB) 后付费可选规格配置(FPGA卡类型,FPGA卡数量,CPU核数, 内存GB,本地磁盘大小GB)
[KU115,1,16,64,450] 同预付费可选规格配置(FPGA卡类型,FPGA数量,CPU核数, 内存GB,本地磁盘大小GB)

实例套餐规格定义(已废弃,不建议使用)

规格分类 规格代码 CPU(Core) 内存(GB)
Tiny bcc.t1.tiny 1 1
General bcc.g1.tiny 1 2
General bcc.g2.tiny 1 4
General bcc.g3.tiny 1 8
General bcc.g1.small 2 2
General bcc.g2.small 2 4
General bcc.g3.small 2 8
General bcc.g4.small 2 12
General bcc.g1.medium 4 4
General bcc.g2.medium 4 8
Memory bcc.m1.medium 4 12
Memory bcc.m2.medium 4 16
Memory bcc.m1.large 8 16
Memory bcc.m2.large 8 24
Memory bcc.m3.large 8 32
cpu bcc.c1.large 8 8
cpu bcc.c2.large 8 12
cpu bcc.c1.xlarge 12 12
cpu bcc.c2.xlarge 12 16
cpu bcc.c3.xlarge 12 24
cpu bcc.c4.xlarge 12 32
cpu bcc.c5.xlarge 12 48
cpu bcc.c1.2xlarge 16 16
cpu bcc.c2.2xlarge 16 24
cpu bcc.c3.2xlarge 16 32
cpu bcc.c4.2xlarge 16 48
cpu bcc.c5.2xlarge 16 64

订单信息定义

Billing

状态 类型 描述
paymentTiming String 付费方式,付费方式,包括预支付(Prepaid)和后支付(Postpaid)
reservation Reservation 保留信息,支付方式为后支付时不需要设置,预支付时必须设置

Reservation

状态 类型 描述
reservationLength int 时长,[1,2,3,4,5,6,7,8,9,12,24,36]
reservationTimeUnit String 时间单位,Month,当前仅支持按月