CreateScheduledTask - Auto Scaling - Centre de documentation Alibaba Cloud

Notes d'utilisation

Si une tâche planifiée échoue en raison d'une activité de mise à l'échelle en cours ou d'un groupe de mise à l'échelle désactivé, le système tente automatiquement de nouveau son exécution dans la fenêtre temporelle définie par LaunchExpirationTime. Si cette nouvelle tentative échoue également, la tâche planifiée est ignorée pour cette occurrence.
Lorsque plusieurs tâches planifiées tentent simultanément d'exécuter la même règle de mise à l'échelle pour un groupe donné, les règles suivantes s'appliquent :
- Groupes de mise à l'échelle avec un nombre attendu d'instances configuré : les activités de mise à l'échelle déclenchées par les tâches planifiées s'exécutent en parallèle. Dans un court laps de temps, Auto Scaling peut déclencher plusieurs tâches planifiées et exécuter leurs activités de mise à l'échelle simultanément.
- Groupes de mise à l'échelle sans nombre attendu d'instances configuré : seule l'activité de mise à l'échelle issue de la tâche planifiée la plus ancienne s'exécute. Comme un groupe de mise à l'échelle ne prend en charge qu'une seule activité active à la fois, les autres tâches planifiées retentent automatiquement leur exécution dans la fenêtre LaunchExpirationTime. Une fois la première activité terminée, les nouvelles tentatives des autres tâches dans la fenêtre exécutent à nouveau la règle de mise à l'échelle, chacune générant une activité distincte.
Définissez le mode de mise à l'échelle d'une tâche planifiée en utilisant l'une des méthodes suivantes :
- ScheduledAction : spécifiez une règle de mise à l'échelle existante qu'Auto Scaling doit exécuter lorsque la tâche planifiée est déclenchée.
- ScalingGroupId : spécifiez le nombre minimal, maximal ou attendu d'instances pour le groupe de mise à l'échelle auquel vous associez la tâche planifiée.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour votre commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateScheduledTask	L'opération que vous souhaitez effectuer. Définissez la valeur sur CreateScheduledTask.
RegionId	String	Yes	cn-qingdao	L'ID de région de la tâche planifiée.
ScheduledTaskName	String	No	scheduled****	Le nom de la tâche planifiée. La longueur du nom doit être comprise entre 2 et 64 caractères et peut contenir des lettres, des chiffres, des traits de soulignement (_), des traits d'union (-) et des points (.). Il doit commencer par une lettre ou un chiffre. Le nom d'une tâche planifiée doit être unique dans la région et au sein du compte Alibaba Cloud. Si vous ne spécifiez pas ce paramètre, la valeur de `ScheduledTaskId` est utilisée.
Description	String	No	Test scheduled task.	La description de la tâche planifiée. La longueur de la description doit être comprise entre 2 et 200 caractères.
ScheduledAction	String	No	ari:acs:ess:cn-hangzhou:140692647:scalingrule/asr-bp12tcnol686y1ik	La règle de mise à l'échelle à exécuter lorsque la tâche planifiée est déclenchée. Spécifiez l'identifiant unique de la règle de mise à l'échelle. Si vous spécifiez ce paramètre, vous devez indiquer une règle de mise à l'échelle existante pour la tâche planifiée. Remarque Si vous spécifiez `ScheduledAction`, vous ne pouvez pas spécifier `ScalingGroupId`.
RecurrenceEndTime	String	No	2014-08-17T16:55Z	L'heure de fin de la tâche planifiée récurrente. Spécifiez l'heure selon la norme ISO 8601 au format AAAA-MM-JJThh:mmZ. L'heure de fin ne doit pas dépasser 365 jours après la création de la tâche.
LaunchTime	String	Yes	2014-08-17T16:52Z	L'heure de début de la tâche planifiée. Spécifiez l'heure selon la norme ISO 8601 au format L'heure de début ne doit pas dépasser 90 jours après la création de la tâche. Si vous spécifiez le paramètre `RecurrenceType`, la tâche planifiée est exécutée de manière répétée à l'instant spécifié par le paramètre LaunchTime. Si vous ne spécifiez pas `RecurrenceType`, la tâche planifiée n'est exécutée qu'une seule fois à l'instant spécifié par LaunchTime.
RecurrenceType	String	No	Daily	Le type de récurrence de la tâche planifiée. Valeurs valides : Daily : la tâche planifiée est exécutée une fois tous les X jours spécifiés. Weekly : la tâche planifiée est déclenchée de manière répétée les jours spécifiés de chaque semaine. Monthly : la tâche planifiée est exécutée chaque jour spécifié du mois. Cron : la tâche planifiée est exécutée selon l'expression cron spécifiée. Si vous spécifiez `RecurrenceType`, vous devez également spécifier `RecurrenceValue`.
RecurrenceValue	String	No	1	La valeur de récurrence de la tâche planifiée. Si vous définissez le paramètre `RecurrenceType` sur `Daily`, vous ne pouvez spécifier qu'une seule valeur. Valeurs valides : 1 à 31. Si vous définissez le paramètre `RecurrenceType` sur `Weekly`, vous pouvez spécifier plusieurs valeurs. Séparez les valeurs par des virgules (,). Les valeurs correspondant à dimanche, lundi, mardi, mercredi, jeudi, vendredi et samedi sont respectivement 0, 1, 2, 3, 4, 5 et 6. Si vous définissez le paramètre `RecurrenceType` sur `Monthly`, vous pouvez spécifier deux valeurs au format `A-B`. Valeurs valides pour A et B : 1 à 31. B doit être supérieur ou égal à A. Si vous définissez le paramètre `RecurrenceType` sur `Cron`, vous pouvez spécifier une expression cron. Une expression cron est écrite en temps UTC et se compose des champs suivants : minute, heure, jour, mois et semaine. L'expression peut contenir les lettres L et W ainsi que les caractères génériques suivants : virgules (,), points d'interrogation (?), traits d'union (-), astérisques (*), dièses (#) et barres obliques (/). Si vous spécifiez `RecurrenceType`, vous devez également spécifier `RecurrenceValue`.
TaskEnabled	Boolean	No	true	Indique si la tâche planifiée est activée. true false Valeur par défaut : true.
LaunchExpirationTime	Integer	No	600	La période pendant laquelle une tâche planifiée ayant échoué fait l'objet de nouvelles tentatives. Unité : secondes. Valeurs valides : 0 à 21600. Valeur par défaut : 600.
MinValue	Integer	No	0	Le nombre minimal d'instances à maintenir dans le groupe de mise à l'échelle. Ce paramètre est disponible uniquement si vous spécifiez ScalingGroupId.
MaxValue	Integer	No	10	Le nombre maximal d'instances pouvant être contenues dans le groupe de mise à l'échelle. Ce paramètre est disponible uniquement si vous spécifiez ScalingGroupId.
DesiredCapacity	Integer	No	10	Le nombre attendu d'instances dans le groupe de mise à l'échelle. Ce paramètre est disponible uniquement si vous spécifiez ScalingGroupId. Remarque Ce paramètre prend effet uniquement si vous spécifiez `DesiredCapacity` lors de la création du groupe de mise à l'échelle.
ScalingGroupId	String	No	asg-bp18p2yfxow2dloq****	L'ID du groupe de mise à l'échelle auquel s'applique la tâche planifiée. Si vous spécifiez ce paramètre, vous devez également spécifier au moins l'un des paramètres suivants : `MinValue`, `MaxValue` et `DesiredCapacity`. Remarque Si vous spécifiez `ScalingGroupId`, vous ne pouvez pas spécifier `ScheduledAction`.

Paramètres de réponse

Parameter

Type

Example

Description

ScheduledTaskId

String

edRtShc57WGXdt8TlPbr****

L'ID globalement unique de la tâche planifiée.

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

L'ID de la requête.

Exemples

Exemple de requêtes

http(s)://ess.aliyuncs.com/?Action=CreateScheduledTask
&RegionId=cn-qingdao
&ScheduledTaskName=scheduled****
&Description=Test scheduled task.
&ScheduledAction=ari:acs:ess:cn-hangzhou:140692647****:scalingrule/asr-bp12tcnol686y1ik****
&RecurrenceEndTime=2014-08-17T16:55Z
&LaunchTime=2014-08-17T16:52Z
&RecurrenceType=Daily
&RecurrenceValue=1
&TaskEnabled=true
&LaunchExpirationTime=600
&MinValue=0
&MaxValue=10
&DesiredCapacity=10
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&<Common request parameters>

Exemple de réponses réussies

XML format

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

<CreateScheduledTaskResponse>
    <ScheduledTaskId>edRtShc57WGXdt8TlPbr****</ScheduledTaskId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</CreateScheduledTaskResponse>

JSON format

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

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

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.

HTTP status code

Error code

Error message

Description

404

InvalidRegionId.NotFound

The specified region does not exist.

La région spécifiée n'existe pas.

400

InvalidScheduledTaskName.Duplicate

The specified value of parameter ScheduledTaskName is duplicated.

Une tâche planifiée portant ce nom existe déjà.

400

QuotaExceeded.ScheduledTask

Scheduled task quota exceeded.

Le compte actuel a atteint sa capacité maximale en tâches planifiées.

400

ScheduledAction.RegionMismatch

The specified scheduled task and the specified scheduled action are not in the same Region.

La règle de mise à l'échelle spécifiée et la tâche planifiée spécifiée se trouvent dans des régions différentes.