Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Elastic Volume Service/ Referência de API/ API Cinder/ Gerenciamento de snapshots/ Consulta de detalhes sobre um snapshot do EVS
Atualizado em 2024-09-25 GMT+08:00
Ver PDF
Compartilhar

Consulta de detalhes sobre um snapshot do EVS

Função

Esta API é usada para consultar detalhes sobre um snapshot do EVS.

Método de chamada

Para obter detalhes, consulte Chamada de APIs.

URI

GET /v2/{project_id}/snapshots/{snapshot_id}

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

O ID do projeto.

Para obter detalhes sobre como obter o ID de projeto, consulte Obtenção de um ID de projeto.

snapshot_id

Sim

String

O ID do snapshot.

Parâmetros de solicitação

Tabela 2 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

O token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário.

Parâmetros de resposta

Código de status: 200

Tabela 3 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

snapshot

SnapshotDetail object

As informações do snapshot.
Tabela 4 SnapshotDetail

Parâmetro

Tipo

Descrição

id

String

O ID do snapshot.

name

String

O nome do snapshot.

Snapshots cujos nomes começam com o prefixo autobk_snapshot_ são criados automaticamente pelo sistema quando os backups são criados. Esses snapshots não podem ser excluídos ou usados para reverter dados.

description

String

A descrição do snapshot.

created_at

String

A hora em que o snapshot foi criado.

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

updated_at

String

A hora em que o snapshot foi atualizado.

metadata

Map<String,String>

Os metadados do snapshot.

volume_id

String

O ID do disco de origem do snapshot.

size

String

O tamanho do snapshot, em GiB.

status

String

O status do snapshot. Para obter detalhes, consulte Status do snapshot do EVS.

os-extended-snapshot-attributes:progress

String

O campo reservado.

os-extended-snapshot-attributes:project_id

String

O ID do locatário. O ID do locatário é o mesmo que o ID do projeto.

Código de status: 400

Tabela 5 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error

Error object

A mensagem de erro retornada se ocorrer um erro.
Tabela 6 Error

Parâmetro

Tipo

Descrição

code

String

O código de erro retornado se ocorrer um erro.

Para obter detalhes sobre códigos de erro e seus significados, consulte Códigos de erro.

message

String

A mensagem de erro retornada se ocorrer um erro.

Exemplo de solicitações

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

Exemplo de respostas

Código de status: 200

OK

{
  "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 status: 400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

Códigos de status

Código de status

Descrição

200

OK

400

Bad Request

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Gerenciamento de snapshots