华为云用户手册

URI DELETE /v2.1/{project_id}/servers/{server_id}/tags/{tag} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方式请参见获取项目ID。 server_id 是 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。 tag 是 标签信息。 约束： 标签的长度不超过80个字符，标签中如果包含non-URL-safe的字符，要进行URLEncode。 如果未指定具体的标签key，将删除该裸金属服务器的所有标签。

约束 tag的长度不超过80个字符。 tag中如果包含non-URL-safe的字符，要进行URLEncode。 “__type_baremetal”标识是一台裸金属服务器，建议不要删除“__type_baremetal”标签，否则，裸金属服务器将仅在E CS 控制台可见，而不在BMS控制台。 “__type_baremetal”删除后可通过为裸金属服务器添加一个标签（废弃）进行重新添加，添加后裸金属服务器会重新显示在BMS的控制台。

响应参数 正常响应要素 表4 正常响应要素说明 名称 参数类型 说明 job_id String 提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。 如何根据job_id来查询Job的执行状态，请参考查询Job状态。 异常响应要素 表5 异常响应要素说明 名称 参数类型 说明 error 字典数据结构 提交任务异常时返回的异常信息，详情请参见表6。 表6 error数据结构 名称 参数类型 说明 message String 任务异常错误信息描述。 code String 任务异常错误信息编码。

请求示例 强制重启ID为616fb98f-46ca-475e-917e-2563e5a8cd19和726fb98f-46ca-475e-917e-2563e5a8cd20的裸金属服务器。 1 POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/action 1 2 3 4 5 6 7 8 9 10 11 12 13 { "reboot": { "type": "HARD", "servers": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19" }, { "id": "726fb98f-46ca-475e-917e-2563e5a8cd20" } ] } }

请求参数 重启裸金属服务器请求参数中，必须以“reboot”字段下发重启裸金属服务器请求，详见请求示例。 参数 是否必选 参数类型 描述 reboot 是 Object 标记为重启裸金属服务器操作，详情请参见表2。 表2 reboot字段数据结构说明 参数 是否必选 参数类型 描述 type 是 String 重启类型： SOFT：普通重启（不生效）。 HARD：强制重启（默认）。 servers 是 Array of objects 裸金属服务器ID列表，详情请参见表3。 表3 servers字段数据结构说明 参数 是否必选 参数类型 描述 id 是 String 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。

响应示例 1 2 3 4 5 6 7 8 9 10 { "addresses": { "08a7715f-7de6-4ff9-a343-95ba4209f24a": [ { "version": 4, "addr": "192.168.2.90" } ] } }

请求示例 查询ID为95bf2490-5428-432c-ad9b-5e3406f869dd的裸金属服务器上ID为ce531f90-199f-48c0-816c-13e38010b442的网卡信息。 1 GET https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/os-interface/ce531f90-199f-48c0-816c-13e38010b442

响应示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 { "interfaceAttachment": { "port_state": "ACTIVE", "fixed_ips": [ { "subnet_id": "f8a6e8f8-c2ec-497c-9f23-da9616de54ef", "ip_address": "192.168.1.3" } ], "net_id": "3cb9bc59-5699-4588-a4b1-b87f96708bc6", "port_id": "ce531f90-199f-48c0-816c-13e38010b442", "mac_addr": "fa:16:3e:4c:2c:30" } }

URI GET /v2.1/{project_id}/servers/{server_id}/os-interface/{id} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方式请参见获取项目ID。 server_id 是 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。 id 是 网卡ID。 可以在裸金属服务器详情页面“网卡”页签中查看；也可以通过查询裸金属服务器网卡信息（废弃）API获取，对应的是参数“port_id”的取值。

响应参数 参数 参数类型 描述 interfaceAttachment Object 裸金属服务器网卡信息列表，详情请参见表2。 表2 interfaceAttachment字段数据结构说明 参数 参数类型 描述 port_state String 网卡端口状态，取值为：ACTIVE、BUILD、DOWN。 fixed_ips Array of objects 网卡IP信息列表，详情请参见表3。 net_id String 网卡端口所属子网的网络ID（network_id）。 port_id String 网卡端口ID。 mac_addr String 网卡MAC地址信息。 表3 fixed_ips字段数据结构说明 参数 参数类型 描述 subnet_id String 网卡私网IP对应子网的子网ID（subnet_id）。 ip_address String 网卡IP地址。

请求示例 关闭ID为95bf2490-5428-432c-ad9b-5e3406f869dd的裸金属服务器。 1 POST https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/action 1 2 3 { "os-stop": {} }

响应示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 { "server": { "tenant_id": "c685484a8cc2416b97260938705deb65", "image": { "links": [ { "rel": "bookmark", "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/images/1a6635d8-afea-4f2b-abb6-27a202bad319" } ], "id": "1a6635d8-afea-4f2b-abb6-27a202bad319" }, "accessIPv4": "", "addresses": { "08a7715f-7de6-4ff9-a343-95ba4209f24a": [ { "addr": "192.168.0.107", "version": 4 } ] }, "metadata": { }, "accessIPv6": "", "created": "2017-05-24T06:14:05Z", "hostId": "e9c3ee0fcc58ab6085cf30df70b5544eab958858fb50d925f023e53e", "flavor": { "links": [ { "rel": "bookmark", "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/flavors/physical.83.medium" } ], "id": "physical.83.medium" }, "OS-DCF:diskConfig": "MANUAL", "user_id": "1311c433dd9b408886f57d695c229cbe", "name": "new-server-test", "progress": 0, "links": [ { "rel": "self", "href": "https://openstack.example.com/v2/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd" }, { "rel": "bookmark", "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd" } ], "id": "95bf2490-5428-432c-ad9b-5e3406f869dd", "updated": "2017-05-25T03:40:25Z", "status": "ACTIVE" } }

请求示例 修改ID为95bf2490-5428-432c-ad9b-5e3406f869dd的裸金属服务器的名称为new-server-test。 1 PUT https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd 1 2 3 4 5 { "server": { "name": "new-server-test" } }

响应参数 表3 响应参数 参数 参数类型 描述 server Object 裸金属服务器信息，详情请参见表4 表4 server字段数据结构说明 参数 参数类型 描述 name String 裸金属服务器名称。 id String 裸金属服务器唯一标识。 status String 裸金属服务器当前状态。 ACTIVE：运行中/正在关机/删除中 BUILD：创建中 ERROR：故障 HARD_REBOOT：强制重启中 REBOOT：重启中 SHUTOFF：关机/正在开机/删除中/重建中/重装操作系统中/重装操作系统失败/冻结 created String 裸金属服务器创建时间。 时间戳格式为ISO 8601：YYYY-MM-DDTHH:MM:SSZ，例如：2019-05-22T03:30:52Z updated String 裸金属服务器上一次更新时间。 时间戳格式为ISO 8601：YYYY-MM-DDTHH:MM:SSZ，例如：2019-05-22T04:30:52Z flavor Object 裸金属服务器规格信息。详情请参见表5。 image Object 裸金属服务器镜像信息。详情请参见表6。 tenant_id String 裸金属服务器所属租户ID，UUID格式。 该参数和project_id表示相同的概念。 user_id String 裸金属服务器所属用户ID。 metadata Object 裸金属服务器元数据。详情请参见表7。 hostId String 裸金属服务器的主机ID。 addresses Array of address objects 裸金属服务器所属网络信息。 key：表示裸金属服务器使用的虚拟私有云的ID。 value：网络详细信息，具体请参见表9。 links Array of objects 裸金属服务器相关信息快捷链接。详情请参见表8。 accessIPv4 String 预留属性。 accessIPv6 String 预留属性。 OS-DCF:diskConfig String 扩展属性，磁盘配置方式，取值为以下两种： MANUAL：API使用镜像中的分区方案和文件系统创建裸金属服务器。如果目标flavor磁盘较大，则API不会对剩余磁盘空间进行分区。 AUTO：API使用与目标flavor磁盘大小相同的单个分区创建裸金属服务器，API会自动调整文件系统以适应整个分区。 progress Integer 预留属性。 表5 flavor字段数据结构说明 参数 参数类型 描述 id String 规格ID。 links Array of objects 规格相关信息快捷链接。详情请参见表8。 表6 image字段数据结构说明 参数 参数类型 描述 id String 裸金属服务器镜像ID。 links Array of objects 裸金属服务器镜像相关快捷链接信息。详情请参见表8。 表7 metadata字段数据结构说明 参数 参数类型 描述 用户自定义字段键值对 String metadata键、值。 键、值长度均不大于255字节。 表8 links字段数据结构说明 参数 参数类型 描述 rel String 快捷链接标记名称。取值为： self：包含版本号的资源链接，需要立即跟踪时使用此类链接。 bookmark：提供了适合长期存储的资源链接。 href String 对应快捷链接。 表9 address字段数据结构说明 参数 参数类型 描述 addr String IP地址。 version String 地址对应的版本。

响应示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 { "count": 2, "servers": [ { "id": "b544be62-1b3b-4982-ad98-572b002ac23b", "name": "bms-test1", "addresses": { "5849fdf1-9d79-4589-80c2-fe557990c417": [ { "version": "4", "addr": "192.168.1.63", "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:3a:8d:f1", "OS-EXT-IPS:port_id": "c79d2813-94c9-4135-973e-cbf5d23e78e6", "OS-EXT-IPS:type": "fixed" } ] }, "flavor": { "disk": "9309", "vcpus": "32", "ram": "193047", "id": "physical.s1.medium.ondemand", "name": "physical.s1.medium.ondemand", "gpus": [{ "name":"Nvidia Tesla V100S 32GB", "count":8, "memory_mb":32768 }], "asic_accelerators": [] }, "accessIPv4": "", "accessIPv6": "", "status": "ACTIVE", "progress": 0, "hostId": "cd243addb5d2c64e89218180b7a3ed95abe6882e81c337cc563137df", "updated": "2018-09-10T01:20:58Z", "created": "2018-09-06T09:29:27Z", "metadata": { "baremetalPortIDList": "[c79d2813-94c9-4135-973e-cbf5d23e78e6]", "chargingMode": "0" }, "tags": [ "__type_baremetal" ], "description": "bms-test1", "locked": false, "config_drive": "", "tenant_id": "bbf1946d374b44a0a2a95533562ba954", "user_id": "0c50494c5816425eb05c40b5e81ab65a", "key_name": "$key_name", "OS-EXT-STS:power_state": 1, "OS-EXT-STS:vm_state": "active", "OS-EXT-SRV-ATTR:host": "bms.dc1", "OS-EXT-SRV-ATTR:instance_name": "instance-0014bdc2", "OS-EXT-SRV-ATTR:hypervisor_hostname": "nova002@2", "OS-DCF:diskConfig": "MANUAL", "OS-EXT-AZ:availability_zone": "az-dc-1", "os:scheduler_hints": {}, "OS-EXT-SRV-ATTR:root_device_name": "/dev/vda", "OS-EXT-SRV-ATTR:ramdisk_id": "", "enterprise_project_id": "0", "OS-SRV-USG:launched_at": "2018-09-06T09:30:36.000000", "OS-EXT-SRV-ATTR:kernel_id": "", "OS-EXT-SRV-ATTR:launch_index": 0, "host_status": "UP", "OS-EXT-SRV-ATTR:reservation_id": "r-qjad3fv0", "OS-EXT-SRV-ATTR:hostname": "bms-test1", "sys_tags": [ { "key": "_sys_enterprise_project_id", "value": "0" } ] }, { "id": "a1541cfc-8ac3-43e9-a70d-b8d4b395b256", "name": "bms_test2", "addresses": { "5849fdf1-9d79-4589-80c2-fe557990c417": [ { "version": "4", "addr": "192.168.1.50", "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:8f:38:2c", "OS-EXT-IPS:port_id": "460aa585-9f83-4719-9527-fc39ebaca9aa", "OS-EXT-IPS:type": "fixed" } ] }, "flavor": { "disk": "9309", "vcpus": "32", "ram": "193047", "id": "physical.s1.medium", "name": "physical.s1.medium" }, "accessIPv4": "", "accessIPv6": "", "status": "SHUTOFF", "hostId": "cd243addb5d2c64e89218180b7a3ed95abe6882e81c337cc563137df", "updated": "2018-09-06T10:00:25Z", "created": "2018-08-30T12:40:47Z", "metadata": { "metering.order_id": "CS18083020422CNV9", "baremetalPortIDList": "[460aa585-9f83-4719-9527-fc39ebaca9aa]", "metering.product_id": "00301-167001-0--0", "chargingMode": "1" }, "tags": [ "__type_baremetal", "_sys_enterprise_project_id=9dd1131d-71fd-40fe-8f14-3fe6b6b5ef8b", "key1=value1", "three=3", "two=2" ], "description": "bms_test2", "locked": false, "config_drive": "", "tenant_id": "bbf1946d374b44a0a2a95533562ba954", "user_id": "3fc5ab2b0c544979abcaafd86edd80e6", "key_name": "$key_name", "OS-EXT-STS:power_state": 4, "OS-EXT-STS:vm_state": "stopped", "OS-EXT-SRV-ATTR:host": "bms.dc1", "OS-EXT-SRV-ATTR:instance_name": "instance-0014581b", "OS-EXT-SRV-ATTR:hypervisor_hostname": "nova002@2", "OS-DCF:diskConfig": "MANUAL", "OS-EXT-AZ:availability_zone": "az-dc-1", "os:scheduler_hints": {}, "OS-EXT-SRV-ATTR:root_device_name": "/dev/vda", "OS-EXT-SRV-ATTR:ramdisk_id": "", "enterprise_project_id": "0", "OS-SRV-USG:launched_at": "2018-08-30T12:42:10.000000", "OS-EXT-SRV-ATTR:kernel_id": "", "OS-EXT-SRV-ATTR:launch_index": 0, "host_status": "UP", "OS-EXT-SRV-ATTR:reservation_id": "r-i5w3yc9a", "OS-EXT-SRV-ATTR:hostname": "bms-test2", "sys_tags": [ { "key": "_sys_enterprise_project_id", "value": "0" }] } ] }

请求示例 修改ID为95bf2490-5428-432c-ad9b-5e3406f869dd的裸金属服务器的元数据，其中自定义metadata键值对为key和value。 1 PUT https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/metadata/{key} 1 2 3 4 5 { "meta": { "key": "value" } }

URI PUT /v2.1/{project_id}/servers/{server_id}/metadata/{key} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方式请参见获取项目ID。 server_id 是 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。 key 是 待修改的裸金属服务器metadata键值。

响应示例 1 2 3 4 5 6 7 8 { "volumeAttachment": { "device": "/dev/vdb", "serverId": "820abbd0-2d8e-4bc5-ae46-69cacfd4fbaa", "id": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6", "volumeId": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6" } }

响应参数 参数 参数类型 描述 volumeAttachment Object 裸金属服务器挂载信息列表。详情请参见表2。 表2 volumeAttachment字段数据结构说明 参数 参数类型 描述 device String 挂载目录，例如“/dev/vdb”。 id String 挂载资源ID。 serverId String 所属裸金属服务器ID。 volumeId String 挂载云磁盘ID。

URI GET /v2.1/{project_id}/servers/{server_id}/os-volume_attachments/{volume_id} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方式请参见获取项目ID。 server_id 是 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。 volume_id 是 云硬盘ID。 可以通过查询裸金属服务器挂载的云硬盘信息（废弃）API查询裸金属服务器挂载的云硬盘列表。

请求示例 查询ID为95bf2490-5428-432c-ad9b-5e3406f869dd的裸金属服务器上挂载的ID为b53f23bd-ee8f-49ec-9420-d1acfeaf91d6的云硬盘信息。 1 GET https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/os-volume_attachments/b53f23bd-ee8f-49ec-9420-d1acfeaf91d6

URI GET /v2.1/{project_id}/servers/{server_id}/ips/{vpc_id} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方式请参见获取项目ID。 server_id 是 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。 vpc_id 是 裸金属服务器所在虚拟私有云ID。

响应示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 { "server": { "tenant_id": "c685484a8cc2416b97260938705deb65", "addresses": { "08a7715f-7de6-4ff9-a343-95ba4209f24a": [ { "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:0e:c3:77", "OS-EXT-IPS:type": "fixed", "addr": "192.168.0.107", "version": 4 } ] }, "metadata": { "op_svc_userid": "1311c433dd9b408886f57d695c229cbe" }, "OS-EXT-STS:task_state": null, "OS-DCF:diskConfig": "MANUAL", "OS-EXT-AZ:availability_zone": "az-dc-1", "links": [ { "rel": "self", "href": "https://openstack.example.com/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd" }, { "rel": "bookmark", "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd" } ], "OS-EXT-STS:power_state": 1, "id": "95bf2490-5428-432c-ad9b-5e3406f869dd", "os-extended-volumes:volumes_attached": [ { "id": "dfa375b5-9856-44ad-a937-a4802b6434c3" }, { "id": "bb9f1b27-843b-4561-b62e-ca18eeaec417" }, { "id": "86e801c3-acc6-465d-890c-d43ba493f553" }, { "id": "0994d3ac-3c6a-495c-a439-c597a4f08fa6" } ], "OS-EXT-SRV-ATTR:host": "bms.az1", "image": { "links": [ { "rel": "bookmark", "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/images/1a6635d8-afea-4f2b-abb6-27a202bad319" } ], "id": "1a6635d8-afea-4f2b-abb6-27a202bad319" }, "OS-SRV-USG:terminated_at": null, "accessIPv4": "", "accessIPv6": "", "created": "2017-05-24T06:14:05Z", "hostId": "e9c3ee0fcc58ab6085cf30df70b5544eab958858fb50d925f023e53e", "OS-EXT-SRV-ATTR:hypervisor_hostname": "nova004@2", "key_name": "$key_name", "flavor": { "links": [ { "rel": "bookmark", "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/flavors/physical.83.medium" } ], "id": "physical.83.medium" }, "security_groups": [ { "name": "0011b620-4982-42e4-ad12-47c95ca495c4" } ], "config_drive": "", "OS-EXT-STS:vm_state": "active", "OS-EXT-SRV-ATTR:instance_name": "instance-0000ebd3", "user_id": "1311c433dd9b408886f57d695c229cbe", "name": "bms-83", "progress": 0, "OS-SRV-USG:launched_at": "2017-05-25T03:40:25.066078", "updated": "2017-05-25T03:40:25Z", "status": "ACTIVE" } }

URI DELETE /v1/{project_id}/baremetalservers/{server_id}/os-server-password 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方式请参见获取项目ID。 server_id 是 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。

URI PUT /v2.1/{project_id}/servers/{server_id}/tags/{tag} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方式请参见获取项目ID。 server_id 是 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。 tag 是 标签信息。 约束： 标签的长度不超过80个字符。 标签不能以点“.”开头。 不支持创建空标签（空串）。 中文或特殊字符需要进行URLEncode。

URI GET /v2.1/{project_id}/servers/{server_id}/tags/{tag} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方式请参见获取项目ID。 server_id 是 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。 tag 是 待查询标签的key。 约束： 中文或特殊字符需要进行URLEncode。 如果未指定标签的key，将返回该裸金属服务器所有的标签。

错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 HTTP状态码 返回值 说明 Error Message 处理措施 400 BMS.0001 请求数据错误。 Fail to parse request, reason: %s. 请参考返回的Error Message信息检查请求体。 400 BMS.0002 裸金属服务器还未上线。 The BMS service is unavailable. 服务当前不可用，请选择合适可用的Region。 400 BMS.0003 请求数据错误。 Create BareMetal Server error, request is null. 请参考返回的Error Message信息检查请求体。 400 BMS.0004 权限不足。 Role check fail, reason: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0005 权限不足。 Role check fail, reason: You do not have permission or your balance is insufficient. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0008 规格查询失败。 Fail to query flavor [%s], reason: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0006 创建Job失败。 Fail to operate baremetal server. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0009 规格相关属性查询失败。 Fail to query flavor extra specs[%s], reason: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0010 镜像查询失败。 Fail to query image [%s], reason: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0011 此镜像属性不支持裸金属服务器。 The selected images cannot be used to apply for BMSs, %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0012 所选子网中的IP地址数目不足。 The number of IP addresses in the selected subnet[%s] is insufficient. 请检查子网的IP是否已经被使用完。 400 BMS.0013 Port查询失败。 Fail to query ports by subnet [%s], reason: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0014 指定的IP地址冲突。 The specified IP address conflicts with an existing IP address in subnet[%s]. 请修改网卡IP。 400 BMS.0015 网卡查询失败。 Fail to query subnet, reason: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0017 弹性公网IP配额不足。 The number[%d] of EIPs has reached the maximum[%d] allowed. Apply for a higher quota and try again. EIP配额不足，请申请扩大EIP配额。 400 BMS.0218 创建订单失败。 Fail to create order, reason: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0219 修改裸金属服务器名称失败。 OpenStack nova change ServerName fail. 请联系技术支持。 400 BMS.0018 请求参数不合法。 Request parameter is invalid. 请参考返回的Error Message修改请求。 400 BMS.0019 网卡参数不合法。 publicIp parameter is illegal, reason: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0020 计费模式检验异常。 Fail to check chargingMode, reason: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0021 所选规格不能创建裸金属服务器，请重新选择。 Flavor parameter is illegal, reason: %s. 请选择合适的规格。 400 BMS.0022 请求参数不合法。 Request parameter is invalid. 请参考返回的Error Message修改请求。 400 BMS.0023 查询配额失败。 Fail to query limits, reason: %s 请参考返回的Error Message，或者联系技术支持。 400 BMS.0025 裸金属服务器的个数超过配额。 The number of cloud servers has reached the maximum allowed. 请申请扩大配额。 400 BMS.0026 裸金属服务器的CPU个数超过配额。 The number of CPU cores used by all cloud servers has reached the maximum allowed. 请申请扩大配额。 400 BMS.0027 裸金属服务器的内存超过配额。 The memory space used by all cloud servers has reached the maximum allowed. 请申请扩大配额。 400 BMS.0028 裸金属服务器的个数和CPU个数超过配额。 The number of CPU cores used by all cloud servers and that of cloud servers have reached the maximum allowed. 请申请扩大配额。 400 BMS.0029 裸金属服务器的个数和内存超过配额。 The memory space used by all cloud servers and the number of cloud servers have reached the maximum allowed. 请申请扩大配额。 400 BMS.0030 裸金属服务器的内存和CPU个数超过配额。 The memory space and number of CPU cores used by all cloud servers have reached the maximum allowed. 请申请扩大配额。 400 BMS.0031 裸金属服务器的个数、CPU个数和内存超过配额。 The number of cloud servers, the memory space used by all cloud servers, and the number of CPU cores used by all cloud servers have reached the maximum allowed. 请申请扩大配额。 400 BMS.0032 请联系技术支持申请裸金属服务器。 Token check fail. 请参考返回的Error Message，或者联系技术支持。 403 BMS.0033 您暂时没有操作权限，请联系技术支持。 Fail to check roles, reason: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0034 暂时不支持自动化发放裸金属服务器。 Not support create Bare Metal Server. 当前不支持此操作。 400 BMS.0047 系统盘参数异常。 Root volume is illegal, reason: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0049 key_name查询失败。 Query keypair fail, reason is: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0089 tag policy合规性校验不通过。 The tag policy does not allow the specified value for the following tag key: %s. 请检查tag policy策略，或者联系技术支持。 400 BMS.0102 此镜像暂不支持挂载卷。 The image does not support attach volume. 请联系技术支持。 400 BMS.0103 该卷不存在。 Attach volume %s fail, volume info is null. 请核对卷信息是否正确。 400 BMS.0104 数据卷不能挂载在系统盘挂载点上。 Attach volume %s fail, data volume can not attach in root volume device. 请选择其他挂载点。 400 BMS.0105 挂载点不合法。 Attach volume %s fail, device is illegal. 检查挂载点是否合法。 400 BMS.0106 数据卷可用区和裸金属服务器可用区不一致。 Attach volume %s fail, volume's az is not equal with server's az. 请确保数据卷和裸金属服务器的可用区一致。 400 BMS.0108 系统盘和裸金属服务器不匹配。 Attach volume %s fail, root volume does not match the VM, do not change image. 系统盘和裸金属服务器不匹配，请确认后再挂载。 400 BMS.1001 只有当裸金属服务器处于运行中或者关机状态，才能进行此操作。 Volume can only be attached when server %s stopped or active. 请稍候重试或联系技术支持。 400 BMS.1002 裸金属服务器可挂载数据卷数量超过配额。 Attach volume fail, server %s attchment num over limit. 请联系技术支持。 400 BMS.1003 卷状态无效。 Attach shareable volume %s fail, volume status is %s, not available or inuse. 请检查该卷的状态是否为已挂卷状态或其他不可用状态。 400 BMS.1004 裸金属服务器可挂载的共享数据卷数量超过配额。 Attach shareable volume %s fail, volume status is %s, not available or inuse. 请联系技术支持。 400 BMS.1006 暂时无法获取该裸金属服务器的运行状态。 Server %s info is null or its status or its metadata is null. 请稍候重试或联系技术支持。 400 BMS.1007 调用接口失败。 Calling interface failed 请参考返回的Error Message，或者联系技术支持。 400 BMS.1008 卷类型不匹配。 The server[%s] is not HANA server, volume[%s] does not match the server. 请检查卷类型是否匹配，或者联系技术支持。 400 BMS.1009 该数据卷已经挂载在这台裸金属服务器上面。 Attach shareable volume %s fail, volume status is %s, the volume has been attached to the server. 请重新选择数据卷。 400 BMS.1011 该数据卷正在挂载。 Attach shareable volume %s fail, volume status is %s, not available or inuse. 请不要重复操作。 400 BMS.3001 查询Security Group或者Subnet失败。 Query security group failed: %s. or Query vpcId for subnet failed: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.3011 系统错误。 Decoded token is null. 请参考返回的Error Message，或者联系技术支持。 400 BMS.3025 云硬盘类型错误。 Not support create shareable data volumes. 请参考返回的Error Message，或者联系技术支持。 400 BMS.3035 此裸金属服务器没有匹配的卷。 Attach volume fail: the bmsid [%s] in volume metadata is not the same with bmsid [%s] in url. 请确保此卷和裸金属服务器匹配，或者联系技术支持。 400 BMS.3039 密码复杂度校验失败。 The password is illegal, reason: %s. 请参考密码规则。 400 BMS.0246 VPC查询失败。 The vpcId[%s] is invalid or not-existing. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0201 创建裸金属服务器参数不正确。 Fail to check the baremetal server params, reason: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0202 数据盘类型不合法。 All volumes must be in same type. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0203 Volume参数不合法。 Volume is illegal, %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0204 数据盘超过最大允许值。 The num of datavolume is illegal, the num is %d, max num allow is %d. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0205 裸金属服务器数量不合法。 The number of baremetal servers is out of range for one quest. 请修改创建或者删除裸金属服务器的数量。 400 BMS.0206 名称含有非法字符。 The baremetal server name [%s] is include invalid char. 请按要求修改名称。 400 BMS.0207 批量创建裸金属服务器不允许指定IP。 VPC is illegal, reason: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0208 AZ查询失败。 Fail to get RegionInfo by tenant [%s], reason: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0210 注入数据超过最大长度。 The size of userdata [%d] is over quota limits [%d]. 请修改注入数据。 400 BMS.0211 密钥不合法。 The image platform is [%s], support publicKey, reason: the publicKey is illegal, null is not allowed. 请选择合适的密钥。 400 BMS.0114 卸载卷不在该裸金属服务器的卷列表中。 Volume %s is not in server %s attach volume list. 请确定该卷是否存在。 400 BMS.0212 系统过载。 System is overloaded, please try again later. 请稍后重试。 400 BMS.0213 权限不足。 OBTAZ role verify fail: not allowed role. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0214 网卡查询失败。 Query subnet[%s] failed: response is null. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0215 创建订单失败。 The response of inquiry order info is null or invalid. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0216 提交订单失败。 Submit order[%s] failed: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0217 Metadata校验失败。 Create server fail, reason: metaData is illegal. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0222 主网卡不允许删除。 primary port can not be deleted. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0223 目前只支持SCSI磁盘模式。 Only SCSI disks are supported. 目前只支持SCSI磁盘模式，请选择该模式。 400 BMS.0039 裸金属服务器已经关机。 Server is stopped, not allow to stop. 请勿重复关机。 400 BMS.0040 裸金属服务器不存在。 The server does not exist. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0035 裸金属服务器已经上电，不允许进行其他操作。 Server is powering on, not allow to %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0036 裸金属服务器已经下电，不允许进行其他操作。 Server is powering off, not allow to %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0038 裸金属服务器正在运行中，不允许启动。 Server is running, not allow to start. 请勿重复开机。 400 BMS.0037 裸金属服务器正在重启，不允许进行其他操作。 Server is rebooting, not allow to %s. 请参考返回的Error Message，或者联系技术支持。 403 BMS.0288 无操作权限。 Policy doesn't allow %s to be performed. 请参考返回的Error Message，或者联系技术支持 400 BMS.0290 该卷不是共享卷，不支持批量挂载。 Batch attach volume type must be sharable. 请选择共享卷。 400 BMS.0291 企业项目ID不能为空。 enterprise_project_id can not be empty. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0294 调用EPS查询项目失败。 Query enterprise_project_id[%s] failed %. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0293 查询项目信息失败。 Query enterprise_project_id[%s] failed: response is null. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0292 企业项目已经停用。 enterprise_project_id[%s] is deactive. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0071 指定EIP创建裸金属服务器时，不能创建新的EIP。 Using an existing EIP and creating a new EIP can't be used at the same time. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0072 不能用一个指定的EIP批量创建多个裸金属服务器。 An existing EIP cannot be assigned to the ECSs created in batches. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0073 带宽参数为空。 Bandwidth info in eip is null. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0074 EIP扩展参数不可用。 Parameter exetendparam or chargingMode is null. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0075 带宽ID为空。 Bandwidth info in eip is null. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0076 EIP计费模式不可用。 Parameter chargingMode only supports postPaid when shared type is whole. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0077 带宽大小不合法。 PublicIp parameter is illegal, reason: %s. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0078 EIP配额不足。 Shared bandwidth has been bound to %d EIPs, quota is %d. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0079 EIP带宽类型不可用。 Specifies the bandwidth of the shared type and the id cannot be empty. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0080 子网状态不可用。 Check subnet status failed. 请检查子网是否存在，或者是否是ACTIVE状态。 400 BMS.0297 云硬盘提交订单且未支付，不允许挂载/卸载。 Fail to attach volume[%s]: volume is locked. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0054 容量校验失败。 Check capacity fail, the number of capacity is: [%d], and req num is: [%d]. 规格容量不足，请联系技术支持。 400 BMS.0055 查询配额失败。 Query capacity fail, Flavor id is [%s], reason: [%s]. 请参考返回的Error Message，或者联系技术支持。 400 BMS.2005 Network查询失败。 Network could not be found. 请检查Network信息，或者联系技术支持。 400 BMS.3037 资源不足或服务器启动失败。 Insufficient resources or failed to start the BMS. 请联系技术支持。 400 BMS.3004 创建失败，系统内部错误。 Failed to create the BMS due to an internal system error. 请联系技术支持。 400 BMS.3005 创建端口失败。 Failed to create the port. 请联系技术支持。 400 BMS.3033 创建系统卷失败。 Failed to create the system disk. 请联系技术支持。 400 BMS.3029 创建系统卷失败，系统卷状态异常。 Failed to create the system disk. The disk status is abnormal. 请联系技术支持。 400 BMS.3006 创建弹性IP失败。 Failed to assign the floating IP address. 请联系技术支持。 400 BMS.3021 创建数据卷失败。 Failed to create the data disk. 请联系技术支持。 400 BMS.3019 挂载数据卷失败。 Failed to attach the data disk. 请联系技术支持。 400 BMS.3038 创建弹性公网IP失败。 Failed to assign the EIP. 请联系技术支持。 400 BMS.0315 该规格不支持挂卷。 Disks cannot be attached to a BMS using this flavor[%s]. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0316 该RAID Level和RAID类型不匹配。 RAID level and RAID type do not match. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0317 磁盘信息不合法，磁盘信息为空。 Disk information is empty. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0320 此规格不支持该类型的卷组RAID。 This flavor does not support RAID formed by disks of this type. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0321 此规格不支持该大小的卷组RAID。 This flavor does not support RAID formed by disks of this size. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0322 磁盘数量和该RAID Level不匹配。 Disk quantity and RAID level do not match. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0323 磁盘数量和规格中对应的磁盘数量不匹配。 Disk quantity does not match that in the flavor. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0325 磁盘数量超过该规格支持的盘数量。 Disk quantity exceeds that supported by the flavor. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0327 仅支持JBOD。 Only JBOD is supported. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0328 仅支持单盘RAID 0。 Only single-disk RAID 0 is supported. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0329 磁盘信息不合法，磁盘类型为空。 Disk type is empty. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0330 不支持组RAID。 RAID is not supported. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0331 没有IPv6公测权限。 No IPv6 Open Beta Test permissions. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0333 不支持IPv6。 IPv6 is not supported. 请参考返回的Error Message，或者联系技术支持。 400 BMS.0400 镜像不支持IPv6。 the image[%s] is not support IPv6. 请参考返回的Error Message，或者联系技术支持 400 BMS.0360 磁盘已经冻结，无法操作裸金属服务器。 This operation cannot be performed because EVS Disk %s is frozen. 请参考返回的Error Message，或者联系技术支持。 400 BMS.3026 密码不符合规则要求。 Password does not meet the requirements of the rule. 请参考返回的Error Message，或者联系技术支持。 400 BMS.3027 VPC参数不合法。 VPC parameter is illegal. 请参考返回的Error Message，或者联系技术支持。 400 BMS.3028 卷配额异常。 cinder quota check fail. 请参考返回的Error Message，或者联系技术支持。 400 Common.0018 token无效，token中的tenant_id和URL中的tenant_id不一致 tenantId in token is not the same with in URL. 请检查租户的token是否正确。 400 BMS.0111 密码或密钥未指定或者重复指定。 none or multiple passwords specified, please specify one. 密码或者密钥不能同时指定，请确认登录方式。 400 BMS.0395 Windows系统的裸金属服务器不支持远程登录。 The server[%s] is windows system and can not support remote login。 请参考返回的Error Message，或者联系技术支持。 400 BMS.0605 当前裸机被锁定。 the BMS is locked. 请参考返回的Error Message，或者联系技术支持。

请求消息 请求参数 参数 是否必选 参数类型 描述 os-getSerialConsole 是 Object 获取裸金属服务器远程登录地址。详情请参见表2。 表2 os-getSerialConsole字段数据结构说明 参数 是否必选 参数类型 描述 type 是 String 获取对象，请将type配置为“serial”。 请求示例 获取ID为47e9be4e-a7b9-471f-92d9-ffc83814e07a的裸金属服务器的远程登录地址。 1 POST https://{ECS Endpoint}/v2/9c53a566cb3443ab910cf0daebca90c4/servers/47e9be4e-a7b9-471f-92d9-ffc83814e07a/action 1 2 3 4 5 { "os-getSerialConsole": { "type": "serial" } }

响应消息 响应参数 无 响应示例 1 2 3 4 5 6 { "console": { "url": "https://baremetal-consoleproxy.az1.dc1.domainname.com:8003/?token=040134bb-9195-4029-9a62-550bce390258", type": "serial" } }

响应示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 { "servers": [ { "tenant_id": "c685484a8cc2416b97260938705deb64", "addresses": { "08a7715f-7de6-4ff9-a343-95ba4209f24a": [ { "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:0e:c4:77", "OS-EXT-IPS:type": "fixed", "addr": "192.168.0.107", "version": 4 } ] }, "metadata": { "op_svc_userid": "1311c433dd9b408886f57d695c229cbe" }, "OS-EXT-STS:task_state": null, "OS-DCF:diskConfig": "MANUAL", "OS-EXT-AZ:availability_zone": "az-dc-1", "links": [ { "rel": "self", "href": "https://openstack.example.com/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd" }, { "rel": "bookmark", "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd" } ], "OS-EXT-STS:power_state": 1, "id": "95bf2490-5428-432c-ad9b-5e3406f869dd", "os-extended-volumes:volumes_attached": [ { "id": "dfa375b5-9856-44ad-a937-a4802b6434c3" }, { "id": "bb9f1b27-843b-4561-b62e-ca18eeaec417" }, { "id": "86e801c3-acc6-465d-890c-d43ba493f553" }, { "id": "0994d3ac-3c6a-495c-a439-c597a4f08fa6" } ], "OS-EXT-SRV-ATTR:host": "bms.az1", "image": { "links": [ { "rel": "bookmark", "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/images/1a6635d8-afea-4f2b-abb6-27a202bad319" } ], "id": "1a6635d8-afea-4f2b-abb6-27a202bad319" }, "OS-SRV-USG:terminated_at": null, "accessIPv4": "", "accessIPv6": "", "created": "2017-05-24T06:14:05Z", "hostId": "e9c3ee0fcc58ab6085cf30df70b5544eab958858fb50d925f023e53e", "OS-EXT-SRV-ATTR:hypervisor_hostname": "nova004@2", "key_name": "$key_name", "flavor": { "links": [ { "rel": "bookmark", "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/flavors/physical.83.medium" } ], "id": "physical.83.medium" }, "security_groups": [ { "name": "0011b620-4982-42e4-ad12-47c95ca495c4" } ], "config_drive": "", "OS-EXT-STS:vm_state": "active", "OS-EXT-SRV-ATTR:instance_name": "instance-0000ebd3", "user_id": "1311c433dd9b408886f57d695c229cbe", "name": "bms", "progress": 0, "OS-SRV-USG:launched_at": "2017-05-25T03:40:25.066078", "updated": "2017-05-25T03:40:25Z", "status": "ACTIVE" } ] }