Suspender tarefa

A tarefa Suspender permite-lhe pausar temporariamente e, em seguida, retomar a execução de uma integração.

Durante a execução de uma integração, quando o controlo atinge uma tarefa de suspensão, a execução é interrompida e todas as tarefas após a tarefa de suspensão são suspensas. A integração retoma a execução quando ocorre um dos seguintes eventos:

Expiração do tempo de suspensão especificado.
Após receber um pedido de retoma da execução da API Suspensions.

Também pode configurar uma variável de saída (Resultado da suspensão) para a tarefa Suspend e defini-la para qualquer valor, bem como usar o valor para criar condições de ramificação para executar as tarefas a jusante.

Compare a tarefa de aprovação, a tarefa de suspensão e a tarefa de temporizador

As três tarefas (Aprovação, Suspender e Temporizador) têm uma função semelhante de pausar e retomar uma integração. No entanto, existem diferenças subtis entre eles. A tabela seguinte descreve as diferenças entre as três tarefas.

Tarefa de aprovação	Suspender tarefa	Tarefa de temporizador
Não suporta o recomeço automático de uma integração e requer intervenção manual para retomar a integração.	Suporta o reinício manual e automático de uma integração. Se não houver intervenção manual para revogar a suspensão, a integração retoma automaticamente a execução após o limite de tempo de suspensão expirar.	Suporta apenas o recomeço automático de uma integração. A execução da integração é retomada automaticamente após a expiração do limite de tempo de suspensão.
Não é possível retomar uma integração através de uma chamada API. Tem de resolver manualmente a suspensão através da IU de integrações.	Pode retomar uma integração através da `Suspensions` API para integrações.	Suporta apenas o recomeço automático de uma integração.
Os utilizadores recebem uma notificação quando uma integração é pausada (suspensa).	Os utilizadores não recebem nenhuma notificação quando uma integração é pausada (suspensa).	Os utilizadores não recebem nenhuma notificação quando uma integração é pausada (suspensa).
Suporta uma variável de saída (booleana), que lhe permite realizar verificações condicionais antes de retomar uma integração. No entanto, a variável de saída só pode ter o valor `true` ou `false`.	Suporta uma variável de saída (string), que lhe permite realizar verificações condicionais antes de retomar uma integração. Pode definir qualquer valor para a variável de saída.	Não suporta variáveis de saída.

Configure a tarefa de suspensão

Para configurar a tarefa Suspender, siga estes passos:

Na Google Cloud consola, aceda à página Application Integration.
Aceda à solução Application Integration
No menu de navegação, clique em Integrações.
A página Integrações é apresentada com todas as integrações disponíveis no projeto do Google Cloud.
Selecione uma integração existente ou clique em Criar integração para criar uma nova.
Se estiver a criar uma nova integração:
1. Introduza um nome e uma descrição no painel Criar integração.
2. Selecione uma região para a integração.
  Nota: o menu pendente Regiões apenas apresenta as regiões aprovisionadas no seu projeto do Google Cloud. Para aprovisionar uma nova região, clique em Ativar região. Consulte o artigo Ative uma nova região para mais informações.
3. Selecione uma conta de serviço para a integração. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
  Nota: a opção para selecionar uma conta de serviço é apresentada apenas se tiver ativado a gestão da integração para a região selecionada.
4. 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 Tasks para ver a lista de tarefas e conetores disponíveis.
Clique e coloque o elemento da tarefa Suspender no editor de integração.
Clique no elemento de tarefa Suspender no estruturador para ver o painel de configuração da tarefa Suspender.
Configure os restantes campos através das Propriedades de configuração da tarefa, conforme detalhado nas tabelas abaixo.
Todas as alterações às propriedades são guardadas automaticamente.

Propriedades de configuração

A tabela seguinte descreve as propriedades de configuração da tarefa Suspend.

Propriedade	Tipo de dados	Descrição
`Suspension Time`	Número inteiro	Tempo (em minutos) até à suspensão da execução da integração. O limite de tempo máximo é de 44640 minutos (31 dias), que também é o valor predefinido. Se a execução da integração não for retomada dentro do limite de tempo especificado, a integração retoma automaticamente a execução após o limite de tempo expirar e define o valor da variável `Suspension result` como `Expired`.
`Suspension result`	String	Uma variável para armazenar o resultado da tarefa Suspender. A definição do valor desta variável é opcional. Pode definir esta variável para qualquer valor com base no seu requisito. Esta variável é útil se quiser ter mais controlo sobre o fluxo de execução da sua integração. Por exemplo, pode ler o resultado da suspensão e configurar decisões condicionais com base no valor em qualquer uma das suas tarefas posteriores.
`Suspension Id`	String	Um identificador exclusivo da tarefa de suspensão. O valor desta variável é definido imediatamente após a suspensão da integração. Pode obter o valor do identificador na página registos de execução na IU de integração. Também pode obter o valor do identificador do objeto de resposta de uma API se estiver a usar uma API para acionar a integração. Pode retomar a execução da integração através do ID de suspensão ou do ID de execução da integração.

Revogue uma suspensão com a API Suspensions

A API Suspensions permite revogar uma suspensão através de uma chamada API. Para revogar uma suspensão com a API Suspensions, tem de ter o ID de execução da integração ou o ID de suspensão da tarefa Suspend. Para revogar uma suspensão, tem de enviar um pedido POST para a seguinte API:

https://REGION-integrations.googleapis.com/v1/{name=projects/PROJECT/locations/LOCATION/integrations/INTEGRATION_ID/executions/EXECUTION_ID/suspensions/SUSPENSION_ID}:lift

Nesta API, o elemento INTEGRATION_ID é opcional. No entanto, tem de fornecer o EXECUTION_ID ou o SUSPENSION_ID. Se não tiver nenhum dos valores de ID, pode substituir o valor por -. Nesta API, REGION, PROJECT e LOCATION são campos obrigatórios.

Depois de revogar a suspensão, a execução da integração é retomada e executa as tarefas a jusante após a tarefa de suspensão.

Os exemplos seguintes mostram como revogar uma suspensão através da API suspensions.

Exemplo 1: revogue uma suspensão apenas com o ID da suspensão

O comando curl seguinte mostra como revogar uma suspensão quando só tem o ID da suspensão:

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"Approved"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/-/suspensions/c6a13a79-a918-41e2-82b9-32b5a010755a:lift

Neste exemplo, a variável Suspension result está definida como Approved para o ID de suspensão c6a13a79-a918-41e2-82b9-32b5a010755a.

Exemplo 2: revogue uma suspensão apenas com o ID de execução

O comando curl seguinte mostra como revogar uma suspensão quando só tem o ID de execução:

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"true"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/76a391e7-c801-45d7-8046-eab20d167ec5/suspensions/-:lift

Neste exemplo, a variável Suspension result está definida como true para o ID de execução 76a391e7-c801-45d7-8046-eab20d167ec5.

Exemplo 3: revogue uma suspensão com o ID de execução e o ID de suspensão

O comando curl seguinte mostra como revogar uma suspensão quando tem o ID de execução e o ID de suspensão:

  curl -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -H X-GFE-SSL: yes \
  -X POST \
  -d '{"suspension_result":"{processname: "Release", owner: "John", status: "approved"};"}' \
  https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/9b721baa-0a23-4576-b2b6-d251d163ea6f/suspensions/f01815bf-ed18-4e01-9d41-cc2ce7861e95:lift

Neste exemplo, a variável Suspension result está definida como {processname: "Release", owner: "John", status: "approved"}; para o ID de suspensão f01815bf-ed18-4e01-9d41-cc2ce7861e95.

Estratégia de processamento de erros

Uma estratégia de processamento de erros para uma tarefa especifica a ação a realizar se a tarefa falhar devido a um erro temporário. Para obter informações sobre como usar uma estratégia de processamento de erros e conhecer os diferentes tipos de estratégias de processamento de erros, consulte o artigo Estratégias de processamento de erros.

Quotas e limites

Para informações sobre quotas e limites, consulte o artigo Quotas e limites.

O que se segue?

Saiba mais sobre todas as tarefas e acionadores.
Saiba como testar e publicar uma integração .

Saiba mais acerca do processamento de erros.
Saiba mais sobre os registos de execução da integração.