云服务器内容精选

  • 响应消息 响应参数如表9所示。 表9 响应参数 参数 参数类型 描述 server Object 云服务器信息,详情请参见表10。 表10 server字段数据结构说明 参数 参数类型 描述 id String 弹性云服务器ID,UUID格式。 links Array of objects 弹性云服务器URI自描述信息,详情参见表11。 security_groups Array of objects 弹性云服务器所在安全组,详情参见表12。 OS-DCF:diskConfig String diskConfig方式。 MANUAL,镜像空间不会扩展。 AUTO,系统盘镜像空间会自动扩展为与flavor大小一致。 reservation_id String reservation_id:通过返回的reservation_id,可以过滤查询到本次创建的弹性云服务器。 说明: 批量创建弹性云服务器时,支持使用该字段。 adminPass String Windows弹性云服务器Administrator用户的密码。 表11 links字段数据结构说明 参数 参数类型 描述 rel String 快捷链接标记名称。 href String 对应快捷链接。 表12 security_groups字段数据结构说明 参数 参数类型 描述 name String 安全组名称或者uuid。
  • 请求示例 通过block_device_mapping_v2扩展属性使用镜像创建一台云服务器,采用密钥方式登录鉴权。 POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers { "server": { "flavorRef": "s3.xlarge.2", "name": "wjvm48", "metadata": { "name": "name_xx1", "id": "id_xxxx1" }, "block_device_mapping_v2": [{ "source_type": "image", "destination_type": "volume", "uuid": "b023fe17-11db-4efb-b800-78882a0e394b", "delete_on_termination": "False", "boot_index": "0", "volume_type": "SAS", "volume_size": "40" }], "security_groups": [{ "name": "name_xx5_sg" }], "networks": [{ "uuid": "fd40e6f8-942d-4b4e-a7ae-465287b02a2c", "port": "e730a11c-1a19-49cc-8797-cee2ad67af6f", "fixed_ip": "10.20.30.137" }], "key_name": "test", "user_data": "ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBpdCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5kIGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVsc2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4gQnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRoZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlvdSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vyc2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6b25zLiINCg0KLVJpY2hhcmQgQmFjaA==", "availability_zone":"az1-dc1" } } 通过block_device_mapping_v2扩展属性使用快照创建一台云服务器,其中,boot_index为0,且该快照对应的云硬盘必须为系统盘。 POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers { "server":{ "name":"wjvm48", "availability_zone":"az1-dc1", "block_device_mapping_v2": [ { "source_type":"snapshot", "boot_index":"0", "uuid":"df51997d-ee35-4fb3-a372-e2ac933a6565", // snapshot id,创建snapshot接口会返回id "destination_type":"volume" } ], "flavorRef":"s3.xlarge.2", "max_count":1, "min_count":1, "networks": [ { "uuid":"79a68cef-0936-4e21-b1f4-b800ecb70246" } ] } } 通过block_device_mapping_v2使用卷创建一台弹性云服务器。 POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers { "server": { "flavorRef": "s3.xlarge.2", "name": "wjvm48", "metadata": { "name": "name_xx1", "id": "id_xxxx1" }, "block_device_mapping_v2": [{ "source_type": "volume", "destination_type": "volume", "uuid": "bd7e4f86-b004-4745-bea2-a55b1085f107", "delete_on_termination": "False", "boot_index": "0", "volume_type": "dsware", "volume_size": "40" }], "security_groups": [{ "name": "name_xx5_sg" }], "networks": [{ "uuid": "fd40e6f8-942d-4b4e-a7ae-465287b02a2c", "port": "e730a11c-1a19-49cc-8797-cee2ad67af6f", "fixed_ip": "10.20.30.137" }], "key_name": "test", "user_data": "ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBpdCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5kIGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVsc2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4gQnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRoZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlvdSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vyc2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6b25zLiINCg0KLVJpY2hhcmQgQmFjaA==", "availability_zone":"az1-dc1" } } 使用imageRef创建一台弹性云服务器,建议将密码在配置文件或者环境变量中密文存放,使用时解密,确保安全。 POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers { "server": { "flavorRef": "s3.xlarge.2", "name": "wjvm48", "metadata": { "name": "name_xx1", "id": "id_xxxx1" }, "adminPass": "$ADMIN_PASS", "imageRef": "6b344c54-d606-4e1a-a99e-a7d0250c3d14", "security_groups": [{ "name": "name_xx5_sg" }], "networks": [{ "uuid": "fd40e6f8-942d-4b4e-a7ae-465287b02a2c", "port": "e730a11c-1a19-49cc-8797-cee2ad67af6f", "fixed_ip": "10.20.30.137" }], "key_name": "test", "user_data": "ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBpdCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5kIGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVsc2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4gQnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRoZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlvdSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vyc2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6b25zLiINCg0KLVJpY2hhcmQgQmFjaA==", "availability_zone":"az1-dc1" } } 批量创建弹性云服务器,最小数量为2,最大数量为3。 POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers { "server": { "availability_zone":"az1.dc1", "name": "test", "imageRef": "10ff4f01-35b6-4209-8397-359cb4475fa0", "flavorRef": "s3.xlarge.2", "return_reservation_id": "true", "networks": [ { "uuid": "51bead38-d1a3-4d08-be20-0970c24b7cab" } ], "min_count": "2", "max_count": "3" } }
  • 响应示例 创建弹性云服务器: { "server": { "security_groups": [ { "name": "name_xx5_sg" } ], "OS-DCF:diskConfig": " MANUAL", "id": "567c1557-0eca-422c-bfce-149d6b8f1bb8", "links": [ { "href": "http://xxx/v2/dc4059e8e7994f2498b514ca04cdaf44/servers/567c1557-0eca-422c-bfce-149d6b8f1bb8", "rel": "self" }, { "href": "http://xxx/dc4059e8e7994f2498b514ca04cdaf44/servers/567c1557-0eca-422c-bfce-149d6b8f1bb8", "rel": "bookmark" } ], "adminPass": "*********" } } 批量创建弹性云服务器: { "reservation_id": "r-3fhpjulh" }
  • 接口约束 该接口为原生接口,不支持整机镜像创建弹性云服务器功能。如需使用整机镜像创建弹性云服务器,请使用创建云服务器(按需)。 该接口为原生接口,不支持创建竞价实例。如需创建竞价实例请使用创建云服务器、创建云服务器(按需)。 该接口为原生接口,不支持创建包年/包月计费模式的实例。如需创建包年/包月计费模式的云服务器请使用创建云服务器。 使用该接口创建的云服务器,不支持在创建过程中绑定弹性公网IP,推荐使用创建云服务器(按需)创建云服务器并绑定弹性公网IP。 网络的三个参数(port、uuid和fixed_ip)中,port优先级最高;指定fixed_ip时必须指明uuid。 注入文件失败,将导致创建弹性云服务器失败。 使用镜像创建弹性云服务器时,存在下面约束: 不支持指定Host创建弹性云服务器。 租户如果对弹性云服务器中的卷进行了备份,则需要租户自行删除该卷所对应的快照等数据后,才能删除卷。 调整镜像创建的弹性云服务器规格时,不支持resource_type不同的flavor之间的规格调整。 云服务平台提供的原生接口/v2/{project_id}/servers 和 /v2.1/{project_id}/servers 是基于社区版OpenStack原生接口加固而成的,兼容社区版OpenStack原生接口。 较之社区版的OpenStack原生接口,在使用指定镜像的方式创建弹性云服务器时存在如下差异: 社区OpenStack原生接口:默认使用服务器本地磁盘创建弹性云服务器。 云服务平台提供的原生接口:为了保障可靠性,使用共享存储作为系统盘创建弹性云服务器。 该差异的具体表现为,当您使用提供的原生接口创建云服务器时: 可以查询到云服务器挂载的系统盘信息。 云服务器的系统盘会占用云硬盘的配额。 不支持使用image过滤查询指定镜像方式创建的弹性云服务器。 指定卷创建弹性云服务器场景下,指定的卷与创建的弹性云服务器必须处于相同的AZ(availability_zone)。 用户创建弹性云服务器时在block_device_mapping_v2设置的device_name字段不会生效,系统会默认生成一个device_name。 请勿使用“provider:network_type”为“geneve”的网络来创建弹性云服务器。 “provider:network_type”为“geneve”时,表示裸金属服务器使用的内部高速网络。 如果使用密钥方式远程登录云服务器,请使用key_name参数。如果使用密码方式远程登录云服务器,可使用adminPass参数;对于Linux云服务器,还可使用user_data进行注入,对于Windows云服务器,还可通过元数据admin_pass进行注入。
  • 错误码说明 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 Ecs.0000 Request error. Try again later or contact customer service. 请求数据错误 请参考返回的error message信息检查请求体 400 Ecs.0001 Insufficient E CS quota. Contact customer service to increase quota. 租户云服务器配额不足 请参考返回的error message申请扩大相应资源的配额 400 Ecs.0002 A system exception occurred. Try again later or contact customer service. 提交任务失败 请联系技术支持进行定位 403 Ecs.0003 You do not have permission to perform this operation. Contact customer service to obtain permission. 账户受限 请参考返回的error message,检查是否余额不足,账号被冻结等 400 Ecs.0004 A system exception occurred. Try again later or contact customer service. 升权失败 请参考返回的error message,或者联系技术支持 400 Ecs.0005 Invalid parameter values. Contact customer service. 参数非法 请参考接口文档检查请求体是否为一个正确的json体 400 Ecs.0006 Invalid parameter values. Contact customer service. 市场镜像没有产品编号 请检查镜像参数 400 Ecs.0007 A system exception occurred. Try again later or contact customer service. 镜像相关属性非法 请调整规格或者镜像类型 400 Ecs.0008 A system exception occurred. Try again later or contact customer service. Flavor相关属性非法 请联系技术支持排查flavor注册是否合法 400 Ecs.0009 Another flavor must be used for resizing. Flavor未变更 变更云服务器规格时选择与原规格不同的Flavor 400 Ecs.0010 The private IP address is already being used. Select another IP address. 私有IP地址已经被使用 请更换Port 400 Ecs.0011 Ensure the password meets the password complexity requirements. 密码不符合系统要求复杂度 请检查密码的长度并修改 400 Ecs.0012 The subnet does not contain enough IP addresses. Release some IP addresses or select a different subnet. IP地址不足 请检查子网的FIP是否已经被使用完 400 Ecs.0013 The current EIP quota limit has been reached. Apply to increase the quota. EIP配额不足 EIP配额不足,请申请扩大EIP配额 400 Ecs.0014 Incorrect VPC, subnet, or security group parameter values. VPC参数不合法 请检查子网是否都属于同一个虚拟机私有云 400 Ecs.0015 Invalid disk type for this type of ECS. Select a valid disk type and try again. 该类型磁盘不适用于该类型云服务器 请检查卷的volume_type是否与Flavor匹配 400 Ecs.0016 You do not have permission to access this AZ. Request OBT permission and try again. 创建云服务器时,没有对应Flavor的公测权限。 变更云服务器规格时,没有对应Flavor的公测权限。 请申请公测权限或者更换其他规格。 400 Ecs.0017 The status of the selected disk does not meet the attachment requirements on the ECS. Select an available disk for attaching. 系统盘或数据盘所属云服务器和待挂载云服务器不同 请检查卷metadata中__system__server_id是否和待挂载的虚拟机uuid相同 400 Ecs.0018 The selected flavor has been sold out. Try another flavor. Flavor已售罄 请更换其他规格 400 Ecs.0019 The selected flavor has been canceled. Try another flavor. Flavor已下线 请更换其他规格 400 Ecs.0021 Insufficient EVS disk quota. Contact customer service to increase quota. 云硬盘配额不足 申请扩大云硬盘配额 400 Ecs.0022 Insufficient ECS group quota. Contact customer service to increase quota. 云服务器组超过用户配额 申请扩大云服务器组配额 400 Ecs.0023 project_id in token mismatches with project_id in url. token无效或者token中的tenantId和URL中的tenantId不匹配 申请合法的token或者检查URL中的项目ID 400 Ecs.0025 EVS is not authorized to obtain KMS keys for encrypting EVS disks. 未授权EVS获取KMS密钥加密云硬盘 请授权EVS获取KMS密钥加密云硬盘 400 Ecs.0027 The ECSs of this flavor cannot be created. Flavor属于私有规格,禁止使用。 请更换其他规格 400 Ecs.0028 The ECSs of this flavor cannot be created. 用户已加入该Flavor黑名单,禁止使用该规格 请更换其他规格 400 Ecs.0029 The flavor does not exist. Flavor不存在或已下线 请更换其他规格 400 Ecs.0030 The ECS has been frozen and does not support specifications modification. 云服务器被冻结 请检查账户是否被冻结或者联系技术支持 400 Ecs.0031 The image does not exist. 镜像不存在 请更换镜像 400 Ecs.0032 The image is not in Active state. 镜像状态错误,非Active状态 请更换镜像 400 Ecs.0034 The full-ECS backup does not exist or has been deleted. 整机备份不存在或已被删除. 请更换镜像 400 Ecs.0036 The flavor does not support automatic recovery. 当前规格不支持自动恢复 请更换规格 400 Ecs.0037 The flavor does not support SCSI disks. 当前规格不支持挂载SCSI类型的磁盘 请更换规格或者类型 400 Ecs.0038 The subnet does not exist. 子网不存在 请调整网络参数 400 Ecs.0039 The specified IP address does not belong to the subnet. 指定的IP不属于该子网 请修改指定的私有IP 400 Ecs.0041 Invalid description field. 描述字段不合法 请修改云服务描述字段 400 Ecs.0042 The number of attached data disks exceeds the maximum allowed limit. 挂载数据盘的个数超过限制 请调整挂载数据盘的个数 400 Ecs.0043 The disk type does not exist. 磁盘类型不存在 请修改磁盘类型 400 Ecs.0044 The disk of this type has been sold out. 该类型磁盘已售罄 请修改磁盘类型 400 Ecs.0045 The bandwidth exceeds the maximum allowed limit. 带宽大小超过限制 请调整带宽的大小 400 Ecs.0046 When creating an ECS using an image, ensure that the type of the attached data disk is the same as that required by the image. 云服务器的磁盘类型必须与快照镜像对应的磁盘一致 请调整磁盘类型 400 Ecs.0048 Ensure that the image status is Normal and that the status of the CSBS backup associated with the image is Available or Creating, and try again later. 整机镜像的状态不可用 请检查整机镜像的状态 400 Ecs.0049 The selected enterprise project has been disabled. Enable the project or select another project. 企业项目状态非法 请修改企业项目的状态 400 Ecs.0050 The number of NICs attached to the ECS exceeds the quota. 云服务器所挂网卡数超过限制。 请调整网卡的个数 400 Ecs.0051 Only SCSI disks can be attached to the ECSs of this flavor. 云服务器只能挂载scsi磁盘 请调整磁盘类型 400 Ecs.0052 Only SCSI system disks can be attached to the ECSs of this flavor. 云服务器只能挂载scsi系统盘 请调整系统盘的磁盘类型 400 Ecs.0053 Only SCSI data disks can be attached to the ECSs of this flavor. 云服务器只能挂载scsi数据盘 请调整数据盘的磁盘类型 400 Ecs.0057 The disk has already been attached to the ECS and you cannot repeatedly attach it. 云服务器已挂载当前磁盘 请替换一个新的磁盘挂载 400 Ecs.0058 You do not have permission to use a third-party image to create ECSs. 镜像的provideId和当前账号的不匹配 请检查账户权限及镜像 400 Ecs.0062 The flavor does not support the driver mode. 规格不支持设置网卡驱动类型 请更换规格 400 Ecs.0064 The VPC ID in the request is inconsistent with that in the main subnet ID. 请求体中的vpcId与主网卡的vpcId不一致 请调整网卡参数 403 Ecs.0066 This operation cannot be performed because real-name authentication has not been completed. 未实名认证受限 请检查账户是否未实名认证受限 403 Ecs.0067 Insufficient account balance. 余额不足受限 请检查账户是否余额不足受限 403 Ecs.0068 This operation cannot be performed by partners. 成为合作伙伴受限 请检查账户是否成为合作伙伴受限 403 Ecs.0069 You have not associated a payment method with your account. 未完善支付信息受限 请检查账户是否未完善支付信息受限 403 Ecs.0070 Insufficient budget. Contact the enterprise administrator and request for a budget increase. 企业部门账号预算不足受限 请检查账户是否企业部门账号预算不足受限 403 Ecs.0071 This operation cannot be performed because your account has been suspended. 黑产账号受限 请检查账户是否黑产账号受限 400 Ecs.0073 The system disk is being backed up. Wait until the execution is complete and try again. 系统卷处于卷备份过程中 系统卷处于备份中时,禁止删除系统卷 400 Ecs.0074 Window images do not support external users. 外部用户禁止创建windows虚拟机 外部用户(非第三方创建镜像)禁止购买windows镜像 400 Ecs.0075 Partners only support Windows images. 合作伙伴只支持购买windows镜像 合作伙伴只支持购买windows镜像 400 Ecs.0076 The spot block specification does not support the selected predefined duration. 购买的竞价实例时长超过最长限制 请调整购买竞价实例时长 400 Ecs.0077 The number of durations exceeds the maximum limit of the spot block ECS. 购买的“竞价实例时长”的个数超过最大限制 请调整购买“竞价实例时长”的个数 400 Ecs.0081 Scheduled deletion is not supported. 不支持定时销毁功能 请参考返回的error message信息检查请求体 400 Ecs.0082 Incorrect time format. 自动释放格式错误。需要使用UTC时间,格式为:yyyy-MM-ddTHH:mm:ssZ 请参考返回的error message信息检查请求体 403 Ecs.0083 The scheduled time has been reached. 自动销毁时间已经过期 请参考返回的error message信息检查请求体 400 Ecs.0084 Scheduled deletion is not supported. 包年/包月实例auto_terminate_time必须为空 请参考返回的error message信息检查请求体 400 Ecs.0085 The server does not have the interface. 虚拟机没有该网卡 请更换网卡 400 Ecs.0086 The interface is not the primary interface. 网卡不是主网卡 请更换网卡 400 Ecs.0089 Tag policy compliance verification failed. Tag policy合规性校验不通过 请检查Tag policy策略,或者联系技术支持。 400 Ecs.0090 Image license type is BYOL, the BYOL feature is not supported at this time. 当前区域不支持BYOL镜像相关特性。 请更换镜像,或者联系技术支持。 400 Ecs.0100 The ECS status does not meet requirements. Make the ECS in the required status and try again. 云服务器状态不符合要求 云服务器状态不支持当前操作,请延后操作 400 Ecs.0101 The system disk is currently unresponsive. Try again later or contact customer service. 系统盘状态异常 具体原因请联系技术支持 400 Ecs.0102 The data disk is currently unresponsive. Try again later or contact customer service. 系统盘状态不支持卸载 请检查系统盘的状态 400 Ecs.0103 The disk can be attached to a server only if it exists and the state must be in the available. Make sure the disk state is available and try again. 云磁盘状态不可用 检查卷的状态或者联系技术支持更改卷状态 400 Ecs.0104 The number of EVS disks that can be attached to the ECS exceeds the maximum number allowed. Decrease the number of EVS disks to be attached and try again. 云服务器可挂载云硬盘槽位不足 请调整挂载磁盘数 400 Ecs.0105 No system disk found. Attach the system disk to the ECS and try again. 云服务器系统盘查询失败 请检查云服务器是否挂载有系统盘 400 Ecs.0106 A network exception occurred. Try again later or contact customer service. 网络状态异常 具体原因请联系技术支持进行定位 403 Ecs.0110 Contact the main account to obtain permission. 客户端禁止,权限不足 权限不足,请确认token权限,详情请参考接口返回的error message 400 Ecs.0111 The EVS disk has been detached from the ECS. Refresh the disk list and check the disk. 磁盘没有挂载至服务列表中 请检查所选磁盘信息是否已经挂载,或者更换新的磁盘 400 Ecs.0112 The ECS is not billed on a pay-per-use basis. 非按需类型云服务器不能迁移 非按需类型云服务器不能迁移,如有疑问请联系技术支持 404 Ecs.0114 The ECS does not exist. 云服务器不存在 请检查云服务器是否已经创建 400 Ecs.0118 The number of ECSs exceeds the maximum allowed limit. 批量操作的任务数超过最大限制 请检查批量操作任务中云服务器的数量 400 Ecs.0119 An encrypted disk with an unavailable key cannot be attached to an ECS. 云服务器无法挂载密钥已禁用的加密磁盘 请更改密钥的状态。 400 Ecs.0120 The yearly/monthly ECS cannot be rebuilt. 包年/包月虚拟机禁止rebuild 包年/包月虚拟机禁止rebuild,如有疑问请联系技术支持 400 Ecs.0121 The disk cannot be attached to the ECS because the disk and the ECS are in different failure domains. 挂卷失败,虚拟机和卷的故障域不一致 选择和虚拟机故障域匹配的卷挂载 400 Ecs.0201 Failed to create the NIC. Try again later or contact customer service. 创建网卡失败 请参考返回的error message,或者联系技术支持 400 Ecs.0202 Failed to create the system disk. Try again later or contact customer service. 创建系统盘失败 请参考返回的error message,或者联系技术支持 400 Ecs.0203 Failed to create the data disk. Try again later or contact customer service. 创建数据盘失败 请参考返回的error message,或者联系技术支持 400 Ecs.0204 Failed to create the ECS. Try again later or contact customer service. 创建云服务器失败 请参考返回的error message,或者联系技术支持 400 Ecs.0205 Failed to attach the data disk. Try again later or contact customer service. 挂载数据盘失败 请参考返回的error message,或者联系技术支持 400 Ecs.0207 Failed to modify the ECS specifications. Try again later or contact customer service. 变更云服务器规格失败 请参考返回的error message,或者联系技术支持 400 Ecs.0208 A system exception occurred. Try again later or contact customer service. 更新镜像metadata失败 请参考返回的error message,或者联系技术支持 400 Ecs.0209 Failed to modify the ECS specifications. Try again or contact customer service. 确认变更云服务器规格失败 请参考返回的error message,或者联系技术支持 400 Ecs.0210 A system exception occurred. Try again later or contact customer service. 创建浮动IP失败 请参考返回的error message,或者联系技术支持 400 Ecs.0211 Failed to create the NIC. Try again later or contact customer service. 创建网卡Qos失败 请参考返回的error message,或者联系技术支持 400 Ecs.0212 Failed to assign the private IP address. Try again later or contact customer service. 创建私有IP地址失败 具体原因请联系技术支持 400 Ecs.0213 Failed to update the port attributes. Try again later or contact customer service. 更新端口属性失败 请参考返回的error message,或者联系技术支持 400 Ecs.0214 Failed to create the network. Try again later or contact customer service. 创建网络失败 请参考返回的error message,或者联系技术支持 400 Ecs.0216 Failed to create the subnet. Try again later or contact customer service. 创建子网失败 请参考返回的error message,或者联系技术支持 400 Ecs.0217 Failed to attach the NIC. Try again later or contact customer service. 挂载端口失败 请参考返回的error message,或者联系技术支持 400 Ecs.0219 Failed to create the ECS. Try again later or contact customer service. 创建云服务器失败 请参考返回的error message,或者联系技术支持 400 Ecs.0221 Cold migration from a dedicated host to the same dedicated host is not supported. 迁移云服务器失败 请参考返回的error message,或者联系技术支持 400 Ecs.0226 Failed to start. 启动云服务器失败 请参考返回的error message,或者联系技术支持 400 Ecs.0227 Failed to reboot. 重启云服务器失败 请参考返回的error message,或者联系技术支持 400 Ecs.0235 The hypervisor of current flavor is KVM, system volume of whole image can't be SCSI. 使用整机镜像创建云服务器失败。 使用QingTian架构的规格 400 Ecs.0301 Failed to query the ECS. Try again later or contact customer service. 查询云服务器失败 请参考返回的error message,或者联系技术支持 400 Ecs.0302 Failed to query the ECS quota of the tenant. Try again later or contact customer service. 查询租户云服务器配额失败 请参考返回的error message,或者联系技术支持 400 Ecs.0303 Failed to query the ECS specifications. Try again later or contact customer service. 查询规格失败 请参考返回的error message,或者联系技术支持 400 Ecs.0304 Failed to query the image. Try again later or contact customer service. 查询镜像失败 请联系技术支持确认镜像是否注册正确,或者联系技术支持确认其他原因 400 Ecs.0306 Failed to query the backup. Try again later or contact customer service. 查询备份失败 请参考返回的error message,或者联系技术支持 400 Ecs.0307 Failed to query the port. Try again later or contact customer service. 查询端口失败 请参考返回的error message,或者联系技术支持 400 Ecs.0308 Failed to query the ECS quota of the tenant. Try again later or contact customer service. 查询租户云服务器配额失败 请参考返回的error message,或者联系技术支持 400 Ecs.0309 Failed to create the NIC. Try again later or contact customer service. 查询网卡Qos失败 请参考返回的error message,或者联系技术支持 400 Ecs.0310 A system exception occurred. Try again later or contact customer service. 查询网络失败 请参考返回的error message,或者联系技术支持 400 Ecs.0311 Failed to obtain the disk type. Try again later or contact customer service. 查询卷类型失败 请参考返回的error message,或者联系技术支持 400 Ecs.0313 ECS group query failed. 查询云服务组失败 请参考返回的error message,或者联系技术支持 400 Ecs.0314 The key pair does not exist. Refresh the key pair list and check key pair 请求OpenStack查询keypair失败 请参考返回的error message,或者联系技术支持 400 Ecs.0315 Failed to call the nova API to query the auto recovery status. 查询云服务器是否设置auto recovery失败 请参考返回的error message,或者联系技术支持 400 Ecs.0319 Insufficient resources for this flavor. Try another flavor. flavor容量不足 申请扩大flavor容量 400 Ecs.0320 AZ query failed. 查询可用区失败 请参考返回的error message,或者联系技术支持 400 Ecs.0321 Console logs query failed. 查询云服务器控制台日志失败 请参考返回的error message,或者联系技术支持 400 Ecs.0322 Subnet query failed. 查询子网详情失败 请参考返回的error message,或者联系技术支持 400 Ecs.0323 Failed to query the NIC attached to the ECS. 查询虚拟机挂载网卡失败 请参考返回的error message,或者联系技术支持 400 Ecs.0401 Failed to release the port. Try again later or contact customer service. 回滚端口失败 请参考返回的error message,或者联系技术支持 400 Ecs.0402 Failed to release the system disk. Try again later or contact customer service. 回滚系统卷失败 请参考返回的error message,或者联系技术支持 400 Ecs.0403 Failed to release the ECS. Try again later or contact customer service. 回滚云服务器失败 联系技术支持定位回滚服务器失败原因 400 Ecs.0405 Failed to release the data disk. Try again later or contact customer service. 回滚数据盘失败 请参考返回的error message,或者联系技术支持 400 Ecs.0501 Failed to delete the ECS. Try again later or contact customer service. 删除云服务器失败 请稍后重新执行操作 400 Ecs.0502 Failed to delete the private IP address. Try again later or contact customer service. 删除私有IP失败 请参考返回的error message,或者联系技术支持 400 Ecs.0503 Failed to obtain the system disk. Try again later or contact customer service. 查询系统卷失败 请参考返回的error message,或者联系技术支持 400 Ecs.0507 Failed to delete the NIC. Try again later or contact customer service. 删除网卡失败 请检查网卡类型 400 Ecs.0510 Yearly/Monthly ECSs do not support changing OSs. 包年/包月弹性云服务器不支持变更操作系统 按包年包月计费的,且使用的市场镜像的云服务器不支持切换操作系统 400 Ecs.0513 server %s is the cycle order and not be deleted by ordinary user 普通用户不允许删除包年/包月弹性云服务器 包周弹性云服务器请执行退订操作 501 Ecs.0603 ther commands are being executed. Try again later. 当前已有其他命令执行,请稍后1分钟重试 请稍后1分钟重试 400 Ecs.0605 ECS locked. 云服务器被锁定 请检查云服务器是否被锁定,若想继续操作请先将云服务器解锁。 400 Ecs.0610 Failed to reset the ECS password. 重置密码失败 请稍后重新执行操作,或者联系技术支持 400 Ecs.0611 Batch operation failed. 批量请求操作失败 根据返回的详细错误信息,修改错误后重新进行请求处理 400 Ecs.0612 Failed to check whether plug-ins have been installed. 校验弹性云服务器是否安装插件请求失败 请稍后重新执行操作,或者联系技术支持 400 Ecs.0613 The ECS has no plug-ins installed. 弹性云服务器未安装插件 安装插件 404 Ecs.0614 The ECS does not exist. 弹性云服务器不存在 检查弹性云服务器是否存在 500 Ecs.0615 The thread list is empty. 服务器处理请求异常 系统内部错误。 请联系技术支持进行定位 400 Ecs.0616 Failed to update the ECS name. 弹性云服务器修改失败 请稍后重新执行操作,或者联系技术支持 400 Ecs.0617 Failed to modify attribute. Please try again later or contact customer service. 修改云服务器挂载的磁盘属性失败 请参考返回的错误信息,或者联系技术支持 400 Ecs.0618 Failed to change the IP address of the ECS NIC. 修改云服务器网卡IP失败 请参考返回的error message,或者联系技术支持 400 Ecs.0701 Failed to obtain the order or product. Try again later or contact customer service. 查询订单或者产品失败 请联系技术支持进行定位 400 Ecs.0702 Failed to get the demand price or spot price. Try again later or contact customer service. 查询价格失败 查询价格接口异常,请联系技术支持 400 Ecs.0703 The single instance price limit cannot be less than the spot price. 用户出价小于当前现价 用户出价小于竞价实例市场价格,请提高竞价实例出价 400 Ecs.0704 Spot ECSs do not support specifications modification. 竞价型实例不允许切换规格 竞价实例不允许切换规格 400 Ecs.0705 Automatic recovery cannot be enabled on spot ECSs. 竞价型实例不允许开启自动恢复 竞价实例不允许开启自动恢复 400 Ecs.0706 RIs cannot be split or combined. 合并拆分预留实例失败 请联系技术支持进行定位 400 Ecs.0707 The product has not been registered. 购买的该产品不存在 请联系技术支持进行定位 400 Ecs.0802 The specifications of an ECS created using a Red Hat image cannot be modified. 弹性云服务器不支持变更规格 特定镜像的弹性云服务器不支持变更规格 400 Ecs.0803 When modifying the specifications of an ECS created on a DeH, specify the DeH. DEH弹性云服务器变更规格需指定专属主机的ID 请修改变更规格请求体 400 Ecs.0804 The ECS flavor cannot be switched to the target flavor. Change the target flavor. 弹性云服务器不支持变更到目标规格 请更换其他规格 400 Ecs.0805 A large-memory ECS cannot be switched to a general computing ECS. 超大内存型Flavor不能与普通Flavor互切 超大内存型Flavor不能与普通Flavor互切 400 Ecs.0806 H2 ECSs do not support specifications modification. 高性能计算型II代实例不支持变更规格 高性能计算型II代实例不支持变更规格 400 Ecs.0807 The number of ECS NICs exceeds the maximum number allowed on the target ECS. Uninstall excess NICs. 弹性云服务器网卡个数超过目标规格云服务器网卡的挂载限制 请卸载多余网卡 400 Ecs.0808 The Xen ECS created using a UEFI image does not support specifications modification. UEFI镜像的XEN弹性云服务器不支持变更规格 UEFI镜像的XEN弹性云服务器不支持变更规格 400 Ecs.0809 The number of VBD disks exceeds the maximum number allowed on the target ECS. Uninstall excess disks. VBD磁盘数量超过目标规格弹性云服务器的挂载限制 请卸载多余磁盘 400 Ecs.0810 The ECS flavor is the same as the target flavor. 目标规格与弹性云服务器当前规格一样 请更换其他规格 400 Ecs.0811 Install the required drivers on the ECS and then change Xen to KVM. 当前规格不支持从xen切换到kvm 请安装驱动脚本 400 Ecs.0812 Current flavor %s can not resize to flavor %s. 当前规格变更到目标规格需要执行驱动检查脚本 请执行驱动检查脚本 详细操作,请参见: KVM实例变更为QingTian实例(Linux) KVM实例变更为QingTian实例(Windows) 400 Ecs.0813 Change flavor %s to flavor %s is risky, the driver needs to be installed. 当前规格切换到目标规格存在风险 执行驱动检查脚本后,入参传force参数且值为true,忽略风险。 400 Ecs.0901 Yearly/Monthly DeHs cannot be allocated. 不支持创建包年/包月的DEH 请更换其他规格 400 Ecs.0902 Spot ECSs do not support Marketplace images. 竞价实例不支持使用市场镜像 请更换其他镜像 400 Ecs.0903 Spot ECSs do not support automatic recovery. 竞价实例不支持自动恢复 请更换其他规格 400 Ecs.0904 UEFI images cannot be used to create Xen ECSs. UEFI镜像不支持创建XEN实例 请更换其他规格 400 Ecs.0905 The number of tags exceeds the maximum allowed limit. 标签的个数超过限制 请减少标签的个数 400 Ecs.0906 Failed to comply with tag character set specifications. 标签的属性非法 请重新制定标签 400 Ecs.0907 Invalid tag character set. 标签字符集不合法 请重新制定标签 400 Ecs.0908 The tag key cannot be duplicate. 标签的键重复 请重新制定标签 400 Ecs.0909 The flavor does not support the disk type. 当前规格不支持该磁盘类型 请更换其他规格或者磁盘类型 400 Ecs.0910 Invalid NIC settings for creating a HANA ECS. 创建HANA实例的网卡参数不合法 请调整网卡参数 400 Ecs.0911 Invalid dedicated storage type of the disk. 磁盘的专属存储类型参数不合法 请调整专属存储类型参数 400 Ecs.0912 Invalid disk encryption key. 磁盘加密属性参数不合法 请调整磁盘加密属性参数 400 Ecs.0913 The number of ECSs to be created exceeds the maximum allowed limit 创建云服务器个数超过限制 请减少创建的云服务器个数 400 Ecs.0914 The length of the ECS name exceeds the maximum allowed limit. 云服务器名称长度超过限制 请调整云服务器名称参数 400 Ecs.0915 The length of the ECS name exceeds the maximum allowed limit. 云服务器名称包含非法字符 请调整云服务器名称参数 400 Ecs.0919 The NIC has been attached to another instance. 端口状态不允许挂载 请更换网卡端口。 400 Ecs.1000 A system exception occurred. Try again later or contact customer service. 调用Nova接口处理请求异常 系统内部调用异常,请稍后重试或请联系技术支持 400 Ecs.1001 A system exception occurred. Try again later or contact customer service. 访问OpenStack异常 OpenStack异常导致云服务器状态异常,请联系技术支持 400 Ecs.1002 A system exception occurred. Try again later or contact customer service. 访问OpenStack超时 如果您正在执行切换VPC、挂载/卸载网卡、挂载/卸载磁盘、切换/重装操作系统等操作,请关闭资源后再重试操作。 如果重试后仍超时,请联系技术支持。 400 Ecs.1100 A system exception occurred. Try again later or contact customer service. 访问 IAM 失败 请参考返回的error message,或者联系技术支持 400 Ecs.1200 A system exception occurred. Try again later or contact customer service. 访问VPC失败 请参考返回的error message,或者联系技术支持 400 Ecs.1201 A system exception occurred. Try again later or contact customer service. 访问VPC超时 任务超时,具体原因请联系技术支持 400 Ecs.1300 A system exception occurred. Try again later or contact customer service. 访问EVS超时 请参考返回的error message,或者联系技术支持 400 Ecs.7000 Check whether your account balance is sufficient for the order, whether there are orders pending payment, and whether the order is being processed. Try again later or contact customer service. 创建订单失败 请查看账户余额是否足够支付订单,是否有订单待支付以及是否订单处理中,或者联系技术支持 403 Pdp.0001 Policy doesn't allow %s to be performed. API鉴权失败 请参考API授权项列表,在IAM增加相关权限 202 Common.0024 exceeds flow over limit 请求流控 请求并发过高,请稍后重试。 400 Common.0002 The request body cannot be left blank. 请求消息体为空 请检查请求body体 400 Common.0011 Failed to query system tasks. 无效JobId 请确认JobId参数来源是否正确 400 Common.0018 The project ID in the URL is different from that in the token. token无效,token中的project_id和URL中的project_id不一致 请检查租户的token是否正确 400 Common.0020 A system exception occurred. Try again later or contact customer service. 任务重试失败 请联系技术支持 400 Common.0021 Sub job fail! 查询Job异常 请稍后重试,或联系技术支持 400 Common.0022 Mission fail! 提交Job异常 请联系技术支持 400 Common.0999 The system was broken, exit. 任务退出 请联系技术支持 400 Common.0025 Query job Error because %s. 查询Job异常 请稍后重试,或联系技术支持 400 Common.0026 Fail to get Region Info 查询AZ信息异常 请稍后重试,或联系技术支持 401 Common.0013 Invalid token. token不合法 请检查租户的token是否正确 500 Common.0001 A system exception occurred. Try again later or contact customer service. 系统异常 请联系技术支持 429 Common.1503 Api flow control Error because %s. API流控 正在执行的API过多,请稍后重试。
  • 背景信息 接口返回的错误码与Error Message不具有一一对应关系,表中只是列出比较常见的一种Error Message。 本服务接口以异步接口居多,有的错误码是在查询任务的返回体中体现的,http状态码有可能不是很准确。 本服务对网络、存储等服务具有强依赖性,Error Message显示依赖服务的错误消息时,处理措施需要联系技术支持。 在管理控制台进行操作时,如果显示错误码,错误码说明请参见《弹性云服务器用户指南》的常见问题“针对管理控制台的异常提示信息,应该如何处理”。
  • 支持的授权项 策略包含系统策略和自定义策略,如果系统策略不满足授权要求,管理员可以创建自定义策略,并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应,授权项列表说明如下: 权限:允许或拒绝对指定资源在特定条件下进行某项操作。 对应API接口:自定义策略实际调用的API接口。 授权项:自定义策略中支持的Action,在自定义策略中的Action中写入授权项,可以实现授权项对应的权限功能。 依赖的授权项:部分Action存在对其他Action的依赖,需要将依赖的Action同时写入授权项,才能实现对应的权限功能。 IAM项目(Project)/企业项目(Enterprise Project):自定义策略的授权范围,包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目,表示此授权项对应的自定义策略,可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目,不支持企业项目,表示仅能在IAM中给用户组授权并生效,如果在企业管理中授权,则该自定义策略不生效。 关于IAM项目与企业项目的区别,详情请参见:IAM与企业管理的区别。 实例授权/标签授权:自定义策略的生效范围。如果同时支持实例授权和标签授权,表示此授权项对应的自定义策略,可以对某些指定实例或某些绑定指定标签的实例生效。如果仅支持标签授权,不支持实例授权,表示该授权项只能对某些绑定指定标签的实例生效。 该功能目前在“华北-乌兰察布一”暂不开放。 “√”表示支持,“x”表示暂不支持。 ECS支持的自定义策略授权项如下所示: 生命周期管理 状态管理 批量操作 网络管理 镜像管理 安全组管理 规格查询 网卡管理 磁盘管理 元数据管理 租户配额管理 SSH密钥管理 密码管理 浮动IP管理 云服务器组管理 云服务器控制台管理 可用区管理 标签管理 FPGA逻辑文件管理
  • 响应消息 响应参数如表3所示。 表3 响应参数 参数 参数类型 描述 instanceActions Array of Object 云服务器操作行为列表,详情请参见表4。 表4 instanceActions字段数据结构说明 参数 是否必选 参数类型 描述 action 是 String 行为动作 取值范围: create , delete , evacuate , restore , stop , start , reboot , rebuild , revertResize , confirmResize , detach_volume , attach_volume , attach_interface , detach_interface , lock , unlock , resize , migrate , pause , unpause , rescue , unrescue , changePassword , shelve ,unshelve , live-migration , live_migration_cancel , live_migration_force_complete , trigger_crash_dump, extend_volume instance_uuid 是 String 弹性云服务器ID,UUID格式 message 是 String 行为完成状态信息 project_id 是 String 项目ID request_id 是 String 请求ID start_time 是 String 行为开始时间 user_id 是 String 用户ID
  • 响应示例 { "instanceActions": [ { "instance_uuid": "e723eb40-f56e-40f9-8c8c-caa517fe06ba", "user_id": "752be40780484291a9cc7ae50fff3e6d", "start_time": "2014-12-16T10:58:14.000000", "request_id": "req-ee56c2b5-d33b-4749-ae83-09281dbbb716", "action": "resize", "message": "Error", "project_id": "89655fe61c4c4a08b9f3e7f9095441b8" }, { "instance_uuid": "e723eb40-f56e-40f9-8c8c-caa517fe06ba", "user_id": "752be40780484291a9cc7ae50fff3e6d", "start_time": "2014-12-16T10:57:56.000000", "request_id": "req-23cfd57f-c58a-45cd-86a6-eab3e38f3753", "action": "resize", "message": "Error", "project_id": "89655fe61c4c4a08b9f3e7f9095441b8" }, ] }
  • 创建磁盘的metadata字段数据结构说明 该字段被如下接口使用: 创建云服务器 /v1/{project_id}/cloudservers 创建云服务器 /v1.1/{project_id}/cloudservers 创建云服务器时,root_volume和data_volume都包含metadata字段。 表10 创建磁盘的metadata字段数据结构说明 参数 是否必选 参数类型 描述 __system__encrypted 否 String metadata中的表示加密功能的字段,0代表不加密,1代表加密。 该字段不存在时,云硬盘默认为不加密。 __system__cmkid 否 String 用户主密钥ID,是metadata中的表示加密功能的字段,与__system__encrypted配合使用。 说明: 请参考查询密钥列表,通过HTTPS请求获取密钥ID。
  • os:scheduler_hints字段数据结构说明 该字段被如下接口使用: 创建云服务器 /v1/{project_id}/cloudservers 创建云服务器 /v1.1/{project_id}/cloudservers 创建云服务器(原生) /v2.1/{project_id}/servers 表12 os:scheduler_hints字段数据结构说明(请求参数) 参数 是否必选 参数类型 描述 group 否 String 云服务器组ID,UUID格式。 云服务器组的ID可以从控制台或者参考查询云服务器组列表获取。 说明: 请确保云服务器组使用的是反亲和性anti-affinity策略,不推荐使用其他策略。 tenancy 否 String 在指定的专属主机或者共享主机上创建弹性云服务器。 参数值为shared或者dedicated。 dedicated_host_id 否 String 专属主机的ID。 说明: 专属主机的ID仅在tenancy为dedicated时生效。 表13 os:scheduler_hints字段数据结构说明(响应参数) 参数 参数类型 描述 group Array of strings 云服务器组ID,UUID格式。 云服务器组的ID可以从控制台或者参考查询云服务器组列表获取。 tenancy Array of strings 在指定的专属主机或者共享主机上创建弹性云服务器。 参数值为shared或者dedicated。 dedicated_host_id Array of strings 专属主机的ID。 说明: 专属主机的ID仅在tenancy为dedicated时生效。
  • 创建云服务器的metadata字段数据结构说明 该字段被如下接口使用: 创建云服务器 /v1/{project_id}/cloudservers 创建云服务器 /v1.1/{project_id}/cloudservers 表11 metadata预留字段数据结构说明 参数 是否必选 参数类型 描述 op_svc_userid 否 String 用户ID。 您可以在我的凭证下,通过“API凭证”页面的“IAM用户ID”,获取该参数的值。更多内容,请参见API凭证。 说明: 该参数取值为当前登录账号的“IAM用户ID”,如果您当前使用IAM用户登录,则需要获取对应IAM用户的“IAM用户ID”。 agency_name 否 String 委托的名称。 委托是由租户管理员在 统一身份认证 服务(Identity and Access Management,IAM)上创建的,可以为弹性云服务器提供访问云服务的临时凭证。 说明: 委托获取、更新请参考如下步骤: 使用IAM服务提供的查询委托列表接口,获取有效可用的委托名称。 使用更新云服务器元数据接口,更新metadata中agency_name字段为新的委托名称。 __support_agent_list 否 String 云服务器是否支持主机安全服务、主机监控。 "ces":主机监控 "hss":主机安全服务基础版 "hss,hss-ent":主机安全服务企业版 取值样例: __support_agent_list:“hss,ces” 可以通过查询镜像详情判断创建云服务器使用的镜像是否支持主机安全服务或主机监控。
  • 数据结构导航 publicip字段数据结构说明 security_groups字段数据结构说明 eip字段数据结构说明 bandwidth字段数据结构说明 ipv6_bandwidth字段数据结构说明 创建弹性公网IP的extendparam字段数据结构说明 创建磁盘的extendparam字段数据结构说明 创建云服务器的extendparam字段数据结构说明 创建磁盘的metadata字段数据结构说明 创建云服务器的metadata字段数据结构说明 os:scheduler_hints字段数据结构说明 server_tags字段数据结构说明
  • publicip字段数据结构说明 该字段被如下接口使用 创建云服务器 /v1/{project_id}/cloudservers 创建云服务器 /v1.1/{project_id}/cloudservers 表1 publicip字段数据结构说明 参数 是否必选 参数类型 描述 id 否 String 为待创建云服务器分配已有弹性公网IP时,分配的弹性公网IP的ID,UUID格式。 约束:只能分配状态(status)为DOWN的弹性公网IP。 eip 否 Object 配置云服务器自动分配弹性公网IP时,创建弹性公网IP的配置参数。 详情请参见表3。 delete_on_termination 否 Boolean 弹性公网IP随实例释放策略。 true:弹性公网IP随实例释放。 false:弹性公网IP不随实例释放。 默认值:false。 说明: 该字段仅按需弹性公网IP支持。 输入publicip字段数据结构中的id和eip的值时,只能选择其中一个参数值输入。
  • security_groups字段数据结构说明 该字段被如下接口使用 创建云服务器 /v1/{project_id}/cloudservers 创建云服务器 /v1.1/{project_id}/cloudservers 表2 security_groups字段数据结构说明 参数 是否必选 参数类型 描述 id 否 String 待创建云服务器的安全组,会对创建云服务器中配置的网卡生效。需要指定已有安全组的ID,UUID格式;若不传id字段,底层会创建默认安全组。