调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/baremetalservers/{server_id}
参数 |
是否必选 |
描述 |
---|---|---|
project_id |
是 |
项目ID。 获取方式请参见获取项目ID。 |
server_id |
是 |
裸金属服务器ID。 可以从裸金属服务器控制台查询,或者通过调用查询裸金属服务器列表(OpenStack原生)API获取。 |
请求参数
无
请求示例
|
响应参数
参数 |
参数类型 |
描述 |
---|---|---|
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 |
|
enterprise_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”。 |
响应示例
|
错误码
请参考错误码。