ModifyDiskSpec - : Central de Documentação do Alibaba Cloud

Observações de uso

Observe os seguintes itens:

Para modificar o nível de desempenho de um ESSD, atente-se aos pontos abaixo:
- Em um ESSD por assinatura, é possível apenas aumentar o nível de desempenho.
- Em um ESSD com pagamento conforme o uso, você pode aumentar ou reduzir o nível de desempenho. No entanto, não é permitido reduzir o nível para PL0.
- O ESSD deve estar no estado In Use (In_Use) ou Unattached (Available).
- Se o ESSD estiver anexado a uma instância do Elastic Compute Service (ECS), a instância precisa estar no estado Running (Running) ou Stopped (Stopped). A instância não pode estar expirada nem parada devido a pagamentos pendentes.
- Se não for possível aumentar o nível de desempenho devido ao limite de capacidade, redimensione o ESSD chamando a operação ResizeDisk e tente novamente. Para mais detalhes, consulte ESSDs.
Para obter informações sobre os limites de alteração da categoria de um disco, visualize a seção "Limites" em Alterar a categoria de um disco.

A nova categoria ou nível de desempenho do disco entra em vigor imediatamente após a execução desta operação. O Alibaba Cloud calcula a fatura com base na nova categoria e no novo nível de desempenho do disco.

Depuração

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

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifyDiskSpec	A operação a ser executada. Defina o valor como ModifyDiskSpec.
DiskId	String	Sim	d-bp131n0q38u3a4zi****	O ID do disco.
PerformanceLevel	String	Não	PL2	O novo nível de desempenho do ESSD. Valores válidos: PL0: Um único ESSD oferece até 10000 IOPS de leitura/gravação aleatória. PL1: Um único ESSD oferece até 50000 IOPS de leitura/gravação aleatória. PL2: Um único ESSD oferece até 100000 IOPS de leitura/gravação aleatória. PL3: Um único ESSD oferece até 1000000 IOPS de leitura/gravação aleatória. Valor padrão: PL1.
DiskCategory	String	Não	cloud_essd	A nova categoria do disco. Valores válidos: cloud_essd: ESSD cloud_auto: Disco ESSD AutoPL cloud_ssd: SSD padrão cloud_efficiency: Disco ultra Este parâmetro está vazio por padrão, o que indica que a categoria do disco não será alterada. Nota Os valores acima estão listados em ordem decrescente de desempenho do disco. Discos por assinatura não podem ter seu nível reduzido.
DryRun	Boolean	Não	false	Define se deve ser executada apenas uma simulação, sem realizar a solicitação real. Valores válidos: true: executa apenas a simulação. O sistema verifica a solicitação quanto a possíveis problemas, incluindo valores de parâmetros ausentes, sintaxe incorreta, limites de serviço e recursos insuficientes do Elastic Compute Service (ECS). Se a solicitação falhar na simulação, uma mensagem de erro será retornada. Caso seja aprovada, o código de erro `DryRunOperation` será retornado. false: executa a simulação e realiza a solicitação real. Se a solicitação passar na simulação, um código de status HTTP 2xx será retornado e a operação será executada. Valor padrão: false.
ProvisionedIops	Long	Não	50000	As IOPS provisionadas de leitura/gravação do disco ESSD AutoPL. Valores válidos: 0 a min{50000, 1000 × Capacidade - IOPS Base}. IOPS Base = min{1800 + 50 × Capacidade, 50000}. Nota Este parâmetro está disponível somente se DiskCategory estiver definido como cloud_auto. Para mais informações, consulte Discos ESSD AutoPL e Modificar as configurações de desempenho de um disco ESSD AutoPL.
PerformanceControlOptions.IOPS	Integer	Não	2000	As novas IOPS do disco. É possível modificar as IOPS apenas de discos em clusters de armazenamento em bloco dedicado. Valores válidos: 900 até o máximo de IOPS por disco (com incremento de 100). Para mais informações, consulte Desempenho de armazenamento em bloco.
PerformanceControlOptions.Throughput	Integer	Não	200	O novo throughput do disco. A modificação do throughput é permitida apenas para discos em clusters de armazenamento em bloco dedicado. Unidade: MB/s. Valores válidos: 60 até o throughput máximo por disco. Para mais informações, consulte Desempenho de armazenamento em bloco.
PerformanceControlOptions.Recover	String	Não	All	Indica se as IOPS e o throughput do disco devem ser redefinidos. Este parâmetro é válido apenas quando o disco pertence a um cluster de armazenamento em bloco dedicado. Ao especificar este parâmetro, PerformanceControlOptions.IOPS e PerformanceControlOptions.Throughput não terão efeito. Defina o valor como All para redefinir as IOPS e o throughput do disco para os valores iniciais.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.
TaskId	String	t-bp67acfmxazb4p****	O ID da tarefa de alteração de categoria do disco. Nota Se você modificar apenas o nível de desempenho de um ESSD, este parâmetro não será retornado.
OrderId	String	20413515388****	O ID do pedido. Nota Este parâmetro é retornado apenas quando a categoria de um disco por assinatura ou o nível de desempenho de um ESSD por assinatura é modificado.

Exemplos

Exemplos de solicitações

http(s)://ecs.aliyuncs.com/?Action=ModifyDiskSpec
&ResourceOwnerId=123
&DiskId=d-bp131n0q38u3a4zi****
&PerformanceLevel=PL2
&DiskCategory=cloud_essd
&DryRun=false
&ProvisionedIops=50000
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifyDiskSpecResponse>
    <TaskId>t-bp67acfmxazb4p****</TaskId>
    <RequestId>5B38289D-88AB-42BD-B021-12FC6942F099</RequestId>
    <OrderId>20413515388****</TaskId>
</ModifyDiskSpecResponse>

Formato JSON

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

{
  "TaskId" : "t-bp67acfmxazb4p****",
  "RequestId" : "5B38289D-88AB-42BD-B021-12FC6942F099",
  "OrderId" : "20413515388****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidPerformanceLevel.Malformed	The specified parameter PerformanceLevel is not valid.	Valor inválido para PerformanceLevel.
400	ProvisionedIopsForDiskCategoryUnsupported	The specified disk category does not support provisioned iops.	A categoria do disco não suporta IOPS provisionadas.
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	MalformedParameter.PerformanceControlOptions	Parameter invalid, %s.	Valor de parâmetro inválido.
400	InvalidPerformanceControlOptions.ModifyOperationUnsupported	The specified performance control options are conflicts with disk category or performance level or ProvisionIOPS.	Os parâmetros com prefixo PerformanceControlOptions entram em conflito com a categoria do disco, o nível de desempenho ou as IOPS provisionadas.
400	InvalidOperation.InstanceRenewWithDowngradeInPlan	The operation is denied due to the specified instance has renew with downgrade record in plan.	Existem pedidos pendentes de renovação com redução de configuração para a instância. Esta operação não pode ser realizada antes que esses pedidos entrem em vigor.
403	DiskInArrears	The specified operation is denied as your disk owing fee.	Há pagamentos pendentes para o disco especificado.
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 pagamentos pendentes. Renove ou conclua o pagamento da instância e tente novamente.
403	IncorrectDiskStatus	The current disk status does not support this operation.	Não é possível executar esta operação no estado atual do disco. Verifique se o disco está disponível e se não há pagamentos pendentes.
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	OperationDenied	The type of the disk does not support the operation.	A categoria do disco especificado não suporta esta operação.
403	OperationDenied.PerformanceLevelNotMatch	The specified PerformanceLevel and disk size do not match.	O nível de desempenho especificado e o tamanho do disco não correspondem entre si.
403	InvalidInstanceType.NotSupportDiskCategory	The instanceType of the specified instance does not support this disk category.	O tipo de instância especificado por InstanceType não suporta a categoria deste disco. Tente outro tipo de instância. Para informações sobre as categorias de disco suportadas, consulte a documentação da família de instâncias.
403	ModifyingDiskCategoryLimitExceed	The amount of modifying disk category exceeds the limit.	O número máximo de discos com alterações de configuração em andamento na região foi excedido.
403	DiskInCoolingPeriod	There is a cooling period after the disk is successfully modified.	O disco está em um período de limitação pós-alteração e não pode sofrer novas modificações durante este intervalo.
403	NoChangeInDiskCategoryAndPerformanceLevel	There is no change between the parameters transmitted and the current.	A categoria e o nível de desempenho especificados são idênticos aos valores atuais do disco.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	Os recursos solicitados estão indisponíveis na zona especificada. Tente outro tipo de instância ou zona. Chame a operação DescribeZones para consultar os recursos disponíveis.
403	InvalidOperation.MultiAttachDisk	Multi attach disk does not support this operation.	Discos com o recurso de montagem múltipla ativado não suportam esta operação.
403	InvalidDiskCategory.NotSupported	The specified disk category is not supported.	A categoria de disco especificada não é suportada.
403	InvalidPerformanceParameter.DiskNotInDedicatedStorageCluster	The specified disk not in dedicated storage cluster, can not modify performance control options.	Discos fora de clusters de armazenamento em bloco dedicado não suportam parâmetros com prefixo PerformanceControlOptions.
403	InvalidStatus.DiskUnderPerformanceControl	The specified disk is under performance control, any modifications to the category or performance level of the specified disk are unsupported..	Não é possível modificar a categoria ou o nível de desempenho enquanto parâmetros com prefixo PerformanceControlOptions estiverem especificados.
403	InvalidStatus.DiskNotReady	This specified disk is not ready, status needs to be either In_use or Available.	O disco especificado deve estar no estado In_use ou Available.
404	InvalidDiskId.NotFound	The specified disk does not exist.	O disco especificado não foi encontrado. Verifique se o ID do disco é 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, 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.