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.
# Revisión y edición de etiquetas para recursos de Macie
A medida que su entorno o sus requisitos cambien con el tiempo, puede evaluar las etiquetas existentes para los recursos de Amazon Macie y cambiarlas según sea necesario. Una *etiqueta* es un identificador que se define y se asigna a recursos de AWS , incluidos determinados tipos de recursos de Macie. 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.
Las etiquetas pueden ayudarle a 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 asignar 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 asignar etiquetas a las cuentas de los miembros de su organización. Un recurso puede tener hasta 50 etiquetas.
**Topics**
+ [Revisión de etiquetas para recursos](#tags-retrieve)
+ [Edición de etiquetas para recursos](#tags-update)
## Revisión de etiquetas para recursos de Macie
Puede revisar las etiquetas de un recurso de Amazon Macie utilizando Macie o. Grupos de recursos de AWS Grupos de recursos de AWS es un servicio diseñado para ayudarlo a agrupar y administrar AWS los recursos como una sola unidad en lugar de hacerlo individualmente. Si utiliza Macie, puede revisar las etiquetas de un recurso cada vez. Con Grupos de recursos de AWSél, puedes revisar las etiquetas de forma masiva de varios recursos existentes que abarcan varios Servicios de AWS, incluido Macie.
**Revisión de las etiquetas de un recurso de Macie**
Para revisar las etiquetas de un recurso individual de Macie, puede utilizar la consola de Amazon Macie o la API de Amazon Macie. Para revisar las etiquetas de varios recursos de Macie al mismo tiempo, utilice el editor de etiquetas de la Grupos de recursos de AWS consola o las operaciones de etiquetado de la API de etiquetado. Grupos de recursos de AWS 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).
------
#### [ Console ]
Siga estos pasos para revisar las etiquetas de un recurso mediante la consola de Amazon Macie.
**Revisar las etiquetas de un recurso**
1. Abra la consola Amazon Macie en. [https://console.aws.amazon.com/macie/](https://console.aws.amazon.com/macie/)
1. Dependiendo del tipo de recurso cuyas etiquetas desea revisar, realice una de las siguientes acciones:
+ Para ver una lista de permitidos, seleccione **Permitir listas** 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. Por ejemplo, la siguiente imagen muestra las etiquetas asignadas a un identificador de datos personalizado.
![\[La ventana Administrar etiquetas. Contiene una tabla en la que se muestran la clave y el valor de la etiqueta para cada una de las tres etiquetas.\]](http://docs.aws.amazon.com/es_es/macie/latest/user/images/scrn-tags-manage-review.png)
En este ejemplo, se asignan tres etiquetas al identificador de datos personalizado: la clave de **CostCenter**etiqueta con **12345** como valor de etiqueta asociado; la clave de etiqueta **Owner** sin ningún valor de etiqueta asociado (—); y la clave de etiqueta **Stack** con **Production** como valor de etiqueta asociado.
1. Cuando termine de revisar las etiquetas, pulse **Cancelar** para cerrar la ventana.
------
#### [ API ]
Para recuperar y revisar las etiquetas de un recurso existente mediante programación, puede utilizar la operación `Get` o `Describe` adecuada para el tipo de recurso cuyas etiquetas desee revisar. Por ejemplo, si utiliza la [GetCustomDataIdentifier](https://docs.aws.amazon.com/macie/latest/APIReference/custom-data-identifiers-id.html)operación o ejecuta el [get-custom-data-identifier](https://docs.aws.amazon.com/cli/latest/reference/macie2/get-custom-data-identifier.html)comando desde AWS Command Line Interface (AWS CLI), la respuesta incluye un `tags` objeto. El objeto muestra todas las etiquetas (tanto las claves como los valores de las etiquetas) que están asignadas actualmente al recurso.
También puede utilizar el [ListTagsForResource](https://docs.aws.amazon.com/macie/latest/APIReference/tags-resourcearn.html)funcionamiento de la API de Amazon Macie. En su solicitud, utilice el parámetro `resourceArn` para especificar el nombre de recurso de Amazon (ARN) del recurso. Si utiliza el AWS CLI, ejecute el [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/macie2/list-tags-for-resource.html)comando y utilice el `resource-arn` parámetro para especificar el ARN del recurso. Por ejemplo:
```
C:\> aws macie2 list-tags-for-resource --resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample
```
En el ejemplo anterior, *arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample* es el ARN de un trabajo de descubrimiento de datos confidenciales existente.
Si la operación se realiza correctamente, Macie devuelve un objeto `tags` que muestra todas las etiquetas (tanto las claves como los valores de las etiquetas) que están asignadas actualmente al recurso. Por ejemplo:
```
{
"tags": {
"Stack": "Production",
"CostCenter": "12345",
"Owner": ""
}
}
```
Donde `Stack`, `CostCenter` y `Owner` son las claves de etiqueta que se asignan al recurso. `Production` es el valor de etiqueta asociado a la clave de etiqueta `Stack`. `12345` es el valor de etiqueta asociado a la clave de etiqueta `CostCenter`. La clave de etiqueta `Owner` no tiene un valor de etiqueta asociado.
Para recuperar una lista de todos los recursos de Macie que tienen etiquetas y todas las etiquetas asignadas a cada uno de esos recursos, utilice la [GetResources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html)operación de la API de Grupos de recursos de AWS etiquetado. En su solicitud, defina el valor del parámetro `ResourceTypeFilters` como `macie2`. Para ello AWS CLI, ejecute el comando [get-resources](https://docs.aws.amazon.com/cli/latest/reference/resourcegroupstaggingapi/get-resources.html) y defina el valor del parámetro en. `resource-type-filters` `macie2` Por ejemplo:
```
C:\> aws resourcegroupstaggingapi get-resources --resource-type-filters "macie2"
```
Si la operación se realiza correctamente, Resource Groups devuelve una `ResourceTagMappingList` matriz que contiene todos los recursos ARNs de Macie que tienen etiquetas y las claves y valores de las etiquetas que están asignados a cada uno de esos recursos.
------
## Edición de etiquetas para recursos de Macie
Para editar las etiquetas (claves o valores de etiquetas) de un recurso de Amazon Macie, puede utilizar Macie o Grupos de recursos de AWS. Si utiliza Macie, puede editar las etiquetas de un recurso cada vez. Si lo usa Grupos de recursos de AWS, puede editar las etiquetas de forma masiva para varios recursos existentes que abarquen varios Servicios de AWS, incluido Macie.
**Edición de las etiquetas de un recurso de Macie**
Para editar las etiquetas de un recurso individual de Macie, puede utilizar la consola de Amazon Macie o la API de Amazon Macie. Para editar etiquetas para varios recursos de Macie al mismo tiempo, utilice el [Editor de etiquetas](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html) de la consola de Grupos de recursos de AWS o las operaciones de etiquetado de la [API de etiquetado de Grupos de recursos de AWS](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html).
**importante**
La edición de etiquetas de un recurso puede afectar al acceso al recurso. Antes de editar la clave o el valor de una etiqueta para un recurso, revisa cualquier política AWS Identity and Access Management (de IAM) que pueda usar la etiqueta para controlar el acceso a los recursos. Para obtener más información, consulte [Controlar el acceso a AWS los recursos mediante etiquetas](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) en la Guía del *usuario de IAM*.
------
#### [ Console ]
Siga estos pasos para editar las etiquetas de un recurso mediante la consola de Amazon Macie.
**Editar las etiquetas de un recurso**
1. Abra la consola Amazon Macie en. [https://console.aws.amazon.com/macie/](https://console.aws.amazon.com/macie/)
1. Dependiendo del tipo de recurso cuyas etiquetas desea editar, realice una de las siguientes acciones:
+ Para ver una lista de permitidos, seleccione **Permitir listas** 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. Realice uno de los siguientes procedimientos:
+ Para añadir un valor de etiqueta a una clave de etiqueta, introduzca el valor en el cuadro **Valor** situado junto a la clave de etiqueta.
+ Para cambiar una clave de etiqueta existente, seleccione **Eliminar** junto a la etiqueta. A continuación, seleccione **Añadir etiqueta**. En el cuadro **Clave** que aparece, introduzca la nueva clave de etiqueta. Opcionalmente, puede introducir un valor de etiqueta asociado en el cuadro **Valor**.
+ Para cambiar el valor de una etiqueta existente, seleccione **X** en el cuadro **Valor** que contiene el valor. A continuación, escriba el nuevo valor de la etiqueta en el cuadro **Valor**.
+ Para eliminar el valor de una etiqueta existente, seleccione **X** en el cuadro **Valor** que contiene el valor.
+ Para eliminar una etiqueta existente (tanto la clave como el valor de la etiqueta), haga clic en **Eliminar** junto a la etiqueta.
Un recurso puede tener hasta 50 etiquetas. 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. Cuando termine de editar las etiquetas, elija **Guardar**.
------
#### [ API ]
Al editar una etiqueta de un recurso mediante programación, sobrescribe la etiqueta existente con valores nuevos. Por lo tanto, la mejor forma de editar una etiqueta depende de si desea editar una clave de etiqueta, un valor de etiqueta o ambos. Para editar una clave de etiqueta, [elimine la etiqueta actual](tags-remove.md) y [añada una nueva](tags-add.md).
Para editar o eliminar únicamente el valor de etiqueta asociado a una clave de etiqueta, sobrescriba el valor existente mediante la [TagResource](https://docs.aws.amazon.com/macie/latest/APIReference/tags-resourcearn.html)operación de la API Amazon Macie. Si usa AWS Command Line Interface (AWS CLI), puede hacerlo ejecutando 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 cuyo valor de etiqueta quiera editar o eliminar.
Para editar el valor de etiqueta de una clave de etiqueta, utilice el parámetro `tags` para especificar la clave de etiqueta cuyo valor de etiqueta desee cambiar y especifique el nuevo valor de etiqueta de la clave. Por ejemplo, el siguiente comando cambia el valor de etiqueta de `Production` a `Staging` para la clave de etiqueta `Stack` asociada al trabajo de detección de datos confidenciales 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\":\"Staging\"}
```
Donde:
+ `resource-arn` especifica el ARN del trabajo.
+ `Stack` es la clave de etiqueta asociada al valor de etiqueta que desea cambiar.
+ `Staging` es el nuevo valor de etiqueta que se utilizará para la clave de etiqueta especificada (`Stack`).
Para eliminar un valor de etiqueta de una clave de etiqueta, no especifique un valor para el argumento `value` en el parámetro `tags`. Por ejemplo:
```
C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"\"}
```
Si la operación 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.
------