华为云用户手册

响应示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 { "interfaceAttachments": [ { "port_state": "ACTIVE", "fixed_ips": [ { "subnet_id": "a5052101-11e1-4f3d-a5fa-f6ba6791219c", "ip_address": "192.168.1.147" } ], "net_id": "ad0fadbf-4bc1-472c-a030-5310e53b3818", "port_id": "bb585b04-f2a2-4528-9064-fd0aeb4e15a9", "mac_addr": "fa:16:3e:3b:58:fc" } ] }

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

响应参数 参数 参数类型 描述 interfaceAttachments Array of objects 裸金属服务器网卡信息列表，详情请参见表2。 表2 interfaceAttachments字段数据结构说明 参数 参数类型 描述 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地址信息。 driver_mode String 从guest os中，网卡的驱动类型。可选值为virtio和hinic，默认为virtio。 pci_address String 弹性网卡在Linux GuestOS里的BDF号。 表3 fixed_ips字段数据结构说明 参数 参数类型 描述 subnet_id String 网卡私网IP对应子网的子网ID（subnet_id）。 ip_address String 网卡私网IP信息。

修订记录 版本日期 变更说明 2023-11-23 第十八次正式发布。 新增切换裸金属服务器操作系统。 2023-09-14 第十七次正式发布。 创建裸金属服务器，新增参数allowed_address_pairs。 2023-05-23 第十六次正式发布。 新增错误码BMS.0089，请参见错误码。 2023-02-28 第十五次正式发布。 优化错误码说明和补充错误码错误码。 补充约束条件创建裸金属服务器 2022-09-26 第十四次正式发布。 补充响应示例、请求示例、优化参数描述等。 涉及修改： 创建裸金属服务器 重装裸金属服务器操作系统 启动裸金属服务器 重启裸金属服务器 关闭裸金属服务器 裸金属服务器挂载云硬盘 裸金属服务器绑定弹性网卡 裸金属服务器解绑弹性网卡 查询裸金属服务器IP地址（OpenStack原生） 查询裸金属服务器的指定IP地址（OpenStack原生） 查询裸金属服务器元数据（OpenStack原生） 查询裸金属服务器挂载的云硬盘信息（OpenStack原生） 查询裸金属服务器详情（OpenStack原生） 查询裸金属服务器详情列表（OpenStack原生） 查询裸金属服务器详情 2022-09-05 第十三次正式发布。 新增如下接口： 获取裸金属服务器远程登录地址 裸金属服务器绑定弹性网卡 裸金属服务器解绑弹性网卡 修改裸金属服务器弹性网卡的属性 批量添加裸金属服务器标签 批量删除裸金属服务器标签 查询裸金属服务器标签 2020-11-09 第十二次正式发布。 新增如下应用示例： 示例1：创建裸金属服务器 示例2：查询裸金属服务器 示例3：裸金属服务器挂载磁盘 2020-01-20 第十一次正式发布。 权限及授权项说明， IAM 控制台改版，修改权限相关描述。 2019-11-12 第十次正式发布。 新增如下接口： 查询API版本信息列表 查询指定API版本信息 查询裸金属服务器详情列表 重装裸金属服务器操作系统 启动裸金属服务器 重启裸金属服务器 关闭裸金属服务器 查询规格详情和规格扩展信息列表 查询裸金属服务器网卡信息 查询裸金属服务器挂载的云硬盘信息 更新裸金属服务器元数据 查询租户配额 查询是否支持一键重置密码 一键重置裸金属服务器密码 Windows裸金属服务器获取密码 Windows裸金属服务器清除密码 2019-06-24 第九次正式发布。 全文优化，包括补充接口使用场景、补充请求示例、优化参数描述等。 2019-05-30 第八次正式发布。 调整文档结构。 2019-05-07 第七次正式发布。 查询裸金属服务器详情、查询裸金属服务器详情（OpenStack原生）、查询裸金属服务器列表（OpenStack原生）、查询裸金属服务器详情列表（OpenStack原生），目前不支持带微版本号查询，删除相关描述。 2019-03-22 第六次正式发布。 支持细粒度授权功能，新增如下章节： 生命周期管理 状态管理 磁盘管理 2019-01-21 第五次正式发布。 错误码，补充缺失的“Error Message”信息。 2018-11-30 第四次正式发布。 创建裸金属服务器，增加“enhanced_high_speed_net”字段。 2018-10-22 第三次正式发布。 调整接口格式。 修改URI中的“tenant_id”为“project_id”。 2018-08-20 第二次正式发布。 调整文档结构。 2018-07-15 第一次正式发布。

响应参数 参数 参数类型 描述 version Object 描述version对象。 id String 版本ID（版本号），如v1。 links Array of objects API的URL地址。 href String 当前API版本的引用地址。 rel String 当前API版本和被引用地址的关系。 version String 若该版本API支持微版本，则为支持的最大微版本号；如果不支持微版本，则为空。 status String 版本状态，为如下3种： CURRENT：表示该版本为主推版本。 SUPPORTED：表示为老版本，但是现在还继续支持。 DEPRECATED：表示为废弃版本，存在后续删除的可能。 updated String 版本发布时间，要求用UTC时间表示。 例如v1发布的时间为：2014-06-28T12:20:21Z。 min_version String 若该版本API支持微版本，则为支持的最小微版本号；如果不支持微版本，则为空。

响应示例 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 { "version": { "min_version": "", "media-types": [ { "type": "application/vnd.openstack.compute+json;version=2", "base": "application/json" } ], "links": [ { "rel": "self", "href": "https://ecs.service.domain.com:443/v2/" }, { "rel": "describedby", "href": "http://docs.openstack.org/", "type": "text/html" } ], "id": "v2.0", "updated": "1999-02-20T11:33:21Z", "version": "", "status": "SUPPORTED" } }

请求示例 为ID为53206ed0-56de-4d6b-b7ee-ffc62ca26f43的裸金属服务器增加标签baz、foo和qux。 1 PUT https://{E CS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers/53206ed0-56de-4d6b-b7ee-ffc62ca26f43/tags 1 2 3 4 5 6 7 { "tags": [ "baz", "foo", "qux" ] }

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

约束 裸金属服务器状态为“关机”时支持用户盘的卸载且没有操作系统的限制。当裸金属服务器状态为“运行中”时卸载磁盘有如下约束： 对于Linux裸金属服务器，由于操作系统限制，需要客户先登录裸金属服务器，执行unmount命令，取消待卸载磁盘与文件系统之间的关联，并确保没有程序正在对该磁盘进行读写操作。否则，卸载磁盘将失败。 对于Windows裸金属服务器，在线卸载磁盘，请确保没有程序正在对该磁盘进行读写操作。否则，将造成数据丢失。

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

请求示例 一键重置ID为77616c78-0bc4-4156-b24b-4286586ac350的裸金属服务器的密码，新密码为Fusion@123。 1 PUT https://{BMS Endpoint}/v1/2e62dec99940499d93717c2789759015/baremetalservers/77616c78-0bc4-4156-b24b-4286586ac350/os-reset-password 1 2 3 4 5 { "reset-password": { "new_password": "Fusion@123" } }

请求参数 参数 是否必选 参数类型 描述 reset-password 是 Object reset-password信息详情。请参见表2。 表2 reset-password字段结构说明 参数名称 是否必选 参数类型 说明 new_password 是 String 裸金属服务器新密码。 该接口不做密码安全性校验，设置的密码复杂度请遵循密码规则。 密码规则： 密码长度范围为8到26位。 密码至少包含以下4种字符中的3种： 大写字母 小写字母 数字 特殊字符 Windows：!@$%-_=+[]:./? Linux：!@%^-_=+[]{}:,./? 密码不能包含用户名或用户名的逆序。 Windows系统的裸金属服务器，不能包含用户名中超过两个连续字符的部分。

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

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

响应参数 正常响应要素 表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 { "os-start": { "servers": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19" }, { "id": "726fb98f-46ca-475e-917e-2563e5a8cd20" } ] } }

请求参数 启动裸金属服务器请求参数中，必须以“os-start”字段下发启动裸金属服务器请求，请参见下面的请求示例。 参数 是否必选 参数类型 描述 os-start 是 Object 标记为启动裸金属服务器操作，详情请参见表2。 表2 os-start字段数据结构说明 参数 是否必选 参数类型 描述 servers 是 Array of objects 裸金属服务器ID列表，详情请参见表3。 表3 servers字段数据结构说明 参数 是否必选 参数类型 描述 id 是 String 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（OpenStack原生）获取。

请求示例 启动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-start": {} }

响应示例 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 { "server": { "tenant_id": "c685484a8cc2416b97260938705deb65", "addresses": { "vpc_id": [ { "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:0e:c4:77", "OS-EXT-IPS:type": "fixed", "OS-EXT-IPS:port_id": "0c111191-9785-49e6-8b42-66ef2802bd8f", "addr": "192.168.0.107", "version": 4 } ] }, "metadata": { "key": "1311c433dd9b408886f57d695c229cbe" }, "OS-EXT-STS:task_state": null, "OS-DCF:diskConfig": "MANUAL", "OS-EXT-AZ:availability_zone": "az-dc-1", "links": [ { "rel": "self", "href": "https://bms.az0.dc1.domainname.com/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd" }, { "rel": "bookmark", "href": "https://bms.az0.dc1.domainname.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.az-dc-1", "image": { "links": [ { "rel": "bookmark", "href": "https://bms.az0.dc1.domainname.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://bms.az0.dc1.domainname.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" } }

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

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

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

注意事项 该接口可以使用合作伙伴自身的AK/SK或者Token调用，也可以用合作伙伴子客户的AK/SK或者Token来调用。 如果使用AK/SK认证方式，示例代码中的region请参考地区和终端节点中“裸金属服务器 BMS”下“区域”的内容，serviceName（英文服务名称缩写）请指定为BMS。 Endpoint请参考地区和终端节点中“裸金属服务器 BMS”下“终端节点（Endpoint）”的内容。 请保证账户余额充足，此接口无法使用优惠券支付，若余额不足会报“BMS.0216”错误码。若想使用优惠券，请将request请求中的isAutoPay字段设置为false，然后在华为云官网页面使用优惠券进行支付或者调用“查询订单可用优惠券”和“支付包周期产品订单”接口进行支付。

请求示例 创建一个裸金属服务器，镜像ID为766a545a-02e1-433e-b1d1-733b5dc95e94，规格为physical.s3.large，计费模式为包年包月，使用密码方式远程登录。 1 POST https://{BMS Endpoint}/v1/{project_id}/baremetalservers 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 { "server": { "availability_zone": "az1", "name": "bms-75c7", "imageRef": "766a545a-02e1-433e-b1d1-733b5dc95e94", "flavorRef": "physical.s3.large", "data_volumes": [ { "volumetype": "SAS", "size": 10, "shareable": false } ], "vpcid": "8df83bf2-fd2e-4ee0-9692-c0b7736513fb", "nics": [ { "subnet_id": "c6bb8788-4fd1-4a8f-adab-7eba3bed8616", "ip_address": "" } ], "count": 1, "schedulerHints": { "dec_baremetal": "share" }, "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "regionID": "region01" }, "metadata": { "op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81", "BYOL": "false", "admin_pass": "$ADMIN_PASS" }, "publicip": { "id": "1b036bce-26b4-465c-acea-99fdbb0573a3" }, "user_data": "$USER_DATA", "security_groups": [ { "id": "993f2916-5bad-4f24-bc3c-db539f1a6d19" } ] } } 创建一个包年包月的Linux裸金属服务器，可用区为az1，名称为bms-3b91，镜像ID为766a545a-02e1-433e-b1d1-733b5dc95e94规格为physical.o2.large且使用密钥方式远程登录。 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 { "server": { "availability_zone": "az1", "name": "bms-3b91", "imageRef": "766a545a-02e1-433e-b1d1-733b5dc95e94", "flavorRef": "physical.o2.large", "data_volumes": [ { "volumetype": "SAS", "size": 10, "shareable": true } ], "vpcid": "8df83bf2-fd2e-4ee0-9692-c0b7736513fb", "nics": [ { "subnet_id": "c6bb8788-4fd1-4a8f-adab-7eba3bed8616", "ip_address": "" }, { "subnet_id": "2b8bcf33-33f2-4a63-aa9c-b1e17ff0ed7f", "ip_address": "" } ], "count": 1, "schedulerHints": { "dec_baremetal": "share" }, "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "regionID": "region01" }, "metadata": { "op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81", "BYOL": "false" }, "publicip": { "eip": { "iptype": "5_bpg", "bandwidth": { "chargemode": "", "name": "bms-3b91-bandwidth", "size": 1, "sharetype": "PER" }, "extendparam": { "chargingMode": "prePaid" } } }, "security_groups": [ { "id": "993f2916-5bad-4f24-bc3c-db539f1a6d19" } ], "key_name": "$key_name" } } Java 语言生成 user_data示例如下： 1 2 3 String userData_org = "#!/bin/bash \r\n echo 'root:xxxxx' | chpasswd ;"; byte[] userData_byte = userData_org.getBytes(); String userData = new BASE64Encoder().encode(userData_byte); 创建包年包月的Windows操作系统的裸金属服务器，可用区为az1，名称为bms-6a1e，镜像ID为fd04041a-5f35-45ae-a27c-bf30f921c6b5，规格为physical.s3.large且使用密钥方式远程登录。 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 { "server": { "availability_zone": "az1", "name": "bms-6a1e", "imageRef": "fd04041a-5f35-45ae-a27c-bf30f921c6b5", "flavorRef": "physical.s3.large", "data_volumes": [ { "volumetype": "SAS", "size": 10, "shareable": false } ], "vpcid": "0adc2847-c160-4263-be1f-e03d36e93e32", "nics": [ { "subnet_id": "4f1cf6cc-4cc3-41d3-8192-625293dccce0", "ip_address": "" } ], "count": 1, "schedulerHints": { "dec_baremetal": "share" }, "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "regionID": "region1" }, "metadata": { "op_svc_userid": "8a74baed155b47e8b59fbca853d6cb48", "BYOL": "false" }, "publicip": { "id": "db9c4f39-fabd-4cc2-8685-82e7715d099f" }, "user_data": "$USER_DATA", "security_groups": [ { "id": "33cf5e40-0b65-4e03-867d-4c67947c49be" } ], "key_name": "$key_name" } }

背景信息（设置登录鉴权方式） 裸金属服务器的登录鉴权方式包括两种：密钥对、密码。为安全起见，推荐使用密钥对方式。 密钥对 指使用密钥对作为裸金属服务器的鉴权方式。 接口调用方法：使用key_name字段，指定裸金属服务器登录时使用的密钥文件。key_name字段的使用方法请参见表2。 密码 指使用设置初始密码方式作为裸金属服务器的鉴权方式，此时，您可以通过用户名密码方式登录裸金属服务器，Linux操作系统时为root用户的初始密码。 接口调用方法： 方法一（推荐）：使用adminPass字段，指定管理员账号的初始登录密码，adminPass字段的使用方法请参见表2。 此时，对于安装了Cloud-init镜像的Linux裸金属服务器，若指定user_data字段，则该adminPass字段无效。 方法二： 对于镜像已安装Cloud-init的Linux裸金属服务器：使用user_data字段进行注入，具体请参见表2。 公共镜像默认已安装Cloud-init或者Cloudbase-init，私有镜像需要您自行确认是否安装。

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

响应示例 { "remote_console": { "type": "serial", "protocol": "serial", "url": "https://console.domainname.com:443/serial/pod05ironic.region-01/?token=2a794f06-15ec-4f3d-a55b-06aca8e3dcbc" } }

请求参数 参数 是否必选 参数类型 描述 remote_console 是 Object 标记为获取裸金属服务器远程登录地址。详情请参见表2。 表2 remote_console字段数据结构说明 参数 是否必选 参数类型 描述 protocol 是 String 远程登录协议，请将protocol配置为“serial”。 type 是 String 远程登录的类型，请将type配置为“serial”。

请求示例 获取ID为cf2a8b97-b5c6-47ef-9714-eb27adf26e5b的裸金属服务器的远程登录地址，远程登录协议和类型均为serial。 1 POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/remote_console { "remote_console": { "protocol": "serial", "type": "serial" } }

请求示例 强制重启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" } ] } }