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.
# Etiquetado de reglas de muestreo y grupos de X-Ray
Las etiquetas son palabras o frases que puedes usar para identificar y organizar tus AWS recursos. Puede añadir varias etiquetas a cada recurso. Cada etiqueta incluye una clave y un valor opcional que define el usuario. Por ejemplo, la clave de etiqueta podría ser **domain** y el valor de etiqueta podría ser **example.com**. Puede buscar y filtrar sus recursos en función de las etiquetas que añada. Para más información sobre el uso de etiquetas, consulte [Etiquetado de recursos de AWS](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) en la *Guía de referencia general de AWS *.
Puede usar etiquetas para aplicar permisos basados en etiquetas en las CloudFront distribuciones. Para obtener más información, consulte [Control de acceso a los recursos de AWS mediante etiquetas](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).
**nota**
Actualmente, ni [Tag Editor](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) ni [AWS Resource Groups](https://docs.aws.amazon.com/ARG/latest/userguide/welcome.html) admiten recursos de X-Ray. Las etiquetas se agregan y administran mediante la AWS X-Ray consola o la API.
Puede aplicar etiquetas a los recursos mediante la consola X-Ray AWS CLI SDKs, la API y AWS Tools for Windows PowerShell. Para obtener más información, consulte la siguiente documentación sobre :
+ API de X-Ray: consulte las siguientes operaciones en la *referencia de la API de AWS X-Ray *:
+ [ListTagsForResource](https://docs.aws.amazon.com/xray/latest/api/API_ListTagsForResource.html)
+ [CreateSamplingRule](https://docs.aws.amazon.com/xray/latest/api/API_CreateSamplingRule.html)
+ [CreateGroup](https://docs.aws.amazon.com/xray/latest/api/API_CreateGroup.html)
+ [TagResource](https://docs.aws.amazon.com/xray/latest/api/API_TagResource.html)
+ [UntagResource](https://docs.aws.amazon.com/xray/latest/api/API_UntagResource.html)
+ AWS CLI — Consulte la [radiografía](https://docs.aws.amazon.com/cli/latest/reference/xray/index.html) en la Referencia de *AWS CLI comandos*
+ SDKs — Consulte la documentación del SDK correspondiente en la página de [AWS documentación](https://docs.aws.amazon.com/)
**nota**
Si no puede agregar o cambiar etiquetas en un recurso de X-Ray, o no puede agregar un recurso que tenga etiquetas específicas, es posible que no tenga permisos para realizar esta operación. Para solicitar acceso, póngase en contacto con un AWS usuario de su empresa que tenga permisos de **administrador** en X-Ray.
**Topics**
+ [Restricciones de las etiquetas](#xray-tagging-restrictions)
+ [Administración de etiquetas en la consola](#xray-tagging-manage)
+ [Administrar las etiquetas en la AWS CLI](#xray-tagging-manage-cli)
+ [Controlar el acceso a los recursos de X-Ray en función de etiquetas](#xray-tagging-policy)
## Restricciones de las etiquetas
Se aplican las siguientes restricciones a las etiquetas.
+ Número máximo de etiquetas por recurso: 50
+ Longitud máxima de la clave: 128 caracteres Unicode.
+ Longitud máxima del valor: 256 caracteres Unicode.
+ Valores válidos para claves y valores: a-z, A-Z, 0-9, espacio y los siguientes caracteres: \$1 . : / = \$1 - y @
+ Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.
+ No utilice `aws:` como prefijo para claves, ya que está reservado para AWS .
**nota**
No puede editar ni eliminar las etiquetas del sistema.
## Administración de etiquetas en la consola
Puede añadir etiquetas opcionales al crear un grupo de X-Ray o una regla de muestreo. Las etiquetas también se pueden cambiar o eliminar en la consola más adelante.
En los siguientes procedimientos se explica cómo agregar, editar y eliminar etiquetas para sus grupos y reglas de muestreo en la consola X-Ray.
**Topics**
+ [Agregar etiquetas a un nuevo grupo (consola)](#xray-tagging-add-group-console)
+ [Agregar etiquetas a una nueva regla de muestreo (consola)](#xray-tagging-add-rule-console)
+ [Edición o eliminación de etiquetas de un grupo (consola)](#xray-tagging-change-group-console)
+ [Edición o eliminación de etiquetas de una regla de muestreo (consola)](#xray-tagging-change-rule-console)
### Agregar etiquetas a un nuevo grupo (consola)
Al crear un nuevo grupo de X-Ray, puede añadir etiquetas opcionales en la página **Crear grupo**.
1. Inicie sesión en la consola de X-Ray Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/xray/casa](https://console.aws.amazon.com/xray/home).
1. En el panel de navegación, expanda **Configuración** y elija **Grupos**.
1. Elija **Crear grupo**.
1. En la página **Crear grupo**, especifique un nombre y una expresión de filtro para el grupo. Para obtener más información sobre estas propiedades, consulte [Configuración de grupos](xray-console-groups.md).
1. En **Etiquetas**, introduzca una clave de etiqueta y, si lo desea, un valor de etiqueta. Por ejemplo, puede introducir una clave de etiqueta de **Stage** y un valor de etiqueta de **Production** para indicar que este grupo es para uso en producción. Al añadir una etiqueta, aparece una nueva línea para que añada otra etiqueta, si es necesario. Consulte [Restricciones de las etiquetas](#xray-tagging-restrictions) en este tema para conocer las limitaciones de las etiquetas.
1. Cuando termine de agregar etiquetas, elija **Crear grupo**.
### Agregar etiquetas a una nueva regla de muestreo (consola)
Al crear una nueva regla de muestreo de X-Ray, puede añadir etiquetas en la página **Crear regla de muestreo**.
1. Inicie sesión en la consola de X-Ray Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/xray/casa](https://console.aws.amazon.com/xray/home).
1. En el panel de navegación, expanda **Configuración** y elija **Muestreo**.
1. Seleccione **Crear regla de muestreo**.
1. En la página **Crear regla de muestreo**, especifique el nombre, la prioridad, los límites, los criterios coincidentes y los atributos coincidentes. Para obtener más información sobre estas propiedades, consulte [Configuración de reglas de muestreo de](xray-console-sampling.md).
1. En **Etiquetas**, introduzca una clave de etiqueta y, si lo desea, un valor de etiqueta. Por ejemplo, puede introducir una clave de etiqueta de **Stage** y un valor de etiqueta de **Production** para indicar que esta regla de muestreo es para uso en producción. Al añadir una etiqueta, aparece una nueva línea para que añada otra etiqueta, si es necesario. Consulte [Restricciones de las etiquetas](#xray-tagging-restrictions) en este tema para conocer las limitaciones de las etiquetas.
1. Cuando termine de agregar etiquetas, elija **Crear regla de muestreo**.
### Edición o eliminación de etiquetas de un grupo (consola)
Puede cambiar o eliminar etiquetas de un grupo de X-Ray en la página **Editar grupo**.
1. Inicie sesión en la consola de X-Ray Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/xray/casa](https://console.aws.amazon.com/xray/home).
1. En el panel de navegación, expanda **Configuración** y elija **Grupos**.
1. En la tabla **Grupos**, elija el nombre del un grupo.
1. En la página **Editar grupo**, en **Etiquetas**, edite las claves y los valores de las etiquetas. No puede tener claves de etiquetas duplicadas. Los valores de las etiquetas son opcionales; puede eliminarlos si lo desea. Para obtener más información sobre otras propiedades de la página **Editar grupo**, consulte [Configuración de grupos](xray-console-groups.md). Consulte [Restricciones de las etiquetas](#xray-tagging-restrictions) en este tema para conocer las limitaciones de las etiquetas.
1. Para eliminar una etiqueta, elija **X** a la derecha de la etiqueta.
1. Cuando haya terminado de editar o eliminar etiquetas, elija **Actualizar grupo**.
### Edición o eliminación de etiquetas de una regla de muestreo (consola)
Puede cambiar o eliminar las etiquetas de una regla de muestreo de X-Ray en la página **Editar regla de muestreo**.
1. Inicie sesión en la consola de X-Ray Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/xray/casa](https://console.aws.amazon.com/xray/home).
1. En el panel de navegación, expanda **Configuración** y elija **Muestreo**.
1. En la tabla **Reglas de muestreo**, elija el nombre de una regla de muestreo.
1. En **Etiquetas**, edite las claves y los valores de las etiquetas. No puede tener claves de etiquetas duplicadas. Los valores de las etiquetas son opcionales; puede eliminarlos si lo desea. Para obtener más información sobre otras propiedades de la página **Editar regla de muestreo**, consulte [Configuración de reglas de muestreo de](xray-console-sampling.md). Consulte [Restricciones de las etiquetas](#xray-tagging-restrictions) en este tema para conocer las limitaciones de las etiquetas.
1. Para eliminar una etiqueta, elija **X** a la derecha de la etiqueta.
1. Cuando haya terminado de editar o eliminar etiquetas, elija **Actualizar regla de muestreo**.
## Administrar las etiquetas en la AWS CLI
Puede añadir etiquetas al crear un grupo o una regla de muestreo de X-Ray. También puede utilizar el AWS CLI para crear y administrar etiquetas. Para actualizar las etiquetas de un grupo o regla de muestreo existente, utilice la AWS X-Ray consola o la tecla [TagResource](https://docs.aws.amazon.com/xray/latest/api/API_TagResource.html)o [UntagResource](https://docs.aws.amazon.com/xray/latest/api/API_UntagResource.html) APIs.
**Topics**
+ [Agregar etiquetas a un nuevo grupo de o regla de muestreo de X-Ray (CLI)](#xray-tagging-cli-create)
+ [Añadir etiquetas a un recurso existente (CLI)](#xray-tagging-cli-add)
+ [Visualizar las etiquetas de un recurso (CLI)](#xray-tagging-cli-list)
+ [Eliminar etiquetas de un recurso (CLI)](#xray-tagging-cli-delete)
### Agregar etiquetas a un nuevo grupo de o regla de muestreo de X-Ray (CLI)
Para añadir etiquetas opcionales al crear un nuevo grupo o una nueva regla de muestreo de X-Ray, utilice uno de los siguientes comandos.
+ Para añadir etiquetas a un grupo nuevo, ejecute el siguiente comando y *group\$1name* sustitúyalo por el nombre del grupo, *mydomain.com* por el punto final del servicio, *key\$1name* por una clave de etiqueta y, si lo desea, *value* por un valor de etiqueta. Para obtener más información sobre cómo crear un grupo, consulte [Groups](xray-api-configuration.md#xray-api-configuration-groups).
```
aws xray create-group \
--group-name "group_name" \
--filter-expression "service(\"mydomain.com\") {fault OR error}" \
--tags [{"Key": "key_name","Value": "value"},{"Key": "key_name","Value": "value"}]
```
A continuación se muestra un ejemplo.
```
aws xray create-group \
--group-name "AdminGroup" \
--filter-expression "service(\"mydomain.com\") {fault OR error}" \
--tags [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]
```
+ Para añadir etiquetas a una nueva regla de muestreo, ejecute el siguiente comando y *key\$1name* sustitúyalo por una clave de etiqueta y, si lo desea, *value* por un valor de etiqueta. Este comando especifica los valores del parámetro `--sampling-rule` como archivo JSON. Para obtener más información sobre cómo crear una regla de muestreo, consulte [Reglas de muestreo](xray-api-configuration.md#xray-api-configuration-sampling).
```
aws xray create-sampling-rule \
--cli-input-json file://file_name.json
```
El siguiente es el contenido del archivo *file\$1name.json* JSON especificado por el `--cli-input-json` parámetro.
```
{
"SamplingRule": {
"RuleName": "rule_name",
"RuleARN": "string",
"ResourceARN": "string",
"Priority": integer,
"FixedRate": double,
"ReservoirSize": integer,
"ServiceName": "string",
"ServiceType": "string",
"Host": "string",
"HTTPMethod": "string",
"URLPath": "string",
"Version": integer,
"Attributes": {"attribute_name": "value","attribute_name": "value"...}
}
"Tags": [
{
"Key":"key_name",
"Value":"value"
},
{
"Key":"key_name",
"Value":"value"
}
]
}
```
El siguiente comando es un ejemplo.
```
aws xray create-sampling-rule \
--cli-input-json file://9000-base-scorekeep.json
```
A continuación puede ver el contenido del archivo de ejemplo `9000-base-scorekeep.json` especificado por el parámetro `--cli-input-json`.
```
{
"SamplingRule": {
"RuleName": "base-scorekeep",
"ResourceARN": "*",
"Priority": 9000,
"FixedRate": 0.1,
"ReservoirSize": 5,
"ServiceName": "Scorekeep",
"ServiceType": "*",
"Host": "*",
"HTTPMethod": "*",
"URLPath": "*",
"Version": 1
}
"Tags": [
{
"Key":"Stage",
"Value":"Prod"
},
{
"Key":"Department",
"Value":"QA"
}
]
}
```
### Añadir etiquetas a un recurso existente (CLI)
Puede ejecutar el comando `tag-resource` para añadir etiquetas a un grupo o una regla de muestreo de X-Ray existente. Este método puede resultar más sencillo que añadir etiquetas ejecutando `update-group` o `update-sampling-rule`.
Para agregar etiquetas a un grupo o a una regla de muestreo, ejecute el siguiente comando, sustituyendo el ARN por el ARN del recurso y especificando las claves y los valores opcionales de las etiquetas que desee agregar.
```
aws xray tag-resource \
--resource-arn "ARN" \
--tag-keys [{"Key":"key_name","Value":"value"}, {"Key":"key_name","Value":"value"}]
```
A continuación se muestra un ejemplo.
```
aws xray tag-resource \
--resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup" \
--tag-keys [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]
```
### Visualizar las etiquetas de un recurso (CLI)
Puede ejecutar el comando `list-tags-for-resource` para ver una lista de las etiquetas de un grupo o una regla de muestreo de X-Ray.
Para ver una lista de las etiquetas asociadas a un grupo o una regla de muestreo, ejecute el siguiente comando sustituyendo el ARN por el ARN del recurso.
```
aws xray list-tags-for-resource \
--resource-arn "ARN"
```
A continuación se muestra un ejemplo.
```
aws xray list-tags-for-resource \
--resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup"
```
### Eliminar etiquetas de un recurso (CLI)
Puede ejecutar el comando `untag-resource` para eliminar las etiquetas de un grupo o una regla de muestreo de X-Ray.
Para agregar etiquetas de un grupo o de una regla de muestreo, ejecute el siguiente comando, sustituyendo el ARN por el ARN del recurso y especificando las claves de las etiquetas que desee eliminar.
Con el comando `untag-resource` solo puede eliminar etiquetas enteras. Para eliminar los valores de las etiquetas, utilice la consola de X-Ray o elimine las etiquetas y añada otras nuevas con las mismas claves pero con valores diferentes o vacíos.
```
aws xray untag-resource \
--resource-arn "ARN" \
--tag-keys ["key_name","key_name"]
```
A continuación se muestra un ejemplo.
```
aws xray untag-resource \
--resource-arn "arn:aws:xray:us-east-2:01234567890:group/group_name" \
--tag-keys ["Stage","Department"]
```
## Controlar el acceso a los recursos de X-Ray en función de etiquetas
Puede adjuntar etiquetas a los grupos o las reglas de muestreo de X-Ray, o pasar las etiquetas en una solicitud a X-Ray. Para controlar el acceso en función de etiquetas, debe proporcionar información de las etiquetas en el [elemento de condición](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) de una política utilizando las claves de condición `xray:ResourceTag/key-name`, `aws:RequestTag/key-name` o `aws:TagKeys`. Para obtener más información sobre estas claves de condición, consulte [Controlar el acceso a AWS los recursos mediante etiquetas de recursos](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).
Para consultar un ejemplo de política basada en la identidad para limitar el acceso a un recurso en función de las etiquetas de ese recurso, consulte [Gestión del acceso a los grupos de rayos X y a las reglas de muestreo en función de las etiquetas](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-manage-sampling-tags).