华为云用户手册

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”标签，否则，裸金属服务器将仅在E CS 控制台可见，而不在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，私有镜像需要您自行确认是否安装。

请求示例 获取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" } }

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为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。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（OpenStack原生）获取。

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

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

请求参数 参数 是否必选 参数类型 描述 nics 是 Array of objects 需要绑定的网卡参数列表，详情请参见表2。 约束： 当前不支持10个网卡以上的并发挂载。10个以上并发挂载时，挂载可能失败。 表2 nics字段数据结构说明 参数 是否必选 参数类型 描述 subnet_id 是 String 网卡的子网ID。 网络（network）的ID可以从控制台或者参考《虚拟私有云API参考》的“查询子网列表”章节获取，UUID格式。 约束： 指定subnet_id绑定网卡时，网卡带宽下限默认值是quota:min_rate。 指定subnet_id绑定网卡时，队列个数默认值是quota:vif_multiqueue_num。 quota:min_rate和quota:vif_multiqueue_num可参见查询裸金属服务器规格extra_specs参数的详情（OpenStack原生）查询。 security_groups 否 Array of objects 网卡的安全组信息，详情请参见表3。 约束： 仅在指定subnet_id时生效，当使用subnet_id跨租户挂网卡时，此字段必填。 ip_address 否 String IP地址。无该参数表示自动分配IP地址。 约束： 仅在指定subnet_id时生效。 表3 security_groups字段数据结构说明 参数 是否必选 参数类型 描述 id 是 String 安全组ID。

请求示例 绑定网卡，其中网卡的子网ID为d32019d3-bc6e-4319-9c1d-6722fc136a23，安全组ID为f0ac4394-7e4a-4409-9701-ba8be283dbc3。 { "nics": [ { "subnet_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23", "security_groups": [ { "id": "f0ac4394-7e4a-4409-9701-ba8be283dbc3" } ] } ] }

BMS接口使用限制 表2 BMS接口使用限制 类型 API URI 使用限制 查询API版本信息 查询API版本信息列表 GET / 每分钟2000次 查询指定API版本信息 GET /{api_version} 每分钟2000次 生命周期管理 创建裸金属服务器 POST /v1/{project_id}/baremetalservers 每分钟50次 查询裸金属服务器详情 GET /v1/{project_id}/baremetalservers/detail 每分钟500次 查询裸金属服务器详情列表 GET /v1/{project_id}/baremetalservers/{server_id} 每分钟1000次 状态管理 修改裸金属服务器名称 PUT /v1/{project_id}/baremetalservers/{server_id} 每分钟100次 重装裸金属服务器操作系统 POST /v1/{project_id}/baremetalservers/{server_id}/reinstallos 每分钟50次 启动裸金属服务器 POST /v1/{project_id}/baremetalservers/action 每分钟50次 重启裸金属服务器 POST /v1/{project_id}/baremetalservers/action 每分钟50次 关闭裸金属服务器 POST /v1/{project_id}/baremetalservers/action 每分钟50次 规格管理 查询规格详情和规格扩展信息列表 GET /v1/{project_id}/baremetalservers/flavors 每分钟500次 网卡管理 查询裸金属服务器网卡信息 GET /v1/{project_id}/baremetalservers/{server_id}/os-interface 每分钟500次 云硬盘管理 裸金属服务器挂载云硬盘 POST /v1/{project_id}/baremetalservers/{server_id}/attachvolume 每分钟100次 裸金属服务器卸载云硬盘 DELETE /v1/{project_id}/baremetalservers/{server_id}/detachvolume/{attachment_id} 每分钟100次 查询裸金属服务器挂载的磁盘信息 GET /v1/{project_id}/baremetalservers/{server_id}/os-volume_attachments 每分钟500次 元数据管理 更新裸金属服务器元数据 POST /v1/{project_id}/baremetalservers/{server_id}/metadata 每分钟100次 租户配额管理 查询租户配额 GET /v1/{project_id}/baremetalservers/limits 每分钟500次 密码管理 查询是否支持一键重置密码 GET /v1/{project_id}/baremetalservers/{server_id}/os-resetpwd-flag 每分钟500次 一键重置裸金属服务器密码 PUT /v1/{project_id}/baremetalservers/{server_id}/os-reset-password 每分钟50次 Windows裸金属服务器获取密码 GET /v1/{project_id}/baremetalservers/{server_id}/os-server-password 每分钟50次 Windows裸金属服务器清除密码 DELETE /v1/{project_id}/baremetalservers/{server_id}/os-server-password 每分钟50次 Job管理 查询Job状态 GET /v1/{project_id}/jobs/{jobId} 每分钟2000次

接口介绍 裸金属服务器所提供的接口分为BMS接口与OpenStack原生接口。 通过配合使用BMS服务提供的接口和OpenStack原生接口，您可以完整地使用裸金属服务器的所有功能。例如创建裸金属服务器实例，可以使用OpenStack原生接口，也可以使用BMS接口进行创建。 表1 接口说明 类型 子类型 说明 BMS接口 查询API版本信息 查询裸金属服务器服务当前所用的API版本。 生命周期管理 可以实现包周期裸金属服务器的创建、裸金属服务器详情查询等操作。 状态管理 裸金属服务器修改名称、重装系统、启动、重启、关闭等功能。 规格管理 用于查询裸金属服务器的规格详情和规格扩展信息，比如规格ID、规格名称、CPU核数、启动源。 网卡管理 可以查询裸金属服务器网卡信息，比如网卡的IP地址、MAC地址。 云硬盘管理 裸金属服务器云硬盘挂载、卸载，以及挂载的磁盘信息查询。 元数据管理 裸金属服务器元数据包含了裸金属服务器在云平台的基本信息，例如服务器ID、主机名、网络信息等。您可以更新裸金属服务器的元数据。 租户配额管理 查询某租户名下，所有资源的配额信息，包括已使用配额。 密码管理 查询是否支持一键重置密码，如果支持，您可以对裸金属服务器重置密码。还包括Windows裸金属服务器的密码获取与清除。 查询Job状态 对于创建裸金属服务器、挂卸卷等异步API，命令下发后，会返回“job_id”，通过“job_id”可以查询任务的执行状态。 OpenStack原生接口（v2.1版本） 生命周期管理 查询类接口，包括查询裸金属服务器详情、查询裸金属服务器列表、查询裸金属服务器详情信息列表。 状态管理 状态管理接口，包括对裸金属服务器的启动、重启、关闭等接口。 元数据管理 裸金属服务器元数据包含了裸金属服务器在云平台的基本信息，例如服务器ID、主机名、网络信息等。您可以查询、更新、删除裸金属服务器的元数据。 IP信息查询 查询裸金属服务器的私有IP地址信息，包括IP地址版本（IPv4或者IPv6）和具体的IP地址。 裸金属服务器规格查询 查询裸金属服务器规格信息列表：查询系统中的所有规格，或者指定过滤条件检索需要的规格。 查询裸金属服务器规格详情：根据裸金属服务器的规格ID，查询规格的详细信息，比如规格名称、CPU核数、内存大小等。 查询裸金属服务器规格extra_specs参数的详情：“extra_specs”参数用于描述裸金属服务器规格的键值对，如果您想确认某个规格是否支持快速发放，可以调用该接口进行查询。 裸金属服务器网卡查询 您可以查询裸金属服务器的所有网卡；或者根据网卡ID，查询某一个网卡的详细信息，比如网卡的IP地址、MAC地址。 云硬盘管理 您可以查询裸金属服务器所挂载的云硬盘信息；或者根据磁盘ID，查询裸金属服务器挂载的某个云硬盘信息，比如挂载目录。 SSH密钥管理 查询SSH密钥信息列表、详情，创建、删除SSH密钥等功能。 一维标签管理 裸金属服务器一维标签的增删改查。 使用BMS提供的接口时，您需要使用BMS服务自身的Endpoint。 使用OpenStack原生接口时，您需要使用ECS服务注册的Endpoint。 当前版本调用OpenStack接口不支持HTTP长连接。

响应示例 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。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（OpenStack原生）获取。 id 是 网卡ID。 可以在裸金属服务器详情页面“网卡”页签中查看；也可以通过查询裸金属服务器网卡信息（OpenStack原生）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": {} }

响应示例 { "flavors": [ { "name": "physical.o2.medium", "links": [ { "href": "https://openstack.example.com/v2/c685484a8cc2416b97260938705deb65/flavors/physical.o2.medium", "rel": "self" }, { "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/flavors/physical.o2.medium", "rel": "bookmark" } ], "ram": 321725, "OS-FLV-DISABLED:disabled": false, "vcpus": 56, "swap": "", "os-flavor-access:is_public": true, "rxtx_factor": 1, "OS-FLV-EXT-DATA:ephemeral": 0, "disk": 3725, "id": "physical.o2.medium" } ] }

响应参数 参数 参数类型 描述 flavors Array of objects 裸金属服务器规格列表。详情请参见表3。 表3 flavors数据结构说明 参数 参数类型 描述 id String 裸金属服务器规格ID。 name String 裸金属服务器规格名称。 vcpus Integer 该裸金属服务器规格对应的CPU核数。 ram Integer 该裸金属服务器规格对应的内存大小，单位为MB。 disk Integer 该裸金属服务器规格对应要求的磁盘大小，单位为GB。 swap String 未使用。 OS-FLV-EXT-DATA:ephemeral Integer 未使用。 OS-FLV-DISABLED:disabled Boolean 未使用。 rxtx_factor Float 未使用。 os-flavor-access:is_public Boolean 未使用。 links Array of objects 规格相关快捷链接地址。详情请参见表4。 表4 links字段数据结构说明 参数 参数类型 描述 rel String 快捷链接标记名称。 self：包含版本号的资源链接，需要立即跟踪时使用此类链接。 bookmark：提供了适合长期存储的资源链接。 href String 对应快捷链接。

请求参数 查询裸金属服务器规格时可选的查询检索参数如表2所示。 表2 可选的查询检索参数 参数 是否必选 参数类型 描述 minDisk 否 String 最小的硬盘规格，单位GB，大于等于此规格的都可以查询到。 minRam 否 String 最小的内存规格，单位MB，大于等于此规格的都可以查询到。 sort_key 否 String 排序字段，默认值为：flavorid。可以指定的其他key为name/ memory_mb/vcpus，/root_gb/flavorid。 sort_dir 否 String 升序/降序排序。 可以指定的参数为asc/desc，默认值为：asc

请求示例 查询规格信息列表。 1 GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/flavors/detail 查询规格信息列表且最小的磁盘规格为3725GB。 1 GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/flavors/detail?minDisk=3725

响应示例 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 { "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": { "op_svc_userid": "1311c433dd9b408886f57d695c229cbe" }, "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 Object 裸金属服务器对应的网络地址信息。详情请参见表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 addresses字段数据结构说明 参数 参数类型 描述 vpc_id Array of objects 裸金属服务器所属网络信息。 key：表示裸金属服务器使用的虚拟私有云的ID。 value：网络详细信息，具体请参见表10。 表10 address字段数据结构说明 参数 参数类型 描述 addr String IP地址。 version String 地址对应的版本。