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á. # Adicionar tags aos recursos do Macie Uma *tag* é um rótulo que você pode definir e atribuir a recursos da AWS , incluindo certos tipos de recursos do Amazon Macie. Ao usar tags, você pode identificar, categorizar e gerenciar recursos de diferentes maneiras, como por finalidade, propriedade, ambiente ou outros critérios. Por exemplo, você pode usar tags para aplicar políticas, alocar custos, distinguir entre versões de recursos ou identificar recursos que suportam determinados requisitos de conformidade ou fluxos de trabalho. Você pode adicionar tags aos seguintes tipos de recursos do Macie: + Lista de permissões + Identificadores de dados personalizados + Regras de filtro e regras de supressão para descobertas + Trabalho de descoberta de dados confidenciais Se você for o administrador do Macie de uma organização, poderá também adicionar tags às contas de membros da organização. Um recurso pode ter até 50 tags. Cada tag consiste em uma *chave de tag* necessária e um *valor de tag* opcional. Uma *chave de tag* é uma etiqueta geral que atua como uma categoria para valores de tags mais específicos. Um *valor de tag* atua como um descritor de uma chave de tag. Para obter mais informações sobre os requisitos e as opções de marcação, consulte [Fundamentos de marcação](tags-basics.md). É possível adicionar tags aos recursos do Macie de várias maneiras. Você pode usar o Macie diretamente. Você também pode usar o Editor de tags no AWS Resource Groups console ou as operações de marcação da API de AWS Resource Groups marcação. AWS Resource Groups é um serviço projetado para ajudar você a agrupar e gerenciar AWS recursos como uma única unidade, em vez de individualmente. Se usar o Macie, você pode adicionar tags a um recurso ao criá-lo. Você também pode adicionar tags aos recursos individuais existentes. Com AWS Resource Groups, você pode adicionar tags em massa para vários recursos existentes, abrangendo vários Serviços da AWS, incluindo o Macie. **Para adicionar tags a um recurso do Macie** Para adicionar tags a um recurso individual do Macie, você pode usar o console do Amazon Macie ou a API do Amazon Macie. Para adicionar tags a vários recursos do Macie ao mesmo tempo, use o AWS Resource Groups console ou a API de AWS Resource Groups marcação. Para obter mais informações, consulte o [Guia do usuário de recursos da AWS para tags](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html). **Importante** Adicionar tags a um recurso pode afetar o acesso a ele. Antes de adicionar uma tag a um recurso, revise todas as políticas AWS Identity and Access Management (IAM) que possam usar tags para controlar o acesso aos recursos. 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) no *Guia do usuário do IAM*. ------ #### [ Console ] Quando você cria uma lista de permissões, um identificador de dados personalizados, ou um trabalho de descoberta de dados confidenciais, o console do Amazon Macie fornece opções para adicionar tags ao recurso. Siga as instruções no console para adicionar tags a esses tipos de recursos ao criar os recursos. Para adicionar tags a uma regra de filtro, regra de supressão, ou conta de membro, você precisa criar o recurso antes de adicionar tags a ele. Para adicionar uma ou mais tags a um recurso existente usando o console do Amazon Macie, siga estas etapas. **Adiciona uma tag a um recurso** 1. Abra o console do Amazon Macie em. [https://console.aws.amazon.com/macie/](https://console.aws.amazon.com/macie/) 1. Dependendo do tipo de recurso ao qual você quer adicionar uma tag, realize uma das seguintes ações: + Para uma lista de permissões, selecione **Listas de permissões** no painel de navegação. Na tabela, marque a caixa de seleção da lista. Em seguida, selecione **Gerenciar tags** no menu **Ações**. + Para um identificador de dados personalizados, selecione **Identificadores de dados personalizados** no painel de navegação. Na tabela, marque a caixa de seleção do identificador de dados personalizado. Em seguida, selecione **Gerenciar tags** no menu **Ações**. + Para uma regra de filtro ou supressão, selecione **Descobertas** no painel de navegação. Na lista **Regras salvas**, selecione o ícone de edição (![\[The edit icon, which is a blue pencil.\]](http://docs.aws.amazon.com/pt_br/macie/latest/user/images/icon-edit-resource-blue.png)) ao lado da regra. Em seguida, selecione **Gerenciar tags**. + Para uma conta de membro em sua organização, selecione **Contas** no painel de navegação. Na tabela, marque a caixa de seleção da conta. Em seguida, selecione **Gerenciar tags** no menu **Ações**. + Para um trabalho de descoberta de dados confidenciais, selecione **Trabalhos** no painel de navegação. Na tabela, marque a caixa de seleção do trabalho. Em seguida, selecione **Gerenciar tags** no menu **Ações**. A janela **Gerenciar tags** lista todas as tags atualmente atribuídas ao recurso. 1. Na janela **Gerenciar tags**, selecione **Editar tags**. 1. Escolha **Adicionar Tag**. 1. Na caixa **Chave**, insira a chave da tag a ser adicionada ao recurso. Em seguida, na caixa **Valor**, você tem a opção de inserir o valor da tag. Uma chave de tag pode ter até 128 caracteres. Um valor de tag pode conter até 256 caracteres. Os caracteres podem ser letras, números, espaços ou os seguintes símbolos: \$1 . : / = \$1 - @ 1. Para adicionar outra tag ao recurso, escolha **Adicionar tag** e repita a etapa anterior. É possível atribuir até 50 tags a um recurso. 1. Quando terminar de adicionar tags, selecione **Salvar**. ------ #### [ API ] Para criar um recurso e adicionar uma ou mais tags a ele programaticamente, use a operação `Create` apropriada para o tipo de recurso que deseja criar: + **Lista de permissões** — Use a [CreateAllowList](https://docs.aws.amazon.com/macie/latest/APIReference/allow-lists.html)operação. Ou, se você estiver usando a AWS Command Line Interface (AWS CLI), execute o comando [create-allow-list](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-allow-list.html). + **Identificador de dados personalizado** — Use a [CreateCustomDataIdentifier](https://docs.aws.amazon.com/macie/latest/APIReference/custom-data-identifiers.html)operação. Ou, se você estiver usando o AWS CLI, execute o [create-custom-data-identifier](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-custom-data-identifier.html)comando. + **Regra de filtro ou supressão** — Use a [CreateFindingsFilter](https://docs.aws.amazon.com/macie/latest/APIReference/findingsfilters.html)operação. Ou, se você estiver usando a AWS CLI, execute o comando [create-findings-filter](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-findings-filter.html). + **Conta de membro** — Use a [CreateMember](https://docs.aws.amazon.com/macie/latest/APIReference/members.html)operação. Ou, se você estiver usando o AWS CLI, execute o comando [create-member](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-member.html). + **Trabalho de descoberta de dados confidenciais** — Use a [CreateClassificationJob](https://docs.aws.amazon.com/macie/latest/APIReference/jobs.html)operação. Ou, se você estiver usando o AWS CLI, execute o [create-classification-job](https://docs.aws.amazon.com/cli/latest/reference/macie2/create-classification-job.html)comando. Em sua solicitação, use o parâmetro `tags` para especificar a chave da tag (`key`) e o valor opcional de tag (`value`) para cada tag a ser adicionada ao recurso. O `tags` parâmetro especifica um string-to-string mapa das chaves de tag e seus valores de tag associados. Para adicionar uma ou mais tags a um recurso existente, use a [TagResource](https://docs.aws.amazon.com/macie/latest/APIReference/tags-resourcearn.html)operação da API Amazon Macie ou, se estiver usando a AWS CLI, execute o comando [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/macie2/tag-resource.html). Na sua solicitação, especifique o nome do recurso da Amazon (ARN) do recurso ao qual deseja adicionar uma tag. Use o parâmetro `tags` para especificar a chave da tag (`key`) e o valor opcional da tag (`value`) para cada tag a ser adicionada ao recurso. Como é o caso de `Create` operações e comandos, o `tags` parâmetro especifica um string-to-string mapa das chaves de tag e seus valores de tag associados. Por exemplo, o AWS CLI comando a seguir adiciona uma chave de `Stack` tag com um valor de `Production` tag ao trabalho especificado. Este exemplo foi formatado para Microsoft Windows e usa o caractere de continuação de linha circunflexo (^) para melhorar a legibilidade. ``` C:\> aws macie2 tag-resource ^ --resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^ --tags={\"Stack\":\"Production\"} ``` Em que: + `resource-arn` especifica o ARN do trabalho ao qual adicionar uma tag. + `Stack` é a chave da tag a ser adicionada ao trabalho. + `Production` é o valor da tag especificada para a chave da tag especificada (`Stack`). No exemplo a seguir, o comando adiciona várias tags ao trabalho: ``` 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 tag em um mapa `tags`, os argumentos `key` e `value` são obrigatórios. No entanto, o valor do argumento `value` pode ser uma string vazia. Se você não quiser associar um valor de tag a uma chave de tag, não especifique um valor para o argumento `value`. Por exemplo, o AWS CLI comando a seguir adiciona uma chave de `Owner` tag sem valor de tag associado: ``` C:\> aws macie2 tag-resource ^ --resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^ --tags={\"Owner\":\"\"} ``` Se a operação for bem sucedida, o Macie retornará uma resposta HTTP 204 vazia. Caso contrário, o Macie retornará uma resposta HTTP 4*xx* ou 500, que indica o motivo de a operação ter falhado. ------