Todos os produtos
Search
Central de documentação

:UpgradeInstance

Última atualização: Jul 03, 2026

Atualiza o plano de um Simple Application Server.

Descrição

  • Os planos do Simple Application Server admitem apenas upgrade. Para mais informações sobre planos, consulte Itens faturáveis.

  • Antes de chamar esta operação para atualizar um servidor, verifique se o saldo da conta é suficiente. Se o saldo for insuficiente, não será possível realizar o upgrade do servidor.

Limites de QPS

O limite de consultas por segundo (QPS) por usuário nesta API é de 10 chamadas por minuto. Se a quantidade de chamadas à API por minuto exceder esse limite, o throttling será acionado e poderá afetar seus negócios. Recomendamos observar esse limite ao chamar esta operação. Para mais informações, consulte Limite de QPS.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

UpgradeInstance

A operação a ser executada. Defina o valor como UpgradeInstance.

InstanceId

String

Sim

ace0706b2ac4454d984295a94213****

O ID do Simple Application Server.

RegionId

String

Sim

cn-hangzhou

O ID da região do Simple Application Server.

PlanId

String

Sim

swas.s2.c2m2s50b4t08

O ID do novo plano. Chame a operação ListPlans para consultar os planos fornecidos pelo Simple Application Server.

ClientToken

String

Não

123e4567-e89b-12d3-a456-426655440000

Token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o valor, mas garanta que ele seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

20758A-585D-4A41-A9B2-28DA8F4F****

O ID da solicitação.

Exemplos

Exemplos de solicitações

https://swas.cn-hangzhou.aliyuncs.com/?Action=UpgradeInstance
&InstanceId=ace0706b2ac4454d984295a94213****
&RegionId=cn-hangzhou
&PlanId=swas.s2.c2m2s50b4t08
&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

<UpgradeInstanceResponse>
    <RequestId>20758A-585D-4A41-A9B2-28DA8F4F****</RequestId>
</UpgradeInstanceResponse>

Formato JSON

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

{
  "RequestId" : "20758A-585D-4A41-A9B2-28DA8F4F****"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

InvalidPlanIdUpgrade.ValueNotSupported

The specification of the specified planId is lower than the current server specification.

Mensagem retornada porque as especificações do novo plano são inferiores às do plano atual do servidor.

403

PaymentFailed

Payment failed. Please check your account balance.

Mensagem retornada devido a falha no pagamento. Verifique se há saldo suficiente em sua conta.

403

InvalidInstance.UnPaidOrder

The specified Instance has an unpaid order.

Mensagem retornada porque existe um pedido não pago. Regularize o pagamento e tente novamente.

404

InvalidPlanId.NotFound

The specified PlanId does not exist.

Mensagem retornada porque o parâmetro PlanId especificado é inválido.

404

InvalidInstanceId.NotFound

The specified InstanceId does not exist.

Mensagem retornada porque o parâmetro InstanceId especificado é inválido.

500

InternalError

An error occurred while processing your request.

Mensagem retornada devido a um erro interno. Tente novamente mais tarde. Se o problema persistir, envie um ticket.

500

NotEnoughUpgradeStock

The upgrade stock is insufficient.

Mensagem retornada porque o estoque é insuficiente durante a tentativa de upgrade do plano do servidor.

Para obter uma lista de códigos de erro, visite o API Error Center.