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

Modifica os atributos de renovação automática de uma ou mais instâncias por assinatura, ajudando você a reduzir o custo de manutenção da expiração de recursos.

Descrição da operação

Antes de usar esta API, certifique-se de compreender totalmente os métodos de cobrança e os preços do Elastic Compute Service (ECS).

Certifique-se de que o saldo da sua conta ou o limite de crédito seja suficiente.
Apenas instâncias por assinatura são suportadas. Um erro será retornado se você chamar esta API para instâncias pay-as-you-go.
A data de dedução da renovação automática é 9 dias antes da expiração da instância. A dedução começa às 08:00:00 (UTC+8).
Se a dedução automática falhar no dia anterior, ela será tentada novamente no horário programado no dia seguinte até que a dedução seja bem-sucedida ou a instância seja bloqueada após a expiração, 9 dias depois.
Se a duração da compra de uma instância recém-criada for de uma semana, a dedução da renovação automática será feita no primeiro dia após a criação da instância..

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

update

*Instance

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância. Você pode especificar até 100 instâncias por assinatura por vez. Separe vários IDs de instância com vírgulas (,).	i-bp67acfmxazb4ph**,i-bp67acfmxazb4pi**
RegionId	string	Sim	O ID da região da instância. Você pode chamar DescribeRegions para visualizar a lista mais recente de regiões da Alibaba Cloud.	cn-hangzhou
Duration	integer	Não	A duração da renovação automática da instância. Quando `PeriodUnit` é definido como `Year`, os valores válidos de `Duration` são: {"1", "2", "3", "4", "5"} Quando `PeriodUnit` é definido como `Month`, os valores válidos de `Duration` são: {"1", "2", "3", "6", "12", "24", "36", "48", "60"}	1
AutoRenew	boolean	Não	Especifica se a instância deve ser renovada automaticamente antes de expirar. true: ativa a renovação automática. false: desativa a renovação automática. Valor padrão: false.	true
RenewalStatus	string	Não	O status de renovação automática da instância. Valores válidos: AutoRenewal: ativa a renovação automática. Normal: desativa a renovação automática. NotRenewal: não renova a instância. Após a definição deste valor, o sistema não envia mais lembretes de expiração e envia apenas um lembrete de não renovação três dias antes da expiração da instância. As instâncias ECS configuradas para não renovar podem ser alteradas para renovação pendente (`Normal`) e, em seguida, renovadas manualmente ou configuradas para renovação automática. Nota O parâmetro `RenewalStatus` tem precedência sobre o parâmetro `AutoRenew`. Se o parâmetro `RenewalStatus` não for especificado, o parâmetro `AutoRenew` entrará em vigor por padrão.	AutoRenewal
PeriodUnit	string	Não	A unidade da duração da renovação, ou seja, a unidade do parâmetro `Duration`. Valores válidos: Month (padrão) Year	Month

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	OperationDenied.StarterPackage	Instance created with a Starter Package plan can not set auto renew.
500	InternalError	The request processing has failed due to some unknown error.
403	MissingParameter.InstanceId	InstanceId should not be null.	The InstanceId parameter is required.
403	InvalidParameter.ToManyInstanceIds	InstanceId should be less than 100.
403	InvalidParameter.InvalidInstanceId	%s	The specified InstanceId parameter is invalid.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	ChargeTypeViolation	Pay-As-You-Go instances do not support this operation.	The operation is not supported by pay-as-you-go instances. Check the billing method of the instance.
403	InvalidParameter.Duration	%s	The specified Duration parameter is invalid.
403	InvalidParameter.RenewalStatus	%s	The specified RenewalStatus parameter is invalid.
403	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.
403	InvalidPeriod.StarterPackage	This instance was created by using a Starter Package plan and can only be renewed monthly, not yearly.	The instance was created in a Starter Package plan and can only be automatically renewed on a monthly basis.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.