Todos os produtos
Search
Central de documentação

Elastic Compute Service:CreateSnapshot

Última atualização: Sep 15, 2026

Cria um snapshot de um disco.

Descrição da operação

O recurso de snapshot local foi substituído pelo recurso de acesso instantâneo a snapshots. As descrições das métricas são as seguintes:

  • Se você usou snapshots locais antes de 14 de dezembro de 2020, pode continuar usando o parâmetro Category como Normal.

  • 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 ESSD (ESSD, ESSD AutoPL, ESSD Entry e ESSD regional) são ativados instantaneamente por padrão e suportam tanto snapshots manuais quanto automáticos. Os parâmetros InstantAccess, InstantAccessRetentionDays e DisableInstantAccess relacionados ao recurso de acesso instantâneo a snapshots não têm mais efeito. As operações de API DescribeSnapshots e DescribeSnapshotGroups incluirão um novo elemento de resposta Available para indicar o status ativo de um snapshot.

Antes de começar:

  • Ative o recurso de snapshot. Para mais informações, consulte Ativar o recurso de snapshot.

  • O disco deve estar no estado In Use ou Unattached. As seguintes precauções se aplicam a cada estado:

    • Se o disco estiver no estado In Use, a instância deve estar no estado Running ou Stopped.

    • Se o disco estiver no estado Unattached, o disco deve ter sido anexado anteriormente a uma instância ECS. Não é possível criar snapshots para discos que nunca foram anexados a uma instância ECS.

    • Se o disco for usado para criar um volume dinâmico ou uma matriz RAID, 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 da ordem de gravação em vários discos em um sistema de negócios e garante a consistência em caso de falha. Para mais informações, consulte Criar um grupo consistente de snapshots e Criar um snapshot consistente com o aplicativo.

Ao criar um snapshot, observe o seguinte:

  • Evite criar snapshots durante o horário de pico de negócios. A criação de um snapshot reduz o desempenho de E/S do disco em menos de 10% e pode causar uma breve lentidão no desempenho de leitura e gravação.

  • Se um snapshot ainda não estiver concluído, ele não poderá ser usado para criar uma imagem personalizada (CreateImage).

  • Os dados incrementais gerados pelas operações do disco durante a criação do snapshot não são incluídos no backup do snapshot.

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

  • Um disco para o qual um snapshot está sendo criado não pode ser expandido. Aguarde até que o snapshot seja concluído antes de executar a operação de expansão.

  • Você pode criar um snapshot para um disco no estado Expired. Se o disco atingir seu tempo de expiração enquanto um snapshot está sendo criado, o disco é liberado e o snapshot no estado Creating é excluído ao mesmo tempo.

  • Após a criação de um snapshot, as taxas são cobradas separadamente para cada região com base no tamanho do snapshot. Para mais informações, consulte Cobrança de snapshots.

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

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

    • A criação de snapshots está sujeita a limites de simultaneidade. Exceder o limite faz com que a criação falhe. Para mais informações, consulte Limites de snapshots.

    • Ao consultar informações da instância ECS, se os dados retornados contiverem {"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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:CreateSnapshot

create

*Disco.

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

*Snapshot.

acs:ecs:{#regionId}:{#accountId}:snapshot/*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

DiskId

string

Sim

O ID do disco.

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 maiúscula ou minúscula ou um caractere chinês, e pode conter caracteres Unicode na categoria de letras (incluindo caracteres em inglês e chinês) e dígitos ASCII (0–9). O nome pode conter dois-pontos (:), sublinhados (_), pontos (.) ou hifens (-).

Nota

O nome não pode começar com http:// ou https://. Para evitar conflitos com nomes de snapshots automáticos, o nome 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, em dias. Valores válidos: 1 a 65536. O snapshot passa por liberação automática quando o período de retenção expira.

Valor padrão: vazio, o que indica que o snapshot não passa por liberação automática.

30

Category

string

Não

O tipo de snapshot. Valores válidos:

  • Standard: snapshot normal.

  • Flash: snapshot local.

Nota

Este parâmetro está sendo descontinuado. Os snapshots padrão para discos ESSD foram atualizados para acesso instantâneo por padrão. Nenhuma configuração adicional é necessária e nenhuma taxa adicional é incorrida.

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 token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir a 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 ESSD suportam este recurso.

  • false: desativa o recurso. Um snapshot normal é criado.

Valor padrão: false.

Nota

Este parâmetro foi descontinuado. Os snapshots padrão para discos ESSD foram atualizados para acesso instantâneo por padrão. Nenhuma configuração adicional é necessária e nenhuma taxa adicional é incorrida.

false

InstantAccessRetentionDays

integer

Não

Configurações para o período de retenção do recurso de acesso instantâneo a snapshots. O snapshot passa por liberação automática quando o período de retenção expira. Este parâmetro entra em vigor apenas quando InstantAccess é definido como true. Unidade: dias. Valores válidos: 1 a 65535.

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

Nota

Este parâmetro foi descontinuado. Os snapshots padrão para discos ESSD foram atualizados para acesso instantâneo por padrão. Nenhuma configuração adicional é necessária e nenhuma taxa adicional é incorrida.

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 do snapshot. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 128 caracteres e 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 do snapshot. Valores válidos de N: 1 a 20. O valor da tag pode 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 do snapshot.

Nota

Para melhor compatibilidade, use o parâmetro Tag.N.Key.

null

value

string

Não

O valor da tag do snapshot.

Nota

Para melhor compatibilidade, use o parâmetro Tag.N.Value.

null

StorageLocationArn

string

Não

Nota

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

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 esta 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 Tag.N.Key contain duplicate key. Existem chaves duplicadas nas tags. Certifique-se de que todas as chaves sejam únicas.
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 de tag especificado é inválido.
400 InvalidRetentionDays.Malformed The specified RetentionDays is not valid. O valor de dias 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. O tipo de block storage especificado não suporta esta operação.
403 IncorrectDiskStatus The current disk status does not support this operation.
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance.
403 InvalidAccountStatus.SnapshotServiceUnavailable Snapshot service has not been opened yet. O serviço de snapshot não está ativado. A operação não pode ser realizada.
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 status atual não oferece suporte a esta operação.
403 IdempotentParameterMismatch The specified clientToken is used. Os parâmetros da solicitação não correspondem à solicitação com 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. A tag ECS deve ser adicionada à chave mestra do cliente (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 opção de 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 em andamento.
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 este disco excedeu a cota simultânea. Aguarde a conclusão dos snapshots anteriores 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 idempotente 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 falhou porque o StorageLocationArn especificado não tem permissões suficientes. 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. As operações não são permitidas enquanto o 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 de tags de recurso atingiu o limite máximo.
403 Forbidden.InDebt The operation is not allowed because your account has an outstanding balance. Please settle the overdue payment and try again.
404 InvalidDiskId.NotFound The specified DiskId does not exist. O disco especificado não existe. Verifique se o ID do disco está correto.
404 InvalidDescription.Malformed The specified description is malformed.
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 não foi encontrado nos registros.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.