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 de BMS/ Cambio del nombre del BMS

Actualización más reciente 2023-03-20 GMT+08:00

Ver PDF

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 identificador del BMS. Puede obtener el ID de BMS desde la consola de BMS o usando la API de Consulta del BMS (API nativa de OpenStack).

Solicitud

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, véase 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 del BMS.

Ejemplo de la solicitud

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

      
           {
  "server":
    {
      "name": "new-server-test"
    }
}

Respuesta

Parámetros de respuesta

Parámetro	Tipo	Descripción
server	Object	Especifica la información del BMS. Para obtener más información, véase 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 identificador ú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 DELETED: Eliminado 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, véase Tabla 6.
image	Object	Especifica la imagen del BMS. Para obtener más información, véase 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, véase 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, véase Tabla 10.
security_groups	Array of objects	Especifica los grupos de seguridad a los que pertenece el BMS. Para obtener más información, véase Tabla 12.
links	Array of objects	Especifica los enlaces de acceso directo del BMS. Para obtener más información, véase 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 BMS. 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 BMS. 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 del host en el que se implementa el BMS.
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. suspended: El BMS está suspendido. 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 del error del BMS. Para más detalles, 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 BMS no tiene la 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 identificadores del BMS reservado en el escenario de creación por lotes. Cuando los BMS se crean en un lote, tienen el mismo reservation_id.
OS-EXT-SRV-ATTR:launch_index	Integer	Especifica la secuencia de inicio del BMS en el escenario 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 de BMS, por ejemplo, /dev/sdb.
OS-EXT-SRV-ATTR:user_data	String	Especifica el user_data especificado durante la creación de 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.
enterprise_project_id	String	Especifica el ID del proyecto de empresa.
os:scheduler_hints	Object	Especifica la información de programación de BMS.

**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 la 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" 
     } 
 }

          

        

      
     