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
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. 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 |
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 |
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 |
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.