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
Testar
Autorização RAM
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:
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:
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.