CreateScheduledTask - Auto Scaling - Centro de documentación de Alibaba Cloud

Crea una tarea programada.

Descripción de la operación

Si una tarea programada no logra activar una regla de escalado porque hay una actividad de escalado en curso en el grupo de escalado o porque el grupo de escalado está deshabilitado, la tarea programada reintenta automáticamente dentro del período especificado por LaunchExpirationTime. De lo contrario, la tarea programada se omite.
Si varias tareas programadas activan reglas de escalado para el mismo grupo de escalado dentro de un marco de tiempo similar, los detalles de las actividades de escalado activadas son los siguientes:
- Grupos de escalado con el número esperado de instancias configurado: Las actividades de escalado activadas por múltiples tareas programadas son actividades de escalado paralelas. Por ejemplo, cuando se ejecutan múltiples tareas programadas dentro de un marco de tiempo similar, el grupo de escalado puede activar múltiples actividades de escalado paralelas simultáneamente.
- Grupos de escalado sin el número esperado de instancias configurado: La tarea programada activada primero ejecuta la actividad de escalado en primer lugar. Dado que un grupo de escalado solo puede tener una actividad de escalado a la vez, las tareas programadas subsiguientes reintentan automáticamente dentro del período especificado por LaunchExpirationTime. Si la actividad de escalado anterior se completa mientras una tarea programada subsiguiente aún está reintentando dentro del período de LaunchExpirationTime, se ejecuta la regla de escalado de esa tarea programada y se activa la actividad de escalado correspondiente.
Las tareas programadas admiten los siguientes dos métodos de escalado:
- Utilice el parámetro ScheduledAction para especificar la regla de escalado que se debe ejecutar.
- Utilice el parámetro ScalingGroupId para especificar el número de instancias en el grupo de escalado.

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

ess:CreateScheduledTask

create

*ScalingGroup

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región donde reside la tarea programada.	cn-qingdao
ScheduledTaskName	string	No	El nombre de la tarea programada. El nombre debe tener entre 2 y 64 caracteres de longitud y puede contener letras, dígitos, guiones bajos (_), guiones (-) y puntos (.). Debe comenzar con un dígito, una letra o un carácter chino. El nombre debe ser único dentro de la misma cuenta en la misma región. Valor predeterminado: el valor de `ScheduledTaskId`.	scheduled****
Description	string	No	La descripción de la tarea programada. La descripción debe tener entre 2 y 200 caracteres de longitud.	Tarea programada de prueba
ScheduledAction	string	No	La regla de escalado que se debe ejecutar cuando se active la tarea programada. Establezca este parámetro en el identificador único de la regla de escalado. Si especifica este parámetro, el método de escalado de la tarea programada consiste en utilizar una regla de escalado existente. Nota No puede especificar `ScheduledAction` y `ScalingGroupId` al mismo tiempo.	ari:acs:ess:cn-hangzhou:140692647**:scalingrule/asr-bp12tcnol686y1ik**
RecurrenceEndTime	string	No	La hora de finalización de la recurrencia de la tarea programada. Especifique la hora en formato estándar ISO 8601 en UTC. Formato: `AAAA-MM-DDThh:mmZ`. La hora de finalización no puede superar los 365 días a partir de la fecha de creación.	2014-08-17T16:55Z
LaunchTime	string	No	El momento en el que se activa la tarea programada. Especifique la hora en formato estándar ISO 8601 en UTC. Formato: `AAAA-MM-DDThh:mmZ`. La hora no puede superar los 90 días a partir de la fecha de creación. Si especifica `RecurrenceType`, la tarea programada se ejecuta repetidamente a la hora especificada por este parámetro. Si no especifica `RecurrenceType`, la tarea se ejecuta solo una vez en la fecha y hora especificadas.	2014-08-17T16:52Z
RecurrenceType	string	No	El tipo de recurrencia de la tarea programada. Valores válidos: Daily: La tarea programada se ejecuta una vez cada cierto número de días especificado. Weekly: La tarea programada se ejecuta en días específicos de cada semana. Monthly: La tarea programada se ejecuta en días específicos de cada mes. Cron: La tarea programada se ejecuta según la expresión cron especificada. Debe especificar tanto `RecurrenceType` como `RecurrenceValue`.	Daily
RecurrenceValue	string	No	El valor de recurrencia de la tarea programada. Si `RecurrenceType` se establece en `Daily`, solo puede especificar un valor. Valores válidos: 1 a 31. Si `RecurrenceType` se establece en `Weekly`, puede especificar varios valores separados por comas (,). Los valores que corresponden a domingo, lunes, martes, miércoles, jueves, viernes y sábado son `0,1,2,3,4,5,6`. Si `RecurrenceType` se establece en `Monthly`, el valor tiene el formato `A-B`. Valores válidos de A y B: 1 a 31. B debe ser mayor o igual que A. Si `RecurrenceType` se establece en `Cron`, el valor es una expresión cron basada en UTC que admite cinco campos: minuto, hora, día, mes y día de la semana. Se admiten los siguientes caracteres comodín: coma (,), signo de interrogación (?), guion (-), asterisco (*), almohadilla (#), barra diagonal (/), L y W. Debe especificar tanto `RecurrenceType` como `RecurrenceValue`.	1
TaskEnabled	boolean	No	Especifica si se debe habilitar la tarea programada. Valores válidos: true: habilita la tarea. false: deshabilita la tarea. Valor predeterminado: true.	true
LaunchExpirationTime	integer	No	El período durante el cual se reintenta una tarea programada fallida. Unidad: segundos. Valores válidos: 0 a 1800. Valor predeterminado: 600.	600
MinValue	integer	No	El número mínimo de instancias en el grupo de escalado cuando el método de escalado de la tarea programada consiste en establecer el número de instancias en el grupo de escalado.	0
MaxValue	integer	No	El número máximo de instancias en el grupo de escalado cuando el método de escalado de la tarea programada consiste en establecer el número de instancias en el grupo de escalado.	10
DesiredCapacity	integer	No	El número esperado de instancias en el grupo de escalado cuando el método de escalado de la tarea programada consiste en establecer el número de instancias en el grupo de escalado. Nota El grupo de escalado debe tener habilitada la función de número esperado de instancias, lo que significa que se especificó `DesiredCapacity` al crear el grupo de escalado.	10
ScalingGroupId	string	No	El ID del grupo de escalado cuyo número de instancias se modifica cuando se activa la tarea programada. Si especifica este parámetro, el método de escalado de la tarea programada consiste en establecer el número de instancias en el grupo de escalado. Debe especificar un valor para al menos uno de los siguientes parámetros: `MinValue`, `MaxValue` y `DesiredCapacity`. Nota No puede especificar `ScheduledAction` y `ScalingGroupId` al mismo tiempo.	asg-bp18p2yfxow2dloq****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
ScheduledTaskId	string	El ID de la tarea programada. El ID es único a nivel global y generado por el sistema.	edRtShc57WGXdt8TlPbr****
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "ScheduledTaskId": "edRtShc57WGXdt8TlPbr****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Códigos de error

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.