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

Consulta de detalles sobre una instantánea de EVS

Función

Esta API se utiliza para consultar detalles sobre una instantánea de EVS.

Método de invocación

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

URI

GET /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.

Parámetros de respuesta

Código de estado: 200

Tabla 3 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

snapshot

SnapshotDetail object

La información de la instantánea.

Tabla 4 SnapshotDetail

Parámetro

Tipo

Descripción

id

String

El ID de la instantánea.

name

String

El nombre de la instantánea.

Las instantáneas cuyos nombres comienzan con el prefijo autobk_snapshot_ son creadas automáticamente por el sistema cuando se crean copias de respaldo. Estas instantáneas no se pueden eliminar ni utilizar para revertir datos.

description

String

La descripción de la instantánea.

created_at

String

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

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

updated_at

String

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

metadata

Map<String,String>

Los metadatos de la instantánea.

volume_id

String

El ID del disco de origen de la instantánea.

size

String

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.

os-extended-snapshot-attributes:progress

String

El campo reservado.

os-extended-snapshot-attributes:project_id

String

El ID de tenant. El ID del tenant es el mismo que el ID del proyecto.

Código de estado: 400

Tabla 5 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 6 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, consulte Códigos de error.

message

String

El mensaje de error devuelto si se produce un error.

Ejemplo de solicitudes

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

Ejemplo de respuestas

Código de estado: 200

Aceptar

{
  "snapshot": {
    "status": "available",
    "os-extended-snapshot-attributes:progress": "100%",
    "description": "daily backup",
    "created_at": "2013-02-25t04:13:17.000000",
    "metadata": {},
    "volume_id": "5aa119a8-d25b-45a7-8d1b-88e127885635",
    "os-extended-snapshot-attributes:project_id": "0c2eba2c5af04d3f9e9d0d410b371fde",
    "size": 1,
    "id": "2bb856e1-b3d8-4432-a858-09e4ce939389",
    "name": "snap-001",
    "updated_at": null,
  }
}

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.