:UpdateTaskFlowSchedule

Vous pouvez appeler cette opération pour mettre à jour les configurations de planification d'un flux de tâches en cours de modification. Vous avez la possibilité de configurer une planification ponctuelle, une planification récurrente et une planification événementielle. La planification ponctuelle permet de définir une exécution unique ou périodique. La planification événementielle permet de configurer des abonnements à des flux de tâches et à des nœuds de flux de tâches.

Une fois la configuration mise à jour, le flux de tâches est republié et déployé. Les nouvelles instances de flux de tâches sont planifiées selon les nouveaux paramètres définis.

Paramètres de requête

Paramètres de planification

Planification ponctuelle : vous pouvez configurer ce paramètre pour une planification unique ou périodique.

Les paramètres suivants sont requis :

• ScheduleSwitch : True

• TriggerType : Cron

• CronBeginDate

• CronEndDate

• CronStr

• CronType

• ScheduleParam : La planification s'effectue une seule fois ou par jour, semaine ou mois.

Exemple :

Planification par jour :

json
{
    "triggerType":"0",
    "dateTime":"00:00"
}

Planification par semaine : « 1 » pour dimanche, « 2 » pour lundi, … « 7 » pour samedi.

json
{
    "triggerType":"0",
    "dateWeek":[
        "1",
        "5"
    ],
    "weekTime":"00:00"
}

Planification par mois :

json
{
    "triggerType":"0",
    "dateMonth":"1",
    "MonthTime":"00:00"
}

Planification unique :

json
{
    "triggerType":"1",
    "specificTime":"2022-09-02 00:00"
}

Paramètres

1. CronStr : la planification du flux de tâches est basée sur la valeur de CronStr.

2. CronBeginDate et CronEndDate : lors d'une planification périodique, CronBeginDate, CronEndDate et CronStr définissent la planification du flux de tâches. Si le moment spécifié par CronStr se situe dans la plage comprise entre CronBeginDate et CronEndDate, la tâche est déclenchée.

3. CronType : utilisé pour la vérification. Vous devez configurer ce paramètre en fonction du cycle défini par CronStr.

4. ScheduleParam : vous devez configurer ce paramètre en fonction du type de planification spécifié par CronStr.

Planification événementielle (déclenchement automatique entre les flux de tâches)

Les paramètres suivants sont requis :

• ScheduleSwitch : True

• TriggerType : Event

• ScheduleParam

Exemple :

json
{
    "triggerType":"2" // Set the value to 2 for event scheduling.
    "deps":[ // Configure the subscription to task flows/nodes.
        {
            "eventType":1, // Subscription type: "0" for task flow and "1" for task node.
            "lisDagId":12345, // The task flow where the subscribed node resides.
            "lisNodeId":2134 // The ID of the subscribed node.
        },
        {
            "eventType":0,
            "lisDagId":12343 // The ID of the subscribed task flow.
        },
        {
            "eventType":0,
            "lisDagId":23456
        }
    ],
    "maxWait":21600 // The longest amount of time to wait for the preceding subscriptions to complete.
}

Paramètres de réponse

Exemples

Exemples de requêtes

http(s)://dms-enterprise.aliyuncs.com/?Action=UpdateTaskFlowSchedule
&ScheduleSwitch=false
&CronBeginDate=CronBeginDate_test
&CronEndDate=CronEndDate_test
&ScheduleParam=ScheduleParam_test
&CronStr=CronStr_test
&TriggerType=Event
&CronType=HOUR
&TimeZoneId=Asia/Shanghai
&Common request parameters

Exemples de réponses

Format XML

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

<UpdateTaskFlowScheduleResponse>
    <RequestId>7BF38A13-C181-5B5E-97F1-8643F8A10093</RequestId>
    <ErrorCode>InvalidParameterValid</ErrorCode>
    <ErrorMessage>InvalidParameterValid</ErrorMessage>
    <Success>true</Success>
</UpdateTaskFlowScheduleResponse>

Format JSON

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

{
  "RequestId" : "7BF38A13-C181-5B5E-97F1-8643F8A10093",
  "ErrorCode" : "InvalidParameterValid",
  "ErrorMessage" : "InvalidParameterValid",
  "Success" : true
}

Codes d'erreur

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