

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Etiquetar tus tareas AWS DataSync
<a name="tagging-tasks"></a>

Las *etiquetas* son pares clave-valor que te ayudan a administrar, filtrar y buscar tus AWS DataSync recursos. Puedes añadir hasta 50 etiquetas a cada DataSync tarea y ejecución de tareas.

Por ejemplo, puede crear una tarea para realizar una migración de datos de gran tamaño y etiquetarla con la clave **Project** y el valor **Large Migration**. Para una mejor organización de la migración, puede etiquetar una ejecución de la tarea con la clave **Transfer Date** y el valor **May 2021** (es posible que se etiqueten las siguientes ejecuciones de las tareas **June 2021**, **July 2021**, etc.).

## Etiquetar tu tarea DataSync
<a name="tagging-tasks-console"></a>

Solo puede etiquetar la DataSync tarea al crearla.

### Uso de la DataSync consola
<a name="tagging-tasks-console-steps"></a>

1. Abra la AWS DataSync consola en [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. En el panel de navegación situado a la izquierda, expanda **Transferencia de datos**; luego, seleccione **Tareas** y, a continuación, seleccione **Crear tarea**.

1. Configure las ubicaciones de origen y destino de la tarea.

   Para obtener más información, consulte [¿Dónde puedo transferir mis datos AWS DataSync?](working-with-locations.md)

1. En la página **Configurar ajustes**, seleccione **Añadir etiqueta nueva** para etiquetar la tarea.

### Usando el AWS CLI
<a name="tagging-tasks-cli-steps"></a>

1. Copie el siguiente comando `create-task`:

   ```
   aws datasync create-task \
       --source-location-arn 'arn:aws:datasync:region:account-id:location/source-location-id' \
       --destination-location-arn 'arn:aws:datasync:region:account-id:location/destination-location-id' \
       --tags Key=tag-key,Value=tag-value
   ```

1. Especifique los siguientes parámetros en el comando:
   + `--source-location-arn`: especifique el nombre de recurso de Amazon (ARN) de la ubicación de origen en la transferencia.
   + `--destination-location-arn`: especifique el ARN de la ubicación de destino en la transferencia.
   + `--tags`: especifique las etiquetas que desea aplicar a la tarea.

     Si hay más de una etiqueta, separe cada par clave-valor con un espacio.

1. (Opcional) Especifique otros parámetros que tengan sentido para su escenario de transferencia.

   Para obtener una lista de `--options`, consulte el comando [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html).

1. Ejecute el comando `create-task`.

   Recibirá una respuesta que le mostrará la tarea que acaba de crear.

   ```
   {
       "TaskArn": "arn:aws:datasync:us-east-2:123456789012:task/task-abcdef01234567890"
   }
   ```

Para ver las etiquetas que ha añadido a esta tarea, puede utilizar el [list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)comando.

## Etiquetar la ejecución de la DataSync tarea
<a name="tagging-task-executions-console"></a>

Puede etiquetar cada ejecución de la DataSync tarea.

Si la tarea ya tiene etiquetas, recuerde lo siguiente sobre el uso de etiquetas en la ejecución de tareas:
+ Si inicia la tarea con la consola, las etiquetas creadas por el usuario se aplicarán de forma automática a la ejecución de la tarea. Sin embargo, no se aplicarán las etiquetas creadas por el sistema que comiencen por `aws:`.
+ Si empiezas la tarea con la DataSync API o AWS CLI, sus etiquetas no se aplican automáticamente a la ejecución de la tarea.

### Uso de la DataSync consola
<a name="tagging-task-executions-console"></a>

Para añadir, editar o eliminar etiquetas de la ejecución de una tarea, debe iniciar la tarea con las opciones de anulación.

1. Abra la AWS DataSync consola en [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. En el panel de navegación situado a la izquierda, expanda **Transferencia de datos** y, a continuación, seleccione **Tareas**.

1. Elija la tarea.

1. Seleccione **Iniciar** y, a continuación, elija una de las siguientes opciones: 
   + **Iniciar con los valores predeterminados**: aplica cualquier etiqueta asociada a la tarea.
   + **Comenzar con las opciones principales**: permite añadir, editar o eliminar etiquetas para la ejecución de esta tarea en particular.

### Usando el AWS CLI
<a name="tagging-task-executions-cli"></a>

1. Copie el siguiente comando `start-task-execution`:

   ```
   aws datasync start-task-execution \
       --task-arn 'arn:aws:datasync:region:account-id:task/task-id' \
       --tags Key=tag-key,Value=tag-value
   ```

1. Especifique los siguientes parámetros en el comando:
   + `--task-arn`: especifique el ARN de la tarea que desea iniciar.
   + `--tags`: especifique las etiquetas que desea aplicar a esta ejecución específica de la tarea.

     Si hay más de una etiqueta, separe cada par clave-valor con un espacio.

1. (Opcional) Especifique otros parámetros que tengan sentido para su situación.

   Para obtener más información, consulte el comando [start-task-execution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/start-task-execution.html).

1. Ejecute el comando `start-task-execution`.

   Recibirá una respuesta que muestra la ejecución de la tarea que usted acaba de iniciar.

   ```
   {
       "TaskExecutionArn": "arn:aws:datasync:us-east-2:123456789012:task/task-abcdef01234567890"
   }
   ```

Para ver las etiquetas que ha añadido a esta tarea, puede utilizar el [list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)comando.