Todos os produtos
Search
Central de documentação

CloudFlow:Wait

Última atualização: Jun 28, 2026

O estado Wait pausa a execução de um fluxo por um número especificado de segundos e retoma a partir do próximo estado. Use esse recurso para introduzir atrasos entre estados, como aguardar antes de tentar novamente uma operação ou espaçar chamadas de API.

Importante

A duração máxima da pausa depende do modo de fluxo:

  • Modo Standard: 1 a 300 segundos

  • Modo Express: 1 a 20 segundos

Atributos

Atributo

Tipo

Obrigatório

Descrição

Type

string

Sim

Tipo de estado. Defina como Wait.

Name

string

Sim

Nome do estado.

Seconds

int

Sim

Duração da pausa em segundos. Valores válidos: 1 a 300 (modo Standard) ou 1 a 20 (modo Express). Para definir o valor dinamicamente, use uma expressão (consulte Definir a duração da espera dinamicamente).

Description

string

Não

Descrição do estado.

Next

string

Não

Estado executado após a conclusão deste. Não obrigatório se End for true.

End

bool

Não

Marca este estado como terminal no escopo atual.

InputConstructor

map[string]any

Não

Construtor de entrada. Para mais detalhes, consulte a seção InputConstructor em Entradas e saídas.

OutputConstructor

map[string]any

Não

Construtor de saída. Para mais detalhes, consulte a seção OutputConstructor em Entradas e saídas.

Exemplos

Aguardar um número fixo de segundos

O fluxo a seguir pausa por 12 segundos antes de terminar:

Type: StateMachine
Name: my-wkfl
SpecVersion: v1
StartAt: Wait1
States:
  - Type: Wait
    Name: Wait1
    Seconds: 12
    End: true

Definir a duração da espera dinamicamente

Para determinar a duração da pausa em tempo de execução, use o sufixo .$ no campo Seconds para ler o valor da entrada do fluxo.

Type: StateMachine
Name: my-wkfl
SpecVersion: v1
StartAt: DynamicWait
States:
  - Type: Wait
    Name: DynamicWait
    Seconds.$: $Input.timeout
    End: true

Neste exemplo, Seconds.$: $Input.timeout lê o valor de timeout da entrada do fluxo e o utiliza como duração da pausa em segundos.