Todos os produtos
Search
Central de documentação

Elastic Compute Service:CreateSnapshot

Última atualização: Oct 09, 2026

Cria um snapshot para um disco.

Descrição da operação

Os snapshots locais foram substituídos pelo recurso de acesso instantâneo a snapshots. As descrições dos parâmetros são as seguintes:\n- Se você usou snapshots locais antes de 14 de dezembro de 2020, pode continuar usando o parâmetro Category normalmente.\n- 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) têm o acesso instantâneo ativado por padrão após a criação, e tanto o snapshot manual quanto o snapshot automático são suportados. Os parâmetros InstantAccess, InstantAccessRetentionDays e DisableInstantAccess relacionados ao recurso de acesso instantâneo a snapshots 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 Snapshot está ativado. Para mais informações, consulte Ativar o Snapshot.

  • O disco deve estar no estado em uso ou não anexado. Observe os seguintes itens para diferentes estados:\n - Se o disco estiver no estado em uso, a instância deve estar no estado em execução ou parada.\n - Se o disco estiver no estado não anexado, certifique-se de que o disco tenha sido anexado a uma instância ECS anteriormente. Não é possível criar snapshots para discos que nunca foram anexados a uma instância ECS.\n - Quando um disco é usado para criar um volume estendido dinâmico ou um array 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 e garante a consistência de falhas em cenários em que um sistema de negócios abrange vários discos. 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 apresentar breves lentidões instantâneas.\n- Se a criação do snapshot não estiver concluída, o snapshot não poderá ser usado para criar uma imagem personalizada (CreateImage).\n- Durante a criação do snapshot, os dados incrementais gerados pelas operações do disco não são copiados para o snapshot.\n- 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á.\n- Os discos para os quais os snapshots estão sendo criados não suportam redimensionamento. Aguarde até que o snapshot seja criado antes de redimensionar o disco.

  • Você pode criar snapshots para discos no estado expirado (Expired). Se um disco 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 for liberado.

  • Após a criação de um snapshot, o sistema cobra pelo snapshot 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 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.

    • Existem limites de simultaneidade para a criação de snapshots. Exceder os limites faz com que a criação falhe. Para mais informações, consulte Limites de snapshots.

    • Ao consultar as 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. Você pode chamar a operação DescribeDisks e filtrar os discos anexados a uma instância usando o parâmetro InstanceId. O disco usado para criar um snapshot deve estar no estado em uso ou não anexado. Um disco não anexado deve ter sido anexado a uma instância ECS anteriormente.

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 e pode conter letras Unicode (incluindo letras em inglês e chinês) e dígitos ASCII (0 a 9). Também pode conter dois-pontos (:), sublinhados (_), pontos (.) e hifens (-).\n\n> O nome não pode começar com http:// ou https://. Para evitar conflitos de nomes com 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://.\n\nValor 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. Após a expiração do período de retenção, a liberação automática é acionada para o snapshot.\n\nValor 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:\n\n- Standard: snapshot padrão.\n- Flash: snapshot local.\n\n> Este parâmetro está prestes a ser descontinuado. Os snapshots padrão para discos ESSD (SSDs corporativos, não SSDs padrão) foram atualizados para ter o acesso instantâneo ativado por padrão. Nenhuma configuração adicional é necessária e nenhuma taxa extra é cobrada.

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 parâmetro ClientToken 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:\n- true: ativa o recurso. Apenas discos ESSD (SSDs corporativos, não SSDs padrão) suportam este recurso.\n- false: desativa o recurso. Um snapshot padrão é criado.\n\nValor padrão: false.\n\n> Este parâmetro foi descontinuado. Os snapshots padrão para discos ESSD (SSDs corporativos, não SSDs padrão) foram atualizados para ter o acesso instantâneo ativado por padrão. Nenhuma configuração adicional é necessária e nenhuma taxa extra é cobrada.

false

InstantAccessRetentionDays

integer

Não

Configurações para o período de retenção do recurso de acesso instantâneo a snapshots. Após a expiração do período de retenção, a liberação automática é acionada para o snapshot. Este parâmetro só tem efeito quando InstantAccess é definido como true. Unidade: dias. Valores válidos: 1 a 65535.\n\nValor padrão: o valor do parâmetro RetentionDays.\n\n> Este parâmetro foi descontinuado. Os snapshots padrão para discos ESSD (SSDs corporativos, não SSDs padrão) foram atualizados para ter o acesso instantâneo ativado por padrão. Nenhuma configuração adicional é necessária e nenhuma taxa extra é cobrada.

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. N varia de 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 do snapshot. N varia de 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 do snapshot.\n\n> Para melhorar a compatibilidade, recomendamos que você use o parâmetro Tag.N.Key.

null

value

string

Não

O valor da tag do snapshot.\n\n> 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 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 da 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 suporta 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 de simultaneidade. 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 atual 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 superior.
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. The specified instance instance does not. Check.[ec2478.desc]O InstanceType parameter is required.
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.