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 a las API.
URI
POST /v3/{project_id}/volumes/{volume_id}/metadata
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
project_id |
Sí |
String |
El ID del proyecto. Para obtener más información sobre cómo obtener el ID de proyecto, consulte Obtención de un ID de proyecto. |
|
volume_id |
Sí |
String |
El ID del disco. |
Parámetros de solicitud
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
X-Auth-Token |
Sí |
String |
El token del usuario. Se puede obtener invocando a 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. |
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
metadata |
Sí |
Metadata object |
Los metadatos que se van a actualizar. Para obtener más detalles, consulte Parámetro en el campo metadata. key o value bajo metadata no pueden contener más de 255 bytes. |
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
__system__encrypted |
No |
String |
El campo de encriptación de metadata. 0: sin encriptación 1: encriptación Si este parámetro no aparece, el disco no está encriptado. |
|
__system__cmkid |
No |
String |
El ID de CMK de encriptación de 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 de metadata.
|
|
full_clone |
No |
String |
El método de clon. Cuando el disco se crea a partir de una instantánea, el valor 0 indica el método de clonación vinculado. |
Parámetros de respuesta
Código de estado: 200
|
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
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
error |
Error object |
El mensaje de error devuelto si se produce un error. |
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
code |
String |
El código de error devuelto si se produce un error. Para obtener más detalles sobre los códigos de error y sus significados, véase Códigos de error. |
|
message |
String |
El mensaje de error devuelto si se produce un error. |
Ejemplo de solicitudes
POST https://{endpoint}/v3/{project_id}/volumes/{volume_id}/metadata
{
"metadata" : {
"key1" : "value1",
"key2" : "value2"
}
}
Ejemplo de respuestas
Código de estado: 200
Aceptar
{
"metadata" : {
"key1" : "value1",
"key2" : "value2"
}
}
Código de estado: 400
Error en la solicitud
{
"error" : {
"message" : "XXXX",
"code" : "XXX"
}
}
Códigos de estado
|
Código de estado |
Descripción |
|---|---|
|
200 |
Aceptar |
|
400 |
Error en la solicitud |
Códigos de error
Consulte Códigos de error.
