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

 

功能介紹

獲取 裸金屬服務器 的詳細信息。

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

調試

您可以在API Explorer中調試該接口。

URI

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

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

表1 參數(shù)說明

參數(shù)

是否必選

描述

project_id

項目ID。

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

server_id

裸金屬服務器ID。

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

請求參數(shù)

請求示例

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

響應參數(shù)

參數(shù)

參數(shù)類型

描述

server

Object

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

表2 server字段數(shù)據(jù)結構說明

參數(shù)

參數(shù)類型

描述

id

String

裸金屬服務器ID,格式為UUID。

user_id

String

創(chuàng)建裸金屬服務器的用戶ID,格式為UUID。

name

String

裸金屬服務器名稱。

created

String

裸金屬服務器創(chuàng)建時間。

時間戳格式為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。

該參數(shù)和project_id表示相同的概念。

hostId

String

裸金屬服務器對應的主機ID。

addresses

Map<String,Array of address objects>

裸金屬服務器所屬網(wǎng)絡信息。

key:表示裸金屬服務器使用的 虛擬私有云 的ID。

value:網(wǎng)絡詳細信息

key_name

String

裸金屬服務器使用的密鑰對名稱。

image

Object

裸金屬服務器 鏡像 信息。詳情請參見表5 image數(shù)據(jù)結構說明。

flavor

Object

裸金屬服務器規(guī)格信息。詳情請參見表6 flavor數(shù)據(jù)結構說明。

security_groups

Array of objects

裸金屬服務器所屬安全組。詳情請參見表7 security_groups數(shù)據(jù)結構說明。

accessIPv4

String

預留屬性。

accessIPv6

String

預留屬性。

status

String

裸金屬服務器當前狀態(tài)信息。

取值范圍:

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

progress

Integer

預留屬性。

config_drive

String

是否為裸金屬服務器配置config drive分區(qū)。

取值為:True或空字符串

metadata

object

裸金屬服務器元數(shù)據(jù)。詳情參見表11 metadata數(shù)據(jù)結構說明。

說明:

元數(shù)據(jù)包含系統(tǒng)默認添加字段和用戶設置的字段。

OS-EXT-STS:task_state

String

擴展屬性,裸金屬服務器當前的任務狀態(tài)。例如:

  • rebooting:重啟中
  • reboot_started:普通重啟
  • reboot_started_hard:強制重啟
  • powering-off:關機中
  • powering-on:開機中
  • rebuilding:重建中
  • scheduling:調度中
  • deleting:刪除中

OS-EXT-STS:vm_state

String

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

  • active:運行中
  • shutoff:關機
  • reboot:重啟

OS-EXT-SRV-ATTR:host

String

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

OS-EXT-SRV-ATTR:instance_name

String

擴展屬性,裸金屬服務器別名。

OS-EXT-STS:power_state

Integer

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

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

OS-EXT-SRV-ATTR:hypervisor_hostname

String

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

OS-EXT-AZ:availability_zone

String

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

OS-DCF:diskConfig

String

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

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

fault

Object

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

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 數(shù)據(jù)結構說明。

description

String

裸金屬服務器的描述信息。

host_status

String

裸金屬服務器宿主機狀態(tài)。

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

OS-EXT-SRV-ATTR:hostname

String

裸金屬服務器的主機名。

OS-EXT-SRV-ATTR:reservation_id

String

批量創(chuàng)建場景,裸金屬服務器的預留ID。

當批量創(chuàng)建裸金屬服務器時,這些服務器將擁有相同的reservation_id。

OS-EXT-SRV-ATTR:launch_index

Integer

批量創(chuàng)建場景,裸金屬服務器的啟動順序。

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

裸金屬服務器系統(tǒng)盤的設備名稱,例如“/dev/sda”。

OS-EXT-SRV-ATTR:user_data

String

創(chuàng)建裸金屬服務器時指定的user_data,取值為base64編碼后的結果或空字符串。

locked

Boolean

裸金屬服務器是否為鎖定狀態(tài)。

  • true:鎖定
  • false:未鎖定

tags

Array of strings

裸金屬服務器標簽。

os:scheduler_hints

Object

裸金屬服務器調度信息。詳情請參見表10 os:scheduler_hints 數(shù)據(jù)結構說明。

enterprise_project_id

String

裸金屬服務器所屬的企業(yè)項目ID。

sys_tags

Array of objects

裸金屬服務器系統(tǒng)標簽。詳情請參見表12 sys_tags數(shù)據(jù)結構說明。

表3 address數(shù)據(jù)結構說明

參數(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地址對應的端口ID。

表4 image數(shù)據(jù)結構說明

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

鏡像相關快捷鏈接地址。詳情請參見表5。

表5 links數(shù)據(jù)結構說明

參數(shù)

參數(shù)類型

描述

rel

String

快捷鏈接標記名稱。

href

String

對應快捷鏈接。

表6 flavor數(shù)據(jù)結構說明

參數(shù)

參數(shù)類型

描述

id

String

裸金屬服務器規(guī)格ID。

name

String

裸金屬服務器規(guī)格名稱。

disk

String

裸金屬服務器規(guī)格對應要求系統(tǒng)盤大小,0為不限制。

vcpus

String

裸金屬服務器規(guī)格對應的CPU核數(shù)。

ram

String

裸金屬服務器規(guī)格對應的內存大小,單位為MB。

表7 security_groups數(shù)據(jù)結構說明

參數(shù)

參數(shù)類型

描述

name

String

安全組名稱。

id

String

安全組ID。

表8 fault數(shù)據(jù)結構說明

參數(shù)

參數(shù)類型

描述

message

String

故障信息。

code

Integer

故障代碼。

details

String

故障詳情。

created

String

故障時間,ISO 8601格式。

表9 os-extended-volumes:volumes_attached數(shù)據(jù)結構說明

參數(shù)

參數(shù)類型

描述

id

String

磁盤ID,格式為UUID。

delete_on_termination

String

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

  • true:是
  • false:否

bootIndex

String

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

device

String

磁盤設備名稱,例如“/dev/sdb”。

表10 os:scheduler_hints數(shù)據(jù)結構說明

參數(shù)

參數(shù)類型

描述

dec_baremetal

Array of strings

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

表11 metadata數(shù)據(jù)結構說明

參數(shù)

參數(shù)類型

描述

chargingMode

String

裸金屬服務器的計費類型。

1:按包年包月計費(即prePaid:預付費方式)。

metering.order_id

String

按“包年/包月”計費的裸金屬服務器對應的訂單ID。

metering.product_id

String

按“包年/包月”計費的裸金屬服務器對應的產品ID。

vpc_id

String

裸金屬服務器所屬的虛擬 私有云 ID。

metering.image_id

String

裸金屬服務器操作系統(tǒng)對應的鏡像ID。

metering.imagetype

String

鏡像類型,目前支持:

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

baremetalPortIDList

String

裸金屬服務器的網(wǎng)卡列表。

metering.resourcespeccode

String

裸金屬服務器對應的資源規(guī)格編碼,格式為:{規(guī)格ID}.{os_type},例如physical.o2.medium.linux。

metering.resourcetype

String

裸金屬服務器對應的資源類型,取值為:__type_baremetal

image_name

String

裸金屬服務器操作系統(tǒng)對應的鏡像名稱。

op_svc_userid

String

用戶ID(登錄管理控制臺,進入我的憑證,即可看到“用戶ID”)。

os_type

String

操作系統(tǒng)類型,取值為:Linux、Windows

__bms_support_evs

String

裸金屬服務器是否支持EVS卷。

os_bit

String

操作系統(tǒng)位數(shù),一般取值為“32”或者“64”。

表12 sys_tags數(shù)據(jù)結構說明

參數(shù)

參數(shù)類型

描述

key

String

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

value

String

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

響應示例

{
    "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

服務器已成功處理了請求。

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

錯誤碼

請參考錯誤碼。