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

Renova uma instância do Elastic Compute Service (ECS) por assinatura. Você pode especificar um período de renovação ou renovar a instância para uma data de expiração unificada.

Descrição da operação

Antes de usar esta operação, certifique-se de compreender totalmente os métodos de cobrança e os preços do Elastic Compute Service.

Certifique-se de que o saldo da sua conta ou limite de crédito seja suficiente.
Apenas instâncias por assinatura são suportadas. Invocar esta operação para instâncias pay-as-you-go retorna um erro.
Você deve especificar os parâmetros de período de renovação (Period e PeriodUnit) ou o parâmetro de data de expiração unificada (ExpectedRenewDay), mas não ambos.

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

update

*Instância.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
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.	0c593ea1-3bea-11e9-b96b-88e9fe637760
InstanceId	string	Sim	O ID da instância que você deseja renovar.	i-bp67acfmxazb4p****
Period	integer	Não	O período de renovação para a instância por assinatura. Se você especificar DedicatedHostId, o valor de Period não poderá exceder o período de assinatura restante do host dedicado. Valores válidos: Se PeriodUnit estiver definido como Month, valores válidos de Period: 1, 2, 3, 4, 5, 6, 7, 8, 9 e 12. Nota Você deve especificar os parâmetros de período de renovação (Period e PeriodUnit) ou o parâmetro de data de expiração unificada (ExpectedRenewDay), mas não ambos.	1
PeriodUnit	string	Não	A unidade do período de renovação. Este parâmetro especifica a unidade para o parâmetro Period. Valores válidos: Month. Valor padrão: Month.	Month
ExpectedRenewDay	integer	Não	O dia em que a instância será renovada para uma data de expiração unificada. Valores válidos: 1 a 28. Para usar este parâmetro, você deve primeiro definir uma data de expiração unificada para instâncias ECS. O valor deste parâmetro deve corresponder à data de expiração unificada que você definiu. Caso contrário, a chamada falhará. Nota Você deve especificar os parâmetros de período de renovação (Period e PeriodUnit) ou o parâmetro de data de expiração unificada (ExpectedRenewDay), mas não ambos.	5

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-A3DC0DE3****

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is not valid.	O método de cobrança de rede especificado é inválido.
400	InvalidInstanceType.NotSupported	The specified InstanceType is not Supported.
400	InvalidParameter	The specified parameter "InternetMaxBandwidthOut" is not valid.
400	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.	O método de cobrança da instância especificado não existe.
400	InvalidRebootTime.Malformed	The specified RebootTime is not valid.
400	InvalidRebootTime.ValueNotSupported	The specified RebootTime is out of the permitted range.	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	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	O ClientToken especificado é inválido.
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	InvalidInstanceType.codeUnauthorized	The specified InstanceType is not authorized.	O InstanceType especificado é inválido.
400	InvalidInternetChargeType.InstanceNotSupported	The specified instance which is in vpc is not support the parameter InternetChargeType.	O InternetChargeType especificado não é suportado para esta instância.
400	InvalidPeriod	The specified period is not valid.	O período de tempo especificado é inválido.
400	MissingParamter	The specified parameter "Period" is not null.	O parâmetro Period não pode estar vazio.
400	Upgrade.NotSupported	Upgrade operation is not supported.	A operação de upgrade é inválida.
400	OperationDenied	Specified instance is in VPC.	O snapshot especificado não permite a criação de volumes de dados.
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.
400	DependencyViolation.InstanceType	Current instancetype cannot be changed to the specified one.	O tipo de instância atual não pode ser alterado para o tipo de instância especificado.
400	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.	O parâmetro PeriodUnit é inválido.
400	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	O host dedicado especificado não existe.
400	InvalidDedicatedHostStatus.NotSupport	Operation denied due to dedicated host status.	O status atual do host dedicado não oferece suporte a esta operação.
400	IncorrectDedicatedHostStatus	The current status of the resource does not support this operation.	O estado atual do recurso não suporta esta operação.
400	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.
400	InvalidStatus.Upgrading	The instance is upgrading; please try again later.	A instância está sendo atualizada. 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.	O período de renovação especificado não pode exceder o período máximo de validade. Reduza o período de renovação e tente novamente.
400	LastOrderProcessing	The previous order is still processing, please try again later.	O pedido está sendo processado. Tente novamente mais tarde.
400	Idempotence.Processing	The previous request is still processing, please try again later.	A solicitação está sendo processada. Tente novamente mais tarde.
400	InvalidLoanOrderStatus.Uncompleted	Any unpaid order must be cancelled before you try this action again. The scheduled unpaid order is a loan order that cannot be auto cancelled. For more information, visit the loan management center.
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	InvalidPeriod.NotFound	The specified period and expectedRenewDay cannot both be empty.
400	InvalidExpectedRenewDay.StarterPackageNotSupported	The specified starterPackage cannot support renew with expectedRenewDay.
400	InvalidParam.ExpectedRenewDay	The specified param ExpectedRenewDay is not valid.
400	QuotaExceed.AlignInstance	The maximum number of align operations is exceeded.
400	InvalidExpectedRenewDay.Conflict	The specified expectedRenewDay is in conflict with period.
400	InvalidExpectedRenewDay.ValueNotSupported	The specified parameter ExpectedRenewDay is not valid.
400	OperationDenied.AbnormalInstanceInfo	The current renewable operation is not supported due to abnormal information of the instance, please submit ticket to process.
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	InvalidOperation.ClassicNetworkTypeNotSupported	The classic network instance does not support this operation.	A instância baseada na arquitetura de rede clássica não pode mais ser renovada. Você deve realizar a migração da instância para uma VPC antes que a renovação normal possa prosseguir.
500	InternalError	The request processing has failed due to some unknown error.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.
403	Diskcategory.Mismatch	The disk specified to convert to portable is not allowed due to the disk category does not support.	O disco especificado não pode ser convertido em um disco desanexável devido a restrições de tipo de disco. Discos deste tipo não oferecem suporte à desanexação.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	InstanceSpecModification.NotEffective	The specified instance has been reserved for making a spec modification and not taken effective in the current contract period.	A instância especificada está reservada devido a uma alteração de especificação e não pode entrar em vigor durante o período do contrato atual.
403	LastTokenProcessing	The last token request is processing.
403	Instance.UnPaidOrder	The specified instance has unpaid order.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	A instância à qual o disco está anexado está bloqueada por motivos de segurança.
403	InvalidDisk.NotAllowed	The specified disk is not allowed to be converted to portable.
403	InstanceTypeNotSupported	The specified zone does not offer the specified instancetype.
403	InvalidChargeType.NotSupported	The chargeType of the instance does not support this operation.	Esta operação não é suportada para instâncias com este tipo de cobrança.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone, try other types of resources or other regions and zones.	A categoria de disco especificada não existe na zona ou no cluster especificado, ou a zona especificada não corresponde ao cluster.
403	OperationDenied.ImageNotValid	The specified marketplace image is not authorized. Please verify the marketplace image authorization and try again.
403	InvalidPeriod.StarterPackage	This instance was created by using a Starter Package plan and can only be renewed monthly, not yearly.	As instâncias que participam da promoção de pacote de nível básico só podem ser configuradas para renovação automática mensal.
403	RenewDateNotSupported.StarterPackage	This instance was created by using a Starter Package plan and can only be renewed three days before it expires.
403	PrePaidInstance.Expired	The prePaid instance has expired.	A instância de assinatura expirou.
403	Forbidden.RiskControl	This operation is forbidden by Aliyun RiskControl system.	A operação é proibida pelo sistema de governança de riscos.
404	InvalidDiskId.NotFound	The specified disk does not exist.	O disco especificado não existe. Verifique se o ID do disco está correto.
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.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.