調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
GET /v1/{project_id}/baremetalservers/{server_id}
| 
 參數(shù)  | 
 是否必選  | 
 描述  | 
|---|---|---|
| 
 project_id  | 
 是  | 
 項目ID。 獲取方式請參見獲取項目ID。  | 
| 
 server_id  | 
 是  | 
 裸金屬服務(wù)器ID。 可以從裸金屬服務(wù)器控制臺查詢,或者通過調(diào)用查詢裸金屬服務(wù)器列表(OpenStack原生)API獲取。  | 
請求參數(shù)
無
請求示例
GET https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/53206ed0-56de-4d6b-b7ee-ffc62ca26f43  | 
響應(yīng)參數(shù)
| 
 參數(shù)  | 
 參數(shù)類型  | 
 描述  | 
|---|---|---|
| 
 id  | 
 String  | 
 裸金屬服務(wù)器ID,格式為UUID。  | 
| 
 user_id  | 
 String  | 
 創(chuàng)建裸金屬服務(wù)器的用戶ID,格式為UUID。  | 
| 
 name  | 
 String  | 
 裸金屬服務(wù)器名稱。  | 
| 
 created  | 
 String  | 
 裸金屬服務(wù)器創(chuàng)建時間。 時間戳格式為ISO 8601:YYYY-MM-DDTHH:MM:SSZ,例如:2019-05-22T03:30:52Z  | 
| 
 updated  | 
 String  | 
 裸金屬服務(wù)器更新時間。 時間戳格式為ISO 8601:YYYY-MM-DDTHH:MM:SSZ,例如:2019-05-22T04:30:52Z  | 
| 
 tenant_id  | 
 String  | 
 裸金屬服務(wù)器所屬租戶ID,格式為UUID。 該參數(shù)和project_id表示相同的概念。  | 
| 
 hostId  | 
 String  | 
 裸金屬服務(wù)器對應(yīng)的主機ID。  | 
| 
 addresses  | 
 裸金屬服務(wù)器所屬網(wǎng)絡(luò)信息。 key:表示裸金屬服務(wù)器使用的 虛擬私有云 的ID。 value:網(wǎng)絡(luò)詳細信息  | 
|
| 
 key_name  | 
 String  | 
 裸金屬服務(wù)器使用的密鑰對名稱。  | 
| 
 image  | 
 Object  | 
 裸金屬服務(wù)器 鏡像 信息。詳情請參見表5 image數(shù)據(jù)結(jié)構(gòu)說明。  | 
| 
 flavor  | 
 Object  | 
 裸金屬服務(wù)器規(guī)格信息。詳情請參見表6 flavor數(shù)據(jù)結(jié)構(gòu)說明。  | 
| 
 security_groups  | 
 Array of objects  | 
 裸金屬服務(wù)器所屬安全組。詳情請參見表7 security_groups數(shù)據(jù)結(jié)構(gòu)說明。  | 
| 
 accessIPv4  | 
 String  | 
 預(yù)留屬性。  | 
| 
 accessIPv6  | 
 String  | 
 預(yù)留屬性。  | 
| 
 status  | 
 String  | 
 裸金屬服務(wù)器當前狀態(tài)信息。 取值范圍: 
  | 
| 
 progress  | 
 Integer  | 
 預(yù)留屬性。  | 
| 
 config_drive  | 
 String  | 
 是否為裸金屬服務(wù)器配置config drive分區(qū)。 取值為:True或空字符串  | 
| 
 metadata  | 
 object  | 
 裸金屬服務(wù)器元數(shù)據(jù)。詳情參見表11 metadata數(shù)據(jù)結(jié)構(gòu)說明。 說明:
 
元數(shù)據(jù)包含系統(tǒng)默認添加字段和用戶設(shè)置的字段。  | 
| 
 OS-EXT-STS:task_state  | 
 String  | 
 擴展屬性,裸金屬服務(wù)器當前的任務(wù)狀態(tài)。例如: 
  | 
| 
 OS-EXT-STS:vm_state  | 
 String  | 
 擴展屬性,裸金屬服務(wù)器的穩(wěn)定狀態(tài)。例如: 
  | 
| 
 OS-EXT-SRV-ATTR:host  | 
 String  | 
 擴展屬性,裸金屬服務(wù)器宿主機名稱。  | 
| 
 OS-EXT-SRV-ATTR:instance_name  | 
 String  | 
 擴展屬性,裸金屬服務(wù)器別名。  | 
| 
 OS-EXT-STS:power_state  | 
 Integer  | 
 擴展屬性,裸金屬服務(wù)器電源狀態(tài)。例如: 
  | 
| 
 OS-EXT-SRV-ATTR:hypervisor_hostname  | 
 String  | 
 擴展屬性,裸金屬服務(wù)器所在虛擬化主機名。  | 
| 
 OS-EXT-AZ:availability_zone  | 
 String  | 
 擴展屬性,裸金屬服務(wù)器所在可用區(qū)名稱。  | 
| 
 OS-DCF:diskConfig  | 
 String  | 
 擴展屬性,磁盤配置,取值為以下兩種: 
  | 
| 
 fault  | 
 Object  | 
|
| 
 OS-SRV-USG:launched_at  | 
 String  | 
 裸金屬服務(wù)器啟動時間。 時間戳格式為ISO 8601,例如:2019-05-22T03:23:59.000000  | 
| 
 OS-SRV-USG:terminated_at  | 
 String  | 
 裸金屬服務(wù)器刪除時間。 時間戳格式為ISO 8601,例如:2019-05-22T04:23:59.000000  | 
| 
 os-extended-volumes:volumes_attached  | 
 Array of objects  | 
 掛載到裸金屬服務(wù)器上的磁盤。詳情請參見表9 os-extended-volumes:volumes_attached 數(shù)據(jù)結(jié)構(gòu)說明。  | 
| 
 description  | 
 String  | 
 裸金屬服務(wù)器的描述信息。  | 
| 
 host_status  | 
 String  | 
 裸金屬服務(wù)器宿主機狀態(tài)。 
  | 
| 
 OS-EXT-SRV-ATTR:hostname  | 
 String  | 
 裸金屬服務(wù)器的主機名。  | 
| 
 OS-EXT-SRV-ATTR:reservation_id  | 
 String  | 
 批量創(chuàng)建場景,裸金屬服務(wù)器的預(yù)留ID。 當批量創(chuàng)建裸金屬服務(wù)器時,這些服務(wù)器將擁有相同的reservation_id。  | 
| 
 OS-EXT-SRV-ATTR:launch_index  | 
 Integer  | 
 批量創(chuàng)建場景,裸金屬服務(wù)器的啟動順序。  | 
| 
 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  | 
 裸金屬服務(wù)器系統(tǒng)盤的設(shè)備名稱,例如“/dev/sda”。  | 
| 
 OS-EXT-SRV-ATTR:user_data  | 
 String  | 
 創(chuàng)建裸金屬服務(wù)器時指定的user_data,取值為base64編碼后的結(jié)果或空字符串。  | 
| 
 locked  | 
 Boolean  | 
 裸金屬服務(wù)器是否為鎖定狀態(tài)。 
  | 
| 
 tags  | 
 Array of strings  | 
 裸金屬服務(wù)器標簽。  | 
| 
 os:scheduler_hints  | 
 Object  | 
 裸金屬服務(wù)器調(diào)度信息。詳情請參見表10 os:scheduler_hints 數(shù)據(jù)結(jié)構(gòu)說明。  | 
| 
 enterprise_project_id  | 
 String  | 
 裸金屬服務(wù)器所屬的企業(yè)項目ID。  | 
| 
 sys_tags  | 
 Array of objects  | 
 裸金屬服務(wù)器系統(tǒng)標簽。詳情請參見表12 sys_tags數(shù)據(jù)結(jié)構(gòu)說明。  | 
| 
 參數(shù)  | 
 參數(shù)類型  | 
 描述  | 
|---|---|---|
| 
 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地址對應(yīng)的端口ID。  | 
| 
 參數(shù)  | 
 參數(shù)類型  | 
 描述  | 
|---|---|---|
| 
 id  | 
 String  | 
 鏡像ID,格式為UUID。  | 
| 
 name  | 
 String  | 
 鏡像的名稱。  | 
| 
 __os_type  | 
 String  | 
 鏡像的類型。 取值為: 
  | 
| 
 links  | 
 Array of objects  | 
| 
 參數(shù)  | 
 參數(shù)類型  | 
 描述  | 
|---|---|---|
| 
 rel  | 
 String  | 
 快捷鏈接標記名稱。  | 
| 
 href  | 
 String  | 
 對應(yīng)快捷鏈接。  | 
| 
 參數(shù)  | 
 參數(shù)類型  | 
 描述  | 
|---|---|---|
| 
 id  | 
 String  | 
 裸金屬服務(wù)器規(guī)格ID。  | 
| 
 name  | 
 String  | 
 裸金屬服務(wù)器規(guī)格名稱。  | 
| 
 disk  | 
 String  | 
 該裸金屬服務(wù)器規(guī)格對應(yīng)要求系統(tǒng)盤大小,0為不限制。  | 
| 
 vcpus  | 
 String  | 
 該裸金屬服務(wù)器規(guī)格對應(yīng)的CPU核數(shù)。  | 
| 
 ram  | 
 String  | 
 該裸金屬服務(wù)器規(guī)格對應(yīng)的內(nèi)存大小,單位為MB。  | 
| 
 參數(shù)  | 
 參數(shù)類型  | 
 描述  | 
|---|---|---|
| 
 name  | 
 String  | 
 安全組名稱。  | 
| 
 id  | 
 String  | 
 安全組ID。  | 
| 
 參數(shù)  | 
 參數(shù)類型  | 
 描述  | 
|---|---|---|
| 
 message  | 
 String  | 
 故障信息。  | 
| 
 code  | 
 Integer  | 
 故障代碼。  | 
| 
 details  | 
 String  | 
 故障詳情。  | 
| 
 created  | 
 String  | 
 故障時間,ISO 8601格式。  | 
| 
 參數(shù)  | 
 參數(shù)類型  | 
 描述  | 
|---|---|---|
| 
 id  | 
 String  | 
 磁盤ID,格式為UUID。  | 
| 
 delete_on_termination  | 
 String  | 
 刪除裸金屬服務(wù)器時是否一并刪除該磁盤。 
  | 
| 
 bootIndex  | 
 String  | 
 啟動標識,“0”代表啟動盤,“-1“代表非啟動盤。  | 
| 
 device  | 
 String  | 
 磁盤設(shè)備名稱,例如“/dev/sdb”。  | 
| 
 參數(shù)  | 
 參數(shù)類型  | 
 描述  | 
|---|---|---|
| 
 dec_baremetal  | 
 Array of strings  | 
 是否在專屬云中創(chuàng)建裸金屬服務(wù)器,參數(shù)值為share或dedicate。  | 
| 
 參數(shù)  | 
 參數(shù)類型  | 
 描述  | 
|---|---|---|
| 
 chargingMode  | 
 String  | 
 裸金屬服務(wù)器的計費類型。 1:按包年包月計費(即prePaid:預(yù)付費方式)。  | 
| 
 metering.order_id  | 
 String  | 
 按“包年/包月”計費的裸金屬服務(wù)器對應(yīng)的訂單ID。  | 
| 
 metering.product_id  | 
 String  | 
 按“包年/包月”計費的裸金屬服務(wù)器對應(yīng)的產(chǎn)品ID。  | 
| 
 vpc_id  | 
 String  | 
 裸金屬服務(wù)器所屬的虛擬 私有云 ID。  | 
| 
 metering.image_id  | 
 String  | 
 裸金屬服務(wù)器操作系統(tǒng)對應(yīng)的鏡像ID。  | 
| 
 metering.imagetype  | 
 String  | 
 鏡像類型,目前支持: 
  | 
| 
 baremetalPortIDList  | 
 String  | 
 裸金屬服務(wù)器的網(wǎng)卡列表。  | 
| 
 metering.resourcespeccode  | 
 String  | 
 裸金屬服務(wù)器對應(yīng)的資源規(guī)格編碼,格式為:{規(guī)格ID}.{os_type},例如physical.o2.medium.linux。  | 
| 
 metering.resourcetype  | 
 String  | 
 裸金屬服務(wù)器對應(yīng)的資源類型,取值為:__type_baremetal  | 
| 
 image_name  | 
 String  | 
 裸金屬服務(wù)器操作系統(tǒng)對應(yīng)的鏡像名稱。  | 
| 
 op_svc_userid  | 
 String  | 
 用戶ID(登錄管理控制臺,進入我的憑證,即可看到“用戶ID”)。  | 
| 
 os_type  | 
 String  | 
 操作系統(tǒng)類型,取值為:Linux、Windows  | 
| 
 __bms_support_evs  | 
 String  | 
 裸金屬服務(wù)器是否支持EVS卷。  | 
| 
 os_bit  | 
 String  | 
 操作系統(tǒng)位數(shù),一般取值為“32”或者“64”。  | 
響應(yīng)示例
{ "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" } ] } }  | 
錯誤碼
請參考錯誤碼。
  
    