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

Actualización de metadatos de BMS

Función

Esta API se utiliza para actualizar metadatos de BMS.

  • Si los metadatos no contienen el campo de destino, el campo se agrega automáticamente al campo.
  • Si los metadatos contienen el campo de destino, el valor del campo se actualiza automáticamente.
  • Si no se solicita el campo de los metadatos, el valor del campo permanece sin cambios.

Restricciones

El BMS debe estar en estado activo, detenido o pausado. El estado se indica mediante el parámetro OS-EXT-STS:vm_state.

URI

POST /v1/{project_id}/baremetalservers/{server_id}/metadata

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

Tabla 2 Parámetros de solicitud

Parámetro

Obligatorio

Tipo

Descripción

metadata

Sí

Object

Especifica el par de clave y valor de metadatos definido por el usuario.

Si no especifica ningún par de clave y valor, los metadatos no se actualizarán.

key:

Contiene un máximo de 255 caracteres de Unicode que pueden ser letras, dígitos, guiones (-), guiones bajos (_), dos puntos (:) y puntos (.). key no se puede dejar en blanco.

value:

Contiene un máximo de 255 caracteres de Unicode.

Ejemplo de solicitud

Actualización de los metadatos de un BMS (ID: cf2a8b97-b5c6-47ef-9714-eb27adf26e5b) para personalizar un par de clave-valor 
1
 
POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/metadata

1
2
3
4
5
 
{
    "metadata": {
        "key": "value"
    }
}

Parámetros de respuesta

Tabla 3 Descripción del parámetro

Parámetro

Obligatorio

Tipo

Descripción

metadata

Sí

Object

Especifica el par de clave y valor de metadatos definido por el usuario.

Si no especifica ningún par de clave y valor, los metadatos no se actualizarán.

key:

Contiene un máximo de 255 caracteres de Unicode que pueden ser letras, dígitos, guiones (-), guiones bajos (_), dos puntos (:) y puntos (.). key no se puede dejar en blanco.

value:

Contiene un máximo de 255 caracteres de Unicode.

Ejemplo de respuesta

1
2
3
4
5
 
{
    "metadata":{
        "key": "value"
    }
}

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.