As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Marcar grupos e regras de amostragem do X-Ray
As tags são palavras ou frases que você pode usar para identificar e organizar seus AWS recursos. Você pode adicionar várias tags a cada recurso. Cada tag inclui uma chave e um valor opcional que você define. Por exemplo, uma chave de tag pode ser **domain** e o valor da tag pode ser **example.com**. Você pode pesquisar e filtrar seus recursos de acordo com as tags adicionadas. Para obter mais informações sobre como usar tags, consulte [Marcar recursos da AWS](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) no *Guia de referência geral da AWS *.
Você pode usar tags para impor permissões baseadas em tags nas distribuições. CloudFront Para obter mais informações, consulte [Controlar o acesso a recursos da AWS usando tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).
**nota**
No momento, o [Editor de tags](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) e o [AWS Resource Groups](https://docs.aws.amazon.com/ARG/latest/userguide/welcome.html) não são compatíveis com recursos do X-Ray. Você adiciona e gerencia tags usando o AWS X-Ray console ou a API.
Você pode aplicar tags aos recursos usando o console X-Ray, a API AWS CLI SDKs,, AWS Tools for Windows PowerShell e. Para saber mais, consulte a documentação a seguir:
+ API do X-Ray: veja as seguintes operações na *Referência de API do 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 — Veja [xray](https://docs.aws.amazon.com/cli/latest/reference/xray/index.html) na Referência de *AWS CLI Comandos*
+ SDKs — Consulte a documentação do SDK aplicável na página de [AWS documentação](https://docs.aws.amazon.com/)
**nota**
Se você não conseguir adicionar ou alterar tags em um recurso do X-Ray, ou não conseguir adicionar um recurso que tenha tags específicas, é provável que você não tenha permissões para realizar essa operação. Para solicitar acesso, entre em contato com um AWS usuário em sua empresa que tenha permissões de **administrador** no X-Ray.
**Topics**
+ [Restrições de tags](#xray-tagging-restrictions)
+ [Gerenciar tags no console](#xray-tagging-manage)
+ [Gerenciando tags no AWS CLI](#xray-tagging-manage-cli)
+ [Controlar o acesso a recursos do X-Ray com base em tags](#xray-tagging-policy)
## Restrições de tags
As restrições a seguir se aplicam a tags.
+ Número máximo de tags por recurso:- 50
+ Comprimento máximo da chave: 128 caracteres Unicode
+ Comprimento máximo do valor: 256 caracteres Unicode
+ Valores válidos de chave e valor: a-z, A-Z, 0-9, espaço e os seguintes caracteres: \$1 . : / = \$1: e @
+ As chaves e valores das tags diferenciam maiúsculas de minúsculas.
+ Não use `aws:` como um prefixo para chaves, pois ele é reservado para uso da AWS .
**nota**
Não é possível editar ou excluir tags do sistema.
## Gerenciar tags no console
Você pode adicionar tags opcionais ao criar uma regra de amostragem ou um grupo do X-Ray. As tags também podem ser alteradas ou excluídas posteriormente no console.
Os procedimentos a seguir explicam como adicionar, editar e excluir tags de grupos e regras de amostragem no console do X-Ray.
**Topics**
+ [Adicionar tags a um novo grupo (console)](#xray-tagging-add-group-console)
+ [Adicionar tags a uma nova regra de amostragem (console)](#xray-tagging-add-rule-console)
+ [Editar ou excluir tags de um grupo (console)](#xray-tagging-change-group-console)
+ [Editar ou excluir tags de uma regra de amostragem (console)](#xray-tagging-change-rule-console)
### Adicionar tags a um novo grupo (console)
Ao criar um grupo do X-Ray, você pode adicionar tags opcionais na página **Criar grupo**.
1. Faça login Console de gerenciamento da AWS e abra o console X-Ray em [https://console.aws.amazon.com/xray/casa](https://console.aws.amazon.com/xray/home).
1. No painel de navegação, expanda **Configuração** e escolha **Grupos**.
1. Escolha **Criar grupo**.
1. Na página **Criar grupo**, especifique um nome e uma expressão de filtro para o grupo. Para obter mais informações sobre essas propriedades, consulte [Configurar grupos](xray-console-groups.md).
1. Em **Tags**, insira uma chave de tag e, opcionalmente, um valor de tag. Por exemplo, você pode inserir uma chave de tag **Stage** e um valor de tag **Production** para indicar que esse grupo é para uso em produção. Ao adicionar uma tag, uma nova linha aparece para você adicionar outra tag, se necessário. Consulte [Restrições de tags](#xray-tagging-restrictions) neste tópico para saber sobre as limitações das tags.
1. Ao terminar de adicionar tags, escolha **Criar grupo**.
### Adicionar tags a uma nova regra de amostragem (console)
Ao criar uma regra de amostragem do X-Ray, você pode adicionar tags na página **Criar regra de amostragem**.
1. Faça login Console de gerenciamento da AWS e abra o console X-Ray em [https://console.aws.amazon.com/xray/casa](https://console.aws.amazon.com/xray/home).
1. No painel de navegação, expanda **Configuração** e escolha **Amostragem**.
1. Escolha **Criar regra de amostragem**.
1. Na página **Criar regra de amostragem**, especifique um nome, prioridade, limites, critérios de correspondência e atributos correspondentes. Para obter mais informações sobre essas propriedades, consulte [Configurar regras de amostragem](xray-console-sampling.md).
1. Em **Tags**, insira uma chave de tag e, opcionalmente, um valor de tag. Por exemplo, você pode inserir uma chave de tag **Stage** e um valor de tag **Production** para indicar que essa regra de amostragem é para uso em produção. Ao adicionar uma tag, uma nova linha aparece para você adicionar outra tag, se necessário. Consulte [Restrições de tags](#xray-tagging-restrictions) neste tópico para saber sobre as limitações das tags.
1. Escolha **Criar regra de amostragem** quando terminar de adicionar as tags.
### Editar ou excluir tags de um grupo (console)
Você pode alterar ou excluir tags em um grupo do X-Ray na página **Editar grupo**.
1. Faça login Console de gerenciamento da AWS e abra o console X-Ray em [https://console.aws.amazon.com/xray/casa](https://console.aws.amazon.com/xray/home).
1. No painel de navegação, expanda **Configuração** e escolha **Grupos**.
1. Na tabela **Grupos**, escolha o nome de um grupo.
1. Na página **Editar grupo**, em **Tags**, edite as chaves e os valores das tags. Não é possível ter chaves de tag duplicadas. Os valores das tags são opcionais; você pode excluir valores se quiser. Para obter mais informações sobre outras propriedades na página **Editar grupo**, consulte [Configurar grupos](xray-console-groups.md). Consulte [Restrições de tags](#xray-tagging-restrictions) neste tópico para saber sobre as limitações das tags.
1. Para excluir uma tag, escolha **X** à direita da tag.
1. Ao terminar de editar ou excluir as tags, escolha **Atualizar grupo**.
### Editar ou excluir tags de uma regra de amostragem (console)
Você pode alterar ou excluir tags em uma regra de amostragem do X-Ray na página **Editar regra de amostragem**.
1. Faça login Console de gerenciamento da AWS e abra o console X-Ray em [https://console.aws.amazon.com/xray/casa](https://console.aws.amazon.com/xray/home).
1. No painel de navegação, expanda **Configuração** e escolha **Amostragem**.
1. Na tabela **Regras de amostragem**, escolha o nome de uma regra de amostragem.
1. Em **Tags**, edite chaves e valores da tag. Não é possível ter chaves de tag duplicadas. Os valores das tags são opcionais; você pode excluir valores se quiser. Para obter mais informações sobre outras propriedades na página **Editar regra de amostragem**, consulte [Configurar regras de amostragem](xray-console-sampling.md). Consulte [Restrições de tags](#xray-tagging-restrictions) neste tópico para saber sobre as limitações das tags.
1. Para excluir uma tag, escolha **X** à direita da tag.
1. Ao terminar de editar ou excluir as tags, escolha **Atualizar regra de amostragem**.
## Gerenciando tags no AWS CLI
Você pode adicionar tags opcionais ao criar uma regra de amostragem ou um grupo do X-Ray. Você também pode usar o AWS CLI para criar e gerenciar tags. Para atualizar as tags em um grupo ou regra de amostragem existente, use o AWS X-Ray console ou o [TagResource](https://docs.aws.amazon.com/xray/latest/api/API_TagResource.html)ou [UntagResource](https://docs.aws.amazon.com/xray/latest/api/API_UntagResource.html) APIs.
**Topics**
+ [Adicione tags a um novo grupo ou regra de amostragem do X-Ray (CLI)](#xray-tagging-cli-create)
+ [Adicionar tags a um recurso existente (CLI)](#xray-tagging-cli-add)
+ [Listar as tags em um recurso (CLI)](#xray-tagging-cli-list)
+ [Excluir tags de um recurso (CLI)](#xray-tagging-cli-delete)
### Adicione tags a um novo grupo ou regra de amostragem do X-Ray (CLI)
Para adicionar tags opcionais ao criar um grupo ou regra de amostragem do X-Ray, use um dos comandos a seguir.
+ Para adicionar tags a um novo grupo, execute o comando a seguir, *group\$1name* substituindo-o pelo nome do seu grupo, *mydomain.com* pelo endpoint do seu serviço, *key\$1name* por uma chave de tag e, opcionalmente, por um valor *value* de tag. Para obter mais informações sobre como criar um grupo, consulte [Groups (Grupos)](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"}]
```
Veja um exemplo do a seguir:
```
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 adicionar tags a uma nova regra de amostragem, execute o comando a seguir, *key\$1name* substituindo por uma chave de tag e, opcionalmente, por um *value* valor de tag. Esse comando especifica os valores no parâmetro `--sampling-rule` como um arquivo JSON. Para obter mais informações sobre como criar uma regra de amostragem, consulte [Regras de amostragem](xray-api-configuration.md#xray-api-configuration-sampling).
```
aws xray create-sampling-rule \
--cli-input-json file://file_name.json
```
Veja a seguir o conteúdo do arquivo *file\$1name.json* JSON especificado pelo `--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"
}
]
}
```
O comando a seguir é um exemplo.
```
aws xray create-sampling-rule \
--cli-input-json file://9000-base-scorekeep.json
```
Veja a seguir o conteúdo do arquivo `9000-base-scorekeep.json` de exemplo especificado pelo 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"
}
]
}
```
### Adicionar tags a um recurso existente (CLI)
Você pode executar o comando `tag-resource` para adicionar tags a um grupo ou regra de amostragem existente do X-Ray. Esse método pode ser mais simples do que adicionar tags executando `update-group` ou `update-sampling-rule`.
Para adicionar tags a um grupo ou a uma regra de amostragem, execute o comando a seguir, substituindo o ARN pelo ARN do recurso e especificando as chaves e os valores opcionais das tags que você deseja adicionar.
```
aws xray tag-resource \
--resource-arn "ARN" \
--tag-keys [{"Key":"key_name","Value":"value"}, {"Key":"key_name","Value":"value"}]
```
Veja um exemplo do a seguir:
```
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"}]
```
### Listar as tags em um recurso (CLI)
Você pode executar o comando `list-tags-for-resource` para listar as tags de um grupo ou regra de amostragem do X-Ray.
Para listar as tags associadas a um grupo ou a uma regra de amostragem, execute o comando a seguir, substituindo o ARN pelo ARN do recurso.
```
aws xray list-tags-for-resource \
--resource-arn "ARN"
```
Veja um exemplo do a seguir:
```
aws xray list-tags-for-resource \
--resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup"
```
### Excluir tags de um recurso (CLI)
Você pode executar o comando `untag-resource` para remover as tags de um grupo ou regra de amostragem do X-Ray.
Para adicionar tags a um grupo ou a uma regra de amostragem, execute o comando a seguir, substituindo o ARN pelo ARN do recurso e especificando as chaves e os valores opcionais das tags que você deseja adicionar.
Você pode remover somente tags inteiras com o comando `untag-resource`. Para remover valores de tag, use o console do X-Ray ou exclua tags e adicione novas tags com as mesmas chaves, mas com valores diferentes ou vazios.
```
aws xray untag-resource \
--resource-arn "ARN" \
--tag-keys ["key_name","key_name"]
```
Veja um exemplo do a seguir:
```
aws xray untag-resource \
--resource-arn "arn:aws:xray:us-east-2:01234567890:group/group_name" \
--tag-keys ["Stage","Department"]
```
## Controlar o acesso a recursos do X-Ray com base em tags
Você pode anexar tags a grupos ou regras de amostragem do X-Ray ou passar tags em uma solicitação para o X-Ray. Para controlar o acesso baseado em tags, forneça informações sobre as tags no [elemento de condição](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) de uma política usando as chaves de condição `xray:ResourceTag/key-name`, `aws:RequestTag/key-name` ou `aws:TagKeys`. Para saber mais sobre essas chaves de condição, consulte [Controle do acesso aos AWS recursos usando tags de recursos](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).
Para visualizar um exemplo de política baseada em identidade para limitar o acesso a um recurso baseado em tags desse recurso, consulte [Gerenciar o acesso a grupos e regras de amostragem do X-Ray com base em tags](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-manage-sampling-tags).