# Execuções de trabalhos
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
+ [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
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
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
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
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
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
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çã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)
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)
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)
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)
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)
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)
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)
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`