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

Migra discos em nuvem para, de ou entre clusters de armazenamento em bloco dedicado.

Descrição da operação

Nota

O recurso de cluster de armazenamento em bloco dedicado está disponível nas regiões China (Hangzhou), China (Xangai), China (Pequim), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), China (Heyuan), Indonésia (Jacarta) e Alemanha (Frankfurt), além da região China (Shenzhen) Finance.

Antes de chamar esta operação, certifique-se de compreender os métodos de cobrança e os preços de discos em nuvem e clusters de armazenamento em bloco dedicado. Você também deve garantir que seu cluster de armazenamento em bloco dedicado não expirou e que sua conta possui saldo positivo. Para mais informações, consulte Cobrança por armazenamento em bloco dedicado e Cobrança de armazenamento em bloco.

Observe o seguinte ao chamar esta operação:

O disco em nuvem e o cluster de armazenamento em bloco dedicado devem estar na mesma zona de disponibilidade.
Apenas discos em nuvem pós-pagos são suportados. Você deve primeiro converter discos em nuvem pré-pagos para pós-pagos. Para mais informações, consulte Converter o método de cobrança de um disco em nuvem.
O tipo de disco em nuvem deve ser compatível com o cluster de armazenamento em bloco dedicado de destino. Ao migrar um disco entre clusters, você pode alterar o tipo de disco para corresponder aos tipos suportados pelo cluster de destino.
O disco em nuvem deve estar no estado Em uso ou Disponível.
Se o disco em nuvem estiver anexado a uma instância ECS, a instância deve estar no estado Em execução ou Parada. A instância ECS não deve estar expirada.
O nível de desempenho de um disco em nuvem ESSD depende de sua capacidade. Se não for possível atualizar o nível de desempenho, redimensione o disco e tente a operação novamente. Para mais informações, consulte ResizeDisk e Discos em nuvem ESSD.
Você pode realizar no máximo cinco tarefas de migração de disco em nuvem simultâneas por conta em uma única região.
Durante a migração, você não pode cancelar a migração, criar snapshots, alterar a configuração, redimensionar, anexar, desanexar ou reinicializar o disco.

Nota

Após a migração de um disco em nuvem, o cluster de destino determina seu método de cobrança, tipo e capacidades. As alterações entram em vigor imediatamente após a chamada da operação, e o Alibaba Cloud cobra com base no novo tipo de disco e nível de desempenho. Para mais informações, consulte Cobrança por armazenamento em bloco dedicado e Cobrança de armazenamento em bloco.

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

update

*Disk

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DiskId	string	Sim	O ID do disco.	d-bp131n0q38u3a4zi****
DiskCategory	string	Não	A nova categoria do disco. Este parâmetro é válido apenas quando você migra um disco entre diferentes clusters de armazenamento em bloco dedicado. O único valor válido é `cloud_essd` (disco ESSD). Valor padrão: Uma string vazia. Se você deixar este parâmetro vazio, a categoria do disco permanecerá inalterada.	cloud_essd
PerformanceLevel	string	Não	O novo nível de desempenho do disco ESSD. Este parâmetro é válido apenas quando você migra um disco entre diferentes clusters de armazenamento em bloco dedicado. Valores válidos: `PL0`: No máximo 10.000 IOPS de leitura/gravação aleatória por disco. `PL1`: No máximo 50.000 IOPS de leitura/gravação aleatória por disco. Valor padrão: Uma string vazia. Se você deixar este parâmetro vazio, o nível de desempenho do disco permanecerá inalterado.	PL1
StorageClusterId	string	Não	O ID do cluster de armazenamento em bloco dedicado. Para migrar o disco para um cluster de armazenamento em bloco dedicado, especifique `StorageClusterId`. Para migrar o disco para um cluster de armazenamento em bloco de nuvem pública, deixe `StorageClusterId` vazio. Valor padrão: Uma string vazia. Se você deixar este parâmetro vazio, o disco será migrado para um cluster de armazenamento em bloco de nuvem pública.	dbsc-cn-c4d2uea****
DryRun	boolean	Não	Especifica se deve ser realizado um dry run. Valores válidos: `true`: Realiza um dry run. O sistema verifica a solicitação quanto a parâmetros obrigatórios, formato, limites de serviço e inventário. O sistema retorna um erro se a verificação falhar, ou o código de erro `DryRunOperation` se a verificação for bem-sucedida. `false`: Envia a solicitação. Se a solicitação passar na verificação, o sistema retorna um código de status HTTP 2xx e migra o disco. Valor padrão: `false`.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O corpo da resposta.
RequestId	string	O ID da solicitação.	D69846D9-F17F-51C0-8AC6-B4B71777****
TaskId	string	O ID da tarefa de migração do disco.	t-bp67acfmxazb4p****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "D69846D9-F17F-51C0-8AC6-B4B71777****",
  "TaskId": "t-bp67acfmxazb4p****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidDiskSpec.Malformed	The specified parameter DiskCategory or PerformanceLevel is not supported.
400	AccountInArrears	The account is in arrears.
400	InvalidStorageClusterId.DiskAlreadyInDestination	The specified disk is already in destination.
500	InternalError	The request processing has failed due to some unknown error.
403	IncorrectDiskStatus	The current disk status does not support this operation.
403	DiskCreatingSnapshot	The operation is denied due to a snapshot of the specified disk is not completed yet.
403	InvalidOperation.DiskTypeUnsupported	The type of the disk does not support this operation.
403	InvalidOperation.DiskCategoryUnsupported	The current category of the disk does not support this operation.
403	InvalidOperation.ChargeTypeUnsupported	The charge type of the disk does not support this operation.
403	InvalidPerformanceLevel.DiskSizeUnsupported	The specified parameter PerformanceLevel does not match the disk size.
403	DiskLimitExceeded	The number of migrated disks at the same time exceeds the limit.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	The requested resources are insufficient.
403	InvalidOperation.MultiAttachDisk	Multi attach disk does not support this operation.	Disks for which the multi-attach feature is enabled do not support the operation.
403	InvalidDisk.DetachedSystemDisk	The specified resource is/has a detached system disk %s , not support current operation.
403	InvalidOperation.NoPermission	You are not authorized to do this action.
403	InvalidOperation.LimitQosUnsupported	The specified disk has limited bps or iops, can not do this operation.
403	InvalidOperation.AcrossRegionsOrZonesUnsupported	Migration across regions or available zones is not supported.
403	InvalidOperation.AttachedShareDisk	Attached share disk does not support this operation.	The attached shared disk does not support this operation.
404	InvalidDiskId.NotFound	The specified disk does not exist.	The specified disk does not exist. Check whether the disk ID is correct.
404	InvalidStorageClusterId.NotFound	The specified dedicated block storage cluster 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.