Criação de um snapshot (Descartado)
Função
Essa API é usada para criar um instantâneo para um volume.
Esta API foi descartada. Use a API descrita em Criação de um snapshot do EVS (OpenStack Cinder API v2).
Restrições
Um nome de instantâneo não pode ser prefixado com autobk_snapshot.
URI
POST /v2.1/{project_id}/os-snapshots
Parâmetro |
Obrigatório |
Descrição |
---|---|---|
project_id |
Sim |
Especifica a ID do projeto. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto. |
Solicitação
Tabela 2 descreve os parâmetros de solicitação.
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
display_description |
Não |
String |
Especifica a descrição do snapshot. |
volume_id |
Sim |
String |
Especifica a ID do volume. |
display_name |
Não |
String |
Especifica o nome do snapshot do EVS. O valor contém um máximo de 255 bytes.
NOTA:
Ao criar um backup para um disco EVS através do VBS, um instantâneo será criado e nomeado com o prefixo autobk_snapshot_. O console do EVS impôs restrições de operação em instantâneos com prefixo autobk_snapshot_. Portanto, é aconselhável não usar autobk_snapshot_ como o prefixo de nome para os snapshots que você criou. Caso contrário, os snapshots não podem ser usados normalmente. |
force |
Não |
Boolean |
Especifica se um snapshot deve ser criado forçosamente. Se o valor for true, um instantâneo para o volume em uso pode ser criado. |
Resposta
Tabela 3 descreve os parâmetros de resposta.
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
id |
Sim |
String |
Especifica a ID do instantâneo do disco no formato UUID. |
status |
Sim |
String |
Especifica o status do snapshot de volume. |
displayName |
Não |
String |
Especifica o nome do instantâneo do volume. |
displayDescription |
Não |
String |
Especifica a descrição do snapshot do volume. |
createdAt |
Sim |
String |
Especifica a hora em que o instantâneo de volume foi criado. |
volumeId |
Sim |
String |
Especifica a ID do disco no formato UUID para o instantâneo. |
size |
Sim |
Integer |
Especifica o tamanho do instantâneo do volume. |
Exemplo de solicitação
POST https://{endpoint}/v2.1/d6c277ba8820452e83df36f33c9fa561/os-snapshots
{ "snapshot": { "display_name": "test", "display_description": null, "volume_id": "ba5730ea-8621-4ae8-b702-ff0ffc12c209" } }
Exemplo de resposta
{ "snapshot": { "createdAt": "2016-05-20T16:54:14.981520", "displayDescription": null, "id": "b836dc3d-4e10-4ea4-a34c-8f6b0460a583", "displayName": "test", "size": 1, "status": "creating", "volumeId": "ba5730ea-8621-4ae8-b702-ff0ffc12c209" } }