Modificación del metadato del BMS especificado (API nativa de OpenStack)

Función

Esta API se utiliza para modificar los metadatos del BMS especificados.

Restricciones

El atributo OS-EXT-STS:vm_state de BMS (estado de BMS) debe ser active, stopped, paused o suspended.

URI

PUT /v2.1/{project_id}/servers/{server_id}/metadata/{key}

Tabla 1 enumera los parámetros.

Solicitud

• Parámetros de solicitud

  Parámetro	Obligatorio	Tipo	Descripción
  meta	Sí	Object	Especifica el par de valores y clave de los metadatos definidos por el usuario. Para obtener más información, véase Tabla 2.

  Tabla 2 Descripción de la estructura de datos de campo meta

  Parámetro	Obligatorio	Tipo	Descripción
  User-defined field key and value pair	Sí	String	Especifica el par de valores y clave de los metadatos definidos por el usuario. Cada clave o valor contiene un máximo de 255 caracteres. La clave no admite los siguientes caracteres especiales: :`~!@#$%^&*()=+<,>?/'";{[]}|\ El valor no admite los siguientes caracteres especiales: \"

• Ejemplo de la solicitud

  1	PUT https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/metadata/{key}

  1 2 3 4 5

  { "meta": { "key": "value" } }

Respuesta

• Parámetros de respuesta

  Parámetro	Tipo	Descripción
  meta	Object	Especifica el par de valores y clave de los metadatos definidos por el usuario. Para obtener más información, véase Tabla 3.

  Tabla 3 Descripción de la estructura de datos de campo meta

  Parámetro	Tipo	Descripción
  User-defined field key and value pair	String	Especifica el par de valores y clave de los metadatos definidos por el usuario. Cada clave o valor contiene un máximo de 255 caracteres.

• Ejemplo de la respuesta

  1 2 3 4 5

  { "meta": { "key": "value" } }

Valores devueltos

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.