调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/baremetalservers/{server_id}
参数 |
是否必选 |
描述 |
---|---|---|
project_id |
是 |
项目ID。 获取方式请参见获取项目ID。 |
server_id |
是 |
裸金属服务器ID。 可以从裸金属服务器控制台查询,或者通过调用查询裸金属服务器列表(OpenStack原生)API获取。 |
请求参数
无
请求示例
GET https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/53206ed0-56de-4d6b-b7ee-ffc62ca26f43 |
响应参数
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
裸金属服务器ID,格式为UUID。 |
user_id |
String |
创建裸金属服务器的用户ID,格式为UUID。 |
name |
String |
裸金属服务器名称。 |
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 |
tenant_id |
String |
裸金属服务器所属租户ID,格式为UUID。 该参数和project_id表示相同的概念。 |
hostId |
String |
裸金属服务器对应的主机ID。 |
addresses |
裸金属服务器所属网络信息。 key:表示裸金属服务器使用的 虚拟私有云 的ID。 value:网络详细信息 |
|
key_name |
String |
裸金属服务器使用的密钥对名称。 |
image |
Object |
裸金属服务器 镜像 信息。详情请参见表5 image数据结构说明。 |
flavor |
Object |
|
security_groups |
Array of objects |
|
accessIPv4 |
String |
预留属性。 |
accessIPv6 |
String |
预留属性。 |
status |
String |
裸金属服务器当前状态信息。 取值范围:
|
progress |
Integer |
预留属性。 |
config_drive |
String |
是否为裸金属服务器配置config drive分区。 取值为:True或空字符串 |
metadata |
object |
裸金属服务器元数据。详情参见表11 metadata数据结构说明。 说明:
元数据包含系统默认添加字段和用户设置的字段。 |
OS-EXT-STS:task_state |
String |
扩展属性,裸金属服务器当前的任务状态。例如:
|
OS-EXT-STS:vm_state |
String |
扩展属性,裸金属服务器的稳定状态。例如:
|
OS-EXT-SRV-ATTR:host |
String |
扩展属性,裸金属服务器宿主机名称。 |
OS-EXT-SRV-ATTR:instance_name |
String |
扩展属性,裸金属服务器别名。 |
OS-EXT-STS:power_state |
Integer |
扩展属性,裸金属服务器电源状态。例如:
|
OS-EXT-SRV-ATTR:hypervisor_hostname |
String |
扩展属性,裸金属服务器所在 虚拟化 主机名。 |
OS-EXT-AZ:availability_zone |
String |
扩展属性,裸金属服务器所在可用区名称。 |
OS-DCF:diskConfig |
String |
扩展属性,磁盘配置,取值为以下两种:
|
fault |
Object |
|
OS-SRV-USG:launched_at |
String |
裸金属服务器启动时间。 时间戳格式为ISO 8601,例如:2019-05-22T03:23:59.000000 |
OS-SRV-USG:terminated_at |
String |
裸金属服务器删除时间。 时间戳格式为ISO 8601,例如:2019-05-22T04:23:59.000000 |
os-extended-volumes:volumes_attached |
Array of objects |
挂载到裸金属服务器上的磁盘。详情请参见表9 os-extended-volumes:volumes_attached 数据结构说明。 |
description |
String |
裸金属服务器的描述信息。 |
host_status |
String |
裸金属服务器宿主机状态。
|
OS-EXT-SRV-ATTR:hostname |
String |
裸金属服务器的主机名。 |
OS-EXT-SRV-ATTR:reservation_id |
String |
批量创建场景,裸金属服务器的预留ID。 当批量创建裸金属服务器时,这些服务器将拥有相同的reservation_id。 |
OS-EXT-SRV-ATTR:launch_index |
Integer |
批量创建场景,裸金属服务器的启动顺序。 |
OS-EXT-SRV-ATTR:kernel_id |
String |
若使用AMI格式的镜像,则表示kernel image的UUID;否则,留空。 |
OS-EXT-SRV-ATTR:ramdisk_id |
String |
若使用AMI格式镜像,则表示ramdisk image的UUID;否则,留空。 |
OS-EXT-SRV-ATTR:root_device_name |
String |
裸金属服务器系统盘的设备名称,例如“/dev/sda”。 |
OS-EXT-SRV-ATTR:user_data |
String |
创建裸金属服务器时指定的user_data,取值为base64编码后的结果或空字符串。 |
locked |
Boolean |
裸金属服务器是否为锁定状态。
|
tags |
Array of strings |
裸金属服务器标签。 |
os:scheduler_hints |
Object |
|
ent erp rise_project_id |
String |
裸金属服务器所属的企业项目ID。 |
sys_tags |
Array of objects |
参数 |
参数类型 |
描述 |
---|---|---|
version |
String |
IP地址版本。
|
addr |
String |
IP地址。 |
OS-EXT-IPS:type |
String |
IP地址类型。
|
OS-EXT-IPS-MAC:mac_addr |
String |
MAC地址。 |
OS-EXT-IPS:port_id |
String |
IP地址对应的端口ID。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
镜像ID,格式为UUID。 |
name |
String |
镜像的名称。 |
__os_type |
String |
镜像的类型。 取值为:
|
links |
Array of objects |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
裸金属服务器规格ID。 |
name |
String |
裸金属服务器规格名称。 |
disk |
String |
该裸金属服务器规格对应要求系统盘大小,0为不限制。 |
vcpus |
String |
该裸金属服务器规格对应的CPU核数。 |
ram |
String |
该裸金属服务器规格对应的内存大小,单位为MB。 |
参数 |
参数类型 |
描述 |
---|---|---|
message |
String |
故障信息。 |
code |
Integer |
故障代码。 |
details |
String |
故障详情。 |
created |
String |
故障时间,ISO 8601格式。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
磁盘ID,格式为UUID。 |
delete_on_termination |
String |
删除裸金属服务器时是否一并删除该磁盘。
|
bootIndex |
String |
启动标识,“0”代表启动盘,“-1“代表非启动盘。 |
device |
String |
磁盘设备名称,例如“/dev/sdb”。 |
参数 |
参数类型 |
描述 |
---|---|---|
dec_baremetal |
Array of strings |
是否在专属云中创建裸金属服务器,参数值为share或dedicate。 |
参数 |
参数类型 |
描述 |
---|---|---|
chargingMode |
String |
裸金属服务器的计费类型。 1:按包年包月计费(即prePaid:预付费方式)。 |
metering.order_id |
String |
按“包年/包月”计费的裸金属服务器对应的订单ID。 |
metering.product_id |
String |
按“包年/包月”计费的裸金属服务器对应的产品ID。 |
vpc_id |
String |
裸金属服务器所属的虚拟 私有云 ID。 |
metering.image_id |
String |
裸金属服务器操作系统对应的镜像ID。 |
metering.imagetype |
String |
镜像类型,目前支持:
|
baremetalPortIDList |
String |
裸金属服务器的网卡列表。 |
metering.resourcespeccode |
String |
裸金属服务器对应的资源规格编码,格式为:{规格ID}.{os_type},例如physical.o2.medium.linux。 |
metering.resourcetype |
String |
裸金属服务器对应的资源类型,取值为:__type_baremetal |
image_name |
String |
裸金属服务器操作系统对应的镜像名称。 |
op_svc_userid |
String |
用户ID(登录管理控制台,进入我的凭证,即可看到“用户ID”)。 |
os_type |
String |
操作系统类型,取值为:Linux、Windows |
__bms_support_evs |
String |
裸金属服务器是否支持EVS卷。 |
os_bit |
String |
操作系统位数,一般取值为“32”或者“64”。 |
响应示例
{ "server": { "id": "53206ed0-56de-4d6b-b7ee-ffc62ca26f43", "name": "bms-test", "addresses": { "5849fdf1-9d79-4589-80c2-fe557990c417": [ { "version": "4", "addr": "192.168.1.216", "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:25:56:c3", "OS-EXT-IPS:port_id": "9e62503b-094e-4c6e-bc95-f10bbfb455d5", "OS-EXT-IPS:type": "fixed" }, { "version": "4", "addr": "10.154.72.77", "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:25:56:c3", "OS-EXT-IPS:port_id": "9e62503b-094e-4c6e-bc95-f10bbfb455d5", "OS-EXT-IPS:type": "floating" } ] }, "flavor": { "disk": "9309", "vcpus": "32", "ram": "193047", "id": "physical.o2.medium", "name": "physical.o2.medium" }, "accessIPv4": "", "accessIPv6": "", "status": "ACTIVE", "progress": 0, "hostId": "cd243addb5d2c64e89218180b7a3ed95abe6882e81c337cc563137df", "updated": "2018-09-18T09:29:44Z", "created": "2018-09-18T02:43:26Z", "metadata": { "metering.order_id": "CS1809181040HCFC2", "metering.image_id": "8589958c-6bc7-40c6-b81b-3fe4cd2e3d85", "baremetalPortIDList": "[9e62503b-094e-4c6e-bc95-f10bbfb455d5]", "metering.resourcespeccode": "physical.o2.medium.linux", "image_name": "redhat_7_2", "op_svc_userid": "745973c535ec4d4caba86f6f9419ff6d", "metering.resourcetype": "__type_baremetal", "metering.product_id": "00301-74069-0--0", "os_bit": "64", "vpc_id": "5849fdf1-9d79-4589-80c2-fe557990c417", "os_type": "Linux", "chargingMode": "1" }, "tags": [ "__type_baremetal" ], "description": "bms-6e18", "locked": false, "image": { "id": "8589958c-6bc7-40c6-b81b-3fe4cd2e3d85" }, "config_drive": "", "tenant_id": "bbf1946d374b44a0a2a95533562ba954", "user_id": "3fc5ab2b0c544979abcaafd86edd80e6", "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-00154f94", "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/sda", "OS-EXT-SRV-ATTR:ramdisk_id": "", "enterprise_project_id": "2c7b6d77-9013-4d74-a221-2f612fc56372", "OS-EXT-SRV-ATTR:user_data": "", "OS-SRV-USG:launched_at": "2018-09-18T02:46:07.954587", "OS-EXT-SRV-ATTR:kernel_id": "", "OS-EXT-SRV-ATTR:launch_index": 0, "host_status": "UP", "OS-EXT-SRV-ATTR:reservation_id": "r-08tuyo8v", "OS-EXT-SRV-ATTR:hostname": "bms-6e18", "sys_tags": [ { "key": "_sys_enterprise_project_id", "value": "2c7b6d77-9013-4d74-a221-2f612fc56372" } ] } } |
错误码
请参考错误码。