# API de trabalhos
<a name="aws-glue-api-jobs"></a>

A API de trabalhos descreve os tipos de dados de trabalhos e contém APIs para operar com trabalhos, execuções de trabalhos e acionadores no AWS Glue.

**Topics**
+ [Tarefas](aws-glue-api-jobs-job.md)
+ [Execuções de trabalhos](aws-glue-api-jobs-runs.md)
+ [Acionadores](aws-glue-api-jobs-trigger.md)

# Tarefas
<a name="aws-glue-api-jobs-job"></a>

A API de trabalhos descreve os tipos de dados e a API relacionada à criação, atualização, exclusão ou previsualização de trabalhos no AWS Glue.

## Tipos de dados
<a name="aws-glue-api-jobs-job-objects"></a>
+ [Estrutura do trabalho](#aws-glue-api-jobs-job-Job)
+ [Estrutura ExecutionProperty](#aws-glue-api-jobs-job-ExecutionProperty)
+ [Estrutura NotificationProperty](#aws-glue-api-jobs-job-NotificationProperty)
+ [Estrutura JobCommand](#aws-glue-api-jobs-job-JobCommand)
+ [Estrutura ConnectionsList](#aws-glue-api-jobs-job-ConnectionsList)
+ [Estrutura JobUpdate](#aws-glue-api-jobs-job-JobUpdate)
+ [Estrutura SourceControlDetails](#aws-glue-api-jobs-job-SourceControlDetails)

## Estrutura do trabalho
<a name="aws-glue-api-jobs-job-Job"></a>

Especifica uma definição de trabalho.

**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 que você atribui a esta definição de trabalho.
+ `JobMode` – string UTF-8 (valores válidos: `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  Um modo que descreve como um trabalho foi criado. Os valores válidos são:
  + `SCRIPT`: o trabalho foi criado usando o editor de scripts do AWS Glue Studio.
  + `VISUAL`: o trabalho foi criado usando o editor visual do AWS Glue Studio.
  + `NOTEBOOK`: o trabalho foi criado usando um caderno de sessões interativas.

  Quando o campo `JobMode` está ausente ou é nulo, `SCRIPT` é atribuído como o valor padrão.
+ `JobRunQueuingEnabled` – Booleano.

  Especifica se o enfileiramento da execução de trabalhos está habilitado para as execuções desse trabalho.

  Um valor "verdadeiro" significa que o enfileiramento da execução de trabalhos está habilitado para a execução do trabalho. Se o valor for "falso" ou não estiver preenchido, as execuções do trabalho não serão consideradas para enfileiramento.

  Se esse campo não corresponder ao valor definido na execução do trabalho, o valor do campo de execução do trabalho será usado.
+ `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 trabalho.
+ `LogUri` – String UTF-8.

  Este campo está reservado para uso futuro.
+ `Role` – String UTF-8.

  O nome ou o nome do recurso da Amazon (ARN) da função do IAM associada a esta trabalho.
+ `CreatedOn` – Timestamp.

  A hora e a data em que esta definição de trabalho foi criada.
+ `LastModifiedOn` – Timestamp.

  O último momento em que esta definição de trabalho foi modificada.
+ `ExecutionProperty` – Um objeto [ExecutionProperty](#aws-glue-api-jobs-job-ExecutionProperty).

  Um `ExecutionProperty` que especifica o número máximo de execuções simultâneas permitidas para o trabalho.
+ `Command` – Um objeto [JobCommand](#aws-glue-api-jobs-job-JobCommand).

  O `JobCommand` que executa esse trabalho.
+ `DefaultArguments` – 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 padrão para toda execução desse trabalho, especificados como pares de nome-valor.

  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.

  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 segredo se pretender mantê-los dentro do trabalho. 

  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 argumentos que podem ser fornecidos a esse campo ao configurar trabalhos do Spark, 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.

  Para obter informações sobre os argumentos que podem ser fornecidos a esse campo ao configurar trabalhos do Ray, consulte o tópico [Usar parâmetros de trabalho em trabalhos do Ray](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html) no guia do desenvolvedor.
+ `NonOverridableArguments` – 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.

  Argumentos para esse trabalho que não são substituídos ao fornecer argumentos de trabalho na execução de um trabalho, especificados como pares de nome-valor.
+ `Connections` – Um objeto [ConnectionsList](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ConnectionsList).

  As conexões usadas no trabalho.
+ `MaxRetries` – Número (íntegro).

  O número máximo de novas tentativas desse trabalho após a falha de um JobRun.
+ `AllocatedCapacity` – Número (íntegro).

  Este campo está obsoleto. Use `MaxCapacity` em vez disso.

  O número de unidades de processamento de dados (DPUs) do AWS Glue alocadas em execuções desse trabalho. É possível alocar um mínimo de 2 DPUs; o padrão é 10. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória. Para obter mais informações, consulte a [página de definição de preços do AWS Glue](https://aws.amazon.com/glue/pricing/).

  
+ `Timeout` – Número (inteiro), pelo menos 1.

  O tempo limite do trabalho 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`.

  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 padrão é de 2.880 minutos.

  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.
+ `MaxCapacity` – Número (duplo).

  Para trabalhos do Glue versão 1.0 ou anterior, usando o tipo de operador padrão, é o número de unidades de processamento de dados (DPUs) do AWS Glue que poderão ser alocadas quando esse trabalho for executado. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória. Para obter mais informações, consulte a [página de definição de preços do AWS Glue](https://aws.amazon.com/glue/pricing/).

  Para trabalhos do Glue versão 2.0 ou posterior, você não pode um `Maximum capacity`. Em vez disso, você deve especificar um `Worker type` e o `Number of workers`.

  Não defina `MaxCapacity` se estiver usando `WorkerType` e `NumberOfWorkers`.

  O valor que pode ser alocado para `MaxCapacity` depende se você está executando um trabalho de shell do Python, um trabalho de ETL do Apache Spark ou um trabalho de ETL de streaming do Apache Spark:
  + Ao especificar um trabalho de shell do Python (`JobCommand.Name`="pythonshell"), será possível alocar 0,0625 ou 1 DPU. O padrão é 0,0625 DPU.
  + Ao especificar um trabalho de ETL do Apache Spark (`JobCommand.Name`="glueetl") ou um trabalho de ETL de streaming do Apache Spark (`JobCommand.Name`="gluestreaming"), é possível alocar de 2 a 100 DPUs. O padrão é de 10 DPUs. Esse tipo de trabalho não pode ter uma alocação de DPU fracionada.
+ `WorkerType` – string UTF-8 (valores válidos: `Standard=""` \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` \$1 `R.4X=""` \$1 `R.8X=""` \$1 `Z.2X=""`).

  O tipo de operador predefinido que é alocado quando um trabalho é executado.

  O AWS Glue oferece vários tipos de operadores para acomodar diferentes requisitos de workload:

  Tipos de operadores G (operadores de computação de uso geral):
  + G.025X: 0.25 DPUs (2 vCPUs, 4 GB de memória, 84 GB de disco)
  + G.1X: 1 DPU (4 vCPUs, 16 GB de memória, 94 GB de disco)
  + G.2X: 2 DPUs (8 vCPUs, 32 GB de memória, 138 GB de disco)
  + G.4X: 4 DPUs (16 vCPUs, 64 GB de memória, 256 GB de disco)
  + G.8X: 8 DPUs (32 vCPUs, 128 GB de memória, 512 GB de disco)
  + G.12X: 12 DPUs (48 vCPUs, 192 GB de memória, 768 GB de disco)
  + G16X: 16 DPUs (64 vCPUs, 256 GB de memória, 1.024 GB de disco)

  Tipos de operadores R (operadores com memória otimizada):
  + R.1X: 1 DPU (4 vCPUs, 32 GB de memória, 94 GB de disco)
  + R.2X: 2 DPU (8 vCPUs, 64 GB de memória, 128 GB de disco)
  + R.4X: 4 DPU (16 vCPUs, 128 GB de memória, 256 GB de disco)
  + R.8X: 8 DPU (32 vCPUs, 256 GB de memória, 512 GB de disco)
+ `NumberOfWorkers` – Número (íntegro).

  O número de operadores de determinado `workerType` que são alocados quando um trabalho é executado.
+ `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 esse trabalho.
+ `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 trabalho.
+ `Running` – Booleano.

  Este campo está reservado para uso futuro.
+ `GlueVersion` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Nas tarefas do Spark, `GlueVersion` determina as versões do Apache Spark e do Python que o AWS Glue disponibiliza em um trabalho. A versão do Python indica a versão compatível com trabalhos do tipo Spark. 

  Os trabalhos de Ray devem definir `GlueVersion` como `4.0` ou mais. Porém, as versões do Ray, do Python e das bibliotecas adicionais disponíveis no seu trabalho do Ray são determinadas pelo parâmetro `Runtime` do comando Job.

  Para obter mais informações sobre as versões disponíveis do AWS Glue e as versões correspondentes do Spark e do Python, consulte [Versão do Glue](https://docs.aws.amazon.com/glue/latest/dg/add-job.html) no guia do desenvolvedor.

  Os trabalhos criados sem especificar uma versão do Glue usam como padrão o Glue 0.9.
+ `CodeGenConfigurationNodes` – Um array de mapa dos pares de valor-chave.

  Cada chave é uma string UTF-8 que corresponde a [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Cada valor é um objeto [CodeGenConfigurationNode](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CodeGenConfigurationNode) A.

  A representação de um gráfico acíclico direcionado no qual tanto o componente visual do Glue Studio quanto a geração de código do Glue Studio são baseados.
+ `ExecutionClass`: string UTF-8, inferior a 16 bytes de comprimento (valores válidos: `FLEX=""` \$1 `STANDARD=""`).

  Indica se o trabalho é executado com uma classe de execução padrão ou flexível. A classe de execução padrão é ideal para workloads sensíveis ao tempo que exigem a inicialização rápida de trabalhos e recursos dedicados.

  A classe de execução flexível é adequada para trabalhos insensíveis ao tempo, cujos horários de início e conclusão podem variar. 

  Somente trabalhos com o AWS Glue versão 3.0 e posterior e o tipo de comando `glueetl` terão permissão para definir `ExecutionClass` como `FLEX`. A classe de execução flexível está disponível para trabalhos do Spark.
+ `SourceControlDetails` – Um objeto [SourceControlDetails](#aws-glue-api-jobs-job-SourceControlDetails).

  Os detalhes de uma configuração de controle de origem para um trabalho, permitindo a sincronização de artefatos de trabalho de ou para um repositório remoto.
+ `MaintenanceWindow` – String UTF-8 correspondente a [Custom string pattern #34](aws-glue-api-common.md#regex_34).

  Esse campo especifica um dia da semana e uma hora para uma janela de manutenção para trabalhos de streaming. O AWS Glue realiza periodicamente atividades de manutenção. Durante essas janelas de manutenção, o AWS Glue precisará reiniciar seus trabalhos de streaming.

  O AWS Glue reiniciará o trabalho dentro de 3 horas da janela de manutenção especificada. Por exemplo, se você configurar a janela de manutenção para segunda-feira às 10h (GMT), seus trabalhos serão reiniciados entre 10h (GMT) e 13h (GMT).
+ `ProfileName` – 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 perfil de uso do AWS Glue associado ao trabalho.

## Estrutura ExecutionProperty
<a name="aws-glue-api-jobs-job-ExecutionProperty"></a>

Uma propriedade de execução de um trabalho.

**Campos**
+ `MaxConcurrentRuns` – Número (íntegro).

  O número máximo de execuções simultâneas permitidas para o trabalho. O padrão é 1. Um erro será retornado quando este limite for atingido. O valor máximo que pode ser especificado é controlado por um limite de serviço.

## Estrutura NotificationProperty
<a name="aws-glue-api-jobs-job-NotificationProperty"></a>

Especifica propriedades de configuração de uma notificação.

**Campos**
+ `NotifyDelayAfter` – Número (inteiro), pelo menos 1.

  Depois que a execução de um trabalho for iniciada, o número de minutos a esperar antes de enviar uma notificação de atraso de execução de trabalho.

## Estrutura JobCommand
<a name="aws-glue-api-jobs-job-JobCommand"></a>

Especifica o código executado quando um trabalho é executado.

**Campos**
+ `Name` – String UTF-8.

  O nome do comando de trabalho. Para um trabalho de ETL do Apache Spark, ele deve ser `glueetl`. Para um trabalho de shell do Python, ele deve ser `pythonshell`. Para um trabalho de ETL de streaming do Apache Spark, ele deve ser `gluestreaming`. Para um trabalho do Ray, isso deve ser `glueray`.
+ `ScriptLocation`: string UTF-8, não superior a 400.000 bytes de comprimento.

  Especifica o caminho do Amazon Simple Storage Service (Amazon S3) para um script que executa um trabalho.
+ `PythonVersion` – String UTF-8 correspondente a [Custom string pattern #49](aws-glue-api-common.md#regex_49).

  A versão de Python que está em uso para executar um trabalho de shell em Python. Os valores permitidos são 2 ou 3.
+ `Runtime` – string UTF-8, com no máximo 64 bytes de comprimento, correspondendo a [Custom string pattern #33](aws-glue-api-common.md#regex_33).

  Em trabalhos do Ray, Runtime é usado para especificar as versões do Ray, do Python e das bibliotecas adicionais disponíveis no ambiente. Esse campo não é usado em outros tipos de trabalho. Para obter os valores do ambiente de runtime compatíveis, consulte [Ambientes de runtime do Ray compatíveis](https://docs.aws.amazon.com/glue/latest/dg/ray-jobs-section.html) no Guia do desenvolvedor do AWS Glue.

## Estrutura ConnectionsList
<a name="aws-glue-api-jobs-job-ConnectionsList"></a>

Especifica as conexões usadas por um trabalho.

**Campos**
+ `Connections`: uma matriz de strings UTF-8, no máximo mil strings.

  Uma lista das conexões usadas pelo trabalho.

## Estrutura JobUpdate
<a name="aws-glue-api-jobs-job-JobUpdate"></a>

Especifica as informações usadas para atualizar uma definição de trabalho existente. A definição de trabalho anterior é totalmente substituída por essa informação.

**Campos**
+ `JobMode` – string UTF-8 (valores válidos: `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  Um modo que descreve como um trabalho foi criado. Os valores válidos são:
  + `SCRIPT`: o trabalho foi criado usando o editor de scripts do AWS Glue Studio.
  + `VISUAL`: o trabalho foi criado usando o editor visual do AWS Glue Studio.
  + `NOTEBOOK`: o trabalho foi criado usando um caderno de sessões interativas.

  Quando o campo `JobMode` está ausente ou é nulo, `SCRIPT` é atribuído como o valor padrão.
+ `JobRunQueuingEnabled` – Booleano.

  Especifica se o enfileiramento da execução de trabalhos está habilitado para as execuções desse trabalho.

  Um valor "verdadeiro" significa que o enfileiramento da execução de trabalhos está habilitado para a execução do trabalho. Se o valor for "falso" ou não estiver preenchido, as execuções do trabalho não serão consideradas para enfileiramento.

  Se esse campo não corresponder ao valor definido na execução do trabalho, o valor do campo de execução do trabalho será usado.
+ `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).

  Descrição do trabalho que está sendo definido.
+ `LogUri` – String UTF-8.

  Este campo está reservado para uso futuro.
+ `Role` – String UTF-8.

  O nome ou o nome do recurso da Amazon (ARN) da função do IAM associada a esse trabalho (obrigatório).
+ `ExecutionProperty` – Um objeto [ExecutionProperty](#aws-glue-api-jobs-job-ExecutionProperty).

  Um `ExecutionProperty` que especifica o número máximo de execuções simultâneas permitidas para o trabalho.
+ `Command` – Um objeto [JobCommand](#aws-glue-api-jobs-job-JobCommand).

  O `JobCommand` que executa esse trabalho (obrigatório).
+ `DefaultArguments` – 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 padrão para toda execução desse trabalho, especificados como pares de nome-valor.

  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.

  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 segredo se pretender mantê-los dentro do trabalho. 

  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 argumentos que podem ser fornecidos a esse campo ao configurar trabalhos do Spark, 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.

  Para obter informações sobre os argumentos que podem ser fornecidos a esse campo ao configurar trabalhos do Ray, consulte o tópico [Usar parâmetros de trabalho em trabalhos do Ray](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html) no guia do desenvolvedor.
+ `NonOverridableArguments` – 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.

  Argumentos para esse trabalho que não são substituídos ao fornecer argumentos de trabalho na execução de um trabalho, especificados como pares de nome-valor.
+ `Connections` – Um objeto [ConnectionsList](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ConnectionsList).

  As conexões usadas no trabalho.
+ `MaxRetries` – Número (íntegro).

  O número máximo de novas tentativas desse trabalho em caso de falha.
+ `AllocatedCapacity` – Número (íntegro).

  Este campo está obsoleto. Use `MaxCapacity` em vez disso.

  O número de unidades de processamento de dados (DPUs) do AWS Glue a serem alocadas para esse trabalho. É possível alocar um mínimo de 2 DPUs; o padrão é 10. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória. Para obter mais informações, consulte a [página de definição de preços do AWS Glue](https://aws.amazon.com/glue/pricing/).
+ `Timeout` – Número (inteiro), pelo menos 1.

  O tempo limite do trabalho 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`.

  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 padrão é de 2.880 minutos.

  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.
+ `MaxCapacity` – Número (duplo).

  Para trabalhos do Glue versão 1.0 ou anterior, usando o tipo de operador padrão, é o número de unidades de processamento de dados (DPUs) do AWS Glue que poderão ser alocadas quando esse trabalho for executado. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória. Para obter mais informações, consulte a [página de definição de preços do AWS Glue](https://aws.amazon.com/glue/pricing/).

  Para trabalhos do Glue versão 2.0\$1, você não pode especificar uma `Maximum capacity`. Em vez disso, você deve especificar um `Worker type` e o `Number of workers`.

  Não defina `MaxCapacity` se estiver usando `WorkerType` e `NumberOfWorkers`.

  O valor que pode ser alocado para `MaxCapacity` depende se você está executando um trabalho de shell do Python, um trabalho de ETL do Apache Spark ou um trabalho de ETL de streaming do Apache Spark:
  + Ao especificar um trabalho de shell do Python (`JobCommand.Name`="pythonshell"), será possível alocar 0,0625 ou 1 DPU. O padrão é 0,0625 DPU.
  + Ao especificar um trabalho de ETL do Apache Spark (`JobCommand.Name`="glueetl") ou um trabalho de ETL de streaming do Apache Spark (`JobCommand.Name`="gluestreaming"), é possível alocar de 2 a 100 DPUs. O padrão é de 10 DPUs. Esse tipo de trabalho não pode ter uma alocação de DPU fracionada.
+ `WorkerType` – string UTF-8 (valores válidos: `Standard=""` \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` \$1 `R.4X=""` \$1 `R.8X=""` \$1 `Z.2X=""`).

  O tipo de operador predefinido que é alocado quando um trabalho é executado. Aceita um valor de G.025X, G.1X, G.2X, G.4X, G.8X, G.12X, G.16X, R.1X, R.2X, R.4X, or R.8X para trabalhos do Spark. Aceita o valor Z.2X para trabalhos do Ray. Para obter mais informações, consulte [Definir propriedades de trabalho para trabalhos do Spark](https://docs.aws.amazon.com/glue/latest/dg/add-job.html#create-job).
+ `NumberOfWorkers` – Número (íntegro).

  O número de operadores de determinado `workerType` que são alocados quando um trabalho é executado.
+ `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 esse trabalho.
+ `NotificationProperty` – Um objeto [NotificationProperty](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty).

  Especifica as propriedades de configuração de uma notificação de trabalho.
+ `GlueVersion` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Nas tarefas do Spark, `GlueVersion` determina as versões do Apache Spark e do Python que o AWS Glue disponibiliza em um trabalho. A versão do Python indica a versão compatível com trabalhos do tipo Spark. 

  Os trabalhos de Ray devem definir `GlueVersion` como `4.0` ou mais. Porém, as versões do Ray, do Python e das bibliotecas adicionais disponíveis no seu trabalho do Ray são determinadas pelo parâmetro `Runtime` do comando Job.

  Para obter mais informações sobre as versões disponíveis do AWS Glue e as versões correspondentes do Spark e do Python, consulte [Versão do Glue](https://docs.aws.amazon.com/glue/latest/dg/add-job.html) no guia do desenvolvedor.

  Os trabalhos criados sem especificar uma versão do Glue usam como padrão o Glue 0.9.
+ `CodeGenConfigurationNodes` – Um array de mapa dos pares de valor-chave.

  Cada chave é uma string UTF-8 que corresponde a [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Cada valor é um objeto [CodeGenConfigurationNode](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CodeGenConfigurationNode) A.

  A representação de um gráfico acíclico direcionado no qual tanto o componente visual do Glue Studio quanto a geração de código do Glue Studio são baseados.
+ `ExecutionClass`: string UTF-8, inferior a 16 bytes de comprimento (valores válidos: `FLEX=""` \$1 `STANDARD=""`).

  Indica se o trabalho é executado com uma classe de execução padrão ou flexível. A classe de execução padrão é ideal para workloads sensíveis ao tempo que exigem a inicialização rápida de trabalhos e recursos dedicados.

  A classe de execução flexível é adequada para trabalhos insensíveis ao tempo, cujos horários de início e conclusão podem variar. 

  Somente trabalhos com o AWS Glue versão 3.0 e posterior e o tipo de comando `glueetl` terão permissão para definir `ExecutionClass` como `FLEX`. A classe de execução flexível está disponível para trabalhos do Spark.
+ `SourceControlDetails` – Um objeto [SourceControlDetails](#aws-glue-api-jobs-job-SourceControlDetails).

  Os detalhes de uma configuração de controle de origem para um trabalho, permitindo a sincronização de artefatos de trabalho de ou para um repositório remoto.
+ `MaintenanceWindow` – String UTF-8 correspondente a [Custom string pattern #34](aws-glue-api-common.md#regex_34).

  Esse campo especifica um dia da semana e uma hora para uma janela de manutenção para trabalhos de streaming. O AWS Glue realiza periodicamente atividades de manutenção. Durante essas janelas de manutenção, o AWS Glue precisará reiniciar seus trabalhos de streaming.

  O AWS Glue reiniciará o trabalho dentro de 3 horas da janela de manutenção especificada. Por exemplo, se você configurar a janela de manutenção para segunda-feira às 10h (GMT), seus trabalhos serão reiniciados entre 10h (GMT) e 13h (GMT).
+ `ProfileName` – 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 perfil de uso do AWS Glue associado ao trabalho.

## Estrutura SourceControlDetails
<a name="aws-glue-api-jobs-job-SourceControlDetails"></a>

Os detalhes de uma configuração de controle de origem para um trabalho, permitindo a sincronização de artefatos de trabalho de ou para um repositório remoto.

**Campos**
+ `Provider` – string UTF-8 (valores válidos: `GITHUB` \$1 `AWS_CODE_COMMIT`).

  O provedor do repositório remoto.
+ `Repository`: string UTF-8, não menos do que 1 ou superior a 512 bytes de comprimento.

  O nome do repositório remoto que contém os artefatos do trabalho.
+ `Owner`: string UTF-8, não menos do que 1 ou superior a 512 bytes de comprimento.

  O proprietário do repositório remoto que contém os artefatos do trabalho.
+ `Branch`: string UTF-8, não menos do que 1 ou superior a 512 bytes de comprimento.

  Uma ramificação opcional no repositório remoto.
+ `Folder`: string UTF-8, não menos do que 1 ou superior a 512 bytes de comprimento.

  Uma pasta opcional no repositório remoto.
+ `LastCommitId`: string UTF-8, não menos do que 1 ou superior a 512 bytes de comprimento.

  O último ID de confirmação no repositório remoto.
+ `LastSyncTimestamp`: string UTF-8, não menos do que 1 ou superior a 512 bytes de comprimento.

  A data e a hora em que a última sincronização de trabalho foi realizada.
+ `AuthStrategy` – string UTF-8 (valores válidos: `PERSONAL_ACCESS_TOKEN` \$1 `AWS_SECRETS_MANAGER`).

  O tipo de autenticação, que pode ser um token de autenticação armazenado no AWS Secrets Manager ou um token de acesso pessoal.
+ `AuthToken`: string UTF-8, não menos do que 1 ou superior a 512 bytes de comprimento.

  O valor de um token de autorização.

## Operações
<a name="aws-glue-api-jobs-job-actions"></a>
+ [Ação CreateJob (Python: create\$1job)](#aws-glue-api-jobs-job-CreateJob)
+ [Ação UpdateJob (Python: update\$1job)](#aws-glue-api-jobs-job-UpdateJob)
+ [Ação GetJob (Python: get\$1job)](#aws-glue-api-jobs-job-GetJob)
+ [Ação GetJobs (Python: get\$1jobs)](#aws-glue-api-jobs-job-GetJobs)
+ [Ação DeleteJob (Python: delete\$1job)](#aws-glue-api-jobs-job-DeleteJob)
+ [Ação ListJobs (Python: list\$1jobs)](#aws-glue-api-jobs-job-ListJobs)
+ [Ação BatchGetJobs (Python: batch\$1get\$1jobs)](#aws-glue-api-jobs-job-BatchGetJobs)

## Ação CreateJob (Python: create\$1job)
<a name="aws-glue-api-jobs-job-CreateJob"></a>

Cria uma nova definição de 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 que você atribui a esta definição de trabalho. Ele deve ser exclusivo na sua conta.
+ `JobMode` – string UTF-8 (valores válidos: `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  Um modo que descreve como um trabalho foi criado. Os valores válidos são:
  + `SCRIPT`: o trabalho foi criado usando o editor de scripts do AWS Glue Studio.
  + `VISUAL`: o trabalho foi criado usando o editor visual do AWS Glue Studio.
  + `NOTEBOOK`: o trabalho foi criado usando um caderno de sessões interativas.

  Quando o campo `JobMode` está ausente ou é nulo, `SCRIPT` é atribuído como o valor padrão.
+ `JobRunQueuingEnabled` – Booleano.

  Especifica se o enfileiramento da execução de trabalhos está habilitado para as execuções desse trabalho.

  Um valor "verdadeiro" significa que o enfileiramento da execução de trabalhos está habilitado para a execução do trabalho. Se o valor for "falso" ou não estiver preenchido, as execuções do trabalho não serão consideradas para enfileiramento.

  Se esse campo não corresponder ao valor definido na execução do trabalho, o valor do campo de execução do trabalho será usado.
+ `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).

  Descrição do trabalho que está sendo definido.
+ `LogUri` – String UTF-8.

  Este campo está reservado para uso futuro.
+ `Role` – *Obrigatório:* string UTF-8.

  O nome ou o nome do recurso da Amazon (ARN) da função do IAM associada a esta trabalho.
+ `ExecutionProperty` – Um objeto [ExecutionProperty](#aws-glue-api-jobs-job-ExecutionProperty).

  Um `ExecutionProperty` que especifica o número máximo de execuções simultâneas permitidas para o trabalho.
+ `Command` – *Obrigatório:* um objeto [JobCommand](#aws-glue-api-jobs-job-JobCommand).

  O `JobCommand` que executa esse trabalho.
+ `DefaultArguments` – 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 padrão para toda execução desse trabalho, especificados como pares de nome-valor.

  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.

  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 segredo se pretender mantê-los dentro do trabalho. 

  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 argumentos que podem ser fornecidos a esse campo ao configurar trabalhos do Spark, 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.

  Para obter informações sobre os argumentos que podem ser fornecidos a esse campo ao configurar trabalhos do Ray, consulte o tópico [Usar parâmetros de trabalho em trabalhos do Ray](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html) no guia do desenvolvedor.
+ `NonOverridableArguments` – 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.

  Argumentos para esse trabalho que não são substituídos ao fornecer argumentos de trabalho na execução de um trabalho, especificados como pares de nome-valor.
+ `Connections` – Um objeto [ConnectionsList](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ConnectionsList).

  As conexões usadas no trabalho.
+ `MaxRetries` – Número (íntegro).

  O número máximo de novas tentativas desse trabalho em caso de falha.
+ `AllocatedCapacity` – Número (íntegro).

  Esse parâmetro está suspenso. Use `MaxCapacity` em vez disso.

  O número de unidades de processamento de dados (DPUs) do AWS Glue a serem alocadas para esse trabalho. É possível alocar um mínimo de 2 DPUs; o padrão é 10. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória. Para obter mais informações, consulte a [página de definição de preços do AWS Glue](https://aws.amazon.com/glue/pricing/).
+ `Timeout` – Número (inteiro), pelo menos 1.

  O tempo limite do trabalho 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`.

  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 padrão é de 2.880 minutos.

  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.
+ `MaxCapacity` – Número (duplo).

  Para trabalhos do Glue versão 1.0 ou anterior, usando o tipo de operador padrão, é o número de unidades de processamento de dados (DPUs) do AWS Glue que poderão ser alocadas quando esse trabalho for executado. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória. Para obter mais informações, consulte a [página de definição de preços do AWS Glue](https://aws.amazon.com/glue/pricing/).

  Para trabalhos do Glue versão 2.0\$1, você não pode especificar uma `Maximum capacity`. Em vez disso, você deve especificar um `Worker type` e o `Number of workers`.

  Não defina `MaxCapacity` se estiver usando `WorkerType` e `NumberOfWorkers`.

  O valor que pode ser alocado para `MaxCapacity` depende se você está executando um trabalho de shell do Python, um trabalho de ETL do Apache Spark ou um trabalho de ETL de streaming do Apache Spark:
  + Ao especificar um trabalho de shell do Python (`JobCommand.Name`="pythonshell"), será possível alocar 0,0625 ou 1 DPU. O padrão é 0,0625 DPU.
  + Ao especificar um trabalho de ETL do Apache Spark (`JobCommand.Name`="glueetl") ou um trabalho de ETL de streaming do Apache Spark (`JobCommand.Name`="gluestreaming"), é possível alocar de 2 a 100 DPUs. O padrão é de 10 DPUs. Esse tipo de trabalho não pode ter uma alocação de DPU fracionada.
+ `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 esse trabalho.
+ `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 essa tarefa. Você pode usar tags para limitar o acesso à tarefa. 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.
+ `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 trabalho.
+ `GlueVersion` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Nas tarefas do Spark, `GlueVersion` determina as versões do Apache Spark e do Python que o AWS Glue disponibiliza em um trabalho. A versão do Python indica a versão compatível com trabalhos do tipo Spark. 

  Os trabalhos de Ray devem definir `GlueVersion` como `4.0` ou mais. Porém, as versões do Ray, do Python e das bibliotecas adicionais disponíveis no seu trabalho do Ray são determinadas pelo parâmetro `Runtime` do comando Job.

  Para obter mais informações sobre as versões disponíveis do AWS Glue e as versões correspondentes do Spark e do Python, consulte [Versão do Glue](https://docs.aws.amazon.com/glue/latest/dg/add-job.html) no guia do desenvolvedor.

  Os trabalhos criados sem especificar uma versão do Glue usam como padrão o Glue 0.9.
+ `NumberOfWorkers` – Número (íntegro).

  O número de operadores de determinado `workerType` que são alocados quando um trabalho é executado.
+ `WorkerType` – string UTF-8 (valores válidos: `Standard=""` \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` \$1 `R.4X=""` \$1 `R.8X=""` \$1 `Z.2X=""`).

  O tipo de operador predefinido que é alocado quando um trabalho é executado. Aceita um valor de G.025X, G.1X, G.2X, G.4X, G.8X, G.12X, G.16X, R.1X, R.2X, R.4X, or R.8X para trabalhos do Spark. Aceita o valor Z.2X para trabalhos do Ray.
  + Para o tipo de operador `G.025X`, cada operador é mapeado para 0,25 DPU (2 vCPU, 4 GB de memória) com 84 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos de streaming de baixo volume. Esse tipo de operador só está disponível para trabalhos de streaming do AWS Glue versão 3.0 ou posterior.
  + Para o tipo de operador `G.1X`, cada operador é mapeado em 1 DPU (4 vCPU, 16 GB de memória) com 94 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads, como transformações de dados, uniões e consultas, para oferecer uma maneira escalável e econômica de executar a maioria dos trabalhos.
  + Para o tipo de operador `G.2X`, cada operador é mapeado em 2 DPU (8 vCPU, 32 GB de memória) com 138 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads, como transformações de dados, uniões e consultas, para oferecer uma maneira escalável e econômica de executar a maioria dos trabalhos.
  + Para o tipo de operador `G.4X`, cada operador é mapeado em 4 DPU (16 vCPU, 64 GB de memória) com 256 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos cujas workloads contêm as transformações, agregações, uniões e consultas mais exigentes. Estes tipos de operadores estão disponíveis apenas para trabalhos Spark ETL do AWS Glue versão 3.0 ou posteriores nas seguintes regiões da AWS: Leste dos EUA (Ohio), Leste dos EUA (Norte da Virgínia), Oeste dos EUA (N. da Califórnia), Oeste dos EUA (Oregon), Ásia-Pacífico (Mumbai), Ásia-Pacífico (Seul), Ásia-Pacífico (Singapura), Ásia-Pacífico (Sydney), Ásia-Pacífico (Tóquio), Canadá (Central), Europa (Frankfurt), Europa (Irlanda), Europa (Londres), Europa (Espanha), Europa (Estocolmo) e 
  + Para o tipo de operador `G.8X`, cada operador é mapeado em 8 DPU (32 vCPU, 128 GB de memória) com 512 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos cujas workloads contêm as transformações, agregações, uniões e consultas mais exigentes. Esse tipo de operador está disponível somente para trabalhos de ETL do Spark no AWS Glue versão 3.0 ou posterior, nas mesmas regiões da AWS compatíveis com o tipo de operador `G.4X`.
  + Para o tipo de operador `G.12X`, cada operador é mapeado em 12 DPU (48 vCPU, 192 GB de memória) com 768 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos com workloads muito grandes. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `G.16X`, cada operador é mapeado em 16 DPU (64 vCPU, 256 GB de memória) com 1024 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos com workloads muito grandes. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `R.1X`, cada operador é mapeado em 1 DPU (4 vCPU, 32 GB de memória) com 94 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads com uso intensivo de memória. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `R.2X`, cada operador é mapeado em 2 DPU (8 vCPU, 64 GB de memória) com 128 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads com uso intensivo de memória. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `R.4X`, cada operador é mapeado em 4 DPU (16 vCPU, 128 GB de memória) com 256 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads com uso intensivo de memória. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `R.8X`, cada operador é mapeado em 8 DPU (32 vCPU, 256 GB de memória) com 512 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads com uso intensivo de memória. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `Z.2X`, cada operador é mapeado em 2 M-DPU (8 vCPUs, 64 GB de memória) com 128 GB de disco e fornece até 8 operadores do Ray baseados no autoscaler.
+ `CodeGenConfigurationNodes` – Um array de mapa dos pares de valor-chave.

  Cada chave é uma string UTF-8 que corresponde a [Custom string pattern #60](aws-glue-api-common.md#regex_60).

  Cada valor é um objeto [CodeGenConfigurationNode](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CodeGenConfigurationNode) A.

  A representação de um gráfico acíclico direcionado no qual tanto o componente visual do Glue Studio quanto a geração de código do Glue Studio são baseados.
+ `ExecutionClass`: string UTF-8, inferior a 16 bytes de comprimento (valores válidos: `FLEX=""` \$1 `STANDARD=""`).

  Indica se o trabalho é executado com uma classe de execução padrão ou flexível. A classe de execução padrão é ideal para workloads sensíveis ao tempo que exigem a inicialização rápida de trabalhos e recursos dedicados.

  A classe de execução flexível é adequada para trabalhos insensíveis ao tempo, cujos horários de início e conclusão podem variar. 

  Somente trabalhos com o AWS Glue versão 3.0 e posterior e o tipo de comando `glueetl` terão permissão para definir `ExecutionClass` como `FLEX`. A classe de execução flexível está disponível para trabalhos do Spark.
+ `SourceControlDetails` – Um objeto [SourceControlDetails](#aws-glue-api-jobs-job-SourceControlDetails).

  Os detalhes de uma configuração de controle de origem para um trabalho, permitindo a sincronização de artefatos de trabalho de ou para um repositório remoto.
+ `MaintenanceWindow` – String UTF-8 correspondente a [Custom string pattern #34](aws-glue-api-common.md#regex_34).

  Esse campo especifica um dia da semana e uma hora para uma janela de manutenção para trabalhos de streaming. O AWS Glue realiza periodicamente atividades de manutenção. Durante essas janelas de manutenção, o AWS Glue precisará reiniciar seus trabalhos de streaming.

  O AWS Glue reiniciará o trabalho dentro de 3 horas da janela de manutenção especificada. Por exemplo, se você configurar a janela de manutenção para segunda-feira às 10h (GMT), seus trabalhos serão reiniciados entre 10h (GMT) e 13h (GMT).
+ `ProfileName` – 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 perfil de uso do AWS Glue associado ao trabalho.

**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 exclusivo que foi fornecido para esta definição de trabalho.

**Erros**
+ `InvalidInputException`
+ `IdempotentParameterMismatchException`
+ `AlreadyExistsException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentModificationException`

## Ação UpdateJob (Python: update\$1job)
<a name="aws-glue-api-jobs-job-UpdateJob"></a>

Atualiza uma definição de trabalho existente. A definição de trabalho anterior é totalmente substituída por essa informação.

**Solicitação**
+ `JobName`: *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).

  Nome da definição de trabalho a ser atualizada.
+ `JobUpdate` – *Obrigatório:* um objeto [JobUpdate](#aws-glue-api-jobs-job-JobUpdate).

  Especifica os valores com os quais a definição de trabalho será atualizada. A configuração não especificada é removida ou redefinida para os valores padrão.
+ `ProfileName` – 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 perfil de uso do AWS Glue associado ao trabalho.

**Resposta**
+ `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).

  Retorna o nome da definição de trabalho atualizada.

**Erros**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`

## Ação GetJob (Python: get\$1job)
<a name="aws-glue-api-jobs-job-GetJob"></a>

Recupera uma definição de trabalho existente.

**Solicitação**
+ `JobName`: *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 da definição de trabalho a ser recuperada.

**Resposta**
+ `Job` – Um objeto [Trabalho](#aws-glue-api-jobs-job-Job).

  A definição de trabalho solicitada.

**Erros**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## Ação GetJobs (Python: get\$1jobs)
<a name="aws-glue-api-jobs-job-GetJobs"></a>

Recupera todas as definições de trabalho atuais.

**Solicitação**
+ `NextToken` – String UTF-8.

  Um token de continuação, se esta for uma chamada de continuação.
+ `MaxResults` – Número (inteiro), superior a 1 ou mais que 1000.

  O tamanho máximo da resposta.

**Resposta**
+ `Jobs`: um array de objetos [Trabalho](#aws-glue-api-jobs-job-Job).

  Uma lista de definições de trabalho.
+ `NextToken` – String UTF-8.

  Um token de continuação, caso algumas definições de trabalho ainda não tenham sido retornadas.

**Erros**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## Ação DeleteJob (Python: delete\$1job)
<a name="aws-glue-api-jobs-job-DeleteJob"></a>

Exclui uma definição de trabalho especificada. Se a definição de trabalho não for encontrada, nenhuma exceção será gerada.

**Solicitação**
+ `JobName`: *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 da definição de trabalho a ser excluída.

**Resposta**
+ `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 da definição de trabalho que foi excluída.

**Erros**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## Ação ListJobs (Python: list\$1jobs)
<a name="aws-glue-api-jobs-job-ListJobs"></a>

Recupera os nomes de todos os recursos do trabalho 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.
+ `MaxResults` – Número (inteiro), superior a 1 ou mais que 1000.

  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**
+ `JobNames` – Uma matriz de strings UTF-8.

  Os nomes de todos os trabalhos na conta ou os trabalhos 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**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## Ação BatchGetJobs (Python: batch\$1get\$1jobs)
<a name="aws-glue-api-jobs-job-BatchGetJobs"></a>

Retorna uma lista de metadados do recurso para uma lista de nomes de trabalho. Depois de chamar a operação `ListJobs`, 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**
+ `JobNames`: *obrigatório:* uma matriz de strings UTF-8.

  Uma lista de nomes de trabalho, que podem ser os nomes retornados da operação `ListJobs`.

**Resposta**
+ `Jobs`: um array de objetos [Trabalho](#aws-glue-api-jobs-job-Job).

  Uma lista de definições de trabalho.
+ `JobsNotFound` – Uma matriz de strings UTF-8.

  Uma lista de nomes de trabalho não encontrados.

**Erros**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`

# Execuções de trabalhos
<a name="aws-glue-api-jobs-runs"></a>

 A API de execuções de trabalhos descreve os tipos de dados e a API relacionada para iniciar, interromper ou visualizar execuções de trabalhos e redefinir marcações de trabalhos no AWS Glue. O histórico de execução de trabalhos pode ser acessado por 90 dias para seu fluxo de trabalho e execução de trabalhos. 

## Tipos de dados
<a name="aws-glue-api-jobs-runs-objects"></a>
+ [Estrutura JobRun](#aws-glue-api-jobs-runs-JobRun)
+ [Estrutura Predecessor](#aws-glue-api-jobs-runs-Predecessor)
+ [Estrutura JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry)
+ [Estrutura BatchStopJobRunSuccessfulSubmission](#aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission)
+ [Estrutura BatchStopJobRunError](#aws-glue-api-jobs-runs-BatchStopJobRunError)
+ [Estrutura NotificationProperty](#aws-glue-api-jobs-runs-NotificationProperty)

## Estrutura JobRun
<a name="aws-glue-api-jobs-runs-JobRun"></a>

Contém informações sobre uma execução de trabalho.

**Campos**
+ `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).

  O ID dessa execução de trabalho.
+ `Attempt` – Número (íntegro).

  O número de tentativas para execução deste trabalho.
+ `PreviousRunId` – 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 ID da execução anterior deste trabalho. Por exemplo, o `JobRunId` especificado na ação `StartJobRun`.
+ `TriggerName` – 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 que iniciou esta execução de trabalho.
+ `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 da definição de trabalho que está sendo usada nesta execução.
+ `JobMode` – string UTF-8 (valores válidos: `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  Um modo que descreve como um trabalho foi criado. Os valores válidos são:
  + `SCRIPT`: o trabalho foi criado usando o editor de scripts do AWS Glue Studio.
  + `VISUAL`: o trabalho foi criado usando o editor visual do AWS Glue Studio.
  + `NOTEBOOK`: o trabalho foi criado usando um caderno de sessões interativas.

  Quando o campo `JobMode` está ausente ou é nulo, `SCRIPT` é atribuído como o valor padrão.
+ `JobRunQueuingEnabled` – Booleano.

  Especifica se o enfileiramento da execução de trabalhos está habilitado para a execução do trabalho.

  Um valor "verdadeiro" significa que o enfileiramento da execução de trabalhos está habilitado para as execuções do trabalho. Se o valor for "falso" ou não estiver preenchido, a execução do trabalho não será considerada para enfileiramento.
+ `StartedOn` – Timestamp.

  A data e a hora em que a execução deste trabalho foi iniciada.
+ `LastModifiedOn` – Timestamp.

  A hora em que a execução desse trabalho foi modificada.
+ `CompletedOn` – Timestamp.

  A data e a hora em que a execução desse trabalho foi concluída.
+ `JobRunState`: string UTF-8 (valores válidos: `STARTING` \$1 `RUNNING` \$1 `STOPPING` \$1 `STOPPED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `TIMEOUT` \$1 `ERROR` \$1 `WAITING` \$1 `EXPIRED`).

  O estado atual da execução do trabalho. Para obter mais informações sobre os status de trabalhos que foram terminados de forma anormal, consulte [Status de execução de trabalhos do AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/job-run-statuses.html).
+ `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 trabalho associados a esta execução. 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.

  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 segredo se pretender mantê-los dentro do trabalho. 

  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 argumentos que podem ser fornecidos a esse campo ao configurar trabalhos do Spark, 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.

  Para obter informações sobre os argumentos que podem ser fornecidos a esse campo ao configurar trabalhos do Ray, consulte o tópico [Uso de parâmetros de trabalho em trabalhos do Ray](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html) no guia do desenvolvedor.
+ `ErrorMessage` – String UTF-8.

  Uma mensagem de erro associada à execução deste trabalho.
+ `PredecessorRuns`: um array de objetos [Predecessor](#aws-glue-api-jobs-runs-Predecessor).

  Uma lista de predecessores para a execução deste trabalho.
+ `AllocatedCapacity` – Número (íntegro).

  Este campo está obsoleto. Use `MaxCapacity` em vez disso.

  O número de unidades de processamento de dados (DPUs) do AWS Glue atribuídas a esse JobRun. É possível atribuir de 2 a 100 DPUs, e o padrão é 10. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória. Para obter mais informações, consulte a [página de definição de preços do AWS Glue](https://aws.amazon.com/glue/pricing/).
+ `ExecutionTime` – Número (íntegro).

  A quantidade de tempo (em segundos) em que o trabalho executado consumiu recursos.
+ `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`. Esse valor 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 padrão é de 2.880 minutos.

  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.
+ `MaxCapacity` – Número (duplo).

  Para trabalhos do Glue versão 1.0 ou anterior, usando o tipo de operador padrão, é o número de unidades de processamento de dados (DPUs) do AWS Glue que poderão ser alocadas quando esse trabalho for executado. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória. Para obter mais informações, consulte a [página de definição de preços do AWS Glue](https://aws.amazon.com/glue/pricing/).

  Para trabalhos do Glue versão 2.0\$1, você não pode especificar uma `Maximum capacity`. Em vez disso, você deve especificar um `Worker type` e o `Number of workers`.

  Não defina `MaxCapacity` se estiver usando `WorkerType` e `NumberOfWorkers`.

  O valor que pode ser alocado para `MaxCapacity` depende se você está executando um trabalho de shell do Python, um trabalho de ETL do Apache Spark ou um trabalho de ETL de streaming do Apache Spark:
  + Ao especificar um trabalho de shell do Python (`JobCommand.Name`="pythonshell"), será possível alocar 0,0625 ou 1 DPU. O padrão é 0,0625 DPU.
  + Ao especificar um trabalho de ETL do Apache Spark (`JobCommand.Name`="glueetl") ou um trabalho de ETL de streaming do Apache Spark (`JobCommand.Name`="gluestreaming"), é possível alocar de 2 a 100 DPUs. O padrão é de 10 DPUs. Esse tipo de trabalho não pode ter uma alocação de DPU fracionada.
+ `WorkerType` – string UTF-8 (valores válidos: `Standard=""` \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` \$1 `R.4X=""` \$1 `R.8X=""` \$1 `Z.2X=""`).

  O tipo de operador predefinido que é alocado quando um trabalho é executado. Aceita um valor de G.025X, G.1X, G.2X, G.4X, G.8X, G.12X, G.16X, R.1X, R.2X, R.4X, or R.8X para trabalhos do Spark. Aceita o valor Z.2X para trabalhos do Ray.
  + Para o tipo de operador `G.1X`, cada operador é mapeado em 1 DPU (4 vCPU, 16 GB de memória) com 94 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads, como transformações de dados, uniões e consultas, para oferecer uma maneira escalável e econômica de executar a maioria dos trabalhos.
  + Para o tipo de operador `G.2X`, cada operador é mapeado em 2 DPU (8 vCPU, 32 GB de memória) com 138 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads, como transformações de dados, uniões e consultas, para oferecer uma maneira escalável e econômica de executar a maioria dos trabalhos.
  + Para o tipo de operador `G.4X`, cada operador é mapeado em 4 DPU (16 vCPU, 64 GB de memória) com 256 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos cujas workloads contêm as transformações, agregações, uniões e consultas mais exigentes. Esse tipo de operador está disponível somente para trabalhos de ETL do Spark no AWS Glue versão 3.0 ou posterior nas seguintes regiões da AWS: Leste dos EUA (Ohio), Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon), Ásia-Pacífico (Singapura), Ásia-Pacífico (Sydney), Ásia-Pacífico (Tóquio), Canadá (Central), Europa (Frankfurt), Europa (Irlanda) e Europa (Estocolmo).
  + Para o tipo de operador `G.8X`, cada operador é mapeado em 8 DPU (32 vCPU, 128 GB de memória) com 512 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos cujas workloads contêm as transformações, agregações, uniões e consultas mais exigentes. Esse tipo de operador está disponível somente para trabalhos de ETL do Spark no AWS Glue versão 3.0 ou posterior, nas mesmas regiões da AWS compatíveis com o tipo de operador `G.4X`.
  + Para o tipo de operador `G.12X`, cada operador é mapeado em 12 DPU (48 vCPU, 192 GB de memória) com 768 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos com workloads muito grandes. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `G.16X`, cada operador é mapeado em 16 DPU (64 vCPU, 256 GB de memória) com 1024 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos com workloads muito grandes. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `G.025X`, cada operador é mapeado para 0,25 DPU (2 vCPU, 4 GB de memória) com 84 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos de streaming de baixo volume. Esse tipo de operador só está disponível para trabalhos de streaming do AWS Glue versão 3.0 ou posterior.
  + Para o tipo de operador `R.1X`, cada operador é mapeado em 1 DPU (4 vCPU, 32 GB de memória) com 94 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads com uso intensivo de memória. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `R.2X`, cada operador é mapeado em 2 DPU (8 vCPU, 64 GB de memória) com 128 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads com uso intensivo de memória. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `R.4X`, cada operador é mapeado em 4 DPU (16 vCPU, 128 GB de memória) com 256 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads com uso intensivo de memória. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `R.8X`, cada operador é mapeado em 8 DPU (32 vCPU, 256 GB de memória) com 512 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads com uso intensivo de memória. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `Z.2X`, cada operador é mapeado em 2 M-DPU (8 vCPUs, 64 GB de memória) com 128 GB de disco e fornece até 8 operadores do Ray baseados no autoscaler.
+ `NumberOfWorkers` – Número (íntegro).

  O número de operadores de determinado `workerType` que são alocados quando um trabalho é executado.
+ `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 a execução desse trabalho.
+ `LogGroupName` – String UTF-8.

  O nome do grupo de logs para registro seguro, que pode ser criptografado no lado do servidor no Amazon CloudWatch usando o AWS KMS. Esse nome pode ser `/aws-glue/jobs/` e, nesse caso, a criptografia padrão é `NONE`. Se você adicionar o nome de um perfil e o nome de `SecurityConfiguration` (em outras palavras, `/aws-glue/jobs-yourRoleName-yourSecurityConfigurationName/`), essa configuração de segurança será usada para criptografar o grupo de logs.
+ `NotificationProperty` – Um objeto [NotificationProperty](#aws-glue-api-jobs-runs-NotificationProperty).

  Especifica propriedades de configuração de uma notificação de execução de trabalho.
+ `GlueVersion` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Nas tarefas do Spark, `GlueVersion` determina as versões do Apache Spark e do Python que o AWS Glue disponibiliza em um trabalho. A versão do Python indica a versão compatível com trabalhos do tipo Spark. 

  Os trabalhos de Ray devem definir `GlueVersion` como `4.0` ou mais. Porém, as versões do Ray, do Python e das bibliotecas adicionais disponíveis no seu trabalho do Ray são determinadas pelo parâmetro `Runtime` do comando Job.

  Para obter mais informações sobre as versões disponíveis do AWS Glue e as versões correspondentes do Spark e do Python, consulte [Versão do Glue](https://docs.aws.amazon.com/glue/latest/dg/add-job.html) no guia do desenvolvedor.

  Os trabalhos criados sem especificar uma versão do Glue usam como padrão o Glue 0.9.
+ `DPUSeconds` – Número (duplo).

  Esse campo pode ser preenchido para execuções de trabalhos com classes de execução `FLEX` ou quando o Auto Scaling está habilitado e representa o tempo total de execução de um executor durante o ciclo de vida de uma execução de trabalho em segundos, multiplicado por um fator de DPU (1 para operadores `G.1X`, 2 para operadores `G.2X` e 0,25 para operadores `G.025X`). Esse valor pode ser diferente de `executionEngineRuntime` \$1 `MaxCapacity`, como no caso de trabalhos do Auto Scaling, pois o número de executores em execução em um determinado momento pode ser menor que `MaxCapacity`. Portanto, é possível que o valor de `DPUSeconds` seja menor que `executionEngineRuntime` \$1 `MaxCapacity`.
+ `ExecutionClass`: string UTF-8, inferior a 16 bytes de comprimento (valores válidos: `FLEX=""` \$1 `STANDARD=""`).

  Indica se o trabalho é executado com uma classe de execução padrão ou flexível. A classe de execução padrão é ideal para workloads sensíveis ao tempo que exigem a inicialização rápida de trabalhos e recursos dedicados.

  A classe de execução flexível é adequada para trabalhos insensíveis ao tempo, cujos horários de início e conclusão podem variar. 

  Somente trabalhos com o AWS Glue versão 3.0 e posterior e o tipo de comando `glueetl` terão permissão para definir `ExecutionClass` como `FLEX`. A classe de execução flexível está disponível para trabalhos do Spark.
+ `MaintenanceWindow` – String UTF-8 correspondente a [Custom string pattern #34](aws-glue-api-common.md#regex_34).

  Esse campo especifica um dia da semana e uma hora para uma janela de manutenção para trabalhos de streaming. O AWS Glue realiza periodicamente atividades de manutenção. Durante essas janelas de manutenção, o AWS Glue precisará reiniciar seus trabalhos de streaming.

  O AWS Glue reiniciará o trabalho dentro de 3 horas da janela de manutenção especificada. Por exemplo, se você configurar a janela de manutenção para segunda-feira às 10h (GMT), seus trabalhos serão reiniciados entre 10h (GMT) e 13h (GMT).
+ `ProfileName` – 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 perfil de uso do AWS Glue associado à execução do trabalho.
+ `StateDetail`: string UTF-8, não superior a 400.000 bytes de comprimento.

  Esse campo contém detalhes referentes ao estado da execução de um trabalho. O campo é anulável.

  Por exemplo, quando a execução de um trabalho está em um estado "EM ESPERA" como resultado da fila de execução de um trabalho, o campo contém o motivo pelo qual a execução do trabalho está nesse estado.
+ `ExecutionRoleSessionPolicy`: string UTF-8 com no mínimo 2 e no máximo 2.048 bytes de comprimento.

  Essa política de sessão em linha da API StartJobRun permite restringir dinamicamente as permissões da função de execução especificada para o escopo do trabalho, sem exigir a criação de perfis do IAM adicionais.

## Estrutura Predecessor
<a name="aws-glue-api-jobs-runs-Predecessor"></a>

Uma execução de trabalho usada no predicado de um gatilho condicional que a acionou.

**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 da definição de trabalho usada pela execução do trabalho antecessor.
+ `RunId` – 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 ID da execução de trabalho predecessor.

## Estrutura JobBookmarkEntry
<a name="aws-glue-api-jobs-runs-JobBookmarkEntry"></a>

Define um ponto em que um trabalho pode retomar o processamento.

**Campos**
+ `JobName` – String UTF-8.

  O nome do trabalho em questão.
+ `Version` – Número (íntegro).

  A versão do trabalho.
+ `Run` – Número (íntegro).

  O número do ID de execução.
+ `Attempt` – Número (íntegro).

  O número do ID de tentativa.
+ `PreviousRunId` – String UTF-8.

  O identificador de execução exclusivo associado à execução do trabalho anterior.
+ `RunId` – String UTF-8.

  O número do ID de execução.
+ `JobBookmark` – String UTF-8.

  O próprio marcador.

## Estrutura BatchStopJobRunSuccessfulSubmission
<a name="aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission"></a>

Registra uma solicitação bem-sucedido para interromper um especificado `JobRun`.

**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 da definição de trabalho usada na execução do trabalho que foi interrompida.
+ `JobRunId` – 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 `JobRunId` da execução de trabalho que foi interrompida.

## Estrutura BatchStopJobRunError
<a name="aws-glue-api-jobs-runs-BatchStopJobRunError"></a>

Registra um erro que ocorreu ao tentar interromper uma execução de trabalho especificada.

**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 da definição de trabalho usada na execução do trabalho em questão.
+ `JobRunId` – 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 `JobRunId` da execução do trabalho em questão.
+ `ErrorDetail` – Um objeto [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail).

  Especifica detalhes sobre o erro encontrado.

## Estrutura NotificationProperty
<a name="aws-glue-api-jobs-runs-NotificationProperty"></a>

Especifica propriedades de configuração de uma notificação.

**Campos**
+ `NotifyDelayAfter` – Número (inteiro), pelo menos 1.

  Depois que a execução de um trabalho for iniciada, o número de minutos a esperar antes de enviar uma notificação de atraso de execução de trabalho.

## Operações
<a name="aws-glue-api-jobs-runs-actions"></a>
+ [Ação StartJobRun (Python: start\$1job\$1run)](#aws-glue-api-jobs-runs-StartJobRun)
+ [Ação BatchStopJobRun (Python: batch\$1stop\$1job\$1run)](#aws-glue-api-jobs-runs-BatchStopJobRun)
+ [Ação GetJobRun (Python: get\$1job\$1run)](#aws-glue-api-jobs-runs-GetJobRun)
+ [Ação GetJobRuns (Python: get\$1job\$1runs)](#aws-glue-api-jobs-runs-GetJobRuns)
+ [Ação GetJobBookmark (Python: get\$1job\$1bookmark)](#aws-glue-api-jobs-runs-GetJobBookmark)
+ [Ação GetJobBookmarks (Python: get\$1job\$1bookmarks)](#aws-glue-api-jobs-runs-GetJobBookmarks)
+ [Ação ResetJobBookmark (Python: reset\$1job\$1bookmark)](#aws-glue-api-jobs-runs-ResetJobBookmark)

## Ação StartJobRun (Python: start\$1job\$1run)
<a name="aws-glue-api-jobs-runs-StartJobRun"></a>

Inicia uma execução de trabalho usando uma definição de trabalho.

**Solicitação**
+ `JobName`: *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 da definição de trabalho que será usada.
+ `JobRunQueuingEnabled` – Booleano.

  Especifica se o enfileiramento da execução de trabalhos está habilitado para a execução do trabalho.

  Um valor "verdadeiro" significa que o enfileiramento da execução de trabalhos está habilitado para as execuções do trabalho. Se o valor for "falso" ou não estiver preenchido, a execução do trabalho não será considerada para enfileiramento.
+ `JobRunId` – 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 ID de um `JobRun` anterior para tentar novamente.
+ `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 trabalho associados a esta execução. 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.

  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 segredo se pretender mantê-los dentro do trabalho. 

  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 argumentos que você pode fornecer a esse campo ao configurar trabalhos do Spark, consulte o AWS Glue tópico [Special Parameters Used by ](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) no guia do desenvolvedor.

  Para obter informações sobre os argumentos que podem ser fornecidos a esse campo ao configurar trabalhos do Ray, consulte o tópico [Uso de parâmetros de trabalho em trabalhos do Ray](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html) no guia do desenvolvedor.
+ `AllocatedCapacity` – Número (íntegro).

  Este campo está obsoleto. Use `MaxCapacity` em vez disso.

  O número de unidades de processamento de dados (DPUs) do AWS Glue a serem atribuídas a esse JobRun. É possível alocar um mínimo de 2 DPUs. O padrão é 10. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória. Para obter mais informações, consulte a [página de definição de preços do AWS Glue](https://aws.amazon.com/glue/pricing/).
+ `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`. Esse valor 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 padrão é de 2.880 minutos.

  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.
+ `MaxCapacity` – Número (duplo).

  Para trabalhos do Glue versão 1.0 ou anterior, usando o tipo de operador padrão, é o número de unidades de processamento de dados (DPUs) do AWS Glue que poderão ser alocadas quando esse trabalho for executado. Uma DPU é uma medida relativa do poder de processamento que consiste em uma capacidade computacional de 4 vCPUs e 16 GB de memória. Para obter mais informações, consulte a [página de definição de preços do AWS Glue](https://aws.amazon.com/glue/pricing/).

  Para trabalhos do Glue versão 2.0\$1, você não pode especificar uma `Maximum capacity`. Em vez disso, você deve especificar um `Worker type` e o `Number of workers`.

  Não defina `MaxCapacity` se estiver usando `WorkerType` e `NumberOfWorkers`.

  O valor que pode ser alocado para `MaxCapacity` depende se você está executando um trabalho de shell do Python, um trabalho de ETL do Apache Spark ou um trabalho de ETL de streaming do Apache Spark:
  + Ao especificar um trabalho de shell do Python (`JobCommand.Name`="pythonshell"), será possível alocar 0,0625 ou 1 DPU. O padrão é 0,0625 DPU.
  + Ao especificar um trabalho de ETL do Apache Spark (`JobCommand.Name`="glueetl") ou um trabalho de ETL de streaming do Apache Spark (`JobCommand.Name`="gluestreaming"), é possível alocar de 2 a 100 DPUs. O padrão é de 10 DPUs. Esse tipo de trabalho não pode ter uma alocação de DPU fracionada.
+ `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 a execução desse trabalho.
+ `NotificationProperty` – Um objeto [NotificationProperty](#aws-glue-api-jobs-runs-NotificationProperty).

  Especifica propriedades de configuração de uma notificação de execução de trabalho.
+ `WorkerType` – string UTF-8 (valores válidos: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  O tipo de operador predefinido que é alocado quando um trabalho é executado. Aceita um valor de G.1X, G.2X, G.4X, G.8X ou G.025X para trabalhos do Spark. Aceita o valor Z.2X para trabalhos do Ray.
  + Para o tipo de operador `G.1X`, cada operador é mapeado em 1 DPU (4 vCPU, 16 GB de memória) com 94 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads, como transformações de dados, uniões e consultas, para oferecer uma maneira escalável e econômica de executar a maioria dos trabalhos.
  + Para o tipo de operador `G.2X`, cada operador é mapeado em 2 DPU (8 vCPU, 32 GB de memória) com 138 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads, como transformações de dados, uniões e consultas, para oferecer uma maneira escalável e econômica de executar a maioria dos trabalhos.
  + Para o tipo de operador `G.4X`, cada operador é mapeado em 4 DPU (16 vCPU, 64 GB de memória) com 256 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos cujas workloads contêm as transformações, agregações, uniões e consultas mais exigentes. Esse tipo de operador está disponível somente para trabalhos de ETL do Spark no AWS Glue versão 3.0 ou posterior nas seguintes regiões da AWS: Leste dos EUA (Ohio), Leste dos EUA (Norte da Virgínia), Oeste dos EUA (Oregon), Ásia-Pacífico (Singapura), Ásia-Pacífico (Sydney), Ásia-Pacífico (Tóquio), Canadá (Central), Europa (Frankfurt), Europa (Irlanda) e Europa (Estocolmo).
  + Para o tipo de operador `G.8X`, cada operador é mapeado em 8 DPU (32 vCPU, 128 GB de memória) com 512 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos cujas workloads contêm as transformações, agregações, uniões e consultas mais exigentes. Esse tipo de operador está disponível somente para trabalhos de ETL do Spark no AWS Glue versão 3.0 ou posterior, nas mesmas regiões da AWS compatíveis com o tipo de operador `G.4X`.
  + Para o tipo de operador `G.12X`, cada operador é mapeado em 12 DPU (48 vCPU, 192 GB de memória) com 768 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos com workloads muito grandes. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `G.16X`, cada operador é mapeado em 16 DPU (64 vCPU, 256 GB de memória) com 1024 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos com workloads muito grandes. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `G.025X`, cada operador é mapeado para 0,25 DPU (2 vCPU, 4 GB de memória) com 84 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para trabalhos de streaming de baixo volume. Esse tipo de operador só está disponível para trabalhos de streaming do AWS Glue versão 3.0 ou posterior.
  + Para o tipo de operador `R.1X`, cada operador é mapeado em 1 DPU (4 vCPU, 32 GB de memória) com 94 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads com uso intensivo de memória. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `R.2X`, cada operador é mapeado em 2 DPU (8 vCPU, 64 GB de memória) com 128 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads com uso intensivo de memória. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `R.4X`, cada operador é mapeado em 4 DPU (16 vCPU, 128 GB de memória) com 256 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads com uso intensivo de memória. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `R.8X`, cada operador é mapeado em 8 DPU (32 vCPU, 256 GB de memória) com 512 GB de disco e fornece 1 executor por operador. Recomendamos esse tipo de operador para workloads com uso intensivo de memória. Esse tipo de operador só está disponível para trabalhos de ETL do Spark no AWS Glue versão 4.0 ou posterior.
  + Para o tipo de operador `Z.2X`, cada operador é mapeado em 2 M-DPU (8 vCPUs, 64 GB de memória) com 128 GB de disco e fornece até 8 operadores do Ray baseados no autoscaler.
+ `NumberOfWorkers` – Número (íntegro).

  O número de operadores de determinado `workerType` que são alocados quando um trabalho é executado.
+ `ExecutionClass`: string UTF-8, inferior a 16 bytes de comprimento (valores válidos: `FLEX=""` \$1 `STANDARD=""`).

  Indica se o trabalho é executado com uma classe de execução padrão ou flexível. A classe de execução padrão é ideal para workloads sensíveis ao tempo que exigem a inicialização rápida de trabalhos e recursos dedicados.

  A classe de execução flexível é adequada para trabalhos insensíveis ao tempo, cujos horários de início e conclusão podem variar. 

  Somente trabalhos com o AWS Glue versão 3.0 e posterior e o tipo de comando `glueetl` terão permissão para definir `ExecutionClass` como `FLEX`. A classe de execução flexível está disponível para trabalhos do Spark.
+ `ProfileName` – 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 perfil de uso do AWS Glue associado à execução do trabalho.
+ `ExecutionRoleSessionPolicy`: string UTF-8 com no mínimo 2 e no máximo 2.048 bytes de comprimento.

  Essa política de sessão em linha da API StartJobRun permite restringir dinamicamente as permissões da função de execução especificada para o escopo do trabalho, sem exigir a criação de perfis do IAM adicionais.

**Resposta**
+ `JobRunId` – 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 ID atribuído a esta execução de trabalho.

**Erros**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentRunsExceededException`

## Ação BatchStopJobRun (Python: batch\$1stop\$1job\$1run)
<a name="aws-glue-api-jobs-runs-BatchStopJobRun"></a>

Interrompe uma ou mais execuções de trabalho para uma definição de trabalho determinada.

**Solicitação**
+ `JobName`: *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 da definição de trabalho para a qual as execuções de trabalho são interrompidas.
+ `JobRunIds` – *Obrigatório:* uma matriz de strings UTF-8, no mínimo 1 ou mais de 25 strings.

  Uma lista dos `JobRunIds` que devem ser interrompidos para essa definição de trabalho.

**Resposta**
+ `SuccessfulSubmissions`: um array de objetos [BatchStopJobRunSuccessfulSubmission](#aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission).

  Uma lista dos JobRuns que foram enviados com sucesso para interrupção.
+ `Errors`: um array de objetos [BatchStopJobRunError](#aws-glue-api-jobs-runs-BatchStopJobRunError).

  Uma lista dos erros que foram encontrados durante a tentativa de interrupção de `JobRuns`, incluindo o `JobRunId` para o qual cada erro foi encontrado e os detalhes do erro.

**Erros**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## Ação GetJobRun (Python: get\$1job\$1run)
<a name="aws-glue-api-jobs-runs-GetJobRun"></a>

Recupera os metadados para uma execução de trabalho específica. O histórico de execução de trabalhos fica disponível por 365 dias para seu fluxo de trabalho e para a execução do trabalho.

**Solicitação**
+ `JobName`: *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).

  Nome da definição de trabalho em execução.
+ `RunId`: *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 ID da execução de trabalho.
+ `PredecessorsIncluded` – Booleano.

  True, se uma lista de execuções antecessoras for retornada.

**Resposta**
+ `JobRun` – Um objeto [JobRun](#aws-glue-api-jobs-runs-JobRun).

  Os metadados solicitados da execução de trabalho.

**Erros**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## Ação GetJobRuns (Python: get\$1job\$1runs)
<a name="aws-glue-api-jobs-runs-GetJobRuns"></a>

Recupera os metadados para todas as execuções de uma determinada definição de trabalho.

`GetJobRuns` retorna as execuções da tarefa em ordem cronológica, com as tarefas mais recentes primeiro.

**Solicitação**
+ `JobName`: *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 da definição de trabalho para a qual todas as execuções de trabalho são recuperadas.
+ `NextToken` – String UTF-8.

  Um token de continuação, se esta for uma chamada de continuação.
+ `MaxResults`: número (inteiro) não inferior a 1 nem superior a 200.

  O tamanho máximo da resposta.

**Resposta**
+ `JobRuns`: um array de objetos [JobRun](#aws-glue-api-jobs-runs-JobRun).

  Uma lista de objetos de metadados de execução de trabalho.
+ `NextToken` – String UTF-8.

  Um token de continuação, se todas as execuções de trabalho solicitadas não tiverem sido retornadas.

**Erros**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## Ação GetJobBookmark (Python: get\$1job\$1bookmark)
<a name="aws-glue-api-jobs-runs-GetJobBookmark"></a>

Retorna informações sobre uma entrada de marcador de trabalho.

Para obter mais informações sobre como habilitar e usar marcadores de trabalho, consulte:
+ [Rastrear dados processados usando marcadores de trabalho](https://docs.aws.amazon.com/glue/latest/dg/monitor-continuations.html)
+ [Parâmetros de trabalho usados pelo AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)
+ [Estrutura do trabalho](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html#aws-glue-api-jobs-job-Job)

**Solicitação**
+ `JobName` – *Obrigatório:* string UTF-8.

  O nome do trabalho em questão.
+ `Version` – Número (íntegro).

  A versão do trabalho.
+ `RunId` – String UTF-8.

  O identificador de execução exclusivo associado à execução desse trabalho.

**Resposta**
+ `JobBookmarkEntry` – Um objeto [JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry).

  Uma estrutura que define um ponto em que um trabalho pode retomar o processamento.

**Erros**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ValidationException`

## Ação GetJobBookmarks (Python: get\$1job\$1bookmarks)
<a name="aws-glue-api-jobs-runs-GetJobBookmarks"></a>

Retorna informações sobre as entradas de marcador de trabalho. A ordem da lista é em números de versão decrescentes.

Para obter mais informações sobre como habilitar e usar marcadores de trabalho, consulte:
+ [Rastrear dados processados usando marcadores de trabalho](https://docs.aws.amazon.com/glue/latest/dg/monitor-continuations.html)
+ [Parâmetros de trabalho usados pelo AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)
+ [Estrutura do trabalho](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html#aws-glue-api-jobs-job-Job)

**Solicitação**
+ `JobName` – *Obrigatório:* string UTF-8.

  O nome do trabalho em questão.
+ `MaxResults` – Número (íntegro).

  O tamanho máximo da resposta.
+ `NextToken` – Número (íntegro).

  Um token de continuação, se esta for uma chamada de continuação.

**Resposta**
+ `JobBookmarkEntries`: um array de objetos [JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry).

  Uma lista de entradas de marcador de trabalho que define um ponto em que um trabalho pode retomar o processamento.
+ `NextToken` – Número (íntegro).

  Um token de continuação, que terá um valor de 1 se todas as entradas forem retornadas ou > 1 se nem todas as execuções solicitadas forem retornadas.

**Erros**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## Ação ResetJobBookmark (Python: reset\$1job\$1bookmark)
<a name="aws-glue-api-jobs-runs-ResetJobBookmark"></a>

Redefine uma entrada de marcador.

Para obter mais informações sobre como habilitar e usar marcadores de trabalho, consulte:
+ [Rastrear dados processados usando marcadores de trabalho](https://docs.aws.amazon.com/glue/latest/dg/monitor-continuations.html)
+ [Parâmetros de trabalho usados pelo AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)
+ [Estrutura do trabalho](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html#aws-glue-api-jobs-job-Job)

**Solicitação**
+ `JobName` – *Obrigatório:* string UTF-8.

  O nome do trabalho em questão.
+ `RunId` – String UTF-8.

  O identificador de execução exclusivo associado à execução desse trabalho.

**Resposta**
+ `JobBookmarkEntry` – Um objeto [JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry).

  A redefinição da entrada de marcador.

**Erros**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

# Acionadores
<a name="aws-glue-api-jobs-trigger"></a>

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
<a name="aws-glue-api-jobs-trigger-objects"></a>
+ [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
<a name="aws-glue-api-jobs-trigger-Trigger"></a>

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` \$1 `CONDITIONAL` \$1 `ON_DEMAND` \$1 `EVENT`).

  O tipo de gatilho.
+ `State` – String UTF-8 (valores válidos: `CREATING` \$1 `CREATED` \$1 `ACTIVATING` \$1 `ACTIVATED` \$1 `DEACTIVATING` \$1 `DEACTIVATED` \$1 `DELETING` \$1 `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
<a name="aws-glue-api-jobs-trigger-TriggerUpdate"></a>

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
<a name="aws-glue-api-jobs-trigger-Predicate"></a>

Define o predicado do gatilho, que determina quando ele é acionado.

**Campos**
+ `Logical`: string UTF-8 (valores válidos: `AND` \$1 `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
<a name="aws-glue-api-jobs-trigger-Condition"></a>

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` \$1 `RUNNING` \$1 `STOPPING` \$1 `STOPPED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `TIMEOUT` \$1 `ERROR` \$1 `WAITING` \$1 `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` \$1 `CANCELLING` \$1 `CANCELLED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `ERROR`).

  O estado do crawler ao qual essa condição se aplica.

## Estrutura Action
<a name="aws-glue-api-jobs-trigger-Action"></a>

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 padrão é de 2.880 minutos.

  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
<a name="aws-glue-api-jobs-trigger-EventBatchingCondition"></a>

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 name="aws-glue-api-jobs-trigger-actions"></a>
+ [Ação CreateTrigger (Python: create\$1trigger)](#aws-glue-api-jobs-trigger-CreateTrigger)
+ [Ação StartTrigger (Python: start\$1trigger)](#aws-glue-api-jobs-trigger-StartTrigger)
+ [Ação GetTrigger (Python: get\$1trigger)](#aws-glue-api-jobs-trigger-GetTrigger)
+ [Ação GetTriggers (Python: get\$1triggers)](#aws-glue-api-jobs-trigger-GetTriggers)
+ [Ação UpdateTrigger (Python: update\$1trigger)](#aws-glue-api-jobs-trigger-UpdateTrigger)
+ [Ação StopTrigger (Python: stop\$1trigger)](#aws-glue-api-jobs-trigger-StopTrigger)
+ [Ação DeleteTrigger (Python: delete\$1trigger)](#aws-glue-api-jobs-trigger-DeleteTrigger)
+ [Ação ListTriggers (Python: list\$1triggers)](#aws-glue-api-jobs-trigger-ListTriggers)
+ [Ação BatchGetTriggers (Python: batch\$1get\$1triggers)](#aws-glue-api-jobs-trigger-BatchGetTriggers)

## Ação CreateTrigger (Python: create\$1trigger)
<a name="aws-glue-api-jobs-trigger-CreateTrigger"></a>

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` \$1 `CONDITIONAL` \$1 `ON_DEMAND` \$1 `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\$1trigger)
<a name="aws-glue-api-jobs-trigger-StartTrigger"></a>

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\$1trigger)
<a name="aws-glue-api-jobs-trigger-GetTrigger"></a>

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\$1triggers)
<a name="aws-glue-api-jobs-trigger-GetTriggers"></a>

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\$1trigger)
<a name="aws-glue-api-jobs-trigger-UpdateTrigger"></a>

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\$1trigger)
<a name="aws-glue-api-jobs-trigger-StopTrigger"></a>

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\$1trigger)
<a name="aws-glue-api-jobs-trigger-DeleteTrigger"></a>

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\$1triggers)
<a name="aws-glue-api-jobs-trigger-ListTriggers"></a>

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\$1get\$1triggers)
<a name="aws-glue-api-jobs-trigger-BatchGetTriggers"></a>

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`