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
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
ecs:CreateSnapshot |
create |
*Disco.
*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:
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:
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.