Todos os produtos
Search
Central de documentação

CloudOps Orchestration Service:ACS::TimerTrigger action

Última atualização: Sep 09, 2026

Finalidade

Use esta ação em cenários de O&M que exigem agendamento. Quando uma execução é iniciada, o Operation Orchestration Service (OOS) a coloca no status Waiting. A execução aguarda até o horário especificado para executar as tarefas subsequentes. Após a conclusão das tarefas, a execução retorna ao status Waiting.

Limites

Os acionadores têm os seguintes limites:

  • Um modelo pode ter apenas uma ação de acionador.

  • A tarefa com a ação de acionador deve ser a primeira na seção Tasks do modelo.

  • Ações de acionador não são permitidas em modelos aninhados (modelos filhos).

Sintaxe

  • Formato YAML

Tasks:
  - Name: timerTask # The name of the task.
    Action: ACS::TimerTrigger
    Properties:
      Type: cron # Required. The time type. Valid values: cron, at, and rate.
      Expression: '0 * * ? * *' # Required. A cron expression, a date and time expression, or a rate expression. By default, cron expressions are based on UTC.
      TimeZone: 'Asia/Shanghai' #  Optional. The time zone. The default is UTC.
      StartDate: '2020-12-20T09:19:30Z' # Optional. The start time. The time is in UTC and must be in the YYYY-MM-DD or YYYY-MM-DDThh:mm:ssZ format. If you do not specify this parameter, the execution start time is used by default.      
      EndDate: '2020-12-29T09:19:30Z' # Required. The end time. The time is in UTC and must be in the YYYY-MM-DD or YYYY-MM-DDThh:mm:ssZ format.
  • Formato JSON (para obter detalhes, consulte os comentários no exemplo YAML)

{
  "Tasks": [
    {
      "Name": "timerTask",
      "Action": "ACS::TimerTrigger",
      "Properties": {
        "Type": "cron",
        "Expression": "0 * * ? * *",
        "StartDate": "2020-12-20T09:19:30Z",
        "EndDate": "2020-12-29T09:19:30Z",
        "TimeZone": "Asia/Shanghai"
      }
    }
  ]
}

Fluxograma

O fluxograma funciona da seguinte maneira:

  • Após a criação da execução, a execução pai entra no status Waiting.

  • No horário especificado, a execução pai passa para o status Running e cria automaticamente uma execução filha com o mesmo modelo e parâmetros. A execução filha ignora a tarefa de acionador e executa diretamente as tarefas subsequentes.

  • Quando a execução filha termina com status Success, Failed ou Cancelled, a execução pai retorna ao status Waiting. Em seguida, aguarda o próximo horário agendado e repete o processo.

  • Ao atingir o horário final, a execução pai para de aguardar, é concluída e recebe o status Success.

  • Cancele uma execução pai ou filha da mesma forma que cancela uma execução normal. O status de uma execução cancelada é Cancelled.

Exemplos

Tipo cron

  • Formato YAML:

FormatVersion: OOS-2019-06-01
Description: Schedule to reboot ECS instances.
Tasks:
  - Name: timer
    Action: ACS::TimerTrigger
    Properties:
      Type: cron
      Expression: "0 * * ? * *"
      StartDate: 2020-12-10T00:00:00Z
      EndDate: 2020-12-20T00:00:00Z
  - Name: rebootInstance
    Action: ACS::ECS::RebootInstance
    Properties:
      InstanceId: "i-xxxxx"
  • Formato JSON:

{
  "FormatVersion": "OOS-2019-06-01",
  "Description": "Schedule to reboot ECS instances.",
  "Tasks": [
    {
      "Name": "timer",
      "Action": "ACS::TimerTrigger",
      "Properties": {
        "Type": "cron",
        "Expression": "0 * * ? * *",
        "StartDate": "2020-12-10T00:00:00Z",
        "EndDate": "2020-12-20 00:00:00 UTC"
      }
    },
    {
      "Name": "rebootInstance",
      "Action": "ACS::ECS::RebootInstance",
      "Properties": {
        "InstanceId": "i-xxxxx"
      }
    }
  ]
}

Tipo at

  • Formato YAML:

FormatVersion: OOS-2019-06-01
Description: Schedule to reboot ECS instances.
Tasks:
  - Name: timer
    Action: ACS::TimerTrigger
    Properties:
      Type: at
      Expression: '2020-02-29T09:17:35Z'
      EndDate: 2020-12-20T00:00:00Z
  - Name: rebootInstance
    Action: ACS::ECS::RebootInstance
    Properties:
      InstanceId: "i-xxxxx"
  • Formato JSON:

{
  "FormatVersion": "OOS-2019-06-01",
  "Description": "Schedule to reboot ECS instances.",
  "Tasks": [
    {
      "Name": "timer",
      "Action": "ACS::TimerTrigger",
      "Properties": {
        "Type": "at",
        "Expression": "2020-02-29T09:17:35Z",
        "EndDate": "2020-12-20T00:00:00.000Z"
      }
    },
    {
      "Name": "rebootInstance",
      "Action": "ACS::ECS::RebootInstance",
      "Properties": {
        "InstanceId": "i-xxxxx"
      }
    }
  ]
}