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.
Centro de ayuda/ Bare Metal Server/ Referencia de la API/ API de BMS/ Gestión del ciclo de vida de BMS/ Consulta de detalles sobre los BMS
Actualización más reciente 2023-03-20 GMT+08:00
Ver PDF
Compartir

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

Sí

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.