華為云計算 云知識 查詢裸金屬服務(wù)器詳情ListBareMetalServerDetails
查詢裸金屬服務(wù)器詳情ListBareMetalServerDetails

 

功能介紹

獲取 裸金屬服務(wù)器 的詳細信息。

該接口支持查詢裸金屬服務(wù)器的計費方式,以及是否被凍結(jié)。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

GET /v1/{project_id}/baremetalservers/{server_id}

參數(shù)說明請參見表1。

表1 參數(shù)說明

參數(shù)

是否必選

描述

project_id

項目ID。

獲取方式請參見獲取項目ID。

server_id

裸金屬服務(wù)器ID。

可以從裸金屬服務(wù)器控制臺查詢,或者通過調(diào)用查詢裸金屬服務(wù)器列表(OpenStack原生)API獲取。

請求參數(shù)

請求示例

查詢ID為53206ed0-56de-4d6b-b7ee-ffc62ca26f43的裸金屬服務(wù)器詳情。
GET https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/53206ed0-56de-4d6b-b7ee-ffc62ca26f43

響應(yīng)參數(shù)

參數(shù)

參數(shù)類型

描述

server

Object

裸金屬服務(wù)器信息。詳情請參見表2。

表2 server字段數(shù)據(jù)結(jié)構(gòu)說明

參數(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

Map<String,Array of address objects>

裸金屬服務(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)信息。

取值范圍:

  • ACTIVE:運行中/正在關(guān)機/刪除中
  • BUILD:創(chuàng)建中
  • ERROR:故障
  • HARD_REBOOT:強制重啟中
  • REBOOT:重啟中
  • SHUTOFF:關(guān)機/正在開機/刪除中/重建中/重裝操作系統(tǒng)中/重裝操作系統(tǒng)失敗/凍結(jié)

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)。例如:

  • rebooting:重啟中
  • reboot_started:普通重啟
  • reboot_started_hard:強制重啟
  • powering-off:關(guān)機中
  • powering-on:開機中
  • rebuilding:重建中
  • scheduling:調(diào)度中
  • deleting:刪除中

OS-EXT-STS:vm_state

String

擴展屬性,裸金屬服務(wù)器的穩(wěn)定狀態(tài)。例如:

  • active:運行中
  • shutoff:關(guān)機
  • reboot:重啟

OS-EXT-SRV-ATTR:host

String

擴展屬性,裸金屬服務(wù)器宿主機名稱。

OS-EXT-SRV-ATTR:instance_name

String

擴展屬性,裸金屬服務(wù)器別名。

OS-EXT-STS:power_state

Integer

擴展屬性,裸金屬服務(wù)器電源狀態(tài)。例如:

  • 0表示“NO STATE”
  • 1表示“RUNNING”
  • 4表示“SHUTDOWN”

OS-EXT-SRV-ATTR:hypervisor_hostname

String

擴展屬性,裸金屬服務(wù)器所在虛擬化主機名。

OS-EXT-AZ:availability_zone

String

擴展屬性,裸金屬服務(wù)器所在可用區(qū)名稱。

OS-DCF:diskConfig

String

擴展屬性,磁盤配置,取值為以下兩種:

  • MANUAL:API使用鏡像中的分區(qū)方案和文件系統(tǒng)創(chuàng)建裸金屬服務(wù)器。如果目標flavor磁盤較大,則API不會對剩余磁盤空間進行分區(qū)。
  • AUTO:API使用與目標flavor磁盤大小相同的單個分區(qū)創(chuàng)建裸金屬服務(wù)器,API會自動調(diào)整文件系統(tǒng)以適應(yīng)整個分區(qū)。

fault

Object

裸金屬服務(wù)器故障原因。詳情請參見表8。

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)。

  • UP:服務(wù)正常
  • UNKNOWN:狀態(tài)未知
  • DOWN:服務(wù)異常
  • MAINTENANCE:維護狀態(tài)
  • 空字符串:裸金屬服務(wù)器無主機信息

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)。

  • true:鎖定
  • false:未鎖定

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)說明。

表3 address數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

version

String

IP地址版本。

  • 4:代表IPv4。
  • 6:代表IPv6。

addr

String

IP地址。

OS-EXT-IPS:type

String

IP地址類型。

  • fixed:代表私有IP地址。
  • floating:代表彈性IP地址。

OS-EXT-IPS-MAC:mac_addr

String

MAC地址。

OS-EXT-IPS:port_id

String

IP地址對應(yīng)的端口ID。

表4 image數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

id

String

鏡像ID,格式為UUID。

name

String

鏡像的名稱。

__os_type

String

鏡像的類型。

取值為:

  • Linux(包括SUSE/Red Hat/CentOS/Oracle Linux/EulerOS/Ubuntu操作系統(tǒng))
  • Windows(Windows操作系統(tǒng))
  • Other(ESXi操作系統(tǒng))

links

Array of objects

鏡像相關(guān)快捷鏈接地址。詳情請參見表5。

表5 links數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

rel

String

快捷鏈接標記名稱。

href

String

對應(yīng)快捷鏈接。

表6 flavor數(shù)據(jù)結(jié)構(gòu)說明

參數(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。

表7 security_groups數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

name

String

安全組名稱。

id

String

安全組ID。

表8 fault數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

message

String

故障信息。

code

Integer

故障代碼。

details

String

故障詳情。

created

String

故障時間,ISO 8601格式。

表9 os-extended-volumes:volumes_attached數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

id

String

磁盤ID,格式為UUID。

delete_on_termination

String

刪除裸金屬服務(wù)器時是否一并刪除該磁盤。

  • true:是
  • false:否

bootIndex

String

啟動標識,“0”代表啟動盤,“-1“代表非啟動盤。

device

String

磁盤設(shè)備名稱,例如“/dev/sdb”。

表10 os:scheduler_hints數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

dec_baremetal

Array of strings

是否在專屬云中創(chuàng)建裸金屬服務(wù)器,參數(shù)值為share或dedicate。

表11 metadata數(shù)據(jù)結(jié)構(gòu)說明

參數(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

鏡像類型,目前支持:

  • 公共鏡像(gold)
  • 私有鏡像(private)
  • 共享鏡像(shared)

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”。

表12 sys_tags數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

key

String

系統(tǒng)標簽的Key值,當前僅支持“_sys_enterprise_project_id”,表示企業(yè)項目ID。

value

String

系統(tǒng)標簽的value值。

響應(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"
            }
        ]
    }
}

返回值

正常返回值:

返回值

說明

200

服務(wù)器已成功處理了請求。

其他返回值請參考狀態(tài)碼

錯誤碼

請參考錯誤碼。