所有文档

          云服务器 BCC

          创建实例

          前提条件

          创建实例需要实名认证,没有通过实名认证的可以前往百度智能云官网控制台中的安全认证下的个人认证企业认证中进行认证。

          BCC实例

          • 计费注意事项:

            • 创建计费方式为后付费的实例需要账户现金余额+通用代金券大于100;预付费方式的实例则需要账户现金余额大于等于实例费用。
            • 指定公网IP带宽创建,计费方式为按照带宽计费。
          • 实例注意事项:

            • 通过instanceType字段指定需要创建的虚机类型,目前API支持创建的虚机类型参见InstanceType。参数instanceTypecpuCountmemoryCapacityInGB可以确定需要的机型以及配置。
            • 同一实例不可以同时购买GPU卡和FPGA卡,购买带有GPU卡或FPGA卡的实例时必须通过cardCount指定要购买的虚机所携带的GPU卡或FPGA卡数量。
            • 购买带有GPU卡或FPGA卡虚机时,随着所携带GPU卡或FPGA卡数量、类型的不同,请求中所需购买的CPU核数(cpuCount)、内存大小(memoryCapacityInGB)、系统盘类型和大小(ephemeralDisks)应为空或者满足GPU型BCC可选规格配置FPGA型BCC可选规格配置中的要求。
          • 存储注意事项:

            • 创建实例时可以指定系统盘大小,指定系统盘大小范围为[40, 500]GB,默认使用免费赠送的40GB的hp1型CDS作为系统盘。可指定系统盘磁盘类型可参见StorageType
            • 百度智能云免费赠送40GB系统盘,超过40GB免费额度按照对应的CDS云磁盘收费。
            • 创建实例时添加的系统盘在创建之后无法更改,且不支持单独创建或添加系统盘。
            • 系统盘不支持挂载、卸载、删除。
            • 创建CDS系统盘和数据盘时,支持按照1GB步长选择磁盘大小。
            • 缺省情形下,一个实例最多只能挂载5个云磁盘。
            • BCC实例的系统盘最大不能超过500G。
            • 每个实例最多只能购买一块临时数据盘,临时数据盘默认只有hp1类型。
            • 创建存储优化型实例时必须购买临时数据盘,通过ephemeralDisks指定临时盘数据盘大小,默认nvme类型数据盘,无需指定。
          • 网络注意事项:

            • BCC实例支持用户自定义安全组和子网,两者需要同时指定在同一个VPC下。如果未指定安全组和子网,在创建专属实例时会自动加入系统默认的安全组和子网内。
          • 其他注意事项:

            • 支持批量创建,且如果创建过程中有一个实例创建失败,所有实例将全部回滚,均创建失败,如果创建时包含CDS,CDS也会回滚。
            • 创建接口为异步创建,可通过查询指定实例详情接口查询实例状态。
            • 可通过该接口指定专属服务器创建实例,专属实例不参与计费。专属实例只能通过ephemeralDisks创建临时盘并指定磁盘类型。

          DCC专属实例

          本接口也用于在专属服务器上创建实例在创建 DCC 专属实例时,以下操作可能与您的业务相关:

          • 专属实例不参与计费。
          • 本接口用于创建一个或多个专属实例。
          • 支持批量创建,且如果创建过程中有一个专属实例创建失败,所有实例将全部回滚,均创建失败,如果创建时包含CDS,CDS也会回滚。
          • 专属实例支持创建、添加本地磁盘。
          • 本地磁盘不支持挂载、卸载、删除。
          • DCC允许用户自定义专属实例的cpu和内存等参数,所创建的专属实例资源将会使用DCC的资源。
          • 专属实例只能通过ephemeralDisks创建临时盘并指定磁盘类型。
          • 专属实例支持用户自定义安全组和子网,两者需要同时指定在同一个VPC下。如果未指定安全组和子网,在创建专属实例时会自动加入系统默认的安全组和子网内。

          请求结构

          POST /v{version}/instance?clientToken={clientToken} HTTP/1.1
          Host: bcc.bj.baidubce.com
          Authorization: authorization string
          
          {
              "instanceType": instanceType,
              "cpuCount": cpuCoreCount,
              "memoryCapacityInGB": memoryCapacityInGB,
              "rootDiskSizeInGb":rootDiskSizeInGb,
              "rootDiskStorageType":"rootDiskStorageType",
              "ephemeralDisks": [
              {
                  "storageType": storageType,
                  "sizeInGB": size
              },
              {
                  "storageType": storageType,
                  "sizeInGB": size
              }
              ],
              "createCdsList": [
                  {
                      "storageType": storageType,
                      "cdsSizeInGB": cdsSizeInGB
                  }
              ],
              "name": "name",
              "imageId": "imageId",
              "localDiskSizeInGB": localDiskSizeInGB,
              "networkCapacityInMbps": networkCapacityInMbps,
              "autoRenewTimeUnit": "autoRenewTimeUnit",
              "autoRenewTime": autoRenewTime,
              "cdsAutoRenew": cdsAutoRenew,
          	"dedicatedHostId": dedicatedHostId,
              "purchaseCount": purchaseCount,
              "billing":{
                  "paymentTiming": paymentTiming,
          		"reservation": {
                  	"reservationLength": reservationLength
              	}
              },
          	"zoneName": zoneName,
          	"subnetId": subnetId,
          	"securityGroupId": securityGroupId,
              "relationTag": relationTag,
              "tags": [
                 {
                    "tagKey": tagKey,
                    "tagValue": tagValue
                 } 
              ],
              "keypairId": keypairId
          }

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号。
          clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串。
          imageId String RequestBody参数 待创建虚拟机实例的镜像ID,
          可通过调用查询镜像列表接口选择获取所需镜像ID。
          billing Billing RequestBody参数 订单、计费相关参数
          instanceType String RequestBody参数 待创建虚拟机实例的类型,具体可选类型参见下述InstanceType,为空时使用默认虚机类型
          cpuCount int RequestBody参数 待创建虚拟机实例的CPU核数
          memoryCapacityInGB int RequestBody参数 待创建虚拟机实例的内存容量,单位GB,可选配置请参考区域机型以及可选配置
          rootDiskSizeInGb int RequestBody参数 待创建虚拟机实例的系统盘大小,单位GB,默认是40GB,范围为[40, 500]GB,超过40GB按照云磁盘价格收费。注意指定的系统盘大小需要满足所使用镜像最小磁盘空间限制。
          rootDiskStorageType String RequestBody参数 待创建虚拟机实例系统盘介质,默认使用hp1型云磁盘,可指定系统盘磁盘类型可参见StorageType
          localDiskSizeInGB int RequestBody参数 [已废弃]待创建虚拟机实例的临时数据盘大小(不含系统盘,系统盘为免费赠送),单位为GB,大小为0~500G,请采用ephemeralDisks字段。
          ephemeralDisks List<EphemeralDisk> RequestBody参数 DCC实例可以创建多块本地盘,需要指定磁盘类型以及大小。其他类型BCC最多只能使用一块本地盘,使用默认磁盘类型,需要指定磁盘大小。FPGA实例以及GPU实例默认使用一块本地磁盘,根据配置指定本地盘大小,具体请参考GPU型BCC可选规格配置 以及FPGA型BCC可选规格配置
          createCdsList List<CreateCdsModel> RequestBody参数 待创建的CDS磁盘列表,具体数据格式参见下述CreateCdsModel
          networkCapacityInMbps int RequestBody参数 公网带宽,单位为Mbps。必须为0~200之间的整数,
          为0表示不分配公网IP,默认为0Mbps。
          dedicatedHostId string RequestBody参数 专属服务器DCC id,指定虚机置放位置时指定该值。
          purchaseCount int RequestBody参数 批量创建(购买)的虚拟机实例个数
          必须为大于0的整数,可选参数,缺省为1。如果设置值为2以上,则代表创建相同配置的2或多台虚拟机实例。
          name String RequestBody参数 虚拟机名字(可选)。默认都不指定name。如果指定name:批量时name作为名字的前缀。后端将加上后缀,后缀生成方式:name{ -序号}。如果没有指定name,则自动生成,方式:{instance-八位随机串-序号}。注:随机串从0~9a~z生成;序号按照count的数量级,依次递增,如果count为100,则序号从000~100递增,如果为10,则从00~10递增。支持大小写字母、数字、中文以及-_ /.特殊字符,必须以字母开头,长度1-65。
          adminPass String RequestBody参数 待指定的实例管理员密码,8-16位字符,英文,数字和符号必须同时存在,符号仅限!@#$%^*(),密码需要加密传输,详见链接
          zoneName String RequestBody参数 指定zone信息,默认为空,由系统自动选择,
          可通过调用查询可用区列表接口查询可用区列表。
          zoneName命名规范是小写的“国家-region-可用区序列",
          例如北京可用区A为"cn-bj-a"。
          专属实例使用专属服务器所在zone,无需指定该字段。
          subnetId String RequestBody参数 指定子网,为空时将使用默认子网
          relationTag boolean RequestBody参数 待创建实例指定的标签是否需要和已有标签键进行关联,默认为false。注意值为true时要保证该标签键已存在
          tags List<TagModel> RequestBody参数 待创建的标签列表,具体数据格式参见下述TagModel
          securityGroupId String RequestBody参数 指定安全组,为空时将使用默认安全组
          gpuCard String RequestBody参数 待创建实例所要携带的GPU卡信息,具体可选信息参照GpuType,非GPU型实例无需指定此字段
          fpgaCard String RequestBody参数 待创建实例所要携带的FPGA卡信息,具体可选信息参照FpgaType,非FPGA型实例无需指定此字段
          cardCount String RequestBody参数 待创建实例所要携带的GPU卡或FPGA卡数量,仅在gpuCard或fpgaCard字段不为空时有效,且需要满足GPU型实例可选规格配置FPGA型实例可选规格配置中的要求
          autoRenewTimeUnit String RequestBody参数 按月付费或者按年付费 月是"month",年是"year"
          autoRenewTime int RequestBody参数 自动续费的时间 按月是1-9 按年是 1-3
          cdsAutoRenew boolean RequestBody参数 cds是否自动续费 是:true 否:false
          keypairId String RequestBody参数 待创建实例所要绑定的密钥对ID
          aspId String RequestBody参数 自动快照策略ID
          internetChargeType String RequestBody参数 公网带宽计费方式,可选参数详见internetChargeType,若不指定internetChargeType,默认付费方式同BCC,预付费默认为包年包月按带宽,后付费默认为按使用带宽计费。
          deployId String RequestBody参数 指定实例所在的部署集id

          返回头域

          除公共头域,无其它特殊头域。

          返回参数

          参数名称 类型 描述
          instanceIds List 虚机实例ID的集合,其中ID符合BCE规范,必须是一个定长字符串,且只允许包含大小写字母、数字、连字号(-)和下划线(_)。

          错误码

          错误码 错误描述 HTTP状态码 中文解释
          Instance.InvalidateRootDiskStorageType Invalidate root disk storage type. 400 无效的系统盘介质
          Instance.InstanceBeBanned The instance is banned, contact technical support for assistance. 403 Bcc服务已被封禁
          Instance.GlobalInstanceQuotaLimitExceeded Quota exceeds limit for regional postpaid instances pool, contact technical support for further assistance. 413 后付费类型的虚机数目超出当前区域预售额度限制
          Instance.InstanceQuotaLimitExceeded Quota exceeds limit. 413 实例个数超过限制
          Instance.EipQuotaLimitExceeded The number of eip will exceed the limit. 413 合并购买时eip个数超过限制
          Instance.InvalidateConfiguration Invalidate cpu memory configuration. 400 无效的虚机配置
          Instance.InsufficientRootDiskSize Not enough root disk size. 400 使用镜像过大,系统盘大小不够
          Instance.PermissionDeny Instance permission deny. 401 无权限
          RealNameQualify No real name authentication. 409 不可操作,未实名认证
          Instance.RegionDenyException You're not allowed to access this region. 403 region拒绝访问异常.
          BadRequest cds config error. 400 cds配置错误
          Instance.InstanceCountCdsCountNotMatchException Cds count must be multiple number of Instance count. 400 创建的虚机数量和cds数量不匹配
          Instance.InvalidateZoneException Invalidate zone name. 400 无效的可用区
          Instance.NotSupportInstanceTypeException not support the instance type. 403 不支持该机型
          BadRequest Not support serviceType. 400 不支持该服务类型
          BadRequest invalid deploy id. 400 无效的部署集ID
          BadRequest invalid cds count. 400 cds 数量应该是bcc的整数倍
          BadRequest Can not create Bcc both with gpuCard and fpgaCard. 400 不能同时创建gpu类型和fpga类型的BCC
          Instance.InvalidateGpuCardException GpuCard is invalid. 400 用户所选GPU卡不存在
          Instance.InvalidateFpgaCardException FpgaCard is invalid. 400 用户所选Fpga卡不存在
          Instance.MKTImageInstanceNotSupportCreateSnapshotException Instance with mkt image not support create system snapshot. 403 云市场镜像不支持创建系统快照
          Instance.CdsSnapshotNotMatchException No cds for snapshot. 400 描述待定 没有供快照使用的CDS
          Instance.CdsSnapshotSmallException Cds for snapshot is smaller than snapshot. 400 描述待定 CDS比快照小
          Instance.InvalidAutoRenewTimeException Instance autoRenew time is invalid. 400 无效的自动续费时长
          Instance.InvalidAutoRenewTimeUnitException Instance autoRenew time unit is invalid. 400 无效的自动续费单元
          BadRequest instanceType invalidate. 400 无效的实例类型
          Instance.InstanceCountCdsCountNotMatchException Cds count must be multiple number of Instance count 400 创建的虚机数量和cds数量不匹配
          Instance.NoStock Sales of this resource are temporarily suspended in the specified region. 403 资源售罄
          BadRequest Invalidate root disk size. 400 无效的系统盘大小
          Instance.EphemeralDiskInvalidException instance ephemeral disk config invalid. 400 无效的实例临时盘配置
          BadRequest Gpu card count not valid. 400 gpu卡数量无效
          Instance.NameInvalid Instance name is invalid. 400 实例名称无效
          Instance.PasswordInvalid Password format is invalid. 400 密码格式非法
          Keypair.UnsupportOsType Unsupported os type, only linux supported. 403 不支持的操作系统
          NoSuchObject asp not exist. 404 asp不存在
          BadRequest bccCreateWithScript invalid. 400 白名单指定脚本地址创建BCC参数无效
          Volume.DiskSizeInvalid Disk size in invalid. 400 cds大小不合法
          Volume.StorageTypeInvalid Storage type is invalid. 400 磁盘存储类型不对
          Image.ImageTypeInvaild image type invalid. 400 镜像类型无效
          BadRequest invalid bcc flavor config. 400 无效的BCC套餐
          Instance.ReleaseTimeInvalid Fail to update the instance scheduled release time settings. 400 更新定时释放 参数无效
          Instance.UserDataPermissionDeny No permission for user data. 403 没有用户数据权限
          Image.ImageArchTypeExceptions Image Arch Type illegal. 400 镜像架构和实例机型不匹配:arm机型只能使用arm架构镜像,x86机型不能使用arm架构镜像
          Volume.DiskQuotaExceededLimit Number of volumes exceeds limit. 413 cds磁盘超额
          Instance.TagQuotaLimitExceeded Quota exceeds limit. 413 标签个数超过限制
          Cds.KmsNotExistException Kms not exist. 400 kms不存在
          Cds.KmsInvalidException Invalid Kms. 400 无效的Kms
          Zone denyAccess zone limit exception. 403 可用区限制异常
          BadRequest subnetId and securityGroupId should be added 400 应该加上subnetId和securityGroupId
          BadRequest BCC with NAT subnet can not bind eip 400 带有NAT子网的BCC不能绑定eip
          BadRequest The subnet is not belong to the logical zone. 400 子网不属于该逻辑可用区
          Vpc.IpInSubnetNotEnoughExceptions The ip left in the subnet is not enouth for this create. 400 子网中剩余的IP不足于创建
          Volume.DiskSizeQuotaExceededLimit Volume size exceeds total capacity quota. 413 cds磁盘大小超额
          Cds.KmsNotMatchException Kms not match with snapshot encryptKey. 400 Kms与快照解密密钥不匹配
          Instance.PostPayEipPurchaseDenied Need to pass senior real-name authentication. please download baiducloud App to do face authentication. 403 需要通过高级实名认证。请下载baiducloud应用程序进行人脸验证。
          BadRequest invalidate bandwidth parameter. 400 无效的带宽参数
          Instance.EipOperationDenied Account has no permission to bind EIP. 403 不支持EIP购买绑定
          PrepayInvalid Prepay not support for this instanceType. 400 不支持预付费
          Dcc.ResourceNotExist Dcc Resource not exist. 400 DCC资源不存在
          BadRequest validateSubnetSecurityGroupInSameVpc error. 400 验证子网和安全组属于同一个vpc下失败
          BadRequest securityGroup and subnet must be in same vpc 400 安全组和子网必须属于同一个vpc
          Dcc.FlavorIllegal unknown dcc flavor. 400 未知dcc flavor
          Instance.EphemeralDiskInvalidException instance ephemeral disk config invalid. 400 实例临时盘配置无效
          BadRequest invalid create request, instanceForCreate is not specified. 400 无效的创建请求,必须指定instanceForCreate

          创建BCC实例请求示例

          POST /v2/instance?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
          Host: bcc.bj.baidubce.com
          ContentType: application/json    
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
          {
              "instanceType": "N1",
              "cpuCount": 2,
              "memoryCapacityInGB": 2,
              "rootDiskSizeInGb":45,
              "rootDiskStorageType":"cloud_hp1",
              "createCdsList": [
                  {
                      "storageType": "std1",
                      "cdsSizeInGB": 5
                  }
              ],
              "name": "example",
              "imageId": "m-mRjO3cjs",
              "localDiskSizeInGB": 5,
              "networkCapacityInMbps": 1,
              "autoRenewTimeUnit": "month",
              "autoRenewTime": 1,
              "cdsAutoRenew": true,
              "internetChargeType": "BANDWIDTH_POSTPAID_BY_HOUR",
              "purchaseCount": 1,
              "billing":{
                  "paymentTiming":"Prepaid",
                  "reservation": {
                      "reservationLength": 1
                  }
              },
              "relationTag": true,
              "tags": [
                  {
                      "tagKey":"tag1",
                      "tagValue":"var1"
                  }
              ],
              "keypairId":"k-R0J0BEA9"
          }

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Wed, 03 Dec 2014 06:42:19 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS
          
          {
          
              "instanceIds": [
          
                  "i-T1I3OtUO"
          
              ]
          
          }

          请求示例(GPU型实例创建)

          POST /v2/instance?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
          Host: bcc.bj.baidubce.com
          ContentType: application/json    
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
          {
            "instanceType": "G1",
            "gpuCard": "P4",
            "cardCount": 2,
            "cpuCount": 24,
            "memoryCapacityInGB": 80,
            "createCdsList": [
             {
                  "storageType": "std1",
                  "cdsSizeInGB": 5
             }
            ],
            "name": "example",
            "imageId": "m-Rx1dCMFF",
            "networkCapacityInMbps": 0,
            "purchaseCount": 1,
            "billing": {
                  "paymentTiming": "Prepaid",
                  "reservation": {
                      "reservationLength": 1
             }
            }
          }

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Wed, 03 Dec 2014 06:42:19 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS
          
          {
              "instanceIds": [
                  "i-T1I3OtUO"
              ]
          }

          创建专属实例请求示例

          POST /v2/instance?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
          Host: bcc.bj.baidubce.com
          ContentType: application/json    
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
          {
              "cpuCount": 1,
              "memoryCapacityInGB": 2,
              "ephemeralDisks": [
                  {
                      "storageType": "sata",
                      "sizeInGB": 1024
                  },
                  {
                      "storageType": "sata",
                      "sizeInGB": 1024
                  }
              ],
              "name": "example",
              "imageId": "m-mRjO3cjs",
              "networkCapacityInMbps": 0,
              "dedicatedHostId": "d-YufwpQAe",
              "purchaseCount": 1
          }

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Tue, 06 Sep 2016 10:08:44 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS
          
          {
              "instanceIds": [
                  "i-T1I3OtUO"
              ]
          }
          上一篇
          错误返回
          下一篇
          创建实例(通过指定实例套餐规格)