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

Atualiza ou reduz o tipo de uma instância Elastic Compute Service (ECS) por assinatura. O novo tipo de instância entra em vigor durante o ciclo de vida restante da instância.

Observações de uso

Recomendamos que você se familiarize com os métodos de faturamento, a tabela de preços e as regras de reembolso do ECS antes de chamar esta operação. Para obter mais informações, consulte Regras de reembolso para redução de configuração em tempo real.

Antes de alterar o tipo de uma instância por assinatura, chame a operação DescribeResourcesModification para consultar os tipos de instância disponíveis para alteração. Você também pode usar o ECS SDK for Python para essa consulta. Para obter mais informações, consulte Consultar recursos disponíveis para alterações de configuração.

Observe os seguintes itens:

Não é possível alterar o tipo de uma instância expirada. Renove a instância e tente novamente.
Ao reduzir o tipo de instância, atente-se aos pontos abaixo:
- A instância deve estar no estado Stopped (Stopped).
- A diferença de preço é reembolsada na conta de pagamento utilizada. Vouchers já resgatados não são reembolsáveis.
Esta operação é assíncrona. A alteração do tipo de instância leva de 5 a 10 segundos. Em seguida, reinicie a instância chamando a operação RebootInstance ou usando o console do ECS para que a alteração entre em vigor. Reiniciar apenas o sistema operacional da instância não aplica a mudança de tipo.
- Se a instância estiver no estado Stopped, basta iniciá-la. Não é necessário reiniciá-la após ela entrar no estado Running.
- Caso RebootWhenFinished esteja definido como true para a instância, a reinicialização manual é dispensável.

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 de solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyPrepayInstanceSpec	A operação a ser executada. Defina o valor como ModifyPrepayInstanceSpec.
InstanceId	String	Yes	i-bp67acfmxazb4ph****	O ID da instância.
RegionId	String	Yes	cn-hangzhou	O ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
InstanceType	String	Yes	ecs.g5.xlarge	O novo tipo de instância. Para obter informações sobre os tipos disponíveis, consulte Famílias de instâncias ou chame a operação DescribeInstanceTypes.
OperatorType	String	No	upgrade	O tipo da operação. Valores válidos: Nota Este parâmetro é opcional. O sistema pode definir o tipo de operação automaticamente. Caso deseje especificar este parâmetro, observe as seguintes regras: upgrade: atualiza o tipo de instância. Certifique-se de que o saldo da sua conta seja suficiente. downgrade: reduz o tipo de instância. Quando o novo tipo especificado por `InstanceType` tiver especificações inferiores ao tipo atual, defina `OperatorType` como downgrade. Nota Para obter mais informações sobre as precauções ao atualizar ou reduzir tipos de instância, consulte a seção "Observações de uso" acima neste tópico.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	O token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o valor, mas garanta que ele seja único entre solicitações diferentes. 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.
AutoPay	Boolean	No	true	Especifica se o pagamento automático deve ser ativado ao atualizar o tipo de instância. Valores válidos: true: O pagamento é concluído automaticamente. Nota Certifique-se de que o saldo da sua conta seja suficiente. Caso contrário, seu pedido se tornará inválido. Se o saldo for insuficiente, defina `AutoPay` como `false` para gerar um pedido não pago. Depois, acesse o console do ECS para pagar o pedido. false: Um pedido é gerado, mas nenhum pagamento é efetuado. Valor padrão: true. Quando `OperatorType` está definido como `downgrade`, `AutoPay` é ignorado.
MigrateAcrossZone	Boolean	No	false	Especifica se há suporte para atualizações de tipo de instância entre zonas. Valor padrão: false. Ao definir `MigrateAcrossZone` como `true` e atualizar a instância com base nas informações retornadas, observe os seguintes itens: Instâncias do tipo de rede clássica: Para tipos de instância descontinuados, o endereço IP privado, os nomes dos dispositivos de disco e os códigos de licença de software de uma instância não otimizada para I/O mudam ao atualizá-la para uma instância otimizada para I/O. Em instâncias Linux, discos básicos (cloud) são identificados como xvd (como xvda e xvdb). Discos ultra (cloud_efficiency) e SSDs padrão (cloud_ssd) são identificados como vd (como vda e vdb). Para famílias de instâncias disponíveis para compra, o endereço IP privado da instância muda quando você altera o tipo de instância. Instâncias do tipo Virtual Private Cloud (VPC): Para tipos de instância descontinuados, quando uma instância não otimizada para I/O é atualizada para uma instância otimizada para I/O, os nomes dos dispositivos de disco e os códigos de licença de software da instância mudam. Em instâncias Linux, discos básicos (cloud) são identificados como xvd (como xvda e xvdb). Discos ultra (cloud_efficiency) e SSDs padrão (cloud_ssd) são identificados como vd (como vda e vdb).
SystemDisk.Category	String	No	cloud_efficiency	A nova categoria do disco do sistema. Este parâmetro é válido apenas ao atualizar uma instância de um tipo descontinuado para um tipo disponível, ou ao atualizar uma instância não otimizada para I/O para uma instância otimizada para I/O. Para obter mais informações, consulte Tipos de instância descontinuados e Famílias de instâncias. Valores válidos: cloud_efficiency: disco ultra. cloud_ssd: SSD padrão.
RebootTime	String	No	2018-01-01T12:05Z	O horário de reinicialização da instância. Especifique o horário no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. O horário deve estar em UTC.
EndTime	String	No	2018-01-01T12:05Z	O horário de término da alteração temporária. Especifique o horário no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. O horário deve estar em UTC.
RebootWhenFinished	Boolean	No	false	Especifica se a instância deve ser reiniciada imediatamente após a alteração do tipo. Valores válidos: true: reinicia a instância imediatamente após a alteração do tipo. false: não reinicia a instância imediatamente após a alteração do tipo. Valor padrão: false. Nota Se a instância estiver no estado Stopping, o estado permanecerá inalterado e nenhuma operação será executada, independentemente de `RebootWhenFinished` estar definido como true.
ModifyMode	String	No	null	Nota Este parâmetro não está disponível publicamente.
Disk.N.DiskId	String	No	null	Nota Este parâmetro não está disponível publicamente.
Disk.N.Category	String	No	null	Nota Este parâmetro não está disponível publicamente.
Disk.N.PerformanceLevel	String	No	null	Nota Este parâmetro não está disponível publicamente.

Parâmetros de resposta

Parameter	Type	Example	Description
OrderId	String	1234567890	O ID do pedido.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=ModifyPrepayInstanceSpec
&RegionId=cn-hangzhou
&InstanceId=i-bp67acfmxazb4ph****
&InstanceType=ecs.g5.xlarge
&AutoPay=true
&OperatorType=upgrade
&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

<ModifyPrepayInstanceSpecResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
    <OrderId>1234567890</OrderId>
</ModifyPrepayInstanceSpecResponse>

Formato JSON

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

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE73368",
  "OrderId" : "1234567890"
}

Códigos de erro

HTTP status code	Error code	Error message	Description
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	Você não tem autorização para usar este tipo de instância.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	O tipo de instância não foi encontrado ou você não tem autorização para gerenciar instâncias deste tipo.
400	InvalidBillingMethod.ValueNotSupported	The operation is not permitted due to an invalid billing method of the instance.	A operação não é suportada devido ao método de faturamento inválido da instância.
400	InvalidInstance.PurchaseNotFound	The specified instance has no purchase history.	O registro de pedido da instância não foi encontrado.
400	InvalidInstanceType.NotSupported	The specified InstanceType is not Supported.	Valor de InstanceType inválido.
400	OrderCreationFailed	Order creation failed, please check your params and try it again later.	Não foi possível criar o pedido. Modifique as configurações dos 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.	Sua solicitação foi negada devido ao limitador de taxa. Tente novamente mais tarde.
400	Account.Arrearage	Your account has an outstanding payment.	Existem pedidos não pagos na sua conta.
400	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Esta instância não foi encontrada. Verifique se o ID da instância especificado é válido.
400	InvalidRebootTime.MalFormed	The specified rebootTime is not valid.	Valor de RebootTime invá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.	Esta solicitação e a anterior contêm o mesmo token de cliente, mas outros parâmetros diferentes.
400	IdempotenceParamNotMatch	%s	Os parâmetros idempotentes não correspondem.
400	InvalidInstanceChargeType.ValueNotSupported	%s	O método de faturamento especificado não é suportado.
400	InvalidStatus.NotStopped	Instance status must be stopped.	A operação só pode ser executada quando a instância estiver no estado Stopped.
400	InvalidAction	%s	A operação é inválida.
400	InstanceDowngrade.QuotaExceed	Quota of instance downgrade is exceed.	O número máximo de reduções de configuração permitidas para a instância foi excedido.
400	InvalidInstanceType.ValueNotSupported	%s	O tipo de instância não suporta esta operação.
400	InvalidParameter	%s	Valor de parâmetro inválido.
400	OperationDenied	The current user does not support this operation.	Sua conta não suporta esta operação.
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.	Recursos avançados estão ativados para a VPC. Não é possível criar instâncias ECS com especificações baixas nesta VPC.
400	InvalidAction.WithActiveElasticUpgrade	The instance has active Elastic Upgrade.	A operação não pode ser executada na instância enquanto as configurações estão sendo atualizadas temporariamente. As configurações passam por uma atualização temporária se a operação ModifyPrepayInstanceSpec for chamada com EndTime definido.
400	QuotaExceed.DiskCapacity	The used capacity of disk type has exceeded the quota in the zone, %s.	A capacidade máxima de discos pertencentes à categoria especificada foi excedida na zona. Acesse o Quota Center para visualizar e aumentar a cota de capacidade de disco.
400	QuotaExceed.RufundVcpu	The maximum number of refunded vcpu is exceeded: %s .	O número máximo de vCPUs de reembolso foi excedido. Para obter mais informações sobre o valor, consulte o valor retornado no espaço reservado %s na mensagem de erro.
403	OperationDenied.NoStock	The specified instance is out of usage.	Os recursos do tipo de instância especificado são insuficientes.
403	InvalidUser.PassRoleForbidden	The RAM user does not have privilege to pass a role.	Usuários do Resource Access Management (RAM) não têm autorização para atribuir funções do RAM.
403	ImageNotSupportInstanceType	The specified image does not support the specified InstanceType.	A imagem especificada não suporta o tipo de instância especificado.
403	InstanceType.Offline	%s	A operação não pode ser executada na instância enquanto o tipo de instância estiver descontinuado ou enquanto os recursos desse tipo forem insuficientes.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	A operação não pode ser executada no recurso no estado atual.
403	InvalidParameter.InstanceId	%s	Valor de InstanceId inválido.
403	OperationDenied	%s	A operação foi negada.
403	ImageNotSupportInstanceType	The specified instanceType is not supported by instance with marketplace image.	A imagem do Alibaba Cloud Marketplace especificada não suporta o tipo de instância.
403	InvalidInstanceStatus	The current status of the instance does not support this operation.	A operação não pode ser executada na instância no estado atual.
403	InvalidInstance.EipNotSupport	The special instance with eip not support operate, please unassociate eip first.	A operação não pode ser executada na instância enquanto um elastic IP address (EIP) estiver associado a ela. Desassocie o EIP primeiro.
403	OperationDenied.LocalDiskUnsupported	The configuration change is not allowed when the specified instance has local disks mounted.	Os tipos de instância que utilizam discos locais não podem ser alterados.
403	OperationDenied.NoStock	The resource is out of stock in the specified zone. Please try other types, or choose other regions and zones.	O recurso especificado não está disponível na zona indicada. Tente outros tipos de recursos ou selecione outras regiões ou zonas.
403	InvalidOperation.Ipv4CountExceeded	%s	O número máximo de endereços IPv4 foi excedido.
403	InvalidOperation.Ipv6CountExceeded	%s	O número máximo de endereços IPv6 foi excedido.
403	InvalidOperation.Ipv6NotSupport	%s	Endereços IPv6 não suportam a operação.
403	InvalidInstance.NotFoundSystemDisk	The specified instance has no system disk.	A instância especificada não possui um disco do sistema anexado. Certifique-se de que a instância tenha um disco do sistema anexado. Chame a operação DescribeInstances para consultar os detalhes da instância.
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 de disco da instância. Tente outro tipo de instância. Para obter informações sobre as categorias de disco suportadas, 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 máximo de instâncias do tipo especificado na região foi excedido. Tente outra região ou tipo de instância, ou reduza a quantidade de compra. Acesse o console do ECS ou o Quota Center para solicitar um aumento de cota.
403	QuotaExceed.ElasticQuota	The number of the specified ECS instances has exceeded the quota of the specified instance type.	O número máximo de instâncias do tipo especificado na região foi excedido. Tente outra região ou tipo de instância, ou reduza a quantidade de compra. Acesse o console do ECS ou o Quota Center para solicitar um aumento de cota.
403	QuotaExceed.ElasticQuota	The number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.	O número máximo de vCPUs para todos os tipos de instância na zona foi excedido. Acesse o console do ECS ou o Quota Center para solicitar um aumento de cota.
403	QuotaExceed.ElasticQuota	The number of the specified ECS instances has exceeded the quota of the specified instance type, or the number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.	O número máximo de instâncias do tipo especificado na região, ou o número máximo de vCPUs para todos os tipos de instância na zona, foi excedido. Acesse o console do ECS ou o Quota Center para solicitar um aumento de cota.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	O número máximo de filas por elastic network interface (ENI) foi excedido. Para obter mais informações, consulte o valor retornado no espaço reservado %s na mensagem de erro.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	O número máximo de filas para todas as ENIs foi excedido. Para obter mais informações, consulte o valor retornado no espaço reservado %s na mensagem de erro.
403	InvalidParameter.InvalidEniQueueNumber	%s	Número inválido de filas por ENI. Para obter mais informações, consulte o valor retornado no espaço reservado %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 pode ser executada devido às limitações de instâncias com o recurso de hibernação ativado.
403	OperationDenied.UnpaidOrder	The specified instance has unpaid order.	Sua conta possui pedidos não pagos para a instância especificada. Acesse o console do ECS para pagar os pedidos.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	Valor de RegionId inválido.
404	BillingMethodNotFound	The account has not chosen any billing method.	Nenhum método de faturamento foi selecionado para a conta Alibaba Cloud.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente mais tarde.
500	InternalError	The request processing has failed due to some unknown error.	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.