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

Modifica o tipo de instância de uma instância ECS de assinatura. Você pode fazer upgrade ou downgrade do tipo de instância. O novo tipo de instância entra em vigor durante todo o ciclo de vida da instância.

Descrição da operação

Antes de chamar esta operação, certifique-se de que você compreende totalmente os métodos de cobrança, os preços e as regras de reembolso por downgrade do ECS.

Esta operação é assíncrona. A alteração de configuração entra em vigor após aproximadamente 5 a 10 segundos. Antes de fazer upgrade ou downgrade do tipo de instância ECS de uma instância ECS de assinatura, você pode chamar DescribeResourcesModification para consultar os tipos de instância ECS para os quais a instância atual pode ser alterada.

Precauções

Se a propriedade NVMe dos tipos de instância de origem e destino forem diferentes (o campo NvmeSupport retornado por DescribeInstanceTypes) e o sistema operacional for Windows (o campo OSType retornado por DescribeInstances), conclua as medidas preventivas antes de realizar o Upgrade/Downgrade.
Instâncias expiradas não podem ser alteradas para um tipo de instância diferente. Conclua a renovação e tente novamente.
Downgrade do tipo de instância:
- A instância deve estar no estado Parada (Stopped).
- A diferença de preço entre o tipo de instância original e o novo é reembolsada ao seu método de cobrança original. Vouchers utilizados não são reembolsáveis. O pagador recebe o reembolso.
- O novo tipo de instância entra em vigor somente após você iniciar a instância após o Upgrade/Downgrade.
Upgrade do tipo de instância:
- A instância deve estar no estado Parada (Stopped) ou Em execução (Running).
- O novo tipo de instância entra em vigor somente após você iniciar a instância ou reiniciar a instância.

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

update

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância.	i-bp67acfmxazb4ph****
RegionId	string	Sim	O ID da região da instância. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
InstanceType	string	Sim	O tipo de instância de destino para o Upgrade/Downgrade. Para mais informações, consulte Família de instâncias ou invoque DescribeInstanceTypes.	ecs.g5.xlarge
OperatorType	string	Não	O tipo da operação. Valores válidos: Nota Este parâmetro é opcional. O sistema pode determinar automaticamente se a operação é um upgrade ou um downgrade. Se você enviar este parâmetro, siga as regras abaixo. upgrade: faz upgrade do tipo de instância. Certifique-se de que o saldo do seu método de pagamento da conta seja suficiente. downgrade: faz downgrade da cota do tipo de instância. Quando o tipo de instância especificado por `InstanceType` for inferior ao tipo de instância atual, defina `OperatorType` como `downgrade`. Nota Para precauções sobre upgrade ou downgrade de tipos de instância, consulte a seção de descrição da operação acima.	upgrade
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 de ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000
AutoPay	boolean	Não	Especifica se o pagamento deve ser concluído automaticamente ao fazer upgrade do tipo de instância. Valores válidos: true: O pagamento é concluído automaticamente. false: Apenas um pedido é criado. Nenhum pagamento é realizado. Valor padrão: true. Nota Se o pagamento automático estiver ativado, certifique-se de que seu método de pagamento tenha saldo suficiente. Caso contrário, um pedido anormal será gerado e você só poderá cancelar o pedido. Se o saldo do seu método de pagamento for insuficiente, você pode definir `AutoPay` como `false` para gerar um pedido não pago. Em seguida, você pode fazer login no console do ECS para pagar o pedido. Quando `OperatorType` é definido como `downgrade`, o parâmetro `AutoPay` é ignorado.	true
MigrateAcrossZone	boolean	Não	Especifica se deve suportar alterações de tipo de instância entre clusters. Valores válidos: true: suportado. false: não suportado. Valor padrão: false. Quando o parâmetro `MigrateAcrossZone` é definido como `true`, observe os seguintes itens após realizar a otimização na instância do Elastic Compute Service com base na resposta: Instâncias do tipo VPC: Para tipos de instância descontinuados, quando uma instância não otimizada para I/O é alterada para uma instância otimizada para I/O, os nomes dos dispositivos de disco e os códigos de autorização de software do servidor são alterados. Para instâncias Linux, discos básicos (cloud) são identificados como xvda ou xvdb. Ultra discos (cloud_efficiency) e SSDs padrão (cloud_ssd) são identificados como vda ou vdb.	false
SystemDisk.Category	string	Não	A nova categoria do disco do sistema. Valores válidos: cloud_efficiency: ultra disco. cloud_ssd: SSD padrão. Nota Este parâmetro é válido somente quando você realiza um aumento de cota de um tipo de instância descontinuado para uma família de instâncias normal e altera uma instância não otimizada para I/O para uma instância otimizada para I/O.	cloud_efficiency
RebootTime	string	Não	O horário de reinicialização da instância. Especifique o horário no padrão ISO 8601 no formato yyyy-MM-ddTHH:mmZ. O horário deve estar em UTC.	2018-01-01T12:05Z
EndTime	string	Não	O horário de término da alteração temporária do tipo de instância. Especifique o horário no padrão ISO 8601 no formato yyyy-MM-ddTHH:mmZ. O horário deve estar em UTC.	2018-01-01T12:05Z
RebootWhenFinished	boolean	Não	Especifica se a instância deve ser reiniciada imediatamente após a conclusão da alteração do tipo de instância. Valores válidos: true: A instância é reiniciada imediatamente. false: A instância não é reiniciada. Valor padrão: false. Nota Se a instância estiver no estado Parada, ela permanecerá parada mesmo que você defina `RebootWhenFinished` como `true`. Nenhuma operação é realizada.	false
ModifyMode	string	Não	Nota Este parâmetro não está disponível publicamente.	null
Disk	array<object>	Não	Nota Este parâmetro não está disponível publicamente.
	object	Não	Nota Este parâmetro não está disponível publicamente.
DiskId	string	Não	Nota Este parâmetro não está disponível publicamente.	null
Category	string	Não	Nota Este parâmetro não está disponível publicamente.	null
PerformanceLevel	string	Não	Nota Este parâmetro não está disponível publicamente.	null

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
OrderId	string	O ID do pedido.	1234567890
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

{
  "OrderId": "1234567890",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	O tipo de instância especificado não suporta o tipo de disco em nuvem de dados anexado à instância atual.
400	InvalidBillingMethod.ValueNotSupported	The operation is not permitted due to an invalid billing method of the instance.	A operação não é permitida porque o método de cobrança da instância é inválido.
400	InvalidInstance.PurchaseNotFound	The specified instance has no purchase history.	A instância especificada não pode ser adquirida.
400	InvalidInstance.UnpaidOrder	The specified instance has unpaid order.
400	InvalidInstanceType.NotSupported	The specified InstanceType is not Supported.
400	OrderCreationFailed	Order creation failed, please check your params and try it again later.	Falha ao criar o pedido. Verifique seus parâmetros e tente novamente.
400	Throttling	You have made too many requests within a short time; your request is denied due to request throttling.	A solicitação foi limitada. Use o método de paginação baseado em NextToken em vez do método de paginação baseado em PageNumber para consultas.
400	Account.Arrearage	Your account has an outstanding payment.	Sua conta possui pagamentos pendentes.
400	InvalidInstanceId.NotFound	The specified InstanceId does not exist.
400	InvalidRebootTime.MalFormed	The specified rebootTime is not valid.	O horário de reinicialização especificado está fora do intervalo válido.
400	InvalidRebootTime.ValueNotSupported	The specified RebootTime is not valid.	O horário de reinicialização especificado está fora do intervalo válido.
400	IdempotenceParamNotMatch	Request uses a client token in a previous request but is not identical to that request.	Os parâmetros de idempotência não correspondem.
400	InvalidInstanceChargeType.ValueNotSupported	%s	O método de cobrança da instância especificada não é suportado.
400	InvalidStatus.NotStopped	Instance status must be stopped.	A instância deve estar no estado Stopped antes de realizar esta operação.
400	InvalidAction	%s	O tipo de operação especificado não é suportado.
400	InstanceDowngrade.QuotaExceed	Quota of instance downgrade is exceed.	A cota de downgrade da instância foi excedida. Esta operação não pode ser realizada.
400	InvalidParameter	%s	A combinação de parâmetros especificada é inválida.
400	OperationDenied	The current user does not support this operation.	O EIP especificado está indisponível ou não autorizado.
400	LastOrderProcessing	The previous order is still processing, please try again later.	O pedido está sendo processado. Tente novamente mais tarde.
400	InvalidOperation.VpcHasEnabledAdvancedNetworkFeature	The specified vpc has enabled advanced network feature.	A VPC possui recursos avançados ativados. Você não pode criar instâncias ECS de baixa especificação nesta VPC.
400	InvalidAction.WithActiveElasticUpgrade	The instance has active Elastic Upgrade.
400	InstanceTypeNotSupported.TooManyDisksAttached	%s
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 excedeu o limite de cota da zona ativa. Acesse o Quota Center para consultar e solicitar um aumento de cota de capacidade de disco.
400	MissingParameter.DiskCategory	The specified parameter Disk.Category can not be null when Disk.DiskId is specified.
400	InvalidParameter.DiskCategory	The specified parameter Disk.Category is not valid.
400	InvalidPerformanceLevel.Malformed	The specified parameter Disk.n.PerformanceLevel is not valid.
400	InvalidSystemDiskCategory.NotMatchInstanceType	The system disk category does not match the instance type.	A categoria do disco do sistema não corresponde ao tipo de instância.
400	QuotaExceed.RufundVcpu	The maximum number of refunded vcpu is exceeded: %s .	A cota de vCPUs na regra de reembolso excede o limite máximo. Para limites específicos, consulte as informações reais no placeholder %s na mensagem de erro.
400	NoPermission.Price	The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true.	Esta operação requer permissões de precificação. Solicite permissões à sua conta Alibaba Cloud ou defina o parâmetro AutoPay como true para pagamento automático.
400	NoPermission.Refund	The operation requires refund permission. Please apply for permission from your main account.	Esta conta não tem permissão para processar reembolsos. A conta principal deve conceder permissões relacionadas a reembolsos.
400	InvalidInstanceStatus	The current status of the instance does not support this operation.
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 que ainda não entrou em vigor. Esta operação não é permitida antes que o pedido entre em vigor.
400	InvalidOperation.OnlineModificationUnsupported	Online modification of instance type is not supported for the specified instance due to its CPU topology.	O tipo de topologia de CPU atual não suporta alterações de especificação a quente.
400	InvalidInstanceType.NotSupportCpuOptionsNestedVirtualization	The specified instance type does not support CpuOptions.NestedVirtualization: %s.	O tipo de instância atual não suporta a capacidade de virtualização aninhada especificada.
401	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	O tipo de instância especificado não existe, ou você não tem permissões para gerenciar instâncias deste tipo.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro ao enviar a solicitação. Tente novamente mais tarde.
500	ImageOrderFailed	Create marketplace image order failed.	Falha ao criar o pedido do Alibaba Cloud Marketplace. Envie um ticket.
403	OperationDenied.NoStock	The specified instance is out of usage.	O tipo de instância atual está esgotado.
403	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.
403	InvalidUser.PassRoleForbidden	The RAM user does not have privilege to pass a role.	O usuário RAM não possui a permissão PassRole para atribuir a função RAM da instância.
403	ImageNotSupportInstanceType	The specified image does not support the specified InstanceType.	A imagem especificada não oferece suporte a instâncias do tipo de instância selecionado.
403	InstanceType.Offline	%s	O tipo de instância especificado foi descontinuado.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	Throttling	You have made too many requests within a short time; your request is denied due to request throttling.
403	InvalidParameter.InstanceId	%s	O parâmetro especificado InstanceId é inválido.
403	OperationDenied	%s
403	InvalidInstanceStatus	The current status of the instance does not support this operation.	O estado atual da instância não suporta esta operação.
403	InvalidOperation.StarterPackage	StarterPackage not support modification.
403	InvalidInstance.PreInstanceExpired	Instance business status is not Expired.
403	InvalidInstance.EipNotSupport	The special instance with eip not support operate, please unassociate eip first.	Esta operação não é suportada para instâncias associadas a um EIP. Desassocie o EIP primeiro.
403	OperationDenied.ImageNotValid	The specified image is not authorized.
403	OperationDenied.LocalDiskUnsupported	The configuration change is not allowed when the specified instance has local disks mounted.	Alterações de especificação não são suportadas para instâncias com discos locais anexados.
403	InvalidOperation.EniCountExceeded	%s
403	InvalidOperation.Ipv4CountExceeded	%s	O número de endereços IPv4 nas Interfaces de Rede Elásticas (ENIs) anexadas à instância ECS atual excede o limite do tipo de instância de destino.
403	InvalidOperation.Ipv6CountExceeded	%s	O número de endereços IPv6 nas Interfaces de Rede Elásticas (ENIs) anexadas à instância ECS atual excede o limite do tipo de instância de destino.
403	InvalidOperation.Ipv6NotSupport	%s	O tipo de instância atual não suporta IPv6.
403	InvalidOperation.Ipv4NotSupport	%s
403	InvalidInstance.NotFoundSystemDisk	The specified instance has no system disk.
403	InvalidInstanceType.NotSupportDiskCategory	The instanceType of the specified instance does not support this disk category.	O tipo de instância especificado (InstanceType) não suporta a categoria de disco da instância atual. Tente um tipo de instância diferente. Para 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	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	O uso do ECS excede a cota. Faça login no Console de Gerenciamento da Alibaba Cloud e envie uma solicitação para aumentar a cota.
403	InvalidResourceType.NotSupported	%s	A combinação de recursos especificada não existe. Tente uma zona ou tipo de instância diferente.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	O número de filas da Elastic Network Interface (ENI) excede o limite máximo. Para mais informações, consulte o resultado real retornado do placeholder %s na mensagem de erro.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	O número total de filas da Elastic Network Interface (ENI) excede o limite superior. Para mais informações, consulte o valor de retorno real do placeholder %s na mensagem de erro.
403	InvalidParameter.InvalidEniQueueNumber	%s	O número de filas do controlador de interface de rede (NIC) está incorreto. Para mais informações, consulte o resultado real retornado do placeholder %s na mensagem de erro.
403	HibernationConfigured.InstanceOperationForbidden	The operation is not permitted due to limit of the hibernation configured instance.	A operação não é permitida porque a instância não atende aos requisitos para ativar a opção de hibernação.
403	InvalidOperation.MaxModifyOnlineNumberExceeded	The specified instance has reached the maximum number of modify online attempts and needs to be rebooted.
403	InvalidOperation.RebootingRequired	The specified instance needs to be rebooted.
403	InvalidOperation.OSTypeNotSupported	The specified OS type is not supported.
403	OperationDenied.UnpaidOrder	The specified instance has unpaid order.	O ID de instância especificado possui um pedido não pago. Faça login no console do ECS para concluir o pagamento.
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. A operação atual não é suportada.
403	InvalidDataDiskCategory.ValueNotSupported	The specified Category of Data Disk is not valid.	O parâmetro DataDisk.Category especificado é inválido.
403	InvalidDiskCategory.NotSupported	The upgrade operation of instance does not support this category of disk.	O tipo de disco especificado não é suportado na zona atual. Modifique o tipo de disco ou selecione uma zona diferente e tente novamente.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	As informações da região são inválidas.
404	BillingMethodNotFound	The account has not chosen any billing method.	A conta Alibaba Cloud não selecionou nenhum método de cobrança.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	O ID da instância especificado é inválido.
503	LimitedOperation.ServiceUnavailable	The service is currently unavailable. Please try again later.	O serviço está indisponível no momento. Tente novamente mais tarde.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.