Todos os produtos
Search
Central de documentação

:ResizeDisk

Última atualização: Jul 03, 2026

Redimensiona um disco de sistema ou disco de dados.

Observações de uso

Nota

Antes de chamar esta operação para redimensionar um disco, verifique o formato da partição do disco. Um disco com master boot record (MBR) não pode ser redimensionado para um tamanho superior a 2 TiB. Se você redimensionar um disco MBR para um tamanho maior que 2 TiB, poderá haver perda de dados. Caso precise redimensionar um disco MBR para mais de 2 TiB, recomendamos executar as seguintes etapas: crie outro disco de dados com tamanho superior a 2 TiB, particione e formate o novo disco de dados como uma tabela de partição GUID (GPT) e copie os dados do disco MBR para o novo disco de dados GPT. Para obter mais informações, consulte

Redimensionar discos offline

.

  • É possível redimensionar as seguintes categorias de discos: discos básicos (cloud), ultra discos (cloud_efficiency), SSDs padrão (cloud_ssd), SSDs aprimorados (ESSDs) (cloud_essd)

    、discos ESSD Entry (cloud_essd_entry)

    e discos ESSD AutoPL (cloud_auto).

  • Não é possível redimensionar um disco enquanto um snapshot está sendo criado para ele.

  • A instância à qual o disco está anexado deve estar no estado Running (Running) ou Stopped (Stopped).

  • Após redimensionar um disco, suas partições e sistemas de arquivos não são alterados automaticamente. É necessário alocar manualmente o espaço de armazenamento no disco após o redimensionamento.

  • Discos com o recurso multi-attach ativado suportam redimensionamento online e offline. Antes de redimensionar esses discos, certifique-se de que as instâncias às quais eles estão anexados estejam no estado Stopped (Stopped).

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action String Sim ResizeDisk

A operação a ser executada. Defina o valor como ResizeDisk.

DiskId String Sim d-bp67acfmxazb4p****

O ID do disco. Chame a operação DescribeDisks para consultar os IDs de disco disponíveis.

Type String Não offline

O método utilizado para redimensionar o disco. Valores válidos:

  • offline (padrão): redimensiona o disco offline. Após redimensionar um disco offline, reinicie a instância associada usando o console do Elastic Compute Service (ECS) ou chamando a operação RebootInstance para que o redimensionamento tenha efeito. Para saber como reiniciar uma instância ECS no console do ECS, consulte Reiniciar uma instância.
  • online: redimensiona o disco online. Após redimensionar um disco online, a operação entra em vigor imediatamente, sem necessidade de reiniciar a instância. Ultra discos, SSDs padrão e ESSDs podem ser redimensionados online.
NewSize Integer Sim 1900

A nova capacidade do disco. Unidade: GiB. Valores válidos:

  • Para disco de sistema:
    • Disco básico (cloud): 20 a 500.
    • Outras categorias de disco: 20 a 2048.
  • Para disco de dados:
    • Ultra disco (cloud_efficiency): 20 a 32768.
    • SSD padrão (cloud_ssd): 20 a 32768.
    • ESSD (cloud_essd): Os valores válidos dependem do valor de PerformanceLevel. Chame a operação DescribeDisks para consultar as informações do disco e verificar o valor de PerformanceLevel na resposta.
      • Valores válidos quando PerformanceLevel é PL0: 40 a 32768.
      • Valores válidos quando PerformanceLevel é PL1: 20 a 32768.
      • Valores válidos quando PerformanceLevel é PL2: 461 a 32768.
      • Valores válidos quando PerformanceLevel é PL3: 1261 a 32768.
    • Disco básico (cloud): 5 a 2000.
    • Disco ESSD AutoPL (cloud_auto): 40 a 32768.

A nova capacidade do disco deve ser maior que a capacidade original.

ClientToken String Não 123e4567-e89b-12d3-a456-426655440000

O token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o token, mas certifique-se de que ele seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não deve exceder 64 caracteres. Para obter mais informações, consulte Como garantir a idempotência.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

OrderId String 20413515388****

O ID do pedido.

Nota Este parâmetro é retornado apenas quando um disco por assinatura é redimensionado.
RequestId String F3CD6886-D8D0-4FEE-B93E-1B732396****

O ID da solicitação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=ResizeDisk
&DiskId=d-bp67acfmxazb4p****
&NewSize=1900
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ResizeDiskResponse>
    <OrderId>20413515388****</OrderId>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B732396****</RequestId>
</ResizeDiskResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "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 beyond the permitted range, or the capacity of snapshot exceeds the size limit of the specified disk category.

O parâmetro DataDisk.N.Size é inválido ou o tamanho do snapshot excede a capacidade máxima permitida para a categoria de disco especificada.

400

InvalidDataDiskCategory.ValueNotSupported

%s

Valor de DataDiskCategory inválido. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.

400

InvalidParameter.Conflict

%s

Um parâmetro especificado é inválido. Verifique se existem conflitos de parâmetros. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.

400

InvalidDataDiskSize.ValueNotSupported

%s

Valor de DataDiskSize inválido. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.

400

InvalidSystemDiskSize.ValueNotSupported

%s

Valor de SystemDisk.Size inválido.

400

IncompleteParamter

Some fields can not be null in this request.

Um parâmetro obrigatório não foi especificado.

400

InvalidRegionId.MalFormed

The specified RegionId is not valid.

Valor de RegionId inválido.

400

InvalidParam.Type

The specified type is not supported.

Valor de Type inválido.

400

LastOrderProcessing

The previous order is still processing, please try again later.

O pedido anterior ainda está sendo processado. Tente novamente mais tarde.

400

InvalidSystemDiskSize.ImageNotSupportResize

The specified image does not support resize.

A imagem especificada não suporta redimensionamento.

400

QuotaExceed.DiskCapacity

The used capacity of disk type has exceeded the quota in the zone, %s.

A capacidade dos discos pertencentes à categoria especificada excede o limite de cota da zona. Acesse o Quota Center para visualizar e aumentar a cota.

400

InvalidOperation.InstanceRenewWithDowngradeInPlan

The operation is denied due to the specified instance has renew with downgrade record in plan.

Pedidos de renovação e downgrade de configuração não entraram em vigor. Esta operação não pode ser executada antes que o pedido tenha efeito.

403

OperationDenied

The type of the disk does not support the operation.

A categoria do disco não suporta esta operação.

403

OperationDenied

The status of the disk or the instance that the disk is attaching with does not support the operation.

Não é possível executar a operação no disco ou na instância no estado atual.

403

InvalidDiskSize.TooSmall

Specified new disk size is less than the original disk size.

A nova capacidade de disco especificada é menor que a capacidade original do disco.

403

InvalidDiskSize.TooLarge

Specified new disk size is beyond the permitted range.

O novo tamanho de disco especificado está fora do intervalo permitido.

403

InstanceExpiredOrInArrears

The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).

A instância expirou ou possui pagamento pendente. Renove ou conclua o pagamento da instância antes de prosseguir.

403

DiskInArrears

The specified operation is denied as your disk owing fee.

Há um pagamento pendente para o disco especificado.

403

IncorrectInstanceStatus

The current status of the resource does not support this operation.

Não é possível executar a operação no recurso no estado atual.

403

DiskCreatingSnapshot

The operation is denied due to a snapshot of the specified disk is not completed yet.

Um snapshot está sendo criado para o disco especificado.

403

InvalidDiskSize

Specified new disk size is less than or equal the original disk size.

O novo tamanho do disco deve ser maior que o tamanho original.

403

Operation.Conflict

The operation may conflicts with others.

A operação entra em conflito com outras operações.

403

InstanceLockedForSecurity

The instance is locked due to security.

Não é possível executar esta operação no recurso bloqueado por motivos de segurança.

403

IncorrectDiskStatus

The current disk status does not support this operation.

Não é possível executar esta operação no disco no estado atual. Certifique-se de que o disco esteja disponível e sem pagamentos pendentes.

403

UserNotInTheWhiteList

The user is not in disk white list.

Você não tem autorização para gerenciar o disco. Tente novamente após obter a autorização necessária.

403

InvalidDiskCategory.NotSupported

The specified disk category is not supported.

A categoria de disco especificada não suporta esta operação.

403

InvalidRegion.NotSupport

The specified region does not support resize online.

O redimensionamento online não é suportado nesta região.

403

InvalidDiskCategory.NotSupported

The specified disk category does not support resize online.

A categoria de disco especificada não suporta redimensionamento online.

403

IncorrectInstanceStatus

The current status of the resource does not support resize online.

Não é possível executar esta operação no recurso no estado atual.

403

InvalidInstanceStatus.NotRunning

The status of instance to which the disk attachs must be running when resizing online.

A instância à qual o disco está anexado não está no estado Running durante o redimensionamento online.

403

InvalidParameter.KMSKeyId.CMKUnauthorized

The CMK needs to be added ECS tag.

Você não tem autorização para usar a chave mestra do cliente (CMK).

403

InvalidParameter.KMSKeyId.CMKNotEnabled

The CMK needs to be enabled.

A CMK não está habilitada quando o ID da CMK é especificado para um disco. Chame a operação DescribeKey do Key Management Service (KMS) para consultar as informações sobre a CMK especificada.

403

InvalidParameter.KMSKeyId.KMSUnauthorized

ECS service have no right to access your KMS.

O ECS não tem autorização para acessar seus recursos do KMS.

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.

Foram detectados riscos no seu cartão de crédito ou débito padrão. Clique em na URL no e-mail para realizar a verificação.

403

QuotaExceeded.PostpaidDataDiskCapacity

The quota of postpaid data disk capacity exceeds.

A capacidade dos discos de dados com pagamento conforme o uso excede o limite de cota.

403

InvalidOperation.MultiAttachDiskNotSupportResizeOnline

Multi attach disk does not support resize online.

O disco com o recurso multi-attach ativado não suporta redimensionamento online.

404

InvalidDiskId.NotFound

The specified disk does not exist.

O disco especificado não foi encontrado. Verifique se o ID do disco especificado é válido.

404

InvalidInstanceId.NotFound

The specified InstanceId does not exist.

A instância não foi encontrada. Verifique se o ID da instância está correto.

500

InternalError

The request processing has failed due to some unknown error.

Ocorreu um erro interno. Tente novamente mais tarde.

500

InternalError

The request processing has failed due to some unknown error, exception or failure.

Ocorreu um erro interno. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.