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.
Actualización más reciente 2024-09-04 GMT+08:00

Actualización de una instantánea de EVS

Función

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

Método de invocación

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

URI

PUT /v2/{project_id}/snapshots/{snapshot_id}

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

project_id

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.

snapshot_id

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

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.

Tabla 3 Parámetros del cuerpo de solicitud

Parámetro

Obligatorio

Tipo

Descripción

snapshot

CinderUpdateSnapshotOption object

La información de instantánea que se va a actualizar.

Tabla 4 CinderUpdateSnapshotOption

Parámetro

Obligatorio

Tipo

Descripción

name

No

String

El nombre de la instantánea. Puede escribir hasta 64 caracteres.

NOTA:

Cuando se crea una copia de respaldo para un disco, también se crea una instantánea y se le asigna un nombre con el prefijo autobk_snapshot_. No se pueden realizar operaciones en dichas instantáneas. Por lo tanto, se recomienda no utilizar autobk_snapshot_ como prefijo de nombres de instantáneas para evitar inconvenientes.

description

No

String

La descripción de la instantánea. Puede escribir hasta 85 caracteres.

Parámetros de respuesta

Código de estado: 200

Tabla 5 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

snapshot

SnapshotSummary object

La información de la instantánea.

Tabla 6 SnapshotSummary

Parámetro

Tipo

Descripción

created_at

String

La hora en que se creó la instantánea.

Formato de hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX

description

String

La descripción de la instantánea.

id

String

El ID de la instantánea.

metadata

Map<String,String>

Los metadatos de la instantánea.

Si metadata contiene el campo __system__enableActive, la instantánea se genera automáticamente durante una copia de respaldo del servidor.

name

String

El nombre de la instantánea.

size

Integer

Tamaño de la instantánea, en GiB.

status

String

El estado de la instantánea. Para obtener más detalles, consulte Estado de la instantánea de EVS.

updated_at

String

La hora en que se actualizó la instantánea.

Formato de hora: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX

volume_id

String

ID del disco de origen de la instantánea.

Código de estado: 400

Tabla 7 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error

Error object

El mensaje de error devuelto si se produce un error.

Tabla 8 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

Actualización del nombre y la descripción de la instantánea de EVS

PUT https://{endpoint}/v2/{project_id}/snapshots/{snapshot_id}

{
  "snapshot" : {
    "name" : "name_xx3",
    "description" : "hello"
  }
}

Ejemplo de respuestas

Código de estado: 200

Aceptar

{
  "snapshot" : {
    "status" : "available",
    "description" : "Daily backup",
    "created_at" : "2013-02-25T03:56:53.081642",
    "metadata" : { },
    "volume_id" : "5aa119a8-d25b-45a7-8d1b-88e127885635",
    "size" : 1,
    "id" : "f9faf7df-fdc1-4093-9ef3-5cba06eef995",
    "name" : "snap-001",
    "updated_at" : "2013-02-25T03:56:53.081642"
  }
}

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.