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.

# Adición de etiquetas a recursos de Macie
<a name="tags-add"></a>

Una *etiqueta* es un identificador que se puede definir y asociar opcionalmente a recursos de AWS , incluidos determinados tipos de recursos de Amazon Macie. Con las etiquetas, puede identificar, clasificar y administrar recursos de distintas formas, como por finalidad, propietario, entorno u otros criterios. Por ejemplo, puede usar etiquetas para aplicar políticas, asignar costos, distinguir entre las versiones de los recursos o identificar los recursos que respaldan determinados requisitos de conformidad o flujos de trabajo.

Puede añadir etiquetas a los siguientes tipos de recursos de Macie:
+ Listas de permitidos
+ Identificadores de datos personalizados
+ Reglas de filtro y supresión de resultados
+ Trabajos de detección de datos confidenciales

Si es el administrador de Macie de una organización, también puede agregar etiquetas a las cuentas de los miembros de la organización.

Un recurso puede tener hasta 50 etiquetas. Cada etiqueta consta de una *clave de etiqueta* necesaria y un *valor de etiqueta* opcional. Una *clave de etiqueta* es una etiqueta general que actúa como una categoría para un valor de etiqueta más específico. Un *valor de etiqueta* actúa como descriptor de una clave de etiqueta. Para obtener más información acerca de las opciones y los requisitos de etiquetado, consulte [Conceptos básicos del etiquetado](tags-basics.md).

Puede añadir etiquetas a los recursos de Macie de varias formas. Puede usar Macie directamente. También puedes usar el editor de etiquetas de la Grupos de recursos de AWS consola o las operaciones de etiquetado de la Grupos de recursos de AWS API de etiquetado. Grupos de recursos de AWS es un servicio diseñado para ayudarte a agrupar y gestionar AWS los recursos como una sola unidad, en lugar de hacerlo de forma individual. Si utiliza Macie, puede añadir etiquetas a los recursos al crear el recurso. También puede añadir etiquetas a los recursos individuales existentes. Con Grupos de recursos de AWSél, puedes añadir etiquetas de forma masiva para varios recursos existentes que abarquen varios Servicios de AWS, incluido Macie.

**Aplicación de etiquetas a un recurso de Macie**  
Para añadir etiquetas a un recurso individual de Macie, puede utilizar la consola de Amazon Macie o la API de Amazon Macie. Para añadir etiquetas a varios recursos de Macie al mismo tiempo, utilice la Grupos de recursos de AWS consola o la Grupos de recursos de AWS API de etiquetado. Para obtener más información, consulte la [Guía del usuario para el etiquetado de recursos de AWS](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html).

**importante**  
La adición de etiquetas a un recurso puede afectar al acceso al recurso. Antes de añadir una etiqueta a un recurso, revise las políticas AWS Identity and Access Management (de IAM) que puedan utilizar etiquetas para controlar el acceso a los recursos. Para obtener más información, consulte [Control del acceso a los recursos de AWS mediante etiquetas](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) en la *Guía del usuario de IAM*.

------
#### [ Console ]

Al crear una lista de permitidos, un identificador de datos personalizado o un trabajo de detección de datos confidenciales, la consola de Amazon Macie ofrece opciones para añadir etiquetas al recurso. Siga las instrucciones de la consola para añadir etiquetas a estos tipos de recursos cuando los cree. Para añadir etiquetas a una regla de filtro, de supresión o a la cuenta de un miembro, debe crear el recurso antes de poder añadirle etiquetas.

Para agregar una o más etiquetas a un recurso existente mediante la consola de Amazon Macie, siga estos pasos.

**Para añadir una etiqueta a un recurso**

1. Abra la consola Amazon Macie en. [https://console.aws.amazon.com/macie/](https://console.aws.amazon.com/macie/)

1. En función del tipo de recurso al que desea añadir una etiqueta, seleccione una de las siguientes opciones:
   + Para ver una lista de permitidos, seleccione **Listas de permitidos** en el panel de navegación. En la tabla, seleccione la casilla de verificación de la lista. A continuación, seleccione **Administrar etiquetas** en el menú **Acciones**.
   + Para un identificador de datos personalizado, seleccione **Identificadores de datos personalizados** en el panel de navegación. En la tabla, seleccione la casilla de verificación del identificador de datos personalizado. A continuación, seleccione **Administrar etiquetas** en el menú **Acciones**.
   + Para una regla de filtro o supresión, seleccione **Resultados** en el panel de navegación. En la lista **Reglas guardadas**, seleccione el icono de edición (![\[The edit icon, which is a blue pencil.\]](http://docs.aws.amazon.com/es_es/macie/latest/user/images/icon-edit-resource-blue.png)) situado junto a la regla. A continuación, seleccione **Administrar etiquetas**.
   + Para una cuenta de miembro de su organización, seleccione **Cuentas** en el panel de navegación. En la tabla, selecciona la casilla de verificación de la cuenta. A continuación, seleccione **Administrar etiquetas** en el menú **Acciones**.
   + Para un trabajo de detección de datos confidenciales, seleccione **Trabajos** en el panel de navegación. En la tabla, seleccione la casilla de verificación del trabajo. A continuación, seleccione **Administrar etiquetas** en el menú **Acciones**.

   La ventana **Administrar etiquetas** muestra todas las etiquetas que están actualmente asignadas al recurso.

1. En la ventana **Administrar etiquetas**, seleccione **Editar etiquetas**.

1. Elija **Añadir etiqueta**.

1. En el cuadro **Clave**, introduzca la clave de etiqueta de la etiqueta que desee añadir al recurso. A continuación, en el cuadro **Valor**, si lo desea, escriba el valor de la clave.

   Una clave de etiqueta puede incluir hasta 128 caracteres. Un valor de etiqueta puede incluir hasta 256 caracteres. Los caracteres pueden ser letras, números, espacios o los siguientes símbolos: \$1 . : / = \$1 - @

1. Para agregar otra etiqueta al recurso, elija **Agregar etiqueta** y, a continuación, repita el paso anterior. Puede asignar hasta 50 etiquetas a un recurso.

1. Cuando haya terminado de agregar etiquetas, elija **Guardar**.

------
#### [ API ]

Para crear un recurso y añadirle una o más etiquetas mediante programación, utilice la operación `Create` adecuada para el tipo de recurso que desee crear:
+ **Lista de permisos**: utilice la [CreateAllowList](https://docs.aws.amazon.com/macie/latest/APIReference/allow-lists.html)operación. O, si utiliza AWS Command Line Interface (AWS CLI), ejecute el comando [create-allow-list](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-allow-list.html).
+ **Identificador de datos personalizado**: utilice la [CreateCustomDataIdentifier](https://docs.aws.amazon.com/macie/latest/APIReference/custom-data-identifiers.html)operación. O bien, si está utilizando el AWS CLI, ejecute el [create-custom-data-identifier](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-custom-data-identifier.html)comando.
+ **Regla de filtrado o supresión**: utilice la [CreateFindingsFilter](https://docs.aws.amazon.com/macie/latest/APIReference/findingsfilters.html)operación. O, si utiliza la interfaz AWS CLI, ejecute el comando [create-findings-filter](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-findings-filter.html).
+ **Cuenta de miembro**: utilice la [CreateMember](https://docs.aws.amazon.com/macie/latest/APIReference/members.html)operación. O bien, si está utilizando el AWS CLI, ejecute el comando [create-member](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-member.html).
+ **Trabajo de descubrimiento de datos confidenciales**: utilice la [CreateClassificationJob](https://docs.aws.amazon.com/macie/latest/APIReference/jobs.html)operación. O bien, si está utilizando el AWS CLI, ejecute el [create-classification-job](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-classification-job.html)comando.

En la solicitud, utilice el parámetro `tags` para especificar la clave de etiqueta (`key`) y el valor de etiqueta opcional (`value`) de cada etiqueta que desee añadir al recurso. El `tags` parámetro especifica un string-to-string mapa de claves de etiquetas y sus valores de etiqueta asociados.

Para añadir una o más etiquetas a un recurso existente, utilice la [TagResource](https://docs.aws.amazon.com/macie/latest/APIReference/tags-resourcearn.html)operación de la API de Amazon Macie o, si la utiliza AWS CLI, ejecute el comando [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/macie2/tag-resource.html). En su solicitud, especifique el nombre de recurso de Amazon (ARN) del recurso al que desea añadir una etiqueta. Utilice el parámetro `tags` para especificar la clave de etiqueta (`key`) y el valor de etiqueta opcional (`value`) de cada etiqueta que desee añadir al recurso. Como ocurre con `Create` las operaciones y los comandos, el `tags` parámetro especifica un string-to-string mapa de claves de etiquetas y sus valores de etiqueta asociados.

Por ejemplo, el siguiente AWS CLI comando agrega una clave de `Stack` etiqueta con un valor de `Production` etiqueta al trabajo especificado. Este ejemplo está formateado para Microsoft Windows y utiliza el carácter de continuación de línea de intercalación (^) para mejorar la legibilidad.

```
C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"Production\"}
```

Donde:
+ `resource-arn` especifica el ARN del trabajo al que se va a añadir una etiqueta.
+ `Stack` es la clave de etiqueta de la etiqueta que se va a añadir al trabajo.
+ `Production` El valor de la clave de etiqueta especificada (`Stack`).

En el siguiente ejemplo, el comando añade varias etiquetas al trabajo:

```
C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"Production\",\"CostCenter\":\"12345\",\"Owner\":\"jane-doe\"}
```

Para cada etiqueta de un mapa `tags`, se requieren los argumentos `key` y `value`. Sin embargo, el valor del argumento `value` puede ser una cadena vacía. Si no desea asociar un valor de etiqueta a una clave de etiqueta, no especifique un valor para el argumento `value`. Por ejemplo, el siguiente AWS CLI comando agrega una clave de `Owner` etiqueta sin ningún valor de etiqueta asociado:

```
C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Owner\":\"\"}
```

Si la operación de etiquetado se realiza correctamente, Macie devuelve una respuesta HTTP 204 vacía. De lo contrario, Macie devuelve una respuesta HTTP 4*xx* o 500 que indica el motivo del error de la operación.

------