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/ Elastic Volume Service/ Referencia de la API/ Las API obsoletas/ API de Cinder/ Gestión de metadatos de instantáneas/ Actualización de los metadatos de una instantánea de EVS
Actualización más reciente 2026-04-23 GMT+08:00
Ver PDF
Compartir

Actualización de los metadatos de una instantánea de EVS

Función

Esta API se utiliza para actualizar los metadatos de una instantánea de EVS.

Método de invocación

Para obtener más información, consulte Invocación de las API.

URI

PUT /v3/{project_id}/snapshots/{snapshot_id}/metadata

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

El ID del proyecto. Para obtener más información, consulte Obtención de un ID de proyecto.

snapshot_id

Sí

String

El ID de la instantánea.

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

El token de usuario.

Se puede obtener invocando la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.
Tabla 3 Parámetros del cuerpo de la solicitud

Parámetro

Obligatorio

Tipo

Descripción

metadata

Sí

Map<String,String>

Los metadatos que se van a actualizar. Para obtener más información, consulte Parámetro en el campo metadata.

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

metadata

Map<String,String>

Los metadatos de la instantánea, que se componen de pares de clave-valor.

Código de estado: 400

Tabla 5 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error

Error object

Definición

La información de error devuelta si se produce un error.

Rango

N/D
Tabla 6 Error

Parámetro

Tipo

Descripción

code

String

Definición

El código de error devuelto si se produce un error.

Rango

Para obtener más información sobre el código de error, consulte Códigos de error.

message

String

Definición

El mensaje de error devuelto si se produce un error.

Rango

N/D

Ejemplos de solicitudes

PUT  https://{endpoint}/v3/{project_id}/snapshots/{snapshot_id}/metadata

{
  "metadata" : {
    "key1" : "value1",
    "key2" : "value2"
  }
}

Ejemplos de respuestas

Código de estado: 200

OK

{
  "metadata" : {
    "key1" : "value1"
  }
}

Código de estado: 400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

Códigos de estado

Código de estado

Descripción

200

OK

400

Bad Request

Códigos de error

Consulte Códigos de error.