A tarefa Cronômetro permite adicionar um atraso no
fluxo de execução da integração.
Durante uma execução de integração, quando o controle atinge a tarefa de timer, a execução é pausada pelo limite de tempo especificado, e todas as tarefas após a tarefa de timer são suspensas. Esta tarefa é compatível apenas com a retomada automática de uma integração. A execução da integração será retomada automaticamente após o término do limite de tempo de suspensão. Por exemplo, se você definir a tarefa de timer como 180 segundos, a execução será pausada por 3 minutos antes de ser retomada automaticamente.
Comparação entre tarefas de aprovação, de suspensão e de timer
As três tarefas (Aprovação,
Suspensão
e Cronômetro) executam uma função
semelhante de pausar e retomar uma integração. No entanto, há diferenças sutis entre elas. A tabela a seguir descreve as diferenças entre as três tarefas.
Tarefa "Aprovação"
Suspender tarefa
Tarefa cronômetro
Não é compatível com a retomada automática de uma integração e exige
intervenção manual para retomar a integração.
Aceita a retomada manual e automática de uma integração. Se não houver
uma intervenção manual para revogar a suspensão, a integração retomará
a execução automaticamente após o término do limite de tempo de suspensão.
Aceita apenas a retomada automática de uma integração. A execução da integração será retomada automaticamente após o término do limite de tempo de suspensão.
Não é possível retomar uma integração por meio de uma chamada de API. Resolva manualmente a
suspensão usando a IU de integrações.
Pode retomar uma integração usando a API Suspensions para integrações.
Aceita apenas a retomada automática de uma integração.
Os usuários recebem uma notificação quando uma integração é pausada (suspensa).
Os usuários não recebem nenhuma notificação quando uma integração é pausada (suspensa).
Os usuários não recebem nenhuma notificação quando uma integração é pausada (suspensa).
Aceita uma variável de saída (booleana), que permite realizar verificações condicionais
antes de retomar uma integração. No entanto, a variável de saída só pode ter o valor de true ou false.
Aceita uma variável de saída (string), que permite realizar verificações condicionais
antes de retomar uma integração. É possível definir qualquer valor para a variável de saída.
Não é compatível com nenhuma variável de saída.
Configurar a tarefa de cronômetro
Para configurar a tarefa Cronômetro:
No console Google Cloud , acesse a página Integração de aplicativos.
A página Integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.
Selecione uma integração ou clique em Criar integração para criar uma nova.
Caso você esteja criando uma nova integração, siga estas etapas:
Insira um nome e uma descrição no painel Criar integração.
Selecione uma região para a integração.
Selecione uma conta de serviço para a integração. É possível mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel infoResumo da integração na barra de ferramentas de integração.
Clique em Criar. A integração recém-criada é aberta no editor de integração.
Na barra de navegação do editor de integração, clique em Tarefas para conferir a lista de tarefas e conectores disponíveis.
Clique e coloque o elemento de tarefa Timer no editor de integração.
Clique no elemento de tarefa Cronômetro no designer para visualizar o painel de configuração de tarefa
Cronômetro.
Configure os campos restantes usando as propriedades de configuração da tarefa. Por exemplo, se você definir Tempo limite após como 180 e Unidade de tempo como Seconds, a execução será pausada por três minutos antes de ser retomada automaticamente.
As alterações nas propriedades são salvas automaticamente.
Propriedades de configuração
A tabela a seguir descreve as propriedades de configuração da tarefa Tempo.
Propriedade
Tipo de dado
Descrição
Timeout after
Inteiro
Tempo para a execução da integração ser pausada. A Apigee
retoma automaticamente a execução da próxima tarefa downstream após o término do
limite de tempo.
Valor padrão: 120 segundos (2 minutos).
Limite máximo de tempo permitido: 44.640 minutos (31 dias).
Time unit
Segundos, minutos, horas, dias
Unidade de tempo da propriedade Tempo limite após.
Estratégia de solução de erros
A estratégia de solução de erros para uma tarefa especifica a ação a ser realizada se a tarefa falhar
devido a um erro temporário. Para mais informações sobre como usar uma estratégia de tratamento de erros e conhecer os diferentes tipos de estratégias de tratamento de erros, consulte Estratégias de tratamento de erros.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-25 UTC."],[[["\u003cp\u003eThe Timer task in Application Integration allows you to pause integration execution for a specified duration before automatically resuming.\u003c/p\u003e\n"],["\u003cp\u003eUnlike the Approval and Suspend tasks, the Timer task only supports automatic resumption and does not require or allow manual intervention.\u003c/p\u003e\n"],["\u003cp\u003eThe Timer task's pause duration is configurable via the "Timeout after" property and "Time unit," with a default of 120 seconds (2 minutes) and a maximum limit of 31 days.\u003c/p\u003e\n"],["\u003cp\u003eThe Timer task does not support output variables or user notifications when an integration pauses, differing from other similar tasks like the Approval and Suspend tasks.\u003c/p\u003e\n"],["\u003cp\u003eYou can configure a Timer task to pause an integration by setting a desired timeout and time unit in the task configuration pane, and this task is part of the broader set of supported connectors for Application Integration.\u003c/p\u003e\n"]]],[],null,["# Timer task\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nTimer task\n==========\n\nThe **Timer** task lets you add a time delay to the\nintegration execution flow.\n\nDuring an integration execution, when the control reaches the Timer task, execution is paused for the specified time limit, and all tasks after the Timer task are suspended. This task supports only automatic resumption of an integration. The integration execution automatically resumes after the expiry of the suspension time limit. For example, if you set the timer task to 180 seconds, the execution is paused for 3 minutes before resuming automatically.\n| **Note:** If you set the timer task to less than 60 seconds, the suspend state will be consistent as synchronous execution mode. Otherwise, the suspend state is consistent with the asynchronous execution mode.\n\nCompare Approval task, Suspend task, and Timer task\n---------------------------------------------------\n\nAll the three ([Approval](/application-integration/docs/approval-task),\n[Suspend](/application-integration/docs/run-suspend-task),\nand [Timer](/application-integration/docs/run-timer-task)) tasks perform a similar\nfunction of pausing and resuming an integration. However, there are subtle differences\namong them. The following table describes the differences amongst the three tasks.\n\nConfigure the Timer task\n------------------------\n\nTo configure the **Timer** task:\n\n1. In the Google Cloud console, go to the **Application Integration** page.\n\n [Go to Application Integration](https://console.cloud.google.com/integrations)\n2. In the navigation menu, click **Integrations** .\n\n\n The **Integrations** page appears listing all the integrations available in the Google Cloud project.\n3. Select an existing integration or click **Create integration** to create a new one.\n\n\n If you are creating a new integration:\n 1. Enter a name and description in the **Create Integration** pane.\n 2. Select a region for the integration. **Note:** The **Regions** dropdown only lists the regions provisioned in your Google Cloud project. To provision a new region, click **Enable Region** . See [Enable new region](/application-integration/docs/enable-new-region) for more information.\n 3. Select a service account for the integration. You can change or update the service account details of an integration any time from the info **Integration summary** pane in the integration toolbar. **Note:** The option to select a service account is displayed only if you have enabled integration governance for the selected region.\n 4. Click **Create** . The newly created integration opens in the *integration editor*.\n\n\n4. In the *integration editor* navigation bar, click **Tasks** to view the list of available tasks and connectors.\n5. Click and place the **Timer** task element in the integration editor.\n6. Click the **Timer** task element on the designer to view the **Timer** task configuration pane.\n7. Configure the remaining fields using the [Configuration properties](#params) for the task. For example, if you set **Timeout after** to `180` and **Time unit** to `Seconds`, the execution is paused for 3 minutes before resuming automatically.\n8. Changes to the properties are saved automatically.\n\nConfiguration properties\n------------------------\n\n\nThe following table describes the configuration properties of the Timer task.\n\nError handling strategy\n-----------------------\n\n\nAn error handling strategy for a task specifies the action to take if the task fails due to a [temporary error](/application-integration/docs/error-handling). For information about how to use an error handling strategy, and to know about the different types of error handling strategies, see [Error handling strategies](/application-integration/docs/error-handling-strategy).\n\nQuotas and limits\n-----------------\n\nFor information about quotas and limits, see [Quotas and limits](/application-integration/docs/quotas).\n\nWhat's next\n-----------\n\n- Learn about [all tasks and triggers](/application-integration/docs/all-triggers-tasks).\n- Learn how to [test and publish an integration](/application-integration/docs/test-publish-integrations).\n\n- Learn about [error handling](/application-integration/docs/error-handling-strategy).\n- Learn about [integration execution logs](/application-integration/docs/introduction-logs)."]]
