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

Renova uma instância do Elastic Compute Service (ECS) por assinatura.

Descrição

Antes de chamar esta operação, verifique se você compreende os métodos de faturamento e a tabela de preços do ECS. Para mais informações, consulte a página do produto Elastic Compute Service.
Use esta operação para renovar uma instância por assinatura por um período determinado ou até uma data de expiração sincronizada.
Não é possível renovar uma instância por assinatura por um período e para uma data de expiração sincronizada simultaneamente nesta chamada. O par de parâmetros relacionado ao período de renovação (Period e PeriodUnit) e o parâmetro ExpectedRenewDay são mutuamente exclusivos.
Sua conta deve ter créditos suficientes.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para sua conveniência. 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	RenewInstance	A operação a ser executada. Defina o valor como RenewInstance.
ClientToken	String	No	0c593ea1-3bea-11e9-b96b-88e9fe637760	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 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.
InstanceId	String	Yes	i-bp67acfmxazb4p****	ID da instância.
Period	Integer	No	1	Período de renovação da instância por assinatura. Se o parâmetro `DedicatedHostId` for especificado, o valor de Period não deve exceder o período de assinatura do host dedicado especificado. Valores válidos: Valores válidos quando PeriodUnit está definido como Month: 1, 2, 3, 4, 5, 6, 7, 8, 9 e 12. Nota O par de parâmetros relacionado ao período de renovação (`Period` e `PeriodUnit`) e o parâmetro `ExpectedRenewDay` são mutuamente exclusivos.
PeriodUnit	String	No	Month	Unidade do período de renovação. Valor válido: Month Valor padrão: Month.
ExpectedRenewDay	Integer	No	5	Data de expiração sincronizada. Defina o valor como uma data de expiração sincronizada especificada por você. Caso contrário, a chamada falhará. Se este parâmetro for definido, a instância será renovada até a data de expiração sincronizada especificada. Valores válidos: 1 a 28. Para obter informações sobre como sincronizar as datas de expiração das instâncias, consulte Sincronizar as datas de expiração de instâncias por assinatura. Nota O par de parâmetros relacionado ao período de renovação (`Period` e `PeriodUnit`) e o parâmetro `ExpectedRenewDay` são mutuamente exclusivos.

Parâmetros de resposta

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

Exemplos

Exemplos de solicitações

http(s)://ecs.aliyuncs.com/?Action=RenewInstance
&InstanceId=i-bp67acfmxazb4p****
&Period=1
&PeriodUnit=Month
&ClientToken=0c593ea1-3bea-11e9-b96b-88e9fe637760
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<RenewInstanceResponse>
    <OrderId>1234567890</OrderId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</RenewInstanceResponse>

Formato JSON

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

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

Códigos de erro

HttpCode	Error code	Error message	Description
400	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is not valid.	Erro retornado porque o método de faturamento de rede especificado para a instância é inválido.
400	InvalidInstanceType.NotSupported	The specified InstanceType is not Supported.	Erro retornado porque o tipo de instância especificado é inválido.
400	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.	Erro retornado porque o método de faturamento da instância especificado não existe.
400	InvalidRebootTime.ValueNotSupported	The specified RebootTime is out of the permitted range.	Erro retornado porque o horário de reinicialização especificado está fora do intervalo permitido.
400	IdempotenceParamNotMatch	Request uses a client token in a previous request but is not identical to that request.	Erro retornado porque esta solicitação e a anterior contêm o mesmo token de cliente, mas parâmetros diferentes.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	Erro retornado porque o parâmetro ClientToken especificado é inválido.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	Erro retornado porque o tipo de instância especificado não existe ou porque você não tem autorização para gerenciar instâncias desse tipo.
400	InvalidInstanceType.codeUnauthorized	The specified InstanceType is not authorized.	Erro retornado porque o tipo de instância especificado é inválido.
400	InvalidInternetChargeType.InstanceNotSupported	The specified instance which is in vpc is not support the parameter InternetChargeType.	Erro retornado porque o método de faturamento de rede especificado não é compatível com a instância indicada, que reside em uma Virtual Private Cloud (VPC).
400	InvalidPeriod	The specified period is not valid.	Erro retornado porque o parâmetro Period especificado é inválido.
400	Upgrade.NotSupported	Upgrade operation is not supported.	Erro retornado porque a operação de upgrade é inválida.
400	OperationDenied	Specified instance is in VPC.	Erro retornado porque a instância reside em uma VPC.
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	Erro retornado porque você não tem autorização para usar o tipo de instância especificado.
400	DependencyViolation.InstanceType	Current instancetype cannot be changed to the specified one.	Erro retornado porque o tipo atual da instância não pode ser alterado para o tipo especificado.
400	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.	Erro retornado porque o parâmetro PeriodUnit especificado é inválido.
400	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	Erro retornado porque o host dedicado especificado não existe.
400	InvalidDedicatedHostStatus.NotSupport	Operation denied due to dedicated host status.	Erro retornado porque a operação não é compatível enquanto o host dedicado estiver no estado atual.
400	IncorrectDedicatedHostStatus	The current status of the resource does not support this operation.	Erro retornado porque a operação não é compatível enquanto o recurso estiver no estado atual.
400	InvalidStatus.Upgrading	The instance is upgrading; please try again later.	Erro retornado porque as configurações da instância especificada estão sendo atualizadas. Tente novamente mais tarde.
400	InvalidPeriod.ExceededMaximumExpirationDate	The specified renewal period cannot exceed the maximum expiration date. We recommend you try shortening the renewal period at next attempt.	Erro retornado porque o período de renovação especificado excede o valor máximo permitido. Recomendamos reduzir o período de renovação na próxima tentativa.
400	LastOrderProcessing	The previous order is still processing, please try again later.	Erro retornado porque o pedido está sendo processado. Tente novamente mais tarde.
400	Idempotence.Processing	The previous request is still processing, please try again later.	Erro retornado porque a solicitação anterior ainda está sendo processada. Tente novamente mais tarde.
400	OperationDenied	The current user does not support this operation.	Erro retornado porque sua conta não oferece suporte à operação.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.	Erro retornado porque a operação não é compatível enquanto a instância utiliza o método de faturamento atual.
403	Diskcategory.Mismatch	The disk specified to convert to portable is not allowed due to the disk category does not support.	Erro retornado porque o disco especificado não pode ser convertido em disco removível devido a restrições da categoria do disco.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Erro retornado porque a operação não é compatível enquanto o recurso estiver no estado atual.
403	InstanceSpecModification.NotEffective	The specified instance has been reserved for making a spec modification and not taken effective in the current contract period.	Erro retornado porque a instância está reservada devido a uma alteração de tipo. As modificações realizadas não podem entrar em vigor durante o período contratual atual.
403	LastTokenProcessing	The last token request is processing.	Erro retornado porque a última solicitação de token está sendo processada. Tente novamente mais tarde.
403	Instance.UnPaidOrder	The specified instance has unpaid order.	Erro retornado porque existem pedidos não pagos para a instância.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	Erro retornado porque a operação não é compatível enquanto a instância estiver bloqueada por motivos de segurança.
403	InvalidDisk.NotAllowed	The specified disk is not allowed to be converted to portable.	Erro retornado porque o disco especificado não pode ser convertido em disco removível.
403	InstanceTypeNotSupported	The specified zone does not offer the specified instancetype.	Erro retornado porque o tipo de instância especificado não é compatível com a zona indicada.
403	InvalidChargeType.NotSupported	The chargeType of the instance does not support this operation.	Erro retornado porque a operação não é compatível enquanto a instância utiliza o método de faturamento atual.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone, try other types of resources or other regions and zones.	Erro retornado porque os recursos solicitados estão esgotados na zona especificada. Tente um tipo de instância ou zona diferente.
403	OperationDenied.NoStock	The resource is out of usage.	Erro retornado porque a instância não está no estado Running. Inicie a instância ou verifique se a operação especificada é válida.
403	InvalidPeriod.StarterPackage	This instance was created by using a Starter Package plan and can only be renewed monthly, not yearly.	Erro retornado porque a instância foi criada usando um plano Starter Package e só pode ser renovada automaticamente mensalmente.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Erro retornado porque o disco especificado não existe. Verifique se o ID do disco está correto.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Erro retornado porque o parâmetro InstanceId especificado não existe.
500	InternalError	The request processing has failed due to some unknown error.	Erro retornado porque ocorreu um erro interno. Tente novamente mais tarde.

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