

# Gerenciar trabalhos de operações em lote do S3
<a name="batch-ops-managing-jobs"></a>

O Amazon S3 oferece um conjunto de ferramentas robusto para ajudar a gerenciar trabalhos do S3 Batch Operations após a criação deles. Esta seção descreve as operações que você pode usar para gerenciar e rastrear trabalhos usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), SDKs da AWS ou a API REST do Amazon S3.

**Topics**
+ [Usar o console do Simple Storage Service (Amazon S3) para gerenciar trabalhos do S3 Batch Operations](#batch-ops-manage-console)
+ [Listar trabalhos](batch-ops-list-jobs.md)
+ [Visualizar detalhes do trabalho](batch-ops-job-details.md)
+ [Atribuir prioridade aos trabalhos](batch-ops-job-priority.md)

## Usar o console do Simple Storage Service (Amazon S3) para gerenciar trabalhos do S3 Batch Operations
<a name="batch-ops-manage-console"></a>

Usar o console para gerenciar seus trabalhos do S3 Batch Operations. Por exemplo, é possível:
+ Exibir trabalhos ativos e enfileirados
+ Conferir o status de um trabalho
+ Alterar a prioridade de um trabalho
+ Confirmar e executar um trabalho
+ Clonar um trabalho
+ Cancelar um trabalho

**Para gerenciar trabalhos do S3 Batch Operations usando o console**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação esquerdo, escolha **Batch Operations** (Operações em lote).

1. Escolha o trabalho que você deseja gerenciar.

# Listar trabalhos
<a name="batch-ops-list-jobs"></a>

Você pode recuperar uma lista dos seus trabalhos de operações em lote do S3. Ela fornece informações sobre os trabalhos ainda não concluídos, bem como os concluídos nos últimos noventa dias. Para cada trabalho, a lista inclui detalhes, como ID do trabalho, descrição, prioridade, status atual e número de tarefas que foram bem-sucedidas e que apresentaram falha.

Você pode filtrar a lista por status. Se você recuperar a lista pelo console, também poderá pesquisar os trabalhos por descrição ou ID e filtrá-los por Região da AWS.

## Obter uma lista de trabalhos `Active` e `Complete`
<a name="batch-ops-example-cli-active-jobs"></a>

O exemplo de AWS CLI a seguir obtém uma lista de trabalhos `Active` e `Complete`. Para usar esse exemplo, substitua os *`user input placeholders`* por suas próprias informações.

```
aws s3control list-jobs \
    --region us-west-2 \
    --account-id account-id \
    --job-statuses '["Active","Complete"]' \
    --max-results 20
```

Para obter mais informações e exemplos, consulte [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/list-jobs.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/list-jobs.html) na *Referência de comandos da AWS CLI*.

# Visualizar detalhes do trabalho
<a name="batch-ops-job-details"></a>

Se quiser mais informações sobre um trabalho do Operações em Lote do Amazon S3 que pode ser recuperado listando trabalhos, poderá visualizar todos os detalhes de um único trabalho. É possível ver detalhes dos trabalhos que ainda não foram concluídos ou dos que foram concluídos nos últimos noventa dias. Além das informações exibidas em uma lista de trabalhos, os detalhes de um trabalho individual incluem informações como: 
+ Os parâmetros da operação.
+ Detalhes sobre o manifesto.
+ Informações sobre o relatório de conclusão, se você configurou um ao criar o trabalho.
+ O nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que você atribuiu para executar o trabalho.

Exibindo os detalhes de um trabalho individual, você acessa toda a configuração de um trabalho. Para visualizar os detalhes de um trabalho, você pode usar o console do Amazon S3 ou a AWS Command Line Interface (AWS CLI).

## Ter a descrição de um trabalho de Operações em Lote do S3 no console do Amazon S3
<a name="batch-ops-console-job-description"></a>

**Como visualizar a descrição de um trabalho de Operações em Lote usando o console**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação esquerdo, escolha **Batch Operations** (Operações em lote).

1. Escolha o ID do trabalho específico para visualizar os detalhes.

## Ter a descrição de um trabalho de Operações em Lote do S3 no AWS CLI
<a name="batch-ops-example-cli-job-description"></a>

O exemplo a seguir obtém a descrição de um trabalho de Operações em Lote do S3 usando a AWS CLI. Para usar o comando a seguir, substitua os *`user input placeholders`* por suas próprias informações.

```
aws s3control describe-job \
--region us-west-2 \
--account-id account-id \
--job-id 00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c
```

Para obter mais informações e exemplos, consulte [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/describe-job.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/describe-job.html) na *Referência de comandos da AWS CLI*.

# Atribuir prioridade aos trabalhos
<a name="batch-ops-job-priority"></a>

Você pode atribuir a cada trabalho do Operações em Lote do Amazon S3 uma prioridade numérica, que pode ser qualquer inteiro positivo. O Operações em Lote do S3 prioriza trabalhos de acordo com a prioridade atribuída. Os trabalhos com prioridade mais alta (ou um valor inteiro mais alto para o parâmetro de prioridade) são avaliados primeiro. A prioridade é determinada em ordem decrescente. Por exemplo, uma fila de tarefas com valor de prioridade 10 tem preferência de programação em relação a uma fila com valor de prioridade 1. 

É possível alterar a prioridade do trabalho enquanto ele está sendo executado. Se você enviar um novo trabalho com uma prioridade mais alta enquanto um trabalho estiver em execução, o trabalho de menor prioridade poderá ser pausado para permitir a execução do trabalho de maior prioridade.

Alterar a prioridade de um trabalho não afeta a velocidade de processamento dele.

**nota**  
O Operações em Lote do S3 respeita as prioridades de trabalhos com o melhor esforço. Embora os trabalhos com prioridades mais altas normalmente tenham precedência sobre os de prioridades mais baixas, o Amazon S3 não garante a classificação rígida dos trabalhos.

## Usar o console do S3
<a name="batch-ops-example-console-update-job-priority"></a>

**Como atualizar a prioridade de trabalhos no console do Amazon S3**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação esquerdo, escolha **Batch Operations** (Operações em lote).

1. Selecione o trabalho específico que você deseja gerenciar.

1. Escolha **Actions** (Ações). Na lista suspensa, escolha **Update priority** (Atualizar prioridade).

## Como usar o AWS CLI
<a name="batch-ops-example-cli-update-job-priority"></a>

O exemplo a seguir atualiza a prioridade do trabalho usando a AWS CLI. Um número maior indica uma prioridade de execução mais alta. Para usar o comando a seguir, substitua os *`user input placeholders`* por suas próprias informações.

```
aws s3control update-job-priority \
    --region us-west-2 \
    --account-id account-id \
    --priority 98 \
    --job-id 00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c
```

## Como usar o AWS SDK para Java
<a name="batch-ops-examples-java-update-job-priority."></a>

Para atualizar a prioridade de um trabalho do recurso Operações em Lote do S3 usando o AWS SDK para Java, você pode usar o cliente S3Control e modificar a prioridade de execução do trabalho, que determina a ordem na qual os trabalhos são processados em relação aos outros trabalhos na fila.

Para obter mais informações sobre prioridade de trabalhos, consulte [Atribuir prioridade aos trabalhos](#batch-ops-job-priority).

Para ver exemplos de como atualizar a prioridade do trabalho com o AWS SDK para Java, consulte [Update the priority of a batch job](https://docs.aws.amazon.com/AmazonS3/latest/API/s3-control_example_s3-control_UpdateJobPriority_section.html) na *Referência de API do Amazon S3*.