Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Actualización más reciente 2023-03-20 GMT+08:00

Consulta de detalles sobre los BMS

Función

Esta API se utiliza para consultar los BMS por filtros y mostrar detalles sobre los BMS.

La información que puede consultarse incluye el modo de facturación del BMS y si el BMS está congelado.

URI

GET /v1/{project_id}/baremetalservers/detail{?flavor={flavor}&name={name}&status={status}&limit={limit}&offset={offset}&tags={tags}&reservation_id={reservation_id}&enterprise_project_id={enterprise_project_id}}

Tabla 1 enumera los parámetros.
Tabla 1 Descripción del parámetro

Parámetro

Obligatorio

Descripción

project_id

Especifica el ID del proyecto.

Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.

Tabla 2 Parámetros para consultar los detalles del BMS

Parámetro

Obligatorio

Tipo

Descripción

flavor

No

String

Especifica el ID de la variante del BMS.

name

No

String

Especifica el nombre del BMS.

status

No

String

Especifica el estado de BMS.

Rango de valores:

  • ACTIVE: Corriendo, deteniendo, eliminando
  • BUILD: Creando
  • ERROR: Defectuosa
  • HARD_REBOOT: Reiniciando por la fuerza
  • REBOOT: Reiniciando
  • DELETED: Eliminado
  • SHUTOFF: Detenido, iniciando, eliminando, reconstruyendo, reinstalando el SO, Error de reinstalación del SO, Congelado

limit

No

Integer

Especifica el número de BMS que se muestran en cada página. El valor predeterminado es 25 y el valor máximo es 1000.

offset

No

Integer

Esta API es una API de consulta de paginación. offset indica el número de página (el número de página de inicio es de 1). El valor devuelto contiene el número de BMS y los detalles sobre los BMS.

  • Si se especifica offset:

    Los BMS se muestran por páginas según el valor limit. De forma predeterminada, el valor limit es 1000. Se muestran los BMS y el número total de BMS en la página offset. El número máximo de BMS es el valor de limit. Si el número de BMS es menor que el valor de limit, se muestra el número real de BMS.

  • Si no se especifica offset:
    • Si se especifica limit: se muestran los BMS y el número total de BMS. El número máximo de BMS es el valor de limit. Si el número de BMS es menor que el valor de limit, se muestra el número real de BMS.
    • Si no se especifica limit: se muestran 25 BMS en cada página. Se muestran los detalles sobre los BMS de la primera página. Si el número de BMS es menor que 25, se muestra el número real de BMS.

tags

No

String

Especifica la etiqueta del BMS. El valor puede ser:

  • __type_baremetal: la etiqueta interna del sistema
  • Otras etiquetas personalizadas

reservation_id

No

String

Especifica el ID reservado, que se puede utilizar para consultar los BMS creados en un lote.

detail

No

String

Especifica el nivel para obtener detalles sobre los resultados de las consultas de BMS. Un nivel superior indica más detalles sobre los resultados de la consulta de BMS.

Los niveles disponibles incluyen 1, 2, 3, 4 y 5. El nivel predeterminado es 4.

Solicitud

  • Parámetros de solicitud

    No hay

  • Ejemplo de la solicitud

    Con múltiples parámetros opcionales

    1
    GET https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/detail?offset=1&limit=2&enterprise_project_id=all_granted_eps
    

Respuesta

  • Parámetros de respuesta

    Parámetro

    Tipo

    Descripción

    servers

    List data structure

    Especifica detalles sobre los BMS. Para obtener más información, véase Consulta de detalles del BMS.

    Los detalles devueltos varían según el nivel de consulta.

    count

    Integer

    Especifica el número de BMS que coinciden con los filtros.

  • Ejemplo de la respuesta
      1
      2
      3
      4
      5
      6
      7
      8
      9
     10
     11
     12
     13
     14
     15
     16
     17
     18
     19
     20
     21
     22
     23
     24
     25
     26
     27
     28
     29
     30
     31
     32
     33
     34
     35
     36
     37
     38
     39
     40
     41
     42
     43
     44
     45
     46
     47
     48
     49
     50
     51
     52
     53
     54
     55
     56
     57
     58
     59
     60
     61
     62
     63
     64
     65
     66
     67
     68
     69
     70
     71
     72
     73
     74
     75
     76
     77
     78
     79
     80
     81
     82
     83
     84
     85
     86
     87
     88
     89
     90
     91
     92
     93
     94
     95
     96
     97
     98
     99
    100
    101
    102
    103
    104
    105
    106
    107
    108
    109
    110
    111
    112
    113
    114
    115
    116
    117
    118
    119
    120
    121
    122
    123
    124
    125
    126
    127
    128
    129
    130
    131
    132
    133
    134
    135
    136
    137
    138
    139
    140
    {
        "count": 2,
        "servers": [
            {
                "id": "b544be62-1b3b-4982-ad98-572b002ac23b",
                "name": "bms-test1",
                "addresses": {
                    "5849fdf1-9d79-4589-80c2-fe557990c417": [
                        {
                            "version": "4",
                            "addr": "192.168.1.63",
                            "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:3a:8d:f1",
                            "OS-EXT-IPS:port_id": "c79d2813-94c9-4135-973e-cbf5d23e78e6",
                            "OS-EXT-IPS:type": "fixed"
                        }
                    ]
                },
                "flavor": {
                    "disk": "9309",
                    "vcpus": "32",
                    "ram": "193047",
                    "id": "physical.s1.medium.ondemand",
                    "name": "physical.s1.medium.ondemand"
                },
                "accessIPv4": "",
                "accessIPv6": "",
                "status": "ACTIVE",
                "progress": 0,
                "hostId": "cd243addb5d2c64e89218180b7a3ed95abe6882e81c337cc563137df",
                "updated": "2018-09-10T01:20:58Z",
                "created": "2018-09-06T09:29:27Z",
                "metadata": {
                    "baremetalPortIDList": "[c79d2813-94c9-4135-973e-cbf5d23e78e6]",
                    "chargingMode": "0"
                },
                "tags": [
                    "__type_baremetal"
                ],
                "description": "bms-test1",
                "locked": false,
                "config_drive": "",
                "tenant_id": "bbf1946d374b44a0a2a95533562ba954",
                "user_id": "0c50494c5816425eb05c40b5e81ab65a",
                "key_name": "KeyPair-dec-jx",
                "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-0014bdc2",
                "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/vda",
                "OS-EXT-SRV-ATTR:ramdisk_id": "",
                "enterprise_project_id": "0",
                "OS-SRV-USG:launched_at": "2018-09-06T09:30:36.000000",
                "OS-EXT-SRV-ATTR:kernel_id": "",
                "OS-EXT-SRV-ATTR:launch_index": 0,
                "host_status": "UP",
                "OS-EXT-SRV-ATTR:reservation_id": "r-qjad3fv0",
                "OS-EXT-SRV-ATTR:hostname": "bms-test1",
                "sys_tags": [
                    {
                        "key": "_sys_enterprise_project_id",
                        "value": "0"
                    }
                ]
            },
            {
                "id": "a1541cfc-8ac3-43e9-a70d-b8d4b395b256",
                "name": "bms_test2",
                "addresses": {
                    "5849fdf1-9d79-4589-80c2-fe557990c417": [
                        {
                            "version": "4",
                            "addr": "192.168.1.50",
                            "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:8f:38:2c",
                            "OS-EXT-IPS:port_id": "460aa585-9f83-4719-9527-fc39ebaca9aa",
                            "OS-EXT-IPS:type": "fixed"
                        }
                    ]
                },
                "flavor": {
                    "disk": "9309",
                    "vcpus": "32",
                    "ram": "193047",
                    "id": "physical.s1.medium",
                    "name": "physical.s1.medium"
                },
                "accessIPv4": "",
                "accessIPv6": "",
                "status": "SHUTOFF",
                "hostId": "cd243addb5d2c64e89218180b7a3ed95abe6882e81c337cc563137df",
                "updated": "2018-09-06T10:00:25Z",
                "created": "2018-08-30T12:40:47Z",
                "metadata": {
                    "metering.order_id": "CS18083020422CNV9",
                    "baremetalPortIDList": "[460aa585-9f83-4719-9527-fc39ebaca9aa]",
                    "metering.product_id": "00301-167001-0--0",
                    "chargingMode": "1"
                },
                "tags": [
                    "__type_baremetal",
                    "_sys_enterprise_project_id=9dd1131d-71fd-40fe-8f14-3fe6b6b5ef8b",
                    "key1=value1",
                    "three=3",
                    "two=2"
                ],
                "description": "bms_test2",
                "locked": false,
                "config_drive": "",
                "tenant_id": "bbf1946d374b44a0a2a95533562ba954",
                "user_id": "3fc5ab2b0c544979abcaafd86edd80e6",
                "key_name": "KeyPair-hec-tzy",
                "OS-EXT-STS:power_state": 4,
                "OS-EXT-STS:vm_state": "stopped",
                "OS-EXT-SRV-ATTR:host": "bms.dc1",
                "OS-EXT-SRV-ATTR:instance_name": "instance-0014581b",
                "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/vda",
                "OS-EXT-SRV-ATTR:ramdisk_id": "",
                "enterprise_project_id": "0",
                "OS-SRV-USG:launched_at": "2018-08-30T12:42:10.000000",
                "OS-EXT-SRV-ATTR:kernel_id": "",
                "OS-EXT-SRV-ATTR:launch_index": 0,
                "host_status": "UP",
                "OS-EXT-SRV-ATTR:reservation_id": "r-i5w3yc9a",
                "OS-EXT-SRV-ATTR:hostname": "bms-test2",
                "sys_tags": [
                    {
                        "key": "_sys_enterprise_project_id",
                        "value": "0"
                    }
                ]
            }
        ]
    }
    

Valores devueltos

Valores normales

Valores devueltos

Descripción

200

La solicitud se ha procesado correctamente.

Para obtener más información sobre otros valores devueltos, consulte Códigos de estado.

Códigos de error

Véase Códigos de error.