华为云用户手册

更多操作 创建版本完成后，您还可以执行如下表2所示的操作。 表2 更多操作 操作 说明 编辑版本 说明： 可编辑未发布的版本，不可编辑已发布的版本。 在“版本管理”页面的版本列表中，单击“操作”列的“编辑”。 在“编辑版本”页面，可编辑版本描述、版本类型、产能、版本开始时间和版本发布时间。 单击“提交”。 删除版本 说明： 可删除未发布的版本，不可删除已发布的版本。 删除版本后其名下全部内容将同步被清空，此操作无法恢复，请谨慎操作。 在“版本管理”页面的版本列表中，单击“操作”列的“删除”。 在“删除版本”对话框，根据界面提示在文本框输入“确定删除”，并勾选“我已知悉，强制删除”。 单击“确定”。

更多操作 创建团队完成后，您还可以执行如下表2所示的操作。 表2 更多操作 操作 说明 关注团队 单击“我的团队”区域右上角“关注团队”。 在“关注团队”页面的“团队列表”中，单击需要添加的团队名称右侧的“关注”。 在“我的团队”列表中可查看到此新关注的团队卡片。 设置默认团队 选中“我的团队”区域内团队卡片左下角的“默认团队”，可将此团队设置为默认团队，此默认团队将置顶显示在开发中心团队空间中的团队首位。 移出团队 单击“我的团队”区域内团队卡片右下角的“移出”，可将此团队从我的团队列表移出，我的团队列表中将不显示此团队。移出后通过右上角“添加团队”可再次添加到我的团队。 说明： 团队创建人不可移出自己创建的团队。

操作步骤 在开发中心工作台首页下方的“我的团队”区域，单击右侧“创建团队”。 在“创建团队”页面，设置团队相关参数，参数配置请参见表1。 表1 创建团队参数说明 参数名称 参数说明 团队名称 必填项，团队的命名。 团队归属部门 必填项，选择系统中已提前创建的部门，部门的创建方法请参见部门管理。 关联服务 必填项，选择系统中已提前创建的服务，服务创建方法请参见服务管理。 团队 LOG O 必填项，单击系统默认图片上的“点击修改”，可选择本地图片自定义LOGO图片。 团队简介（可选） 非必填项，团队空间的功能描述或其他备注信息。 单击“创建”。 在“我的团队”区域可查看到创建的团队的卡片。

响应示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 { "versions": [ { "links": [ { "rel": "self", "href": "https://192.168.82.231:443/v2/" } ], "id": "v2.0", "updated": "2018-09-21T12:33:21Z", "status": "SUPPORTED" } ] }

响应参数 参数 参数类型 描述 versions Array of objects 描述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支持微版本，则为支持的最小微版本号；如果不支持微版本，则为空。

请求示例 创建裸金属服务器，其中镜像ID为1a6635d8-afea-4f2b-abb6-27a202bad319，规格为physical.o2.medium，名称为bms_name01，可用区为az-dc-1，网络UUID为8470310b-bfa2-4edf-8f64-d15196b2b2c9。 1 POST https://{E CS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers 1 2 3 4 5 6 7 8 9 10 11 12 13 { "server": { "imageRef": "1a6635d8-afea-4f2b-abb6-27a202bad319", "flavorRef": "physical.o2.medium", "name": "bms_name01", "availability_zone": "az-dc-1", "networks": [ { "uuid": "8470310b-bfa2-4edf-8f64-d15196b2b2c9" } ] } }

响应参数 参数 参数类型 描述 server Object 裸金属服务器信息。详情请参见表6。 表6 server字段数据结构说明 参数 参数类型 描述 security_groups Array of objects 裸金属服务器安全组信息。详情请参见表7。 OS-DCF:diskConfig String 磁盘配置，取值为以下两种： MANUAL：API使用镜像中的分区方案和文件系统创建裸金属服务器。如果目标flavor磁盘较大，则API不会对剩余磁盘空间进行分区。 AUTO：API使用与目标flavor磁盘大小相同的单个分区创建裸金属服务器，API会自动调整文件系统以适应整个分区。 id String 裸金属服务器ID。 links Array of objects 裸金属服务器相关快捷链接信息。详情请参见表8。 adminPass String 裸金属服务器管理员账户初始登录密码。 表7 security_groups字段数据结构说明 参数 参数类型 描述 name String 裸金属服务器对应的安全组名称。 表8 links字段数据结构说明 参数 参数类型 描述 rel String 快捷链接标记名称。取值为： self：包含版本号的资源链接，需要立即跟踪时使用此类链接。 bookmark：提供了适合长期存储的资源链接。 href String 对应快捷链接。

响应示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 { "server": { "security_groups": [ { "name": "default" } ], "OS-DCF:diskConfig": "MANUAL", "links": [ { "rel": "self", "href": "https://openstack.example.com/v2/c685484a8cc2416b97260938705deb65/servers/9ab74d89-61e7-4259-8546-465fdebe4944" }, { "rel": "bookmark", "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/servers/9ab74d89-61e7-4259-8546-465fdebe4944" } ], "id": "9ab74d89-61e7-4259-8546-465fdebe4944", "adminPass": "RjdD3h8U2DBe" } }

约束 本接口不支持批量创建裸金属服务器。 使用支持Cloud-init或Cloudbase-init功能的镜像创建裸金属服务器时，只能使用key_name参数，adminPass参数无效。对于Linux裸金属服务器，如果需要注入密码，只能使用userdata方式进行注入；对于Windows裸金属服务器，如果需要注入密码，只能通过元数据admin_pass进行注入。 使用不支持Cloud-init或Cloudbase-init功能的镜像创建裸金属服务器时，adminPass和key_name参数都无效，请使用镜像内置的密码或证书登录。 不支持文件注入功能。 不支持从系统卷创建裸金属服务器。 网络的三个参数（port、uuid和fixed_ip）中，port优先级最高；指定fixed_ip时必须指明uuid。 创建裸金属服务器后建议对其添加“__type_baremetal”标签，表示其是一台裸金属服务器，否则在Console上裸金属服务器列表中可能查询不到申请的该服务器。 裸金属服务器最多只能指定2个VPC网络，第一个网络会作为裸金属服务器的主网卡网络。

请求参数 参数 是否必选 参数类型 描述 server 是 Object 裸金属服务器信息，详情请参见表2。 表2 server字段数据结构说明 参数 是否必选 参数类型 描述 imageRef 是 String 裸金属服务器使用的镜像ID或者镜像资源的URL。 镜像ID示例：3b8d6fef-af77-42ab-b8b7-5a7f0f0af8f2 镜像URL示例：http://glance.openstack.example.com/images/3b8d6fef-af77-42ab-b8b7-5a7f0f0af8f2 说明： 对于部分规格的裸金属服务器，不能支持云服务平台提供的所有公共镜像。具体规格的镜像支持列表，请登录管理控制台，以“创建裸金属服务器”页面系统自动过滤的镜像信息为准，并在 镜像服务 页面查询镜像ID。 如果创建失败，请尝试修改参数配置。 flavorRef 是 String 裸金属服务器使用的规格ID或URL。 name 是 String 裸金属服务器名称。长度大于0小于256字节。 metadata 否 Object 裸金属服务器元数据，key和value的长度均不大于255字节。详情请参见表3。 user_data 否 String 创建裸金属服务器过程中注入用户数据。 支持注入文本、文本文件或gzip文件。注入内容最大长度32KB。注入内容，需要进行base64格式编码。 adminPass 否 String 裸金属服务器管理员账户初始登录密码。其中，Linux注入无效，Windows管理员账户为Administrator。 密码复杂度要求： 长度为8-26位。 密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%^-_=+[{}]:,./?）中的三种。 密码不能包含用户名或用户名的逆序。 Windows系统密码不能包含用户名或用户名的逆序，不能包含用户名中超过两个连续字符的部分。 注：不输入则会随机生成密码。 特殊字符：!@$%^-_=+[{}]:,./? security_groups 否 Array of objects 指定裸金属服务器的安全组，默认为default，指定network参数时有效，不支持指定多个安全组。详情请参见表4。 networks 是 Array of objects 指定裸金属服务器的网卡信息。详情请参见表5。 最多只能指定4个网络信息，其中2个为vxlan类型的网络，2个为geneve类型的网络。参数中第一个网络信息必须为vxlan类型的网络，其会作为裸金属服务器的主网卡网络。若用户指定了多组网络参数，需保证各组参数都属于同一虚拟私有云。 key_name 否 String 扩展属性，指定keypair的名称。 availability_zone 是 String 裸金属服务器对应可用区信息，不支持指定具体的主机信息。 表3 metadata字段数据结构说明 参数 是否必选 参数类型 描述 用户自定义字段键值对 否 String metadata键、值。 键、值长度均不大于255字节。 表4 security_groups字段数据结构说明 参数 是否必选 参数类型 描述 name 是 String 裸金属服务器对应的安全组名称。 表5 networks字段数据结构说明 参数 是否必选 参数类型 描述 port 否 String 网络Port UUID。 uuid 否 String 网络UUID。 fixed_ip 否 String 指定的IP地址。

响应示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 { "interfaceAttachments": [ { "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" } ] }

响应参数 参数 参数类型 描述 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地址信息。 表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 4 5 { "reboot": { "type": "HARD" } }

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

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

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

创建带数据盘的裸金属服务器 您还可以为裸金属服务器配置数据盘，只需在请求消息体中增加data_volumes字段即可，示例如下： 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 { "server": { "availability_zone": "cn-north-4a", "name": "bms-test03", "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" } ], "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "regionID": "cn-north-4" }, "metadata": { "op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81" }, "key_name": "$key_name" } } volumetype：数据盘的类型，“SAS”表示“高IO”。 size：数据盘大小，容量单位为GB，输入大小范围为[10,32768]。 shareable：是否为共享磁盘。“true”为共享盘，“false”为普通云硬盘。

创建带弹性公网IP的裸金属服务器 您还可以为裸金属服务器配置弹性公网IP，只需在请求消息体中增加publicip字段即可，创建裸金属服务器的时候会同时创建一个弹性公网IP，且弹性公网IP与裸金属服务器绑定在一起。示例如下： 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 { "server": { "availability_zone": "cn-north-4a", "name": "bms-test04", "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" } ], "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "regionID": "cn-north-4" }, "metadata": { "op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81" }, "publicip": { "eip": { "iptype": "5_bgp", "bandwidth": { "chargemode": "bandwidth", "name": "bms-test04-bandwidth", "size": 1, "sharetype": "PER" }, "extendparam": [ "chargingMode": "prePaid" ] } }, "key_name": "$key_name" } } iptype：弹性公网IP地址类型，“5_bgp”表示全动态BGP。 chargemode：带宽的计费类型，取值包括“traffic”（按流量计费）和“bandwidth”（按带宽计费）。 name：带宽名称。 size：带宽大小，单位为Mbit/s，输入大小范围为[1,2000]。 sharetype：带宽的共享类型，“PER”表示独享。 extendparam.chargingMode：弹性公网IP的计费模式，“prePaid”表示预付费，即包年包月。

创建快速发放裸金属服务器 如下示例是创建快速发放裸金属服务器最简单的配置。 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 { "server": { "availability_zone": "cn-north-4a", "name": "bms-test02", "imageRef": "766a545a-02e1-433e-b1d1-733b5dc95e94", "flavorRef": "physical.h2.large", "root_volume": { "volumetype": "SAS", "size": 150 }, "vpcid": "8df83bf2-fd2e-4ee0-9692-c0b7736513fb", "nics": [ { "subnet_id": "c6bb8788-4fd1-4a8f-adab-7eba3bed8616" } ], "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "regionID": "cn-north-4" }, "metadata": { "op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81" }, "key_name": "$key_name" } } 相比创建本地盘裸金属服务器，此场景的不同之处是选择启动源为云硬盘的规格，以及设置系统盘参数。 volumetype：系统盘的类型，“SAS”表示“高IO”，您还可以指定其他类型，具体请参见创建裸金属服务器中的参数解释。 size：系统盘大小，容量单位为GB，输入大小范围为[40,1024]。系统盘大小取值应不小于镜像中系统盘的最小值（min_disk属性），您可以通过查询镜像列表API查询镜像的min_disk参数值。

前提条件 您需要规划裸金属服务器所在的区域信息，并根据区域确定调用API的Endpoint，详细信息请参见终端节点（Endpoint）。 裸金属服务器的启动源分为本地盘和云硬盘，对应的裸金属服务器为本地盘裸金属服务器，和快速发放裸金属服务器。有两种方式查看启动源是本地盘还是云硬盘： 在裸金属服务器控制台选择某一规格后，如果“磁盘”配置项中出现“系统盘”参数，表示该规格的启动盘为云硬盘。反之为本地盘。 调用查询裸金属服务器规格extra_specs参数的详情API，在响应参数中查找“baremetal:extBootType”取值，“LocalDisk”表示启动源为本地盘，“Volume”表示启动源为云硬盘。

创建本地盘裸金属服务器 如下示例是创建本地盘裸金属服务器最简单的配置。 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 { "server": { "availability_zone": "cn-north-4a", "name": "bms-test01", "imageRef": "766a545a-02e1-433e-b1d1-733b5dc95e94", "flavorRef": "physical.s3.large", "vpcid": "8df83bf2-fd2e-4ee0-9692-c0b7736513fb", "nics": [ { "subnet_id": "c6bb8788-4fd1-4a8f-adab-7eba3bed8616" } ], "extendparam": { "chargingMode": "prePaid", "periodType": "month", "periodNum": 1, "isAutoRenew": "true", "isAutoPay": "true", "regionID": "cn-north-4" }, "metadata": { "op_svc_userid": "59781460e9e54886a7d03df7d3f3fc81" }, "key_name": "$key_name" } } availability_zone：服务所在区域的可用区，您可以在地区和终端节点查询。例如，“cn-north-4a”表示“华北-北京四”的“可用区1”。 name：裸金属服务器的名称，由您自定义，例如取名为“bms-test01”。 imageRef：镜像ID，即创建裸金属服务器使用哪个镜像（操作系统）。镜像ID可以在镜像服务控制台查询。 flavorRef：裸金属服务器使用的规格ID，格式为physical.x.x。规格ID可以从裸金属服务器控制台获取，并参考前提条件判断规格的启动源，此处选择启动源为本地盘的规格，例如“physical.s3.large”。 vpcid：裸金属服务器所在VPC（虚拟私有云）的ID，您可以在虚拟私有云控制台查询，也可以通过查询VPC列表API获取。 nics.subnet_id：VPC内子网的网络ID，您可以在虚拟私有云控制台查询，也可以通过查询子网列表API获取。 extendparam：“chargingMode”表示计费模式，“prePaid”为预付费，即包年/包月；“periodType”表示订购周期类型，“month”表示按月；“periodNum”表示订购周期数，本例中的“1”表示一个月；“isAutoRenew”表示是否自动续订；“isAutoPay”表示下单订购后，是否自动从客户的账户中支付，而不需要客户手动去支付；“regionID”表示服务所在的区域ID，您可以在地区和终端节点查询。 metadata.op_svc_userid：用户ID，您可以在我的凭证查询。 key_name：密钥对名称。如果使用SSH密钥方式登录裸金属服务器，需要指定已有密钥的名称。您可以在密钥对控制台查询。

响应示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 { "extra_specs": { "capabilities:cpu_arch": "x86_64", "baremetal:disk_detail": "SAS 8T", "capabilities:hypervisor_type": "ironic", "baremetal:__support_evs": "true", "baremetal:extBootType": "LocalDisk", "capabilities:board_type": "s2m", "baremetal:net_num": "2", "baremetal:netcard_detail": "2*10GE", "baremetal:cpu_detail": "2*8coreIntel Xeon E5-2667 V43.2GHz", "resource_type": "ironic", "baremetal:memory_detail": "256GB DDR4 RAM (GB)" } }

响应参数 参数 参数类型 描述 extra_specs Object 描述裸金属服务器规格的键值对。 capabilities:cpu_arch：裸金属服务器的CPU架构，取值为x86_64（适用于x86机型）或aarch64（适用于ARM机型） baremetal:disk_detail：磁盘的描述信息。 capabilities:hypervisor_type：hypervisor类型，固定为“ironic”。 baremetal:__support_evs：是否支持云硬盘，取值为true或false。如果裸金属服务器规格中没有此参数，表示不支持云硬盘。 baremetal:extBootType：表示裸金属服务器的启动源，取值为LocalDisk（表示本地盘）或Volume（表示云硬盘，即快速发放） baremetal:net_num：裸金属服务器实际可绑定的网卡数量。 baremetal:netcard_detail：网卡的描述信息。 baremetal:cpu_detail：CPU的描述信息。 resource_type：资源类型，固定为“ironic”。 baremetal:memory_detail：内存的描述信息。

请求参数 关闭裸金属服务器请求参数，必须如请求示例中，以“os-stop”字段下发关闭裸金属服务器请求。 参数 是否必选 参数类型 描述 os-stop 是 Object 标记为关闭裸金属服务器操作，详情请参见表2。 表2 os-stop字段数据结构说明 参数 是否必选 参数类型 描述 servers 是 Array of objects 裸金属服务器ID列表，详情请参见表3。 type 否 String 关机类型： SOFT：普通关机（不生效）。 HARD：强制关机（默认）。 表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 任务异常错误信息编码。

请求示例 强制关闭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 { "os-stop": { "type": "HARD", "servers": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19" }, { "id": "726fb98f-46ca-475e-917e-2563e5a8cd20" } ] } }

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

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

请求示例 更新ID为cf2a8b97-b5c6-47ef-9714-eb27adf26e5b的裸金属服务器的元数据，自定义metadata键值对为key和value。 1 POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/metadata 1 2 3 4 5 { "metadata": { "key": "value" } }

约束 使用私有镜像创建的裸金属服务器，请确保已经安装了Cloud-init（Linux镜像）或Cloudbase-init（Windows镜像）。如使用未安装Cloud-init或Cloudbase-init的镜像，该接口不能注入密钥或密码。公共镜像默认已安装Cloud-init或Cloudbase-init。 执行重装操作系统任务时，请勿并行执行其他任务，否则可能会引起重装操作系统失败。 关机状态或者重装操作系统失败的裸金属服务器，才能执行重装操作。 目前Windows镜像不支持注入密码，Linux镜像的user_data为加密后的密码。