Consulta da lista de snapshot
Função
Essa API é usada para consultar a lista de snapshot.
Depuração
Você pode depurar essa API no Explorador da API.
URI
- Formato URI
GET /v1.0/{project_id}/snapshots
- Descrição do parâmetro
Tabela 1 Parâmetros URI Parâmetro
Obrigatório
Tipo
Descrição
project_id
Sim
String
Project ID. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID do projeto.
Mensagem de solicitação
Exemplo de solicitação
GET https://{Endpoint}/v1.0/89cd04f168b84af6be287f71730fdb4b/snapshots
Mensagem de resposta
- Exemplo de resposta
{ "snapshots": [ { "id": "2a4d0f86-67cd-408a-8b66-017454fb7793", "name": "snapshot-1", "description": "", "started": "2016-08-23T03:59:23Z", "finished": "2016-08-23T04:01:40Z", "size": 500, "status": "AVAILABLE", "type": "MANUAL", "cluster_id": "4f87d3c4-9e33-482f-b962-e23b30d1a18c" }, { "id": "4af11460-06ec-48a4-b3ad-0e3bbdcd8ab1", "name": "snapshot-2", "description": "", "started": "2016-08-23T18:20:00Z", "finished": "2016-08-23T18:22:12Z", "size": 500, "status": "AVAILABLE", "type": "MANUAL", "cluster_id": "4f87d3c4-9e33-482f-b962-e23b30d1a18c" } ], "count":2 }
- Descrição do parâmetro
Tabela 2 Descrição do parâmetro de resultados Parâmetro
Tipo
Descrição
snapshots
Array of Snapshots objects
Lista de objetos de snapshot
count
Integer
Número total de objetos de snapshot
Tabela 3 Snapshots Parâmetro
Tipo
Descrição
id
String
ID do snapshot
name
String
Snapshot name
description
String
Descrição de captura instantânea
started
String
Hora em que um snapshot começa a ser criado. Formato: ISO8601: YYYY-MM-DDThh:mm:ssZ
finished
String
Hora em que um snapshot é concluído. Formato: ISO8601: YYYY-MM-DDThh:mm:ssZ
size
Double
Tamanho do snapshot, em GB
status
String
Status do snapshot:
- CREATING
- AVAILABLE
- UNAVAILABLE
type
String
Tipo de snapshot. Pode ser:
- MANUAL
- AUTOMATED
cluster_id
String
ID do cluster para o qual os snapshots são criados. Para obter detalhes sobre como obter o ID, consulte Obtenção de ID de cluster.
Código de status
- Normal
- Exceção
Tabela 4 Valores retornados Valor retornado
Descrição
400 Bad Request
Erro na solicitação.
401 Unauthorized
Autenticação falhou.
403 Forbidden
Sem permissão de operação.
404 Not Found
Nenhum recurso encontrado.
500 Internal Server Error
Erro de serviço interno.
503 Service Unavailable
Serviço não está disponível.