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 de las API.
URI
PUT /v3/{project_id}/snapshots/{snapshot_id}
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| project_id | Sí | String | Definición El ID del proyecto. Para obtener más información, consulte Obtención de un ID de proyecto. Restricciones N/D Rango N/D Valor predeterminado N/D |
| snapshot_id | Sí | String | El ID de la instantánea. |
Parámetros de solicitud
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| X-Auth-Token | Sí | String | Definición 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. Restricciones N/D Rango N/D Valor predeterminado N/D |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| snapshot | Sí | CinderUpdateSnapshotOption object | La información de instantánea que se va a actualizar. |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| name | No | String | El nombre de la instantánea. Puede ingresar 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 el prefijo de los nombres de las instantáneas para evitar cualquier inconveniente. |
| description | No | String | La descripción de la instantánea. Puede ingresar hasta 85 caracteres. |
Parámetros de respuesta
Código de estado: 200
| Parámetro | Tipo | Descripción |
|---|---|---|
| snapshot | SnapshotSummary object | La información de la instantánea. |
| Parámetro | Tipo | Descripción |
|---|---|---|
| created_at | String | La hora en que se creó la instantánea. Formato de tiempo: 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 es una instantánea generada automáticamente creada durante una copia de respaldo del servidor. |
| name | String | El nombre de la instantánea. |
| size | Integer | El tamaño de la instantánea, en GiB. |
| status | String | El estado de la instantánea. Para obtener más información, consulte Estado de la instantánea de EVS. |
| updated_at | String | La hora en que se actualizó la instantánea. Formato de tiempo: UTC AAAA-MM-DDTHH:MM:SS.XXXXXX |
| volume_id | String | El ID del disco de origen de la instantánea. |
Código de estado: 400
| Parámetro | Tipo | Descripción |
|---|---|---|
| error | Error object | Definición La información de error devuelta si se produce un error. Rango N/D |
| 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}
{
"snapshot" : {
"name" : "name_xx3",
"description" : "hello"
}
} Ejemplos de respuestas
Código de estado: 200
OK
{
"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
Bad Request
{
"error" : {
"message" : "XXXX",
"code" : "EVS.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.
