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

Altera o tipo de um disco ou modifica o nível de desempenho (PL) de um SSD corporativo (ESSD). SSDs corporativos regionais (ESSDs), discos básicos, discos efêmeros elásticos e discos locais não suportam alterações de tipo de disco.

Descrição da operação

Para minimizar o impacto das alterações de especificação em suas cargas de trabalho, realize as alterações durante horários de menor demanda.

Ao chamar esta operação, observe o seguinte:

Para modificar o nível de desempenho (PL) de um SSD corporativo (ESSD):
- SSDs corporativos (ESSDs) por assinatura suportam apenas upgrades de nível de desempenho (PL).
- SSDs corporativos (ESSDs) pós-pagos suportam upgrades e downgrades de nível de desempenho (PL), mas não podem sofrer downgrade para PL0.
- O SSD corporativo (ESSD) deve estar no estado Em uso (In_use) ou Disponível.
- Se o SSD corporativo (ESSD) estiver anexado a uma instância ECS, a instância deve estar no estado Em execução ou Parada. A instância não pode estar em estado expirado ou com pagamento em atraso.
- Como o nível de desempenho do ESSD está sujeito à capacidade do disco, se você não conseguir fazer o upgrade do nível de desempenho, expanda o disco (ResizeDisk) e tente novamente. Para mais informações, consulte SSD corporativo.
Para precauções sobre a alteração do tipo de disco, consulte Alterar o tipo de disco.
Para obter informações sobre as alterações de tipo de disco suportadas, consulte Alterações de tipo de disco suportadas.

Após uma alteração de tipo de disco, a cobrança muda da seguinte forma:

Discos pós-pagos: cobrados com base no novo tipo de disco.
Discos por assinatura: a taxa adicional é calculada com base na diferença de preço entre as configurações antiga e nova e os dias restantes no ciclo de cobrança (das 00:00 do dia seguinte até o fim do período de validade).

Para informações de cobrança sobre discos, consulte 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:ModifyDiskSpec

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.	d-bp131n0q38u3a4zi****
PerformanceLevel	string	Não	O novo nível de desempenho (PL) do SSD corporativo (ESSD). Valores válidos: PL0: IOPS máximo de leitura/gravação aleatória de 10.000 por disco. PL1: IOPS máximo de leitura/gravação aleatória de 50.000 por disco. PL2: IOPS máximo de leitura/gravação aleatória de 100.000 por disco. PL3: IOPS máximo de leitura/gravação aleatória de 1.000.000 por disco. Valor padrão: PL1.	PL2
DiskCategory	string	Não	O novo tipo de disco. Valores válidos: cloud_essd: SSD corporativo (ESSD). cloud_auto: disco ESSD AutoPL. cloud_ssd: SSD padrão. cloud_efficiency: disco ultra. Valor padrão: vazio, o que significa que nenhuma alteração de tipo de disco é realizada. Nota Os valores válidos acima estão listados em ordem decrescente de desempenho do disco. Se o disco especificado for um disco por assinatura, você não poderá fazer downgrade do tipo de disco.	cloud_essd
DryRun	boolean	Não	Especifica se deve ser realizado apenas um dry run para esta solicitação. Valores válidos: true: realiza um dry run. O sistema verifica se os parâmetros obrigatórios foram especificados, se o formato da solicitação é válido, se os limites de negócios são atendidos e se os recursos do ECS são suficientes. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for bem-sucedida, o código de erro DryRunOperation será retornado. false: executa a solicitação real. Após a aprovação na verificação, um código de status HTTP 2XX é retornado e a alteração do tipo de disco ou a modificação do nível de desempenho do ESSD é realizada. Valor padrão: false.	false
ProvisionedIops	integer	Não	Especifica se deve modificar o IOPS de leitura/gravação provisionado do disco ESSD AutoPL. Valores válidos: 0 a min{50.000, 1.000 × capacidade - desempenho de linha de base}. Desempenho de linha de base = min{1.800 + 50 × capacidade, 50.000}. Nota Este parâmetro é suportado apenas quando DiskCategory está definido como cloud_auto. Para mais informações, consulte Disco ESSD AutoPL e Modificar o desempenho provisionado de um disco ESSD AutoPL.	50000
PerformanceControlOptions	object	Não	A coleção de parâmetros de controle de desempenho do disco.
IOPS	integer	Não	O IOPS alvo do disco. Apenas o IOPS de discos de cluster de armazenamento em bloco dedicado pode ser modificado. Valores válidos: 900 até o IOPS máximo de um único disco, em incrementos de 100. Para mais informações, consulte Desempenho do disco.	2000
Recover	string	Não	Redefine o desempenho do disco. Este parâmetro é suportado apenas para discos de cluster de armazenamento em bloco dedicado. Se este parâmetro for especificado, os parâmetros PerformanceControlOptions.IOPS e PerformanceControlOptions.Throughput não terão efeito. Atualmente, apenas All é suportado, o que redefine o IOPS e a taxa de transferência do disco para seus valores iniciais.	All
Throughput	integer	Não	A taxa de transferência alvo do disco, em MB/s. Apenas a taxa de transferência de discos de cluster de armazenamento em bloco dedicado pode ser modificada. Valores válidos: 60 até a taxa de transferência máxima de um único disco. Para mais informações, consulte Desempenho do disco.	200
DestinationZoneId	string	Não	Nota Este parâmetro está atualmente em visualização por convite e não está disponível para uso.	cn-hangzhou-g

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
OrderId	string	O ID do pedido gerado. Nota Um ID de pedido é retornado apenas quando um disco por assinatura é alterado ou modificado.	20413515388****
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TaskId	string	O ID da tarefa de alteração de tipo de disco. Nota Este parâmetro não é retornado se você apenas modificou o nível de desempenho (PL) de um SSD corporativo (ESSD).	t-bp67acfmxazb4p****

Exemplos

Resposta de sucesso

JSON formato

{
  "OrderId": "20413515388****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TaskId": "t-bp67acfmxazb4p****"
}

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.	O parâmetro PerformanceLevel especificado é inválido.
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	InvalidPerformanceLevelParam.Mismatch	The specified parameter PerformanceLevel should be null when DiskCategory is not cloud_essd.
400	OperationDenied.DiskInDedicatedBlockStorageCluster	The disk in dedicated block storage cluster is not allowed to do this operation.
400	IncorrectDiskStatus.ReplicationStatusNotFound	Disk replication status not found.
400	IncorrectDiskStatus.InReplication	Disk already in replication.
400	ProvisionedIopsForDiskCategoryUnsupported	The specified disk category does not support provisioned iops.	O tipo de disco especificado não oferece suporte a IOPS provisionados.
400	InvalidProvisionedIops.LimitExceed	The provisioned iops exceeds the limit.	O parâmetro ProvisionedIops especificado excede o limite.
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	MalformedParameter.PerformanceControlOptions	Parameter invalid, %s.	O 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 de controle de desempenho do disco entram em conflito com o tipo de disco, o nível de desempenho do disco ou os parâmetros de IOPS provisionados.
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	InvalidOperation.InstanceStatusUnsupported	The specified instance status is not supported for this operation. The expected status is Running or Stopped.
400	MissingParameter.DestinationZoneId	The parameter DestinationZoneId must be specified when modifying the disk specification from a regional disk to a zone disk.	Ao alterar um disco regional para um disco de nível de zona, você deve especificar DestinationZoneId.
400	InvalidDestinationZoneId.Mismatch	The specified DestinationZoneId of the regional disk with 'In-use' status should remain consistent with the ZoneId of instance.	Ao realizar uma alteração de especificação em um disco regional anexado, o DestinationZoneId especificado deve ser o mesmo da zona da instância.
400	InvalidOperation.MultiAttachRegionalDiskUnsupported	The multi-attach regional disk with 'In-use' status attached to more than one instance is not allowed to modify disk spec.	Para realizar uma alteração de especificação em um disco regional de anexação múltipla anexado, o disco deve estar anexado a apenas uma instância.
400	InvalidDestinationZoneId.DiskCategoryUnsupported	The specified disk category does not allow the DestinationZoneId parameter for this operation.	O tipo de disco do disco especificado não suporta a especificação de DestinationZoneId durante uma alteração de especificação.
400	IncorrectInstanceStatus	The current status of the instance does not support this operation.	O status atual da instância não oferece suporte a esta operação.
400	InvalidOperation.DiskStatusNotSupported	The specified disk is not in a valid status for the current operation. Ensure the disk is in a valid status before you modify its specification.
500	InternalError	The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
403	DiskInArrears	The specified operation is denied because the disk has overdue payments. Please settle the outstanding balance.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
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	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	InvalidPerformanceLevel.TooLow	Specified new performance level is lower than the original performance level.
403	OperationDenied.PerformanceLevelNotMatch	The specified PerformanceLevel and disk size do not match.	O nível de desempenho especificado não corresponde ao tamanho do disco.
403	UserNotInTheWhiteList	The user is not in modify disk category white list.
403	InvalidRegion.NotSupport	The specified region does not support modify disk category.
403	InvalidDiskCategory.ValueNotSupported	The current disk category of the resource does not support this operation.	O tipo de disco do sistema e o tipo de disco de dados especificados não são suportados.
403	Downgrade.NotSupported	Downgrade operation for prepay resource is not supported.
403	InvalidInstanceType.NotSupportDiskCategory	The instanceType of the specified instance does not support this disk category.	O tipo de instância especificado (InstanceType) não oferece suporte à categoria de disco da instância atual. Tente um tipo de instância diferente. Para obter informações sobre os tipos de disco suportados por cada tipo de instância, consulte a documentação da família de instâncias.
403	ModifyingDiskCategoryLimitExceed	The amount of modifying disk category exceeds the limit.	O número de discos sendo redimensionados na região atual atingiu o limite máximo.
403	DiskInCoolingPeriod	There is a cooling period after the disk is successfully modified.	O disco está dentro de um período de espera para alteração de especificação e não pode ser redimensionado novamente.
403	DiskHasFlashSnapshot	The specified disk with flash snapshots do not support modify disk category.
403	NoChangeInDiskCategoryAndPerformanceLevel	There is no change between the parameters transmitted and the current.	A categoria e o nível de desempenho do disco especificados são os mesmos do disco atual.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	A categoria de disco especificada não existe na zona ou no cluster especificado, ou a zona especificada não corresponde ao cluster.
403	InvalidOperation.MultiAttachDisk	Multi attach disk does not support this operation.	Esta operação não é suportada para discos com multi-attach ativado.
403	OperationDenied.DiskExpansionUnfinished	The instance has not been restarted after a previous disk expansion.
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	InvalidPerformanceParameter.DiskNotInDedicatedStorageCluster	The specified disk is not in a dedicated storage cluster. Performance control options cannot be modified.
403	InvalidStatus.DiskUnderPerformanceControl	The specified disk is under performance control. Any modifications to the category or performance level of the specified disk are unsupported.
403	InvalidStatus.DiskNotReady	The specified disk is not ready. The status must be either In_use or Available.
403	InvalidOperation.DiskInReplicaPairsUnsupported	The disk in replication pairs does not support this operation.	Os discos em um par de replicação assíncrona não suportam alterações de tipo de disco.
403	InvalidDisk.DetachedSystemDisk	The specified resource is/has a detached system disk %s , not support current operation.	O disco especificado é um disco de sistema desanexado e não suporta a operação atual.
403	InvalidDiskCategory.InstanceTypeUnsupported	The current instance type does not support the specified disk category. Please check the list of disk category supported by the instance type and select an appropriate disk category for configuration.	O tipo de instância atual não suporta a categoria de disco especificada. Verifique a lista de tipos de disco suportados pelo tipo de instância e selecione uma categoria de disco válida.
403	InvalidOperation.CMKNotEnabled	The specified KMS key must be in an enabled state. Please enable the key in the KMS console and try again.
403	InvalidOperation.CMKUnauthorized	The specified KMS key is not authorized for the ECS service. Please grant the ECS service permission to use the key in the KMS console and try again.
403	InstanceLockedForSecurity	The instance is locked for security reasons. Please contact Security Technical Support for assistance.	A instância à qual o disco está anexado está bloqueada por motivos de segurança.
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.
404	InternalError	The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
404	InvalidDiskCategory.ValueUnauthorized	The specified DiskCategory is not authorized.
404	OperationDenied	The specified InstanceType or Zone is not available or not authorized.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.