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

Descrição

Antes de chamar esta operação, certifique-se de compreender os métodos de faturamento e a tabela de preços do ECS. Para obter mais informações, consulte a página do produto Elastic Compute Service.

O sistema deduz o pagamento da renovação automática pela primeira vez às 08:00:00 (UTC+8), nove dias antes do vencimento da instância.

Caso a primeira tentativa de dedução falhe, o Alibaba Cloud tentará deduzir o pagamento diariamente até que a cobrança seja efetuada ou até que a instância seja bloqueada após o término do período de nove dias. Garanta saldo suficiente em sua conta ou crédito disponível.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifyInstanceAutoRenewAttribute	A operação a ser executada. Defina o valor como ModifyInstanceAutoRenewAttribute.
InstanceId	String	Sim	i-bp67acfmxazb4ph**,i-bp67acfmxazb4pi**	O ID da instância. Especifique IDs de até 100 instâncias por assinatura. Separe os IDs das instâncias por vírgulas (,).
RegionId	String	Sim	cn-hangzhou	O ID da região da instância. Chame a operação DescribeRegions para consultar a lista mais recente de regiões.
Duration	Integer	Não.	1	O período de renovação automática da instância. Valores válidos de `Duration` quando `PeriodUnit` está definido como `Year` (ano): 1, 2, 3, 4 e 5. Valores válidos de `Duration` quando `PeriodUnit` está definido como `Month` (mês): 1, 2, 3, 6, 12, 24, 36, 48 e 60.
AutoRenew	Boolean	Não	true	Define se a renovação automática deve ser ativada para a instância. Valor padrão: false.
RenewalStatus	String	Não	AutoRenewal	O estado de renovação automática da instância. Valores válidos: AutoRenewal: a renovação automática está ativada para a instância. Normal: a renovação automática está desativada para a instância. NotRenewal: a instância não será renovada. O sistema deixa de enviar notificações de vencimento. As notificações de renovação são enviadas três dias antes do horário de vencimento da instância. Altere o valor deste parâmetro de NotRenewal para `Normal` em uma instância e renove-a manualmente. Como alternativa, defina o parâmetro RenewalStatus como AutoRenewal. Nota `RenewalStatus` tem precedência sobre `AutoRenew`. Se você não especificar `RenewalStatus`, o parâmetro `AutoRenew` será usado por padrão.
PeriodUnit	String	Não	Month	A unidade do período de renovação (`Duration`). Valor padrão: Month. Valores válidos: Month Year

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=ModifyInstanceAutoRenewAttribute
&RegionId=cn-hangzhou
&InstanceId=i-bp67acfmxazb4ph****,i-bp67acfmxazb4pi****
&Duration=1
&PeriodUnit=Month
&AutoRenew=true
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifyInstanceAutoRenewAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyInstanceAutoRenewAttributeResponse>

Formato JSON

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
403	MissingParameter.InstanceId	InstanceId should not be null.	Mensagem retornada porque o parâmetro InstanceId não foi especificado.
403	InvalidParameter.ToManyInstanceIds	InstanceId should be less than 100.	Mensagem retornada porque o número total de instâncias excedeu 100.
403	InvalidParameter.InvalidInstanceId	%s	Mensagem retornada porque o parâmetro InstanceId especificado é inválido.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Mensagem retornada porque a operação não é compatível com o estado atual do recurso.
403	ChargeTypeViolation	Pay-As-You-Go instances do not support this operation.	Mensagem retornada porque instâncias de pagamento conforme o uso não são compatíveis com esta operação. Verifique o método de faturamento da instância.
403	InvalidParameter.Duration	%s	Mensagem retornada porque o parâmetro Period especificado é inválido.
403	InvalidParameter.RenewalStatus	%s	Mensagem retornada porque o parâmetro RenewalStatus especificado é inválido.
403	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.	Mensagem retornada porque o parâmetro PeriodUnit especificado é inválido.
403	InvalidPeriod.StarterPackage	This instance was created by using a Starter Package plan and can only be renewed monthly, not yearly.	Mensagem retornada porque a instância foi criada com um plano Starter Package e só pode ter renovação automática mensal.
500	InternalError	The request processing has failed due to some unknown error.	Mensagem retornada devido a um erro interno. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.