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.

En esta página

Función
Restricciones
URI
Parámetros de solicitud
Ejemplo de solicitud
Parámetros de respuesta
Ejemplo de respuesta
Valores devueltos
Códigos de error

Mostrar todo

Centro de ayuda/ Bare Metal Server/ Referencia de la API/ API de BMS/ Gestión de estado del BMS/ Cambio del nombre del BMS

Cambio del nombre del BMS

Actualización más reciente 2025-02-18 GMT+08:00

Ver PDF

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 (.).

NOTA:

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

     
        PUT https://{BMS Endpoint}/v1/c685484a8cc2416b97260938705deb65/baremetalservers/95bf2490-5428-432c-ad9b-5e3406f869dd

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

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

Tema anterior: Gestión de estado del BMS

Tema siguiente: Reinstalación del SO de BMS

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.

¿Cuáles de los siguientes problemas se presentaron?

Contenido diferente a la de la IU del producto

Descripciones poco claras

Falta de ejemplos o código

Pasos incorrectos

No puedo encontrar lo que necesito

Falta de prácticas recomendadas

Comentarios (opcional)

0/500

Seleccione al menos un tipo de problema e ingrese sus comentarios o sugerencias.

Ingrese 500 caracteres como máximo.

Enviar Cancelar