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 de estado del BMS/ Cambio del nombre del BMS
Actualización más reciente 2025-02-18 GMT+08:00
Ver PDF
Compartir

Cambio del nombre del BMS

Función

Esta API se utiliza para cambiar el nombre de un BMS.

Restricciones

El nuevo nombre debe cumplir los siguientes requisitos:

Contiene de 1 a 63 caracteres, que consisten en letras (sin distinción entre mayúsculas y minúsculas), dígitos, guiones bajos (_), guiones (-) y puntos (.).

Esta API solo se puede usar para cambiar el nombre del BMS. El nombre de host no se cambiará. El nuevo nombre entra en vigor después de reiniciar el BMS.

URI

PUT /v1/{project_id}/baremetalservers/{server_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.

server_id

Sí

Especifica el ID de BMS.

Puede obtener el ID de BMS desde la consola de BMSBMS o invocando al Consulta de los BMS (API nativa de OpenStack).

Parámetros de solicitud

Parámetro

Obligatorio

Tipo

Descripción

server

Sí

Object

Especifica la estructura de datos del BMS. Para obtener más información, consulte Tabla 2.
Tabla 2 Descripción de la estructura de datos de campo server

Parámetro

Obligatorio

Tipo

Descripción

name

Sí

String

Especifica el nuevo nombre de BMS.

Ejemplo de solicitud

Cambio del nombre de un BMS (ID: 95bf2490-5428-432c-ad9b-5e3406f869dd) a new-server-test 
1
 
PUT https://{BMS Endpoint}/v1/c685484a8cc2416b97260938705deb65/baremetalservers/95bf2490-5428-432c-ad9b-5e3406f869dd

1
2
3
4
5
6
 
{
  "server":
    {
      "name": "new-server-test"
    }
}

Parámetros de respuesta

Parámetro

Tipo

Descripción

server

Object

Especifica la información del BMS. Para obtener más información, consulte Tabla 3.
Tabla 3 Descripción de la estructura de datos de campo server

Parámetro

Tipo

Descripción

name

String

Especifica el nombre del BMS.

id

String

Especifica el ID único del BMS.

status

String

Especifica el estado del BMS.

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

created

String

Especifica la hora en que se creó el BMS.

El formato de marca de tiempo es AAAA-MM-DDTHH:MM:SSZ (ISO 8601), por ejemplo, 2019-05-22T03:30:52Z.

updated

String

Especifica la hora a la que se actualizó por última vez el BMS.

El formato de marca de tiempo es AAAA-MM-DDTHH:MM:SSZ (ISO 8601), por ejemplo, 2019-05-22T04:30:52Z.

flavor

Object

Especifica la variante del BMS. Para obtener más información, consulte Tabla 6.

image

Object

Especifica la imagen del BMS. Para obtener más información, consulte Tabla 7.

tenant_id

String

Especifica el ID del tenant que posee el BMS. El valor está en formato UUID.

Este parámetro especifica el mismo significado que project_id.

key_name

String

Especifica el nombre de clave de SSH.

user_id

String

Especifica el ID del usuario al que pertenece el BMS.

metadata

Object

Especifica los metadatos del BMS. Para obtener más información, consulte Tabla 9.

hostId

String

Especifica el identificador de host del BMS.

addresses

Object

Especifica las direcciones de red del BMS. Para obtener más información, consulte Tabla 10.

security_groups

Array of objects

Especifica los grupos de seguridad a los que pertenece el BMS. Para obtener más información, consulte Tabla 12.

links

Array of objects

Especifica los enlaces de acceso directo del BMS. Para obtener más información, consulte Tabla 8.

OS-DCF:diskConfig

String

Especifica el método de configuración del disco. Este es un atributo extendido. El valor puede ser:

  • MANUAL: La API utiliza el esquema de particionamiento en la imagen y el sistema de archivos para crear un BMSBMS. Si la variante de destino tiene un disco grande, la API no particiona el espacio restante en disco.
  • AUTO: La API utiliza una sola partición con el mismo tamaño que el disco de la variante de destino para crear un BMSBMS. La API ajusta automáticamente el sistema de archivos para que se adapte a toda la partición.

OS-EXT-AZ:availability_zone

String

Especifica la AZ donde se encuentra el BMS.

OS-EXT-SRV-ATTR:host

String

Especifica el nombre de host del BMS. Este es un atributo extendido.

OS-EXT-SRV-ATTR:hypervisor_hostname

String

Especifica el nombre de host del hipervisor.

OS-EXT-SRV-ATTR:instance_name

String

Especifica el alias del BMS. Este es un atributo extendido.

OS-EXT-STS:power_state

Integer

Especifica el estado de energía del BMS. Este es un atributo extendido. Ejemplos:

  • 0: indica NO STATE.
  • 1: indica RUNNING.
  • 4: indica SHUTDOWN.

OS-EXT-STS:task_state

String

Especifica el estado de la tarea del BMS. Este es un atributo extendido. Ejemplos:

  • rebooting: Se está reiniciando el BMS.
  • reboot_started: El BMS normalmente se reinicia.
  • reboot_started_hard: El BMS se reinicia a la fuerza.
  • powering-off: El BMS está siendo apagado.
  • powering-on: El BMS está siendo encendido.
  • rebuilding: El BMS está siendo reconstruido.
  • scheduling: El BMS se está programando.
  • deleting: El BMS se está eliminando.

OS-EXT-STS:vm_state

String

Especifica el estado del BMS. Este es un atributo extendido. Ejemplos:

  • active: El BMS se está ejecutando.
  • shutoff: El BMS se detiene.
  • reboot: Se reinicia el BMS.

OS-SRV-USG:launched_at

String

Especifica la hora en que se inició el BMS. Este es un atributo extendido.

El formato de marca de tiempo es ISO 8601, por ejemplo, 2019-05-25T03:40:25.000000.

OS-SRV-USG:terminated_at

String

Especifica la hora en que se detuvo el BMS. Este es un atributo extendido.

El formato de marca de tiempo es ISO 8601, por ejemplo, 2019-06-25T03:40:25.000000.

os-extended-volumes:volumes_attached

Array of objects

Especifica los discos de EVS conectados al BMS. Para obtener más información, véase Tabla 13.

accessIPv4

String

Este es un atributo reservado.

accessIPv6

String

Este es un atributo reservado.

fault

Object

Especifica la causa de un error de BMS. Para obtener más información, consulte Tabla 14.

config_drive

String

Este es un atributo reservado.

progress

Integer

Este es un atributo reservado.

description

String

Especifica la información del BMS.

host_status

String

Especifica el estado del host que aloja el BMS.

  • UP: El estado de nova-compute es normal.
  • UNKNOWN: El estado de nova-compute es desconocido.
  • DOWN: el estado de nova-compute es anormal.
  • MAINTENANCE: El nova-compute se encuentra en estado de mantenimiento.
  • Cadena vacía: El BMSBMS no tiene información de host.

OS-EXT-SRV-ATTR:hostname

String

Especifica el nombre de host del BMS.

OS-EXT-SRV-ATTR:reservation_id

String

Especifica los ID de BMS reservados en una situación de creación por lotes.

Cuando los BMSBMS se crean por un lote, tienen el mismo reservation_id.

OS-EXT-SRV-ATTR:launch_index

Integer

Especifica la secuencia de inicio del BMS en una situación de creación por lotes.

OS-EXT-SRV-ATTR:kernel_id

String

Especifica el UUID de la imagen del núcleo cuando se utiliza la imagen AMI. En otros escenarios, deje este parámetro en blanco.

OS-EXT-SRV-ATTR:ramdisk_id

String

Especifica el UUID de la imagen Ramdisk cuando se utiliza la imagen AMI. En otros escenarios, deje este parámetro en blanco.

OS-EXT-SRV-ATTR:root_device_name

String

Especifica el nombre del dispositivo del disco del sistema BMS, por ejemplo, /dev/sdb.

OS-EXT-SRV-ATTR:user_data

String

Especifica el user_data especificado durante la creación del BMS. El valor se codifica usando Base64 o una string vacía.

locked

Boolean

Especifica si el BMS está bloqueado.

  • true: El BMS está bloqueado.
  • false: El BMS no está bloqueado.

tags

Array of strings

Especifica las etiquetas del BMS.

sys_tags

Array of objects

Especifica las etiquetas de sistema del BMS. Para obtener más información, consulte Tabla 4.

enterprise_project_id

String

Especifica el ID del proyecto de empresa.

os:scheduler_hints

Object

Especifica la información de programación de BMS. Para obtener más información, consulte Tabla 5.
Tabla 4 Descripción de la estructura de datos de campo sys_tags

Parámetro

Tipo

Descripción

key

String

Especifica la clave de etiqueta del sistema.

value

String

Especifica el valor de la etiqueta del sistema.
Tabla 5 Descripción de la estructura de datos de campo os:scheduler_hints

Parámetro

Tipo

Descripción

group

Array of strings

Especifica el ID de grupo de BMS en formato UUID.
Tabla 6 Descripción de la estructura de datos de campo flavor

Parámetro

Tipo

Descripción

id

String

Especifica el ID de la variante.

links

Array of objects

Especifica los enlaces de acceso directo de la variante. Para obtener más información, véase Tabla 8.
Tabla 7 Descripción de la estructura de datos de campo image

Parámetro

Tipo

Descripción

id

String

Especifica el ID de imagen del BMS.

links

Array of objects

Especifica los enlaces de acceso directo de la imagen del BMS. Para obtener más información, véase Tabla 8.
Tabla 8 Descripción de la estructura de datos de campo links

Parámetro

Tipo

Descripción

rel

String

Especifica el nombre del marcador del enlace de acceso directo. El valor puede ser:

  • self: el enlace de recurso que contiene el número de la versión. Se utiliza cuando se requiere un seguimiento inmediato.
  • bookmark: el enlace de recurso que se puede almacenar durante mucho tiempo.

href

String

Especifica el enlace de acceso directo correspondiente.
Tabla 9 Descripción de la estructura de datos de campo metadata

Parámetro

Tipo

Descripción

key

String

Especifica el par de clave y valor de los metadatos.

Cada clave o valor contiene un máximo de 255 caracteres.
Tabla 10 Descripción de la estructura de datos del campo addresses

Parámetro

Tipo

Descripción

vpc_id

Array of objects

Especifica la VPC utilizada por el BMS.

  • key: indica el ID de la VPC utilizada por el BMS.
  • value: indica los detalles de la VPC. Para obtener más información, véase Tabla 11.
Tabla 11 Descripción de la estructura de datos de campo address

Parámetro

Tipo

Descripción

addr

String

Especifica la dirección IP.

version

Integer

Especifica el tipo de la dirección IP. El valor puede ser 4 o 6.

  • 4: el tipo de la dirección IP es IPv4.
  • 6: el tipo de la dirección IP es IPv6.

OS-EXT-IPS-MAC:mac_addr

String

Especifica la dirección de MAC. Este es un atributo extendido.

OS-EXT-IPS:type

String

Especifica el modo de asignación de direcciones IP. Este es un atributo extendido.

OS-EXT-IPS:port_id

String

Especifica el ID de puerto correspondiente a la dirección IP.
Tabla 12 Descripción de la estructura de datos de campo security_groups

Parámetro

Tipo

Descripción

name

String
  • Si no se especifica ningún grupo de seguridad durante la creación del BMS, se utiliza el valor default.
  • Al crear un BMS debe especificar el ID de un grupo de seguridad existente (en formato UUID).
Tabla 13 Descripción de la estructura de datos de campo os-extended-volumes:volumes_attached

Parámetro

Tipo

Descripción

id

String

Especifica el ID de disco de EVS.

delete_on_termination

Boolean

Especifica si se eliminará el disco cuando se eliminará el BMS.

  • true: Sí
  • false: No
Tabla 14 Descripción de la estructura de datos de campo fault

Parámetro

Tipo

Descripción

message

String

Especifica la información de error.

code

Integer

Especifica el código de error.

details

String

Especifica los detalles del error.

created

String

Especifica la hora en que se produjo un error.

El formato de marca de tiempo es AAAA-MM-DDTHH:MM:SSZ (ISO 8601), por ejemplo, 2019-05-22T03:30:52Z.

Ejemplo de 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
 
{ 
     "server": { 
         "tenant_id": "c685484a8cc2416b97260938705deb65", 
         "addresses": { 
             "08a7715f-7de6-4ff9-a343-95ba4209f24a": [  
                 { 
                     "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:0e:c4:77", 
                     "OS-EXT-IPS:type": "fixed",
                     "OS-EXT-IPS:port_id": "0c111191-9785-49e6-8b42-66ef2802bd8f",
                     "addr": "192.168.0.107", 
                     "version": 4 
                 } 
             ] 
         }, 
         "metadata": { 
             "op_svc_userid": "1311c433dd9b408886f57d695c229cbe" 
         }, 
         "OS-EXT-STS:task_state": null, 
         "OS-DCF:diskConfig": "MANUAL", 
         "OS-EXT-AZ:availability_zone": "az-dc-1", 
         "links": [ 
             { 
                 "rel": "self", 
                 "href": "https://bms.az0.dc1.domainname.com/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd" 
             }, 
             { 
                 "rel": "bookmark", 
                 "href": "https://bms.az0.dc1.domainname.com/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd" 
             } 
         ], 
         "OS-EXT-STS:power_state": 1, 
         "id": "95bf2490-5428-432c-ad9b-5e3406f869dd", 
         "os-extended-volumes:volumes_attached": [ 
             { 
                 "id": "dfa375b5-9856-44ad-a937-a4802b6434c3" 
             }, 
             { 
                 "id": "bb9f1b27-843b-4561-b62e-ca18eeaec417" 
             }, 
             { 
                 "id": "86e801c3-acc6-465d-890c-d43ba493f553" 
             }, 
             { 
                 "id": "0994d3ac-3c6a-495c-a439-c597a4f08fa6" 
             } 
         ], 
         "OS-EXT-SRV-ATTR:host": "bms.az-dc-1", 
         "image": { 
             "links": [ 
                 { 
                     "rel": "bookmark", 
                     "href": "https://bms.az0.dc1.domainname.com/c685484a8cc2416b97260938705deb65/images/1a6635d8-afea-4f2b-abb6-27a202bad319" 
                 } 
             ], 
             "id": "1a6635d8-afea-4f2b-abb6-27a202bad319" 
         }, 
         "OS-SRV-USG:terminated_at": null, 
         "accessIPv4": "", 
         "accessIPv6": "", 
         "created": "2017-05-24T06:14:05Z", 
         "hostId": "e9c3ee0fcc58ab6085cf30df70b5544eab958858fb50d925f023e53e", 
         "OS-EXT-SRV-ATTR:hypervisor_hostname": "nova004@2", 
         "key_name": "KeyPair-JX", 
         "flavor": { 
             "links": [ 
                 { 
                     "rel": "bookmark", 
                     "href": "https://bms.az0.dc1.domainname.com/c685484a8cc2416b97260938705deb65/flavors/physical.83.medium" 
                 } 
             ], 
             "id": "physical.83.medium" 
         }, 
         "security_groups": [ 
             { 
                 "name": "0011b620-4982-42e4-ad12-47c95ca495c4" 
             } 
         ], 
         "config_drive": "", 
         "OS-EXT-STS:vm_state": "active", 
         "OS-EXT-SRV-ATTR:instance_name": "instance-0000ebd3", 
         "user_id": "1311c433dd9b408886f57d695c229cbe", 
         "name": "bms-83", 
         "progress": 0, 
         "OS-SRV-USG:launched_at": "2017-05-25T03:40:25.066078", 
         "updated": "2017-05-25T03:40:25Z", 
         "status": "ACTIVE" 
     } 
 }

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.

Tema principal: Gestión de estado del BMS