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 discos/ Adición de metadatos de un disco de EVS
Actualización más reciente 2026-04-23 GMT+08:00
Ver PDF
Compartir

Adición de metadatos de un disco de EVS

Función

Esta API se utiliza para agregar los metadatos de un disco de EVS.

Método de invocación

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

URI

POST /v3/{project_id}/volumes/{volume_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.

volume_id

Sí

String

El ID del disco.

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í

Metadata object

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

key o value bajo metadata no pueden contener más de 255 bytes.
Tabla 4 Metadata

Parámetro

Obligatorio

Tipo

Descripción

__system__encrypted

No

String

El campo de encriptación en metadata.

0: no encriptación

1: encriptación

Si este parámetro no aparece, el disco no está encriptado.

__system__cmkid

No

String

El ID del CMK de encriptación en metadata. Este parámetro se utiliza junto con __system__encrypted para la encriptación. La longitud de cmkid se fija en 36 bytes.

hw:passthrough

No

String

El parámetro que describe el tipo de dispositivo de disco en metadata.

  • Si el valor de este parámetro es true, el tipo de dispositivo de disco es SCSI, lo que permite que los SO de ECS accedan directamente al medio de almacenamiento subyacente y admitan comandos de reserva SCSI.

  • Si el valor de este parámetro es false, el tipo de dispositivo de disco es VBD, que solo admite comandos simples de lectura/escritura SCSI.

  • Si este parámetro no aparece, el tipo de dispositivo de disco es VBD.

Parámetros de respuesta

Código de estado: 200

Tabla 5 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 6 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 7 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

POST https://{endpoint}/v3/{project_id}/volumes/{volume_id}/metadata

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

Ejemplos de respuestas

Código de estado: 200

OK

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

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.