Restrições de tags Gerenciar tags no console Gerenciar tags na AWS CLI Controlar o acesso a recursos do X-Ray com base em tags

Marcar grupos e regras de amostragem do X-Ray

Tags são palavras ou frases que podem ser usadas para identificar e organizar seus recursos da AWS. 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 no Guia de referência geral da AWS.

É possível usar tags para aplicar permissões baseadas em tags em distribuições do CloudFront. Para obter mais informações, consulte Controlar o acesso a recursos da AWS usando tags.

nota

No momento, o Editor de tags e o AWS Resource Groups não são compatíveis com recursos do X-Ray. Você adiciona e gerencia tags usando a API ou o console do AWS X-Ray.

Você pode aplicar tags a recursos usando o console do X-Ray, a API, a AWS CLI, SDKs e o AWS Tools for Windows PowerShell. Para obter mais informações, consulte a seguinte documentação do :

API do X-Ray: veja as seguintes operações na Referência de API do AWS X-Ray:
AWS CLI: consulte xray na Referência de comandos da AWS CLI.
SDKs: consulte a documentação do SDK aplicável na página Documentação da AWS

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 usuário da AWS em sua empresa que tenha permissões de administrador no X-Ray.

Tópicos

Restrições de tags
Gerenciar tags no console
Gerenciar tags na AWS CLI
Controlar o acesso a recursos do X-Ray com base em tags

Restrições de tags

As restrições a seguir se aplicam a marcas.

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: _ . : / = +: 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.

Tópicos

Adicionar tags a um novo grupo (console)
Adicionar tags a uma nova regra de amostragem (console)
Editar ou excluir tags de um grupo (console)
Editar ou excluir tags de uma regra de amostragem (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.

Faça login no AWS Management Console e abra o console do X-Ray em https://console.aws.amazon.com/xray/home.
No painel de navegação, expanda Configuração e escolha Grupos.
Escolha Criar grupo.
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.
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 neste tópico para saber sobre as limitações das tags.
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.

Faça login no AWS Management Console e abra o console do X-Ray em https://console.aws.amazon.com/xray/home.
No painel de navegação, expanda Configuração e escolha Amostragem.
Escolha Criar regra de amostragem.
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.
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 neste tópico para saber sobre as limitações das tags.
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.

Faça login no AWS Management Console e abra o console do X-Ray em https://console.aws.amazon.com/xray/home.
No painel de navegação, expanda Configuração e escolha Grupos.
Na tabela Grupos, escolha o nome de um grupo.
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. Consulte Restrições de tags neste tópico para saber sobre as limitações das tags.
Para excluir uma tag, escolha X à direita da tag.
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.

Faça login no AWS Management Console e abra o console do X-Ray em https://console.aws.amazon.com/xray/home.
No painel de navegação, expanda Configuração e escolha Amostragem.
Na tabela Regras de amostragem, escolha o nome de uma regra de amostragem.
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. Consulte Restrições de tags neste tópico para saber sobre as limitações das tags.
Para excluir uma tag, escolha X à direita da tag.
Ao terminar de editar ou excluir as tags, escolha Atualizar regra de amostragem.

Gerenciar tags na AWS CLI

Você pode adicionar tags opcionais ao criar uma regra de amostragem ou um grupo do X-Ray. É possível usar a AWS CLI para criar e gerenciar tags. Para atualizar tags em um grupo ou regra de amostragem existente, use o console do AWS X-Ray ou as APIs TagResource ou UntagResource.

Tópicos

Adicione tags a um novo grupo ou regra de amostragem do X-Ray (CLI)
Adicionar tags a um recurso existente (CLI)
Listar as tags em um recurso (CLI)
Excluir tags de um recurso (CLI)

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, substituindo group_name pelo nome do seu grupo, mydomain.com pelo endpoint do seu serviço, key_name por uma chave de tag e, opcionalmente, value por um valor de tag. Para obter mais informações sobre como criar um grupo, consulte Grupos.


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 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, substituindo key_name por uma chave de tag e, opcionalmente, value por um 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.


aws xray create-sampling-rule \
   --cli-input-json file://file_name.json

Veja a seguir o conteúdo do arquivo JSON file_name.json especificado pelo parâmetro --cli-input-json.


{
    "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 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 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.

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 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 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 Controlar o acesso a recursos da AWS usando tags.

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.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Criar recursos do X-Ray com o CloudFormation

Solução de problemas