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

Modifica o tipo de instância de uma instância ECS por assinatura, permitindo que você faça upgrade ou downgrade do tipo de instância. A modificação entra em vigor para todo o ciclo de vida da instância.

Descrição da operação

Antes de usar esta operação, certifique-se de compreender totalmente os métodos de cobrança, os preços e as regras de reembolso para downgrades de especificação do ECS.

Esta é uma operação assíncrona. A alteração de configuração é concluída após aproximadamente 5 a 10 segundos. Antes de fazer upgrade ou downgrade do tipo de instância ECS de uma instância ECS por 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 do tipo de instância de origem e do tipo de instância de destino for diferente (o campo NvmeSupport retornado por DescribeInstanceTypes) e o sistema operacional for Windows (o campo OSType retornado por DescribeInstances), conclua as operações descritas em Medidas preventivas antes de realizar o upgrade/downgrade.
Você não pode modificar o tipo de instância de uma instância expirada. Realize uma 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 os tipos de instância original e novo é reembolsada ao seu pagador original. Os vouchers utilizados não são reembolsáveis.
- O novo tipo de instância entra em vigor somente após você iniciar a instância.
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

*Instância.

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 chame 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ê especificar 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 seja suficiente. downgrade: faz downgrade do tipo de instância. Defina OperatorType como downgrade quando o tipo de instância especificado por InstanceType for inferior ao tipo de instância atual. 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 de 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 exclusivo entre diferentes solicitações. O valor de 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
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: Um pedido é criado, mas o pagamento não é concluído. Valor padrão: true. Nota Quando o pagamento automático está ativado, certifique-se de que o saldo do seu método de pagamento seja suficiente. Caso contrário, um pedido anormal é gerado e só pode ser anulado. 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 concluir o pagamento. Quando OperatorType é definido como downgrade, o parâmetro AutoPay é ignorado.	true
MigrateAcrossZone	boolean	Não	Especifica se há suporte para upgrade/downgrade de tipos de instância entre clusters. Valores válidos: true: Há suporte para alterações de tipo de instância entre clusters. false: Não há suporte para alterações de tipo de instância entre clusters. Valor padrão: false. Quando o parâmetro MigrateAcrossZone é definido como true, observe os seguintes itens após fazer upgrade da 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, os discos básicos (cloud) são identificados como xvda ou xvdb, e os 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ê aumenta a cota de um tipo de instância descontinuado para uma família de instâncias disponível para compra e faz upgrade de uma instância não otimizada para I/O para uma instância otimizada para I/O.	cloud_efficiency
RebootTime	string	Não	A hora de reinicialização da instância. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mmZ. A hora deve estar em UTC.	2018-01-01T12:05Z
EndTime	string	Não	A hora de término da alteração temporária do tipo de instância. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mmZ. A hora 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 imediatamente. Valor padrão: false. Nota Se a instância estiver no estado Parada, a instância 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.
Category	string	Não	Nota Este parâmetro não está disponível publicamente.	null
DiskId	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 é inválido porque está fora do intervalo disponível.
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.
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.
400	Account.Arrearage	Your account has an outstanding payment.	O saldo da sua conta é insuficiente. Recarregue sua conta antes de prosseguir.
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 é inválido.
400	IdempotenceParamNotMatch	Request uses a client token in a previous request but is not identical to that request.	Os parâmetros da solicitação não correspondem à solicitação com o mesmo ClientToken.
400	InvalidInstanceChargeType.ValueNotSupported	%s	O método de cobrança da instância especificado não existe.
400	InvalidStatus.NotStopped	Instance status must be stopped.	Esta operação só pode ser realizada quando a instância está no estado Stopped.
400	InvalidAction	%s	A operação é inválida.
400	InstanceDowngrade.QuotaExceed	Quota of instance downgrade is exceed.	A cota de downgrade de instância foi excedida. Você não pode realizar esta operação.
400	InvalidParameter	%s	Os parâmetros da solicitação atual são inválidos. Tente novamente.
400	OperationDenied	The current user does not support this operation.	O snapshot especificado não permite a criação de volumes de dados.
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 e não oferece suporte à criação de instâncias ECS com especificações baixas.
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 excede o limite de cota da zona. Acesse o Quota Center para consultar e solicitar um aumento na 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 vCPU nas regras de reembolso excede o limite máximo. Para obter mais informações sobre o limite, consulte o valor real retornado para o 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 preços. Solicite permissões à sua conta principal 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 realizar um reembolso. A conta principal deve conceder as permissões relacionadas ao reembolso.
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 não efetivado. 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 oferece suporte a 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 oferece suporte ao recurso de virtualização aninhada especificado.
400	OperationDenied.UnfinishedOrder	The current instance has unfinished refundOrder, this operation is denied.	A instância possui um pedido de reembolso pendente. Aguarde um momento e tente novamente mais tarde.
400	InvalidStatus.InstanceLocked	The specified instance is locked	A instância especificada está bloqueada.
401	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	O InstanceType especificado não existe.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente.
500	ImageOrderFailed	Create marketplace image order failed.	Falha ao criar um pedido do Alibaba Cloud Marketplace. Abra um ticket para obter assistência.
403	OperationDenied.NoStock	The specified instance is out of usage.	A categoria de disco especificada não existe na zona ou no cluster especificado, ou a zona especificada não corresponde ao cluster.
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 está autorizado a transmitir a função RAM.
403	ImageNotSupportInstanceType	The specified image does not support the specified InstanceType.	A imagem especificada não suporta este tipo de instância.
403	InstanceType.Offline	%s	O tipo de instância especificado foi descontinuado. Selecione um tipo de instância diferente.
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 InstanceId especificado é 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 marketplace image is not authorized. Please verify the marketplace image authorization and try again.
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 atingiu o limite máximo, o que invalida esta operação.
403	InvalidOperation.Ipv6CountExceeded	%s	O número de endereços IPv6 atingiu o limite superior, o que torna esta operação inválida.
403	InvalidOperation.Ipv6NotSupport	%s	O IPv6 não suporta a operação atual.
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 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	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	O número de instâncias a serem criadas com o tipo de instância selecionado na região atual excede a cota, ou a cota total de vCPU para todos os tipos de instância foi excedida. Você pode acessar o console do ECS ou o Quota Center para solicitar um aumento de cota.
403	InvalidResourceType.NotSupported	%s	O tipo de recurso não é suportado.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	O número de filas da Elastic Network Interface (ENI) excede o limite superior. Para obter mais informações, consulte o resultado de retorno real 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 obter mais informações, consulte o resultado de retorno real do placeholder %s na mensagem de erro.
403	InvalidParameter.InvalidEniQueueNumber	%s	O número de filas da Elastic Network Interface (ENI) está incorreto. Para obter mais informações, consulte o resultado de retorno real 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.	Já existe um pedido não pago para o ID da instância especificado. Você pode fazer 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 e não suporta a operação atual.
403	InvalidDataDiskCategory.ValueNotSupported	The specified Category of Data Disk is not valid.	O parâmetro DataDisk.n.Category especificado é inválido.
403	InvalidDiskCategory.NotSupported	The upgrade operation of instance does not support this category of disk.	A categoria de disco especificada não é suportada pelo tipo de instância.
403	InvalidOperation.InstanceTypeSecureBootUnsupported	The instance type does not support secure boot.	O tipo de instância não oferece suporte a Secure Boot.
403	InvalidOperation.InstanceTypeNotSupportEniTrunking	The specified instance type does not support ENI trunking operation.	A operação não é suportada. Para obter mais informações, consulte o valor real retornado para o placeholder %s na mensagem de erro.
403	InvalidStatus.InstanceStatus	The specified instance status does not support this operation, expected status is Running or Stopped.	O status atual da instância não oferece suporte a esta operação.
403	InvalidClientToken.Malformed	The specified clientToken is improperly formatted. It must contain only ASCII characters and must not exceed 64 characters in length.	O parâmetro idempotente especificado é inválido.
403	IncorrectDiskStatus	This operation is not supported for the current disk status. The disk must be In Use or Available to continue.	O disco atual não suporta esta operação. Certifique-se de que o disco esteja em uso normal e de que não haja pagamentos em atraso.
403	InvalidParameter.NotMatch	%s	O parâmetro especificado é inválido. Verifique se os parâmetros entram em conflito entre si.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	O RegionId especificado não existe. Verifique se o produto está disponível nesta região.
404	BillingMethodNotFound	The account has not chosen any billing method.	A conta Alibaba Cloud não possui um método de cobrança selecionado.
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.
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.