CreateSnapshot - : Central de Documentação do Alibaba Cloud

Descrição

Um snapshot é um backup pontual de um disco. Você pode usar snapshots para fazer backup de dados, recuperar dados após a liberação acidental de instâncias, recuperar dados após ataques de rede e criar imagens personalizadas.

Nota Não há cobrança pela criação de snapshots em servidores de aplicativos simples.

Precauções

É possível criar até três snapshots por disco em cada servidor de aplicativos simples.
O número máximo de snapshots que podem ser mantidos em uma conta Alibaba Cloud é o triplo do número de servidores de aplicativos simples criados. Esse valor não pode ser superior a 15.
Se um servidor de aplicativos simples for liberado automaticamente devido à expiração, os snapshots criados para esse servidor serão excluídos.
Se você criar um snapshot antes de redefinir o servidor de aplicativos simples, o snapshot será mantido após a redefinição, mas não poderá ser usado para restaurar os discos do servidor.

Limites de QPS

Você pode chamar esta operação de API até 10 vezes por minuto por conta. Solicitações que excederem esse limite serão descartadas, o que pode causar interrupções no serviço. Recomendamos que você observe esse limite ao chamar esta operação. Para obter mais informações, consulte Limites de QPS.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
RegionId	String	Sim	cn-hangzhou	O ID da região do servidor de aplicativos simples ao qual o disco está anexado.
DiskId	String	Sim	d-bp18kjxg9ebrhsgi****	O ID do disco.
SnapshotName	String	Sim	test-SnapshotName	O nome do snapshot. O nome deve ter entre 2 e 50 caracteres. Deve começar com uma letra, mas não pode começar com `http://` ou `https://`. O nome pode conter letras, dígitos, dois pontos (:), sublinhados (_), pontos (.) e hifens (-).
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o valor, mas deve garantir que ele seja exclusivo entre diferentes solicitações. O valor de ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para obter mais informações, consulte Como garantir a idempotência.
Action	String	Sim	CreateSnapshot	A operação que você deseja executar. Defina o valor como CreateSnapshot.

Parâmetros da resposta

Parâmetro	Tipo	Exemplo	Descrição
SnapshotId	String	s-bp16oazlsold4dks****	O ID do snapshot.
RequestId	String	20758A-585D-4A41-A9B2-28DA8F4F534F	O ID da solicitação.

Exemplos

Solicitações de exemplo

http(s)://swas.cn-hangzhou.aliyuncs.com/?RegionId=cn-hangzhou
&DiskId=d-bp18kjxg9ebrhsgi****
&SnapshotName=test-SnapshotName
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Action=CreateSnapshot
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateSnapshotResponse>
    <SnapshotId>s-bp16oazlsold4dks****</SnapshotId>
    <RequestId>20758A-585D-4A41-A9B2-28DA8F4F534F	</RequestId>
</CreateSnapshotResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "SnapshotId" : "s-bp16oazlsold4dks****",
  "RequestId" : "20758A-585D-4A41-A9B2-28DA8F4F534F\t"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidRemark.ValueNotSupported	The specified parameter Remark is invalid.	Mensagem de erro retornada porque as observações do snapshot especificadas são inválidas.
400	InvalidRemark.Duplicate	The specified Remark already exists.	Mensagem de erro retornada porque as observações do snapshot especificadas já existem.
400	IncorrectStatus	The state of the disk or instance does not currently support snapshot creation.	Mensagem de erro retornada porque a operação não é suportada enquanto o disco ou o servidor de aplicativos simples está no estado atual.
400	InvalidSnapshotName.ValueNotSupported	The specified SnapshotName is invalid.	Mensagem de erro retornada porque o parâmetro SnapshotName especificado é inválido.
400	InvalidSnapshotName.Duplicate	The specified SnapshotName already exists.	Mensagem de erro retornada porque o nome do snapshot especificado já existe.
403	SnapshotLimitExceed	The maximum number of snapshots in an instance is exceeded.	Mensagem de erro retornada porque o número máximo de snapshots que podem ser criados para o servidor de aplicativos simples foi atingido.
403	IncorrectDiskStatus.CreatingSnapshot	A snapshot is being created in the specified disk. Please try again later.	Mensagem de erro retornada porque outro snapshot está sendo criado para o disco. Aguarde a conclusão da criação do snapshot e tente novamente.
404	InvalidDiskId.NotFound	The specified DiskId does not exist.	Mensagem de erro retornada porque o parâmetro DiskId especificado é inválido.
500	InternalError	An error occurred while processing your request.	Mensagem de erro retornada porque ocorreu um erro interno. Tente novamente mais tarde. Se o erro persistir, abra um ticket.

Para obter uma lista de códigos de erro, visite a Central de Erros de API.