CreateSnapshot - Criar um snapshot para um disco - : Central de Documentação do Alibaba Cloud

Cria um snapshot de um disco.

Descrição

O recurso de snapshot local foi substituído pelo recurso de acesso instantâneo.

Se você usou o recurso de snapshot local antes de 14 de dezembro de 2020, use os parâmetros Category ou InstantAccess normalmente e observe os seguintes pontos:
- Não especifique os parâmetros Category e InstantAccess simultaneamente.
- Se nenhum dos parâmetros Category e InstantAccess for especificado, o sistema criará snapshots normais.
Se você não usou o recurso de snapshot local antes de 14 de dezembro de 2020, use o parâmetro InstantAccess. O parâmetro Category não está disponível.

Não é possível criar snapshots de um disco nos seguintes cenários:

O disco atingiu o limite de 256 snapshots manuais.
A criação de um snapshot para este disco está em andamento.
A instância do Elastic Compute Service (ECS) à qual o disco está anexado nunca foi iniciada.
A instância ECS associada ao disco não está no estado Stopped (Stopped) ou Running (Running).
A consulta às informações da instância retorna {"OperationLocks": {"LockReason" : "security"}} na resposta. Isso indica que a instância está bloqueada por motivos de segurança e todas as operações estão proibidas.

Ao criar um snapshot, observe os seguintes pontos:

Durante a criação de um snapshot, não é possível usá-lo para gerar uma imagem personalizada por meio da operação CreateImage.
Não altere o estado de uma instância ECS enquanto um snapshot do disco anexado estiver em criação.
É permitido criar snapshots de discos no estado Expired (Expired). Se o horário de liberação programada do disco ocorrer durante a criação do snapshot, ele permanecerá no estado Creating (Creating) e será excluído quando o disco for liberado.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateSnapshot	A operação a ser executada. Defina o valor como CreateSnapshot.
DiskId	String	Sim	d-bp1s5fnvk4gn2tws0****	O ID do disco.
SnapshotName	String	Não	testSnapshotName	O nome do snapshot. Deve ter entre 2 e 128 caracteres, começar com uma letra e não pode iniciar com `http://` ou `https://`. Pode conter letras, dígitos, dois-pontos (:), sublinhados (_) e hífens (-). Não comece com `auto`, pois snapshots cujos nomes começam com auto são identificados como snapshots automáticos.
Description	String	Não	testDescription	A descrição do snapshot. Deve ter entre 2 e 256 caracteres e não pode começar com `http://` ou `https://`. Este parâmetro está vazio por padrão.
RetentionDays	Integer	Não	30	O período de retenção do snapshot. Valores válidos: 1 a 65536. Unidade: dias. O snapshot é liberado automaticamente quando o período de retenção expira. Este parâmetro está vazio por padrão, o que indica que o snapshot não será liberado automaticamente.
Category	String	Não	Standard	O tipo do snapshot. Valores válidos: Standard: snapshot normal Flash: snapshot local Nota Este parâmetro será removido futuramente. Recomendamos usar o parâmetro `InstantAccess` para garantir compatibilidade futura. Não especifique este parâmetro e o parâmetro `InstantAccess` simultaneamente. Para mais informações, consulte a seção "Descrição" deste tópico.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	O token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o valor e garanta que ele seja único entre diferentes solicitações. O valor de ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência.
ResourceGroupId	String	Não	rg-bp67acfmxazb4p****	O ID do grupo de recursos ao qual atribuir o snapshot.
InstantAccess	Boolean	Não	false	Especifica se o recurso de acesso instantâneo deve ser ativado. Valores válidos: true: ativa o recurso de acesso instantâneo. Este recurso só pode ser ativado para SSDs aprimorados (ESSDs). Nota Após ativar o recurso de acesso instantâneo, use o snapshot para reverter discos ou criar discos entre zonas mesmo durante a criação. Esse recurso garante acesso instantâneo a um novo snapshot para um ESSD, independentemente do tamanho do ESSD. false: não ativa o recurso de acesso instantâneo. Se InstantAccess estiver definido como false, o sistema criará um snapshot normal. Valor padrão: false. Nota Não especifique este parâmetro e o parâmetro `Category` simultaneamente. Para mais informações, consulte a seção "Descrição" deste tópico.
InstantAccessRetentionDays	Integer	Não	1	O período de validade do recurso de acesso instantâneo. Quando o período termina, o recurso é desativado e o snapshot de acesso instantâneo (IA) é liberado automaticamente. Este parâmetro entra em vigor apenas quando `InstantAccess` está definido como true. Unidade: dias. Valores válidos: 1 a 65535. Por padrão, o valor deste parâmetro é igual ao de `RetentionDays`.
Tag.N.key	String	Não	null	A chave da tag N a adicionar ao snapshot. Nota Este parâmetro será removido futuramente. Recomendamos usar o parâmetro Tag.N.Key para garantir compatibilidade futura.
Tag.N.Key	String	Não	TestKey	A chave da tag N a adicionar ao snapshot. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. Pode ter até 128 caracteres e não pode começar com acs: ou aliyun. Não pode conter http:// ou https://.
Tag.N.Value	String	Não	TestValue	O valor da tag N a adicionar ao snapshot. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia. Pode ter até 128 caracteres e não pode começar com acs: ou conter http:// ou https://.
Tag.N.value	String	Não	null	O valor da tag N a adicionar ao snapshot. Nota Este parâmetro será removido futuramente. Recomendamos usar o parâmetro Tag.N.Value para garantir compatibilidade futura.
StorageLocationArn	String	Não	null	Nota Este parâmetro não está disponível.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
SnapshotId	String	s-bp17441ohwka0yuh****	O ID do snapshot.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=CreateSnapshot
&DiskId=d-bp1s5fnvk4gn2tws0****
&SnapshotName=testSnapshotName
&Description=testDescription
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<CreateSnapshotResponse>
        <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
        <SnapshotId>s-bp17441ohwka0yuh****</SnapshotId>
</CreateSnapshotResponse>

Formato JSON

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

{
  "RequestId" : "C8B26B44-0189-443E-9816-D951F59623A9",
  "SnapshotId" : "s-bp17441ohwka0yuh****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist.	Mensagem retornada porque o ID da chave do Key Management Service (KMS) especificado não existe.
400	InvalidSnapshotName.Malformed	The specified SnapshotName is wrongly formed.	Mensagem retornada porque o parâmetro SnapshotName especificado é inválido.
400	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Mensagem retornada porque a operação não é suportada enquanto o recurso está no estado atual.
400	DiskCategory.OperationNotSupported	The operation is not supported to the specified disk due to its disk category	Mensagem retornada porque a categoria do disco especificado não suporta esta operação.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Mensagem retornada porque a chave de tag especificada já existe. As chaves de tag devem ser únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Mensagem retornada porque o parâmetro Tag.N.Key especificado é inválido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Mensagem retornada porque o parâmetro Tag.N.Value especificado é inválido.
400	InvalidRetentionDays.Malformed	The specified RetentionDays is not valid.	Mensagem retornada porque o parâmetro RetentionDays especificado é inválido.
403	Throttling	Request was denied due to user flow control.	Mensagem retornada porque sua solicitação foi limitada. Tente novamente mais tarde.
403	IncorrectDiskStatus.CreatingSnapshot	A previous snapshot creation is in process.	Mensagem retornada porque outro snapshot está sendo criado para o disco. Aguarde a conclusão da criação e tente novamente.
403	InstanceLockedForSecurity	The disk attached instance is locked due to security.	Mensagem retornada porque a instância à qual o disco está anexado foi bloqueada por motivos de segurança.
403	IncorrectDiskStatus.NeverAttached	The specified disk has never been attached to any instance.	Mensagem retornada porque o disco removível nunca foi anexado a instâncias e seus dados permanecem inalterados.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.	Mensagem retornada porque o número máximo de snapshots foi atingido. Para criar novos snapshots, exclua aqueles que não são mais necessários.
403	IncorrectDiskStatus.NeverUsed	The specified disk has never been used after creating.	Mensagem retornada porque o disco especificado nunca foi utilizado após a criação e seus dados permanecem inalterados.
403	CreateSnapshot.Failed	The process of creating snapshot is failed.	Mensagem retornada porque não foi possível criar o snapshot.
403	DiskInArrears	The specified operation is denied as your disk has expired.	Mensagem retornada porque o disco expirou devido a pagamento pendente.
403	DiskId.ValueNotSupported	The specified parameter diskid is not supported.	Mensagem retornada porque a categoria do dispositivo Elastic Block Storage (EBS) especificado não suporta esta operação.
403	IncorrectDiskStatus	The current disk status does not support this operation.	Mensagem retornada porque a operação não é suportada enquanto o disco está no estado atual. Verifique se o disco está utilizável e se não há pagamentos pendentes.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Mensagem retornada porque o saldo da sua conta é insuficiente. Adicione fundos à sua conta e tente novamente.
403	InvalidAccountStatus.SnapshotServiceUnavailable	Snapshot service has not been opened yet.	Mensagem retornada porque a operação não é suportada enquanto o serviço de snapshot não estiver ativado.
403	IncorrectVolumeStatus	The current volume status does not support this operation.	Mensagem retornada porque a operação não é suportada enquanto o dispositivo Shared Block Storage está no estado atual.
403	IdempotentParameterMismatch	The specified clientToken is used.	Mensagem retornada porque o token de cliente especificado já está em uso.
403	IncorrectDiskType.NotSupport	The specified device type is not supported.	Mensagem retornada porque o tipo de disco especificado não suporta a operação.
403	IncorrectDiskStatus.Transferring	The specified device is transferring, you can retry after the process is finished.	Mensagem retornada porque o disco especificado está sendo migrado. Aguarde a conclusão da migração e tente novamente.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	Mensagem retornada porque a chave mestra do cliente (CMK) não está ativada quando um ID de chave KMS é especificado para um disco. Chame a operação DescribeKey do KMS para consultar as informações sobre a CMK especificada.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service have no right to access your KMS.	Mensagem retornada porque o ECS não tem autorização para acessar seus recursos do KMS.
403	IdempotentProcessing	The previous idempotent request(s) is still processing.	Mensagem retornada porque uma solicitação idempotente anterior ainda está sendo processada. Tente novamente mais tarde.
403	QuotaExceed.Tags	%s	Mensagem retornada porque o número de tags especificadas excede o limite superior. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.
403	InvalidSnapshotCategory.Malformed	The specified Category is not valid.	Mensagem retornada porque o parâmetro Category especificado é inválido.
403	IncorrectDiskStatus.Invalid	The specified disk status invalid, restart instance and try again.	Mensagem retornada porque o estado do disco especificado é inválido. Reinicie a instância e tente novamente.
404	InvalidDiskId.NotFound	The specified DiskId does not exist.	Mensagem retornada porque o parâmetro DiskId especificado não existe.
404	InvalidDescription.Malformed	The specified description is wrongly formed.	Mensagem retornada porque o parâmetro Description especificado é inválido. A descrição deve ter entre 2 e 256 caracteres e não pode começar com http:// ou https://.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Mensagem retornada porque o ID da instância especificado não existe. Verifique se o ID da instância está correto.
404	InvalidVolumeId.NotFound	The specified volume does not exist.	Mensagem retornada porque o dispositivo Shared Block Storage especificado não existe. Verifique se o ID do dispositivo Shared Block Storage está correto.
500	InternalError	The request processing has failed due to some unknown error.	Mensagem retornada porque ocorreu um erro interno. Tente novamente mais tarde.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Mensagem retornada porque ocorreu um erro interno. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, visite o API Error Center.