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 Cloud Server/ Referência de API/ As API desatualizadas/ Gerenciamento de snapshot (as API de Nova do OpenStack)/ Criação de um snapshot (Descartado)

Atualizado em 2025-08-25 GMT+08:00

Ver PDF

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

Tabela 1 descreve os parâmetros no URI.

**Tabela 1** Descrição do parâmetro
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.

**Tabela 2** 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.

**Tabela 3** 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"
        }
}