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

Expande a capacidade de um disco, incluindo discos do sistema e discos de dados.

Descrição da operação

Nota

Antes de expandir um disco, consulte o formato de partição do disco. Se o disco usar o formato de partição MBR, você não poderá expandir o disco para mais de 2 TiB. Caso contrário, poderá ocorrer perda de dados. Para expandir um disco particionado em MBR, crie e anexe um novo disco de dados que use o formato GUID Partition Table (GPT) e, em seguida, copie os dados existentes para o novo disco de dados. Para mais informações, consulte Expandir um disco.

Os tipos de disco suportados incluem discos básicos (cloud), discos ultra (cloud_efficiency), SSDs padrão (cloud_ssd), SSDs corporativos (cloud_essd), discos ESSD AutoPL (cloud_auto), discos efêmeros elásticos - Standard (elastic_ephemeral_disk_standard), discos efêmeros elásticos - Premium (elastic_ephemeral_disk_premium) e ESSDs regionais (cloud_regional_disk_auto).
Discos para os quais snapshots estão sendo criados não podem ser expandidos. Aguarde até que a criação do snapshot seja concluída antes de expandir o disco.
Esta operação não expande partições ou sistemas de arquivos. Após expandir a capacidade do disco, você deve alocar manualmente as partições e os sistemas de arquivos. Para mais informações, consulte Expandir partições e sistemas de arquivos (Linux) e Expandir partições e sistemas de arquivos (Windows).
Discos com o recurso de multi-attach ativado suportam expansão online e offline. Certifique-se de que as instâncias às quais o disco está anexado atendam aos seguintes requisitos:
- Para expansão online, o status da instância deve ser Running (Running).
- Para expansão offline, o status da instância deve ser Running (Running) ou Stopped (Stopped).
Certifique-se de que o disco atenda aos seguintes requisitos:
- O disco está no estado In Use (In Use) ou Available (Available).
- (Altamente recomendado) Um snapshot foi criado para o disco para fazer backup dos dados. Para mais informações, consulte Criar um snapshot.
- Se o disco de dados foi adquirido recentemente, inicialize o disco antes de expandi-lo. Para mais informações, consulte Visão geral da inicialização.

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

update

*Disco.

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. Você pode chamar DescribeDisks para consultar os IDs dos discos.	d-bp67acfmxazb4p****
Type	string	Não	O método usado para expandir o disco. Valores válidos: offline (padrão): expansão offline. Após a expansão, você deve reiniciar a instância no console seguindo as instruções em Reiniciar uma instância ou chamando a operação RebootInstance para que as alterações tenham efeito. online: expansão online. A expansão entra em vigor sem reiniciar a instância. Os tipos de disco suportados incluem discos ultra, SSDs padrão, SSDs corporativos e discos efêmeros elásticos.	offline
NewSize	integer	Sim	A nova capacidade para a qual você deseja expandir o disco. Unidade: GiB. Valores válidos: Disco do sistema: Disco básico: 20 a 500. SSD corporativo: PL0: 1 a 2048. PL1: 20 a 2048. PL2: 461 a 2048. PL3: 1261 a 2048. Disco ESSD AutoPL: 1 a 2048. Outros tipos de disco: 20 a 2048. Disco de dados: Disco ultra (cloud_efficiency): 20 a 32768. SSD padrão (cloud_ssd): 20 a 32768. SSD corporativo (cloud_essd): Os valores válidos dependem do valor de `PerformanceLevel`. Você pode chamar DescribeDisks para consultar as informações do disco e verificar o parâmetro `PerformanceLevel` na resposta. PL0: 1 a 65536. PL1: 20 a 65536. PL2: 461 a 65536. PL3: 1261 a 65536. Disco básico (cloud): 5 a 2000. Disco ESSD AutoPL (cloud_auto): 1 a 65536. Disco efêmero elástico - Standard (elastic_ephemeral_disk_standard): 64 a 8.192. Disco efêmero elástico - Premium (elastic_ephemeral_disk_premium): 64 a 8.192. Nota A nova capacidade do disco especificada deve ser maior que a capacidade original do disco. Caso contrário, um erro será retornado.	1900
ClientToken	string	Não	O token do 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 único entre diferentes solicitações. O valor 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

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
OrderId	string	O ID do pedido. Nota Um ID de pedido é retornado apenas quando você expande um disco por assinatura.	20413515388****
RequestId	string	O ID da solicitação.	F3CD6886-D8D0-4FEE-B93E-1B732396****

Exemplos

Resposta de sucesso

JSON formato

{
  "OrderId": "20413515388****",
  "RequestId": "F3CD6886-D8D0-4FEE-B93E-1B732396****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidDataDiskSize.ValueNotSupported	The specified DataDisk.n.Size is beyond the permitted range; or the capacity of the snapshot exceeds the size limit of the specified disk category.
400	InvalidParameter.Conflict	%s	Os parâmetros estão em conflito.
400	IncompleteParamter	Some fields can not be null in this request.	Um parâmetro obrigatório está ausente na solicitação.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.
400	InvalidParam.Type	The specified type is not supported.	O parâmetro Type especificado é inválido.
400	LastOrderProcessing	The previous order is still processing. Please try again later.	A solicitação está sendo processada. Tente novamente mais tarde.
400	InvalidStatus.Upgrading	The instance which the disk attachs is upgrading; please try again later.
400	InvalidSystemDiskSize.ImageNotSupportResize	The image of the instance does not support resize.
400	InvalidDisk.DetachedSystemDisk	The specified disk is a detached system disk. This operation is not supported.
400	OperationDenied.NotEnoughCapacity	The capacity of the current dedicated block storage cluster is not enough to expand.
400	IncorrectDiskStatus.ReplicationStatusNotFound	Disk replication status not found.
400	IncorrectDiskStatus.InReplication	Disk already in replication.
400	QuotaExceed.DiskCapacity	The used capacity of disk type has exceeded the quota in the zone, %s.	A capacidade utilizada do tipo de disco especificado excede o limite de cota da zona. Acesse o Quota Center para consultar e solicitar um aumento na cota de capacidade do disco.
400	NoPermission.Price	The operation requires price permission. Please either apply for permission from your main account or set the parameter AutoPay to true.
400	NoPermission.Refund	The operation requires refund permission. Please apply for permission from your main account.	A conta não tem permissão para realizar um reembolso. A conta principal deve conceder as permissões relacionadas ao reembolso.
400	InvalidOperation.InstanceRenewWithDowngradeInPlan	The operation is denied due to the specified instance has renew with downgrade record in plan.	Existe um pedido de renovação e downgrade não efetivado. Esta operação não é permitida antes que o pedido entre em vigor.
400	InvalidSystemDiskSize.ValueNotSupported	The specified system disk size is invalid.	O SystemDisk.Size especificado é inválido.
400	OperationDenied.UnfinishedOrder	The current instance has an unfinished refund order. This operation is denied.
400	AccountForbidden.CreateOrder	Order cannot be created due to abnormal account.	A conta atual não tem permissão para criar pedidos.
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.
500	InternalError	The request processing has failed due to some unknown error.
403	InvalidDataDiskSize.ValueNotSupported	The specified DataDisk.n.Size is beyond the permitted range; or the capacity of the snapshot exceeds the size limit of the specified disk category.
403	OperationDenied	The type of the disk does not support the operation.	O snapshot especificado não permite a criação de volumes de dados.
403	InvalidDiskSize.TooSmall	Specified new disk size is less than the original disk size.
403	InvalidDiskSize.TooLarge	Specified new disk size is beyond the permitted range.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403	DiskError	Incorrect disk status.
403	DiskInArrears	The specified operation is denied because the disk has overdue payments. Please settle the outstanding balance.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	DiskCreatingSnapshot	The operation is denied due to a snapshot of the specified disk is not completed yet.
403	InvalidDiskSize	Specified new disk size is less than or equal the original disk size.	O novo tamanho de disco especificado deve ser maior que o tamanho original do disco.
403	Operation.Conflict	The operation may conflict with others. Please retry later.
403	InstanceLockedForSecurity	The instance is locked due to security.	A instância à qual o disco está anexado está bloqueada por motivos de segurança.
403	IncorrectDiskStatus	The current disk status does not support this operation.
403	UserNotInTheWhiteList	The user is not in disk white list.	O usuário não está na lista de permissões do Shared Block Storage. Abra um ticket para solicitar a inclusão na lista de permissões.
403	InvalidDiskCategory.NotSupported	The specified disk category is not supported.	A categoria de disco especificada não é compatível com o tipo de instância.
403	InvalidRegion.NotSupport	The specified region does not support resize online.	A região especificada não é suportada.
403	InvalidInstanceStatus.NotRunning	The status of instance to which the disk attachs must be running when resizing online.	O status atual da instância não suporta esta operação. Execute esta operação quando o status da instância for Running.
403	InvalidOperation.InstanceTypeNotSupportOnlineResize	The instance type of the specified instance does not support resize online.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK has not authorized the ECS service to perform the KMS TagResource and UntagResource operations. Please verify the authorization and try again.
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	InstanceSpecModification.NotEffective	The instance which the disk attachs has been reserved for making a spec modification and not taken effective in the current contract period.
403	InvalidDiskSize.NotSupportResizeOnline	The current size of the resource does not support resize online.
403	SecurityRisk.3DVerification	We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email.	Um risco de segurança foi detectado no seu cartão de crédito ou débito padrão. Verifique sua identidade usando o link no e-mail.
403	QuotaExceeded.PostpaidDataDiskCapacity	The quota of postpaid data disk capacity exceeds.	A capacidade utilizada dos discos de dados pós-pagos excede a cota.
403	InvalidOperation.MultiAttachDiskNotSupportResizeOnline	Multi attach disk does not support resize online.	A expansão online não é suportada para discos com multi-attach ativado.
403	InvalidDataDiskCategory.ValueNotSupported	The specified Category of Data Disk is not valid.	O parâmetro DataDisk.n.Category especificado é inválido.
403	InvalidDiskSize.NotSupportMultiAttachDisk	The specified disk size exceeds the maximum limit 65536 for enabling multi-attach.	Discos maiores que 64 TB não oferecem suporte à anexação múltipla.
404	InvalidDiskId.NotFound	The specified disk does not exist.	O disco especificado não existe. Verifique se o ID do disco está correto.
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.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.