# Acionadores
A API de acionadores descreve os tipos de dados e a API relacionada à criação, atualização ou exclusão, e início e interrupção, de acionadores de trabalho no AWS Glue.
## Tipos de dados
+ [Estrutura de acionador](#aws-glue-api-jobs-trigger-Trigger)
+ [Estrutura TriggerUpdate](#aws-glue-api-jobs-trigger-TriggerUpdate)
+ [Estrutura Predicate](#aws-glue-api-jobs-trigger-Predicate)
+ [Estrutura Condition](#aws-glue-api-jobs-trigger-Condition)
+ [Estrutura Action](#aws-glue-api-jobs-trigger-Action)
+ [Estrutura EventBatchingCondition](#aws-glue-api-jobs-trigger-EventBatchingCondition)
## Estrutura de acionador
As informações sobre um determinado gatilho.
**Campos**
+ `Name` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do gatilho.
+ `WorkflowName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do fluxo de trabalho associado ao gatilho.
+ `Id` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Reservado para uso futuro.
+ `Type` – string UTF-8 (valores válidos: `SCHEDULED` \| `CONDITIONAL` \| `ON_DEMAND` \| `EVENT`).
O tipo de gatilho.
+ `State` – string UTF-8 (valores válidos: `CREATING` \| `CREATED` \| `ACTIVATING` \| `ACTIVATED` \| `DEACTIVATING` \| `DEACTIVATED` \| `DELETING` \| `UPDATING`).
O estado atual do gatilho do trabalho.
+ `Description` – string de descrição com no máximo 2.048 bytes de comprimento e correspondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
Uma descrição desse gatilho.
+ `Schedule` – String UTF-8.
Uma expressão `cron` usada para especificar a programação (consulte [Programações baseadas em hora para tarefas e crawlers](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html). Por exemplo, para executar algo todos os dias às 12h15 UTC, especifique: `cron(15 12 * * ? *)`.
+ `Actions`: um array de objetos [Ação](#aws-glue-api-jobs-trigger-Action).
As ações iniciadas por esse gatilho.
+ `Predicate` – Um objeto [Predicado](#aws-glue-api-jobs-trigger-Predicate).
O predicado deste gatilho, que define quando ele disparará.
+ `EventBatchingCondition` – Um objeto [EventBatchingCondition](#aws-glue-api-jobs-trigger-EventBatchingCondition).
Condição de lote que deve ser atendida (número especificado de eventos recebidos ou janela de tempo de lote expirada) antes que o acionador do evento do EventBridge dispare.
## Estrutura TriggerUpdate
Uma estrutura usada para fornecer as informações necessárias para atualizar um gatilho. Este objeto atualiza a definição do gatilho anterior, substituindo-a completamente.
**Campos**
+ `Name` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
Reservado para uso futuro.
+ `Description` – string de descrição com no máximo 2.048 bytes de comprimento e correspondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
Uma descrição desse gatilho.
+ `Schedule` – String UTF-8.
Uma expressão `cron` usada para especificar a programação (consulte [Programações baseadas em hora para tarefas e crawlers](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html). Por exemplo, para executar algo todos os dias às 12h15 UTC, especifique: `cron(15 12 * * ? *)`.
+ `Actions`: um array de objetos [Ação](#aws-glue-api-jobs-trigger-Action).
As ações iniciadas por esse gatilho.
+ `Predicate` – Um objeto [Predicado](#aws-glue-api-jobs-trigger-Predicate).
O predicado deste gatilho, que define quando ele disparará.
+ `EventBatchingCondition` – Um objeto [EventBatchingCondition](#aws-glue-api-jobs-trigger-EventBatchingCondition).
Condição de lote que deve ser atendida (número especificado de eventos recebidos ou janela de tempo de lote expirada) antes que o acionador do evento do EventBridge dispare.
## Estrutura Predicate
Define o predicado do gatilho, que determina quando ele é acionado.
**Campos**
+ `Logical` – string UTF-8 (valores válidos: `AND` \| `ANY`).
Um campo opcional se apenas uma condição estiver listada. Se várias condições estiverem listadas, esse campo será obrigatório.
+ `Conditions`: uma matriz de objetos [Condição](#aws-glue-api-jobs-trigger-Condition), não mais de 500 estruturas.
Uma lista das condições que determinam quando o gatilho será acionado.
## Estrutura Condition
Define em que condição um gatilho será acionado.
**Campos**
+ `LogicalOperator` – string UTF-8 (valores válidos: `EQUALS`).
Um operador lógico.
+ `JobName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do trabalho cujo `JobRuns` essa condição se aplica e na qual esse gatilho aguardará.
+ `State`: string UTF-8 (valores válidos: `STARTING` \| `RUNNING` \| `STOPPING` \| `STOPPED` \| `SUCCEEDED` \| `FAILED` \| `TIMEOUT` \| `ERROR` \| `WAITING` \| `EXPIRED`).
O estado da condição. No momento, os únicos estados de trabalho que um trigger pode escutar são `SUCCEEDED`, `STOPPED`, `FAILED` e `TIMEOUT`. Os únicos estados de crawler que um trigger pode escutar são `SUCCEEDED`, `FAILED` e `CANCELLED`.
+ `CrawlerName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do crawler ao qual essa condição se aplica.
+ `CrawlState` – string UTF-8 (valores válidos: `RUNNING` \| `CANCELLING` \| `CANCELLED` \| `SUCCEEDED` \| `FAILED` \| `ERROR`).
O estado do crawler ao qual essa condição se aplica.
## Estrutura Action
Define uma ação a ser iniciada por um gatilho.
**Campos**
+ `JobName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome de um trabalho a ser executado.
+ `Arguments` – Um array de mapa dos pares de valor-chave.
Cada chave é uma sequência de caracteres UTF-8.
Cada valor é uma sequência de caracteres UTF-8.
Os argumentos de tarefa usados ao acionar esse trigger. Para essa execução de tarefa, eles substituem os argumentos padrão definidos na própria definição de tarefa.
Aqui, é possível especificar os argumentos que seu próprio script de execução de trabalho consome, além dos argumentos que o AWS Glue consome.
Para obter informações sobre como especificar e consumir seus próprios argumentos de trabalho, consulte o tópico [Chamar APIs do AWS Glue em Python](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) no guia do desenvolvedor.
Para obter informações sobre os pares de chave-valor que o AWS Glue consome para configurar o trabalho, consulte o tópico [Parâmetros especiais usados pelo AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) no guia do desenvolvedor.
+ `Timeout` – Número (inteiro), pelo menos 1.
O tempo limite de `JobRun` em minutos. Este é o tempo máximo durante o qual uma execução de trabalho pode consumir recursos antes de ser encerrada e entrar no status `TIMEOUT`. Isso substitui o valor de tempo limite definido no trabalho principal.
Os trabalhos devem ter valores de tempo limite inferiores a 7 dias ou 10.080 minutos. Caso contrário, os trabalhos gerarão uma exceção.
Quando o valor é deixado em branco, o tempo limite é padronizado para 2.880 minutos para o Glue versão 4.0 e anterior, ou 480 minutos para o Glue versão 5.0 e posterior.
Quaisquer trabalhos do AWS Glue existentes que tinham um valor de tempo limite maior que 7 dias serão padronizados para 7 dias. Por exemplo, se você especificou um tempo limite de 20 dias para um trabalho em lote, ele será interrompido no 7º dia.
Para trabalhos de streaming, se você tiver configurado uma janela de manutenção, ela será reiniciada durante a janela de manutenção após 7 dias.
+ `SecurityConfiguration` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome da estrutura de `SecurityConfiguration` a ser usada com essa ação.
+ `NotificationProperty` – Um objeto [NotificationProperty](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty).
Especifica propriedades de configuração de uma notificação de execução de trabalho.
+ `CrawlerName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do crawler que será usado com essa ação.
## Estrutura EventBatchingCondition
Condição de lote que deve ser atendida (número especificado de eventos recebidos ou janela de tempo de lote expirada) antes que o acionador do evento do EventBridge dispare.
**Campos**
+ `BatchSize`: *obrigatório:* número (inteiro), não menos do que 1 ou superior a 100.
Número de eventos que devem ser recebidos do Amazon EventBridge antes que o acionador do evento do EventBridge dispare.
+ `BatchWindow`: número (inteiro), não menos do que 1 ou superior a 900.
Janela de tempo em segundos após a qual o acionador do evento do EventBridge dispara. A janela é iniciada quando o primeiro evento é recebido.
## Operações
+ [Ação CreateTrigger (Python: create\_trigger)](#aws-glue-api-jobs-trigger-CreateTrigger)
+ [Ação StartTrigger (Python: start\_trigger)](#aws-glue-api-jobs-trigger-StartTrigger)
+ [Ação GetTrigger (Python: get\_trigger)](#aws-glue-api-jobs-trigger-GetTrigger)
+ [Ação GetTriggers (Python: get\_triggers)](#aws-glue-api-jobs-trigger-GetTriggers)
+ [Ação UpdateTrigger (Python: update\_trigger)](#aws-glue-api-jobs-trigger-UpdateTrigger)
+ [Ação StopTrigger (Python: stop\_trigger)](#aws-glue-api-jobs-trigger-StopTrigger)
+ [Ação DeleteTrigger (Python: delete\_trigger)](#aws-glue-api-jobs-trigger-DeleteTrigger)
+ [Ação ListTriggers (Python: list\_triggers)](#aws-glue-api-jobs-trigger-ListTriggers)
+ [Ação BatchGetTriggers (Python: batch\_get\_triggers)](#aws-glue-api-jobs-trigger-BatchGetTriggers)
## Ação CreateTrigger (Python: create\_trigger)
Cria um novo gatilho.
Os argumentos do trabalho podem ser registrados em log. Não transmita segredos em texto simples como argumentos. Recupere os segredos de uma conexão do AWS Glue, AWS Secrets Manager ou outro mecanismo de gerenciamento de segredos se pretender mantê-los dentro do trabalho.
**Solicitação**
+ `Name`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do gatilho.
+ `WorkflowName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do fluxo de trabalho associado ao gatilho.
+ `Type`: *obrigatório:* string UTF-8 (valores válidos: `SCHEDULED` \| `CONDITIONAL` \| `ON_DEMAND` \| `EVENT`).
O tipo do novo gatilho.
+ `Schedule` – String UTF-8.
Uma expressão `cron` usada para especificar a programação (consulte [Programações baseadas em hora para tarefas e crawlers](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html). Por exemplo, para executar algo todos os dias às 12h15 UTC, especifique: `cron(15 12 * * ? *)`.
Esse campo é obrigatório quando o tipo do gatilho é SCHEDULED.
+ `Predicate` – Um objeto [Predicado](#aws-glue-api-jobs-trigger-Predicate).
Um predicado para especificar quando o novo gatilho será disparado.
Esse campo é obrigatório quando o tipo do gatilho é `CONDITIONAL`.
+ `Actions` – *Obrigatório:* uma matriz de objetos [Ação](#aws-glue-api-jobs-trigger-Action).
As ações iniciadas por esse gatilho quando ele é disparado.
+ `Description` – string de descrição com no máximo 2.048 bytes de comprimento e correspondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
Uma descrição do novo gatilho.
+ `StartOnCreation` – Booleano.
Defina como `true` para iniciar os gatilhos `SCHEDULED` e `CONDITIONAL` na criação. True (Verdadeiro) não é compatível com gatilhos `ON_DEMAND`.
+ `Tags`: uma matriz de mapa dos pares de chave-valor, não mais do que 50 pares.
Cada chave é uma string UTF-8, com comprimento entre 1 e 128 bytes.
Cada valor é uma string UTF-8, inferior a 256 bytes de comprimento.
As tags a serem usadas com esse trigger. Você pode usar tags para limitar o acesso ao trigger. Para obter mais informações sobre tags no AWS Glue, consulte [Tags da AWS no AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html) no guia do desenvolvedor.
+ `EventBatchingCondition` – Um objeto [EventBatchingCondition](#aws-glue-api-jobs-trigger-EventBatchingCondition).
Condição de lote que deve ser atendida (número especificado de eventos recebidos ou janela de tempo de lote expirada) antes que o acionador do evento do EventBridge dispare.
**Resposta**
+ `Name` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do gatilho.
**Erros**
+ `AlreadyExistsException`
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `IdempotentParameterMismatchException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentModificationException`
## Ação StartTrigger (Python: start\_trigger)
Inicia um gatilho existente. Consulte [Acionar tarefas](https://docs.aws.amazon.com/glue/latest/dg/trigger-job.html) para obter informações sobre como diferentes tipos de gatilho são acionados.
**Solicitação**
+ `Name`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do gatilho a ser iniciado.
**Resposta**
+ `Name` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do gatilho iniciado.
**Erros**
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentRunsExceededException`
## Ação GetTrigger (Python: get\_trigger)
Recupera a definição de um gatilho.
**Solicitação**
+ `Name`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do gatilho a ser recuperado.
**Resposta**
+ `Trigger` – Um objeto [Trigger](#aws-glue-api-jobs-trigger-Trigger).
A definição de gatilho solicitada.
**Erros**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
## Ação GetTriggers (Python: get\_triggers)
Obtém todos os gatilhos associados a um trabalho.
**Solicitação**
+ `NextToken` – String UTF-8.
Um token de continuação, se esta for uma chamada de continuação.
+ `DependentJobName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do trabalho para o qual recuperar gatilhos. O gatilho que pode iniciar esse trabalho será retornado e, se ele não existir, todos os gatilhos serão retornados.
+ `MaxResults`: número (inteiro) não inferior a 1 nem superior a 200.
O tamanho máximo da resposta.
**Resposta**
+ `Triggers`: um array de objetos [Trigger](#aws-glue-api-jobs-trigger-Trigger).
Uma lista de gatilhos para o trabalho especificado.
+ `NextToken` – String UTF-8.
Um token de continuação, se todos os gatilhos solicitados ainda não tiverem sido retornados.
**Erros**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
## Ação UpdateTrigger (Python: update\_trigger)
Atualiza uma definição do gatilho.
Os argumentos do trabalho podem ser registrados em log. Não transmita segredos em texto simples como argumentos. Recupere os segredos de uma conexão do AWS Glue, AWS Secrets Manager ou outro mecanismo de gerenciamento de segredos se pretender mantê-los dentro do trabalho.
**Solicitação**
+ `Name`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do gatilho a ser atualizado.
+ `TriggerUpdate` – *Obrigatório:* um objeto [TriggerUpdate](#aws-glue-api-jobs-trigger-TriggerUpdate).
Os novos valores para atualização do gatilho.
**Resposta**
+ `Trigger` – Um objeto [Trigger](#aws-glue-api-jobs-trigger-Trigger).
A definição de gatilho resultante.
**Erros**
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`
## Ação StopTrigger (Python: stop\_trigger)
Interrompe um gatilho especificado.
**Solicitação**
+ `Name`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do gatilho a ser interrompido.
**Resposta**
+ `Name` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do gatilho interrompido.
**Erros**
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`
## Ação DeleteTrigger (Python: delete\_trigger)
Exclui um gatilho especificado. Se o gatilho não for encontrado, nenhuma exceção será lançada.
**Solicitação**
+ `Name`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do gatilho a ser excluído.
**Resposta**
+ `Name` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do gatilho excluído.
**Erros**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`
## Ação ListTriggers (Python: list\_triggers)
Recupera os nomes de todos os recursos de acionador nessa conta da AWS ou os recursos com a tag especificada. Essa operação permite que você veja quais recursos estão disponíveis em sua conta e seus nomes.
Essa operação aceita o campo `Tags` opcional, que pode ser usado como um filtro na resposta, para que recursos com tags possam ser recuperados como um grupo. Se você optar por usar a filtragem por tags, apenas os recursos com a tag serão recuperados.
**Solicitação**
+ `NextToken` – String UTF-8.
Um token de continuação, se esta for uma solicitação de continuação.
+ `DependentJobName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).
O nome do trabalho para o qual recuperar gatilhos. O gatilho que pode iniciar esse trabalho é retornado. Se esse gatilho não existir, todos os gatilhos serão retornados.
+ `MaxResults`: número (inteiro) não inferior a 1 nem superior a 200.
O tamanho máximo de uma lista a ser retornada.
+ `Tags`: uma matriz de mapa dos pares de chave-valor, não mais do que 50 pares.
Cada chave é uma string UTF-8, com comprimento entre 1 e 128 bytes.
Cada valor é uma string UTF-8, inferior a 256 bytes de comprimento.
Especifica apenas o retorno desses recursos com tags.
**Resposta**
+ `TriggerNames` – Uma matriz de strings UTF-8.
Os nomes de todos os gatilhos na conta ou os gatilhos com as tags especificadas.
+ `NextToken` – String UTF-8.
Um token de continuação, se a lista retornada não contiver a métrica mais recente disponível.
**Erros**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
## Ação BatchGetTriggers (Python: batch\_get\_triggers)
Retorna uma lista de metadados de recurso para uma lista de nomes de gatilho. Depois de chamar a operação `ListTriggers`, você pode chamar essa operação para acessar os dados aos quais você recebeu permissões. Essa operação oferece suporte a todas as permissões do IAM, incluindo condições de permissão que usam tags.
**Solicitação**
+ `TriggerNames`: *obrigatório:* uma matriz de strings UTF-8.
Uma lista de nomes de gatilho, que podem ser os nomes retornados pela operação `ListTriggers`.
**Resposta**
+ `Triggers`: um array de objetos [Trigger](#aws-glue-api-jobs-trigger-Trigger).
Uma lista das definições de gatilho.
+ `TriggersNotFound` – Uma matriz de strings UTF-8.
Uma lista de nomes de gatilhos não encontrados.
**Erros**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`