Todos os produtos
Search
Central de documentação

Elastic Compute Service:CreateSnapshot

Última atualização: Oct 22, 2026

Cria um snapshot para um disco em nuvem.

Descrição da operação

Os snapshots locais foram substituídos pelo recurso de acesso instantâneo a snapshots. A descrição da métrica é a seguinte:

  • Se você usou snapshots locais antes de 14 de dezembro de 2020, o uso normal do parâmetro Category é permitido.

  • Se você não usou snapshots locais antes de 14 de dezembro de 2020, nenhuma configuração adicional é necessária. Os snapshots criados para discos da série SSD empresarial (SSD empresarial, ESSD AutoPL, ESSD Entry e SSD empresarial regional) são ativados por padrão após a criação, e os recursos de snapshot manual e snapshot automático são suportados. Os parâmetros InstantAccess, InstantAccessRetentionDays e DisableInstantAccess relacionados ao recurso de acesso instantâneo não têm mais efeito nas operações de API. As operações de API DescribeSnapshots e DescribeSnapshotGroups adicionam o parâmetro de resposta Available para descrever o status ativo dos snapshots.

Antes de começar:

  • O recurso de snapshot está ativado. Para mais informações, consulte Ativar o recurso de snapshot.

  • O disco em nuvem deve estar no estado Em uso ou Disponível. Observe os seguintes itens com base no estado do disco:

    • Se o disco em nuvem estiver no estado Em uso, a instância deve estar no estado Em execução ou Parada.

    • Se o disco em nuvem estiver no estado Disponível, certifique-se de que o disco em nuvem foi anexado anteriormente a uma instância ECS. Você não pode criar snapshots para discos em nuvem que nunca foram anexados a uma instância ECS.

    • Quando um disco em nuvem é usado para criar um volume estendido dinâmico ou uma matriz RAID, recomendamos que você use um grupo consistente de snapshots e ative snapshots consistentes com o aplicativo para fazer backup dos dados. Um grupo consistente de snapshots garante a consistência cronológica dos dados gravados nos discos em nuvem e garante a consistência de falhas em cenários onde um sistema de negócios abrange vários discos em nuvem. Para mais informações, consulte Criar um grupo consistente de snapshots e Criar um snapshot consistente com o aplicativo.

Ao criar um snapshot, observe os seguintes itens:

  • Evite criar snapshots durante o horário de pico de negócios. Quando um snapshot está sendo criado, o desempenho de E/S do disco diminui em menos de 10%, e o desempenho de leitura e gravação pode sofrer breves desacelerações instantâneas.

  • Se a criação do snapshot não estiver concluída, o snapshot não poderá ser usado para criar uma imagem personalizada (CreateImage).

  • Durante a criação do snapshot, nenhum backup de dados incrementais gerados por operações no disco é salvo no snapshot.

  • Se o disco estiver anexado a uma instância ECS, não altere o status da instância durante a criação do snapshot, como parar ou reiniciar a instância ECS. Caso contrário, isso resultará em uma falha na criação do snapshot.

  • Você não pode realizar expansão em um disco enquanto um snapshot está sendo criado para ele. Aguarde até que o snapshot seja criado antes de executar operações de expansão.

  • Você pode criar snapshots para discos em nuvem no estado Expirado (Expired). Se um disco em nuvem atingir seu tempo de expiração e liberação enquanto um snapshot está sendo criado, o snapshot no estado Criando (Creating) será excluído quando o disco em nuvem for liberado.

  • Após a criação de um snapshot, o sistema cobra com base no tamanho do snapshot em cada região. Para mais informações, consulte Cobrança de snapshots.

  • Você não pode criar snapshots para um disco em nuvem especificado nos seguintes cenários:

    • O número de snapshots manuais retidos para o disco em nuvem atinge o limite superior. Para mais informações, consulte Limites de snapshots.

    • A criação de snapshots possui limites de simultaneidade. Exceder os limites causa falha na criação. Para mais informações, consulte Limites de snapshots.

    • Se a resposta a uma consulta de informações da instância ECS contiver {"OperationLocks": {"LockReason" : "security"}}, todas as operações serão proibidas.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

DiskId

string

Sim

O ID do disco em nuvem. Você pode chamar a operação DescribeDisks e filtrar por InstanceId para consultar os discos em nuvem anexados à instância. O disco em nuvem usado para criar um snapshot deve estar no estado Em uso ou Disponível. Um disco em nuvem disponível deve ter sido anexado anteriormente a uma instância ECS.

d-bp1s5fnvk4gn2tws0****

SnapshotName

string

Não

O nome do snapshot. O nome deve ter de 2 a 128 caracteres. Deve começar com uma letra ou um caractere chinês e pode conter letras Unicode (incluindo caracteres em inglês e chinês) e dígitos ASCII (0-9). Pode conter dois-pontos (:), sublinhados (_), pontos (.) e hifens (-).

Nota

Não pode começar com http:// ou https://. Para evitar conflitos de nomes com snapshots automáticos, não pode começar com auto.

testSnapshotName

Description

string

Não

A descrição do snapshot. A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.

Valor padrão: vazio.

testDescription

RetentionDays

integer

Não

Configurações para o período de retenção do snapshot. Unidade: dias. Valores válidos: 1 a 65536. O snapshot está sujeito à liberação automática quando o período de retenção expirar.

Valor padrão: vazio, o que indica que o snapshot não está sujeito à liberação automática.

30

Category

string

Não

O tipo de snapshot. Valores válidos:

  • Standard: snapshot padrão.

  • Flash: snapshot local.

Nota

Este parâmetro está prestes a ser descontinuado. Os snapshots padrão para discos SSD empresariais (excluindo SSD padrão) foram atualizados para ativos por padrão. Nenhuma configuração adicional é necessária e nenhum custo extra é incorrido.

Standard

ClientToken

string

Não

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 o valor seja exclusivo entre diferentes solicitações. O parâmetro ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Garantir idempotência.

123e4567-e89b-12d3-a456-426655440000

ResourceGroupId

string

Não

O ID do grupo de recursos ao qual o snapshot pertence.

rg-bp67acfmxazb4p****

InstantAccess

boolean

Não

Especifica se o recurso de acesso instantâneo a snapshots deve ser ativado. Valores válidos:

  • true: ativa o recurso. Apenas discos SSD empresariais (excluindo SSD padrão) suportam este recurso.

  • false: desativa o recurso. Um snapshot padrão é criado.

Valor padrão: false.

Nota

Este parâmetro foi descontinuado. Os snapshots padrão para discos SSD empresariais (excluindo SSD padrão) foram atualizados para ativos por padrão. Nenhuma configuração adicional é necessária e nenhum custo extra é incorrido.

false

InstantAccessRetentionDays

integer

Não

Configurações para o período de retenção do recurso de acesso instantâneo a snapshots. O snapshot está sujeito à liberação automática quando o período de retenção expirar. Este parâmetro só tem efeito quando InstantAccess é definido como true. Unidade: dias. Valores válidos: 1 a 65535.

Valor padrão: o valor do parâmetro RetentionDays.

Nota

Este parâmetro foi descontinuado. Os snapshots padrão para discos SSD empresariais (excluindo SSD padrão) foram atualizados para ativos por padrão. Nenhuma configuração adicional é necessária e nenhum custo extra é incorrido.

1

Tag

array<object>

Não

A lista de tags.

object

Não

A lista de tags.

Key

string

Não

A chave da tag N do snapshot. Valores válidos de N: 1 a 20. Se este parâmetro for especificado, não poderá ser uma string vazia. A chave da tag pode ter até 128 caracteres. Não pode começar com aliyun ou acs: e não pode conter http:// ou https://.

TestKey

Value

string

Não

O valor da tag N do snapshot. Valores válidos de N: 1 a 20. Se este parâmetro for especificado, poderá ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode conter http:// ou https://.

TestValue

key

string

Não

A chave da tag.

Nota

Para melhorar a compatibilidade, recomendamos que você use o parâmetro Tag.N.Key.

null

value

string

Não

O valor da tag.

Nota

Para melhorar a compatibilidade, recomendamos que você use o parâmetro Tag.N.Value.

null

StorageLocationArn

string

Não

Nota

Este parâmetro não está disponível.

null

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

SnapshotId

string

O ID do snapshot.

s-bp17441ohwka0yuh****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "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. Please verify that the key ID is correct and that the key resides in the current region.
400 InvalidSnapshotName.Malformed The specified SnapshotName is malformed.
400 IncorrectInstanceStatus The current status of the resource does not support this operation. O status atual da instância não oferece suporte a este tipo de operação.
400 DiskCategory.OperationNotSupported The type of the specified disk does not support creating a snapshot. O tipo de disco atual não oferece suporte a esta operação.
400 Duplicate.TagKey The parameter Tag.N.Key contains duplicate values. Please remove the duplicate tag keys and try again.
400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid. O parâmetro de chave de tag especificado é inválido.
400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. O parâmetro de valor da tag especificado é inválido.
400 InvalidRetentionDays.Malformed The specified RetentionDays is not valid. O período de retenção especificado é inválido. Verifique se o valor do parâmetro RetentionDays está correto.
400 CreateSnapshot.Failed The process of creating snapshot is failed. Falha ao criar o snapshot.
400 InvalidOperation.StorageLocationMismatch The specified storageLocation does not match the storage location of the last snapshot for the disk. Ensure the storageLocation is consistent with previous snapshots.
500 InternalError The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
403 Throttling Request was denied due to user flow control. A solicitação foi limitada.
403 IncorrectDiskStatus.CreatingSnapshot A previous snapshot creation is in process.
403 InstanceLockedForSecurity The disk attached instance is locked due to security.
403 IncorrectDiskStatus.NeverAttached The specified disk has never been attached to any instance.
403 QuotaExceed.Snapshot The snapshot quota exceeds.
403 IncorrectDiskStatus.NeverUsed The specified disk has never been used after creating.
403 CreateSnapshot.Failed The process of creating snapshot is failed.
403 DiskInArrears The specified operation is denied as your disk has expired.
403 DiskId.ValueNotSupported The specified parameter diskid is not supported. Esta operação não é suportada para o tipo de block storage especificado.
403 IncorrectDiskStatus The current disk status does not support this operation.
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance.
403 InvalidAccountStatus.SnapshotServiceUnavailable The snapshot service has not been activated. Please activate it and try again.
403 IncorrectInstanceStatus The current status of the resource does not support this operation.
403 IncorrectVolumeStatus The current volume status does not support this operation. O estado atual não suporta esta operação.
403 IdempotentParameterMismatch The specified clientToken is used. Os parâmetros da solicitação são inconsistentes com os da solicitação que usa o mesmo ClientToken.
403 IncorrectDiskStatus.Invalid The specified disk status is invalid. Restart the instance and try again.
403 IncorrectDiskType.NotSupport The specified device type is not supported. O tipo de armazenamento do disco especificado não oferece suporte a esta operação.
403 IncorrectDiskStatus.Transferring The specified device is transferring. You can retry after the process is finished.
403 InvalidParameter.KMSKeyId.CMKUnauthorized ECS tags must be added to the CMK. Uma tag ECS deve ser adicionada à CMK.
403 InvalidParameter.KMSKeyId.CMKNotEnabled The CMK needs to be enabled.
403 InvalidParameter.KMSKeyId.KMSUnauthorized ECS service does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service.
403 IdempotentProcessing The previous idempotent request(s) is still processing. A solicitação idempotente anterior ainda está sendo processada. Tente novamente mais tarde.
403 InvalidSnapshotCategory.Malformed The specified Category is not valid. O tipo de snapshot especificado é inválido. Verifique se o valor do parâmetro Category está correto.
403 InvalidAction.Unauthorized The specified action is not valid. A operação especificada é inválida.
403 InvalidRegion.NotSupportSnapshotInstantAccessRegion The snapshot InstantAccess is not supported for this region.
403 InvalidCategoryAndInstantAccess.Malformed The snapshot Category and InstantAccess can't be used together.
403 DISK_HAS_CREATING_SNAPSHOT The operation cannot be performed while a snapshot is being created for the disk.
403 HibernationConfigured.InstanceOperationForbidden The operation is not permitted due to limit of the hibernation configured instance. A operação não é permitida porque a instância não atende aos requisitos para ativar a hibernação.
403 QuotaExceed.SnapshotQuota The quota is insufficient. Please contact your channel partner to increase the quota.
403 InvalidInstantAccessRetentionDays.Malformed The specified InstantAccessRetentionDays is not valid. O formato do parâmetro InstantAccessRetentionDays especificado é inválido.
403 CloudBoxNotSupportSnapshotWithInstantAccess The specified disk in CloudBox does not support to create a snapshot with InstantAccess. Os discos no CloudBox não oferecem suporte à criação de snapshots com o recurso de acesso instantâneo.
403 InvalidOperation.UnfinishedEncryptedSnapshotCopy This disk has unfinished encrypted copy snapshots in the target region. O disco possui uma tarefa de cópia de snapshot criptografado incompleta.
403 QuotaExceed.ConcurrentSnapshotQuota The number of snapshots being created for the disk %s has exceeded the concurrent quota (%s). Please wait for the previous snapshots to complete before trying again. O número de snapshots sendo criados para o disco excede a cota de simultaneidade. Aguarde a conclusão dos snapshots em andamento e tente novamente.
403 InvalidClientToken.Malformed The specified clientToken is improperly formatted. It must contain only ASCII characters and must not exceed 64 characters in length. O parâmetro de idempotência especificado é inválido.
403 InvalidParameter.UnauthorizedStorageLocationArn The operation has failed due to lack of permission for the specified "StorageLocationArn". Please use a resource with appropriate permission for the operation. A operação atual falhou devido a permissões insuficientes no StorageLocationArn especificado. Entre em contato com o administrador do recurso para obter as permissões necessárias.
403 InvalidStorageLocationArn.Malformed The specified parameter StorageLocationArn is malformed.
403 InvalidStatus.ResourceGroup You cannot perform an operation on a resource group that is being created or deleted. Esta operação não é permitida enquanto um grupo de recursos está sendo criado ou excluído.
403 OperationDenied.QuotaExceed The quota of tags on resource is beyond permitted range. O número máximo de tags de recurso foi atingido.
403 Forbidden.InDebt The operation is not allowed because your account has an outstanding balance. Please settle the overdue payment and try again.
403 InvalidOperation.RegionUnsupported Creating snapshots is not supported in the specified region. Please use a region that supports the snapshot feature. A região especificada não oferece suporte à criação de snapshots. Use uma região que ofereça suporte a snapshots.
403 OperationDenied.KMSKeyUnauthorized The operation is denied due to missing KMS key authorization. Please check the KMS key permissions and ensure the key is properly authorized for this operation.
404 InvalidDiskId.NotFound The specified DiskId does not exist. Please verify the disk ID and the current region. O DiskId especificado não existe. Verifique o ID do disco e a região.
404 InvalidDescription.Malformed The specified parameter Description is not valid. Please ensure that the description is 2 to 256 characters long and does not start with "http://" or "https://" and try again. O parâmetro Description especificado é inválido. Certifique-se de que a descrição tenha de 2 a 256 caracteres e não comece com "http://" ou "https://" e tente novamente.
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. A instância especificada não existe. Verifique se o ID da instância está correto.
404 InvalidVolumeId.NotFound The specified volume does not exist.
404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records. O grupo de recursos especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.