# Monitorar o status de uma tarefa de transferência de arquivo
<a name="Appendix.SQLServer.Options.S3-integration.using.monitortasks"></a>

Para rastrear o status da tarefa de integração do S3, chame a função `rds_fn_task_status`. Ela leva dois parâmetros. O primeiro parâmetro sempre deve ser `NULL` porque não se aplica à integração do S3. O segundo parâmetro aceita um ID de tarefa.

Para ver uma lista de todas as tarefas, defina o primeiro parâmetro como `NULL` e o segundo parâmetro como `0`, conforme mostrado no seguinte exemplo.

```
SELECT * FROM msdb.dbo.rds_fn_task_status(NULL,{{0}});
```

Para obter uma tarefa específica, defina o primeiro parâmetro como `NULL` e o segundo parâmetro como o ID da tarefa, conforme mostrado no exemplo a seguir.

```
SELECT * FROM msdb.dbo.rds_fn_task_status(NULL,{{42}});
```

A função `rds_fn_task_status` retorna as informações a seguir.


|  Parâmetro de saída  |  Descrição  | 
| --- | --- | 
| `task_id` | O ID da tarefa. | 
| `task_type` | Para a integração do S3, as tarefas podem ter os seguintes tipos de tarefa:+  `DOWNLOAD_FROM_S3` <br />+  `UPLOAD_TO_S3` <br />+  `LIST_FILES_ON_DISK` <br />+  `DELETE_FILES_ON_DISK`  | 
| `database_name` | Não aplicável a tarefas de integração do S3. | 
| `% complete` | O progresso da tarefa em porcentagem. | 
| `duration(mins)` | A quantidade de tempo gasta na tarefa, em minutos. | 
| `lifecycle` | O status da tarefa. Os possíveis status são os seguintes:+  `CREATED` – Após chamar um dos procedimentos armazenados de integração do S3, uma tarefa será criada, e o status será definido como `CREATED`. <br />+  `IN_PROGRESS` – Após iniciar uma tarefa, o status será definido como `IN_PROGRESS`. Pode demorar até 5 minutos para que o status mude de `CREATED` para `IN_PROGRESS`. <br />+  `SUCCESS` – Após concluir uma tarefa, o status será definido como `SUCCESS`. <br />+  `ERROR` – Se uma tarefa falhar, o status será definido como `ERROR`. Para obter mais informações sobre o erro, consulte a coluna `task_info`. <br />+  `CANCEL_REQUESTED` – Após chamar `rds_cancel_task`, o status da tarefa será definido como `CANCEL_REQUESTED`. <br />+  `CANCELLED` – após uma tarefa ter sido cancelada com sucesso, o status da tarefa será definido como `CANCELLED`.   | 
| `task_info` | Informações adicionais sobre a tarefa. Se um erro ocorrer durante o processamento, essa coluna conterá informações sobre o erro.  | 
| `last_updated` | A data e hora em que o status da tarefa foi atualizado pela última vez.  | 
| `created_at` | A data e hora em que a tarefa foi criada. | 
| `S3_object_arn` | O ARN do objeto do S3 baixado ou carregado. | 
| `overwrite_S3_backup_file` | Não aplicável a tarefas de integração do S3. | 
| `KMS_master_key_arn` | Não aplicável a tarefas de integração do S3. | 
| `filepath` | O caminho de arquivo na instância de banco de dados do RDS | 
| `overwrite_file` | Uma opção que indica se um arquivo existente foi substituído. | 
| `task_metadata` | Não aplicável a tarefas de integração do S3. |