ModifyInstanceAutoRenewAttribute - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Modifica los atributos de renovación automática de una o más instancias de suscripción, lo que ayuda a reducir el costo de mantenimiento por vencimiento de recursos.

Descripción de la operación

Antes de utilizar esta API, asegúrese de comprender completamente los métodos de facturación y los precios de Elastic Compute Service (ECS).

Asegúrese de que el saldo de su cuenta o su límite de crédito sea suficiente.
Solo se admiten instancias de suscripción. Se devuelve un error si llama a esta API para instancias de pago por uso.
La fecha de deducción por renovación automática es 9 días antes de que venza la instancia. La deducción comienza a las 08:00:00 (UTC+8).
Si la deducción automática falla el día anterior, se volverá a intentar a la hora programada del día siguiente hasta que la deducción se realice con éxito o la instancia se bloquee tras vencer 9 días después.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ecs:ModifyInstanceAutoRenewAttribute

update

*Instance

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
InstanceId	string	Sí	El ID de la instancia. Puede especificar hasta 100 instancias de suscripción a la vez. Separe varios ID de instancia con comas (,).	i-bp67acfmxazb4ph**,i-bp67acfmxazb4pi**
RegionId	string	Sí	El ID de región de la instancia. Puede llamar a DescribeRegions para ver la lista más reciente de regiones de Alibaba Cloud.	cn-hangzhou
Duration	integer	No	La duración de la renovación automática de la instancia. Cuando `PeriodUnit` se establece en `Year`, los valores válidos de `Duration` son: {"1", "2", "3", "4", "5"} Cuando `PeriodUnit` se establece en `Month`, los valores válidos de `Duration` son: {"1", "2", "3", "6", "12", "24", "36", "48", "60"}	1
AutoRenew	boolean	No	Especifica si se debe renovar automáticamente la instancia antes de que venza. true: habilita la renovación automática. false: deshabilita la renovación automática. Valor predeterminado: false.	true
RenewalStatus	string	No	El estado de renovación automática de la instancia. Valores válidos: AutoRenewal: habilita la renovación automática. Normal: deshabilita la renovación automática. NotRenewal: no renueva la instancia. Después de establecer este valor, el sistema ya no envía recordatorios de vencimiento y solo envía un recordatorio de no renovación tres días antes de que venza la instancia. Las instancias de ECS configuradas para no renovarse pueden cambiarse a pendiente de renovación (`Normal`) y luego renovarse manualmente o configurarse para renovación automática. Nota El parámetro `RenewalStatus` tiene prioridad sobre el parámetro `AutoRenew`. Si no se especifica el parámetro `RenewalStatus`, el parámetro `AutoRenew` surte efecto de forma predeterminada.	AutoRenewal
PeriodUnit	string	No	La unidad de la duración de la renovación, es decir, la unidad del parámetro `Duration`. Valores válidos: Month (predeterminado) Year	Month

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
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 error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.