CloneDisks - Elastic Compute Service: Central de Documentação do Alibaba Cloud

A clonagem de disco permite criar rapidamente um novo disco com os mesmos dados do disco de origem na mesma zona. O disco clonado suporta atributos personalizados de capacidade, tipo e criptografia. Após o disco clonado ser anexado a uma instância, você pode replicar rapidamente dados comerciais ou expandir serviços.

Descrição da operação

Nota

O recurso de clonagem de disco em si é gratuito, mas o novo disco gerado pela clonagem é cobrado com base nas regras de cobrança de armazenamento em bloco. Os itens cobráveis variam conforme o tipo de disco e incluem taxas de capacidade do disco, taxas de desempenho provisionado e taxas de pico de desempenho. Exceto pelas taxas de pico de desempenho, que são cobradas após a ocorrência de um pico, as demais taxas começam a ser acumuladas após a criação do disco, independentemente de o disco estar ou não anexado a uma instância.

Notas de uso

Esta é uma operação assíncrona. Após uma chamada bem-sucedida, use o taskGroupId e chame a operação DescribeTasks para consultar o resultado da execução.

Recursos

A clonagem suporta apenas discos da série ESSD (cloud_essd, cloud_auto, cloud_essd_entry, cloud_regional_disk_auto) como origem, e o novo disco só pode ser do tipo da série ESSD.
- Discos não regionais só podem ser clonados para tipos de disco não regionais. Discos regionais só podem ser clonados para tipos de disco regionais.
- Discos locais e discos efêmeros elásticos não podem ser clonados nem usados como fontes de clonagem.
Você pode especificar o tipo e o nível de desempenho (PL) do novo disco durante a clonagem.
Você pode especificar a capacidade do novo disco durante a clonagem, mas a capacidade do novo disco deve ser maior ou igual à capacidade do disco de origem.
Você pode configurar o desempenho provisionado e o pico de desempenho para o novo disco, desde que o tipo de disco de destino suporte desempenho provisionado e pico de desempenho.
Você pode especificar criptografia ou alterar a chave de criptografia para o novo disco. Se o disco de origem estiver criptografado, você não poderá cloná-lo em um disco não criptografado, mas poderá alterar a chave de criptografia.
Você pode usar um disco por assinatura como disco de origem. Mesmo que o disco por assinatura tenha expirado, ele ainda pode ser usado como disco de origem.
O novo disco clonado não suporta reinicialização.
A clonagem não suporta conjuntos de armazenamento ou clusters dedicados de armazenamento em bloco. No entanto, discos nesses recursos podem ser usados como disco de origem. O disco clonado não será colocado no conjunto de armazenamento ou cluster dedicado de armazenamento em bloco.
Restrições de status do disco de origem:
- O status do disco de origem é Em Uso, e o status da instância associada é Running ou Stopped.
- O status do disco de origem é Disponível, e o disco foi anexado anteriormente.
- Discos em processo de alteração de especificação não podem ser usados como disco de origem.
- Discos em processo de expansão não podem ser usados como disco de origem.
A clonagem de disco não é suportada para cenários de hibernação de instância. Se um disco estiver em uma instância hibernada, ele não poderá ser usado como disco de origem.

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:CloneDisks

create

*Disk

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

*Disk

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
DryRun	string	Não	Especifica se deve ser realizado apenas um dry run, sem executar a solicitação real. Valores válidos: true: envia uma solicitação de verificação sem consultar o status de registro. Os itens de verificação incluem se o par de AccessKey é válido, se o usuário do Resource Access Management (RAM) recebeu a autorização necessária e se os parâmetros obrigatórios foram especificados. Se a verificação falhar, a mensagem de erro correspondente será retornada. Se a verificação for bem-sucedida, o código de erro DryRunOperation será retornado. false (padrão): envia uma solicitação Normal. Após a verificação ser bem-sucedida, um código de status HTTP 2XX é retornado e o status de registro é consultado diretamente.	true
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 certifique-se de que o token seja exclusivo entre diferentes solicitações. O valor do ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000
Tag	array<object>	Não	A lista de tags do disco.
	object	Não	A lista de tags do disco.
Key	string	Não	A chave da tag do disco. 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 de comprimento e não pode começar com aliyun ou acs:. A chave da tag não pode conter http:// ou https://.	TestKey
Value	string	Não	O valor da tag do disco. 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 de comprimento e não pode conter http:// ou https://.	TestValue
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual o disco pertence.	rg-bp199lyny9b3****
SourceDiskId	string	Sim	O ID do disco de origem.	d-bp1d6tsvznfghy7y****
DiskName	string	Não	O nome do disco. O nome deve ter de 2 a 128 caracteres de comprimento e pode conter letras, dígitos, dois pontos (:), sublinhados (_), pontos (.) e hifens (-). O nome deve começar com uma letra. Valor padrão: vazio.	MyDiskName
DiskCategory	string	Sim	A categoria do novo disco. Valores válidos: cloud_essd: SSD empresarial (ESSD). cloud_auto: disco ESSD AutoPL. cloud_essd_entry: disco ESSD Entry. cloud_regional_disk_auto: ESSD regional. Nota Restrições de categoria de disco para clonagem de disco: Discos não regionais só podem ser clonados para tipos de disco não regionais. Discos regionais só podem ser clonados para tipos de disco regionais.	cloud_essd
PerformanceLevel	string	Não	O nível de desempenho (PL) do novo SSD padrão. Valores válidos: PL0: Um único disco pode fornecer até 10.000 IOPS de leitura/gravação aleatória. PL1: Um único disco pode fornecer até 50.000 IOPS de leitura/gravação aleatória. PL2: Um único disco pode fornecer até 100.000 IOPS de leitura/gravação aleatória. PL3: Um único disco pode fornecer até 1.000.000 IOPS de leitura/gravação aleatória. Nota Se DiskCategory estiver definido como cloud_essd, PerformanceLevel é obrigatório. Para mais informações sobre como selecionar um nível de desempenho ESSD, consulte ESSDs.	PL1
Size	integer	Sim	A capacidade do novo disco. Unidade: GiB. Você deve especificar um valor para este parâmetro. Valores válidos: cloud_essd: Os valores válidos variam conforme o nível de desempenho. PL0: 1 a 65.536. PL1: 20 a 65.536. PL2: 461 a 65.536. PL3: 1.261 a 65.536. cloud_auto: 1 a 65.536. cloud_essd_entry: 10 a 32.768. cloud_regional_disk_auto: 10 a 65.536.	60
MultiAttach	string	Sim	Especifica se o atributo de anexo múltiplo deve ser ativado para o novo disco. Valores válidos: Disabled: desativa o atributo de anexo múltiplo. Enabled: ativa o atributo de anexo múltiplo. Apenas SSDs empresariais (ESSDs) suportam este parâmetro definido como `Enabled`.	Disabled
ProvisionedIops	integer	Não	As IOPS de leitura/gravação provisionadas do disco ESSD AutoPL. Valores válidos: Capacidade (GiB) <= 3: Desempenho provisionado não é suportado. Capacidade (GiB) >= 4: [0, min{(1.000 IOPS/GiB × Capacidade - IOPS de linha de base), 50.000}] Desempenho de linha de base = max{min{1.800 + 50 × Capacidade, 50.000}, 3.000}. Nota Este parâmetro é suportado apenas quando DiskCategory está definido como cloud_auto. Para mais informações, consulte Discos ESSD AutoPL.	10
BurstingEnabled	boolean	Não	Especifica se o recurso de pico de desempenho deve ser ativado para o novo disco. Valores válidos: true: ativa o recurso de pico de desempenho. false: não ativa o recurso de pico de desempenho. Nota Este parâmetro é suportado apenas quando DiskCategory está definido como cloud_auto. Para mais informações, consulte Discos ESSD AutoPL.	true
Encrypted	boolean	Não	Especifica se o novo disco é criptografado. Valores válidos: true: O novo disco é criptografado. false: O novo disco não é criptografado. Valor padrão: false.	false
KmsKeyId	string	Não	O ID da chave KMS usada pelo novo disco.	key-szz67b2f696f4wh9yeg5d
Arn	array<object>	Não	Nota Este parâmetro não está disponível publicamente.
	object	Não	Nota Este parâmetro não está disponível publicamente.
RoleType	string	Não	Nota Este parâmetro não está disponível publicamente.	null
Rolearn	string	Não	Nota Este parâmetro não está disponível publicamente.	null
AssumeRoleFor	string	Não	Nota Este parâmetro não está disponível publicamente.	null

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
TaskGroupId	string	O ID do grupo de tarefas da tarefa de clonagem de disco. Você pode chamar DescribeTasks para consultar o resultado da execução da tarefa.	g-2ze2op2grqpclwu7****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "TaskGroupId": "g-2ze2op2grqpclwu7****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidDiskCategory.SourceDiskCategoryNotSupport	The specified target disk category %s does not support cloning from origin disk category %s.
400	InvalidDisk.NeverAttached	The specified disk %s has been never attached to any instance.
400	InvalidStatus.SourceDiskStatusViolation	The specified disk %s has an invalid status. The expected status is Available or In_use; but the current status is %s.
400	InvalidDiskCategory.ValueNotSupported	The specified parameter "DiskCategory" is not valid.	O tipo de disco do sistema e o tipo de disco de dados especificados não são suportados.
400	InvalidDiskName.ValueNotSupported	The specified parameter "DiskName" is not valid.
400	InvalidPerformanceLevel.ValueNotSupported	The specified parameter "PerformanceLevel" is not valid.
400	InvalidMultiAttach.ValueNotSupported	The specified parameter "MultiAttach" is not valid.
400	InvalidBurstingEnabled.DiskCategoryNotSupported	The specified disk category does not support bursting enabled.
400	InvalidProvisionedIops.DiskCategoryNotSupported	The specified disk category does not support provisioned IOPS.
400	InvalidProvisionedIops.LimitExceed	The provisioned IOPS exceeds the permitted range for the specified disk category.
400	InvalidSize.MustGreaterThanSourceDisk	The specified size %s(GB) must greater than source disk size %s(GB).
400	DryRunOperation	Request validation has been passed with DryRun flag set.	A solicitação de dry run passou na validação.
400	InvalidSourceDisk.Lazyloading	The specified source disk %s is lazyloading.
400	InvalidOperation.DiskCloneExceedsConcurrencyLimit	The source disk %s has reached the maximum number (1) of concurrent clone operations. In-progress cloned disks: %s. Please wait a moment and try again later.
400	InvalidParameter.Arns	The specified Arns is not valid.	O parâmetro Arns é inválido. Verifique o parâmetro e tente novamente.
400	InvalidOperation.DiskTypeUnsupported	The specified source disk "%s" does not support cloning. Please select a different source disk.
401	InvalidOperation.UserNotInWhiteList	The specified user %s is not in the CloneDisks whitelist.
403	OperationDenied.NotInArnsWhitelist	The current account is not authorized for this operation. Please check the ARNS whitelist configuration.
404	InvalidRegionId.NotFound	The specified region does not exist.	O RegionId especificado não existe. Verifique se o produto está disponível nesta região.
404	InvalidSourceDiskId.NotFound	The specified source disk does not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.