

# Monitoreo del estado de una tarea de transferencia de archivos
<a name="Appendix.SQLServer.Options.S3-integration.using.monitortasks"></a>

Para realizar un seguimiento del estado de la tarea de integración de S3, llame a la función `rds_fn_task_status`. Tiene dos parámetros. El primer parámetro siempre debe ser `NULL` porque no se aplica a la integración de S3. El segundo parámetro acepta un ID de tarea.

Para obtener una lista de todas las tareas, establezca el primer parámetro en `NULL` y el segundo en `0`, como se muestra en el siguiente ejemplo.

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

Para obtener una tarea específica, establezca el primer parámetro en `NULL` y el segundo en el ID de la tarea, como se muestra en el siguiente ejemplo.

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

La función `rds_fn_task_status` devuelve la siguiente información.


|  Parámetro de salida  |  Descripción  | 
| --- | --- | 
| `task_id` | El ID de la tarea. | 
| `task_type` | En la integración de S3, las tareas pueden ser de los siguientes tipos:+  `DOWNLOAD_FROM_S3` <br />+  `UPLOAD_TO_S3` <br />+  `LIST_FILES_ON_DISK` <br />+  `DELETE_FILES_ON_DISK`  | 
| `database_name` | No se aplica a las tareas de integración de S3. | 
| `% complete` | El porcentaje de progreso de la tarea. | 
| `duration(mins)` | El tiempo empleado en la tarea, en minutos. | 
| `lifecycle` | El estado de la tarea. Los posibles estados son los siguientes:+  `CREATED` – después de llamar a uno de los procedimientos almacenados de la integración de S3, se crea una tarea y el estado se establece en `CREATED`. <br />+  `IN_PROGRESS` – cuando una tarea comienza, el estado se establece en `IN_PROGRESS`. Pueden pasar hasta cinco minutos hasta que el estado cambie de `CREATED` a `IN_PROGRESS`. <br />+  `SUCCESS` – cuando una tarea se completa, el estado se establece en `SUCCESS`. <br />+  `ERROR` – si se produce un error con una tarea, el estado se establece en `ERROR`. Para obtener más información acerca del error, consulte la columna `task_info`. <br />+  `CANCEL_REQUESTED`: después de llamar a `rds_cancel_task`, el estado de la tarea se establece en `CANCEL_REQUESTED`. <br />+  `CANCELLED` – después de que se cancela una tarea correctamente, se establece su estado en `CANCELLED`.   | 
| `task_info` | Información adicional acerca de la tarea. Si se produce un error durante el procesamiento, esta columna contiene información acerca del error.  | 
| `last_updated` | La fecha y hora en que se actualizó por última vez el estado de la tarea.  | 
| `created_at` | La fecha y hora en que se creó la tarea. | 
| `S3_object_arn` | El ARN del objeto de S3 desde el que se descarga o al que se carga. | 
| `overwrite_S3_backup_file` | No se aplica a las tareas de integración de S3. | 
| `KMS_master_key_arn` | No se aplica a las tareas de integración de S3. | 
| `filepath` | La ruta del archivo de la instancia de base de datos de RDS. | 
| `overwrite_file` | Una opción que indica si un archivo existente se sobrescribe. | 
| `task_metadata` | No se aplica a las tareas de integración de S3. | 