Marcando recursos do Macie

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 ou supressão, ou a uma conta de membro em uma organização, 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.

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:

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 TagResourceoperação do Amazon Macie API ou, se estiver usando o AWS CLI, execute o comando tag-resource. Em sua solicitação, especifique o Amazon Resource Name (ARN) do recurso ao qual você 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:

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 uma operação de marcação for bem-sucedida, o Macie retornará uma resposta 204 vaziaHTTP. Caso contrário, Macie retornará uma resposta de HTTP 4 xx ou 500 que indica por que a operação falhou.

Siga estas etapas para revisar as tags de um recurso usando o console do Amazon Macie.

Para recuperar e revisar programaticamente as tags de um recurso existente, você pode usar a operação Get ou Describe apropriada para o tipo de recurso para o qual deseja revisar as tags. Por exemplo, se você usar a GetCustomDataIdentifieroperação ou executar o get-custom-data-identifiercomando a partir do AWS Command Line Interface (AWS CLI), a resposta incluirá um tags objeto. O objeto lista todas as tags (tanto chaves e quanto valores de tag) que estão atualmente atribuídas ao recurso.

Você também pode usar a ListTagsForResourceoperação do Amazon API Macie. Em sua solicitação, use o resourceArn parâmetro para especificar o Amazon Resource Name (ARN) do recurso. Se você estiver usando o AWS CLI, execute o list-tags-for-resourcecomando e use o resource-arn parâmetro para especificar o ARN do recurso. Por exemplo:

C:\> aws macie2 list-tags-for-resource --resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample

No exemplo anterior, arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample é o ARN de um trabalho existente de descoberta de dados confidenciais.

Se a operação for bem-sucedida, o Macie retornará um objeto tags que lista todas as tags (chaves e valores de tag) atualmente atribuídas ao recurso. Por exemplo:

{
    "tags": {
        "Stack": "Production",
        "CostCenter": "12345",
        "Owner": ""
    }
}

Onde Stack, CostCenter e Owner são as chaves de tag atribuídas ao recurso. Production é o valor da tag associado à chave da tag Stack. 12345 é o valor da tag associado à chave da tag CostCenter. A chave de tag Owner não tem nenhum valor associado.

Para recuperar uma lista de todos os recursos do Macie que têm tags e todas as tags atribuídas a cada um desses recursos, use a GetResourcesoperação de Marcação. AWS Resource Groups API Na sua solicitação, defina o valor do parâmetro ResourceTypeFilters como macie2. Para fazer isso usando o AWS CLI, execute o comando get-resources e defina o valor do resource-type-filters parâmetro como. macie2 Por exemplo:

C:\> aws resourcegroupstaggingapi get-resources --resource-type-filters "macie2"

Se a operação for bem-sucedida, Resource Groups retornará uma ResourceTagMappingList matriz que contém todos os recursos do Macie que têm tags e as chaves e valores de tag atribuídos a cada um desses recursos. ARNs

Siga estas etapas para editar as tags de um recurso usando o console do Amazon Macie.

Ao editar uma tag para um recurso programaticamente, você substitui a tag existente por novos valores. Portanto, a melhor maneira de editar uma tag depende se você deseja editar uma chave de tag, um valor de tag ou ambos. Para editar uma chave, remova a tag atual e adicione uma nova.

Para editar ou remover somente o valor da tag associado a uma chave de tag, substitua o valor existente usando a TagResourceoperação do Amazon API Macie ou, se você estiver usando AWS Command Line Interface o AWS CLI(), executando o comando tag-resource. Em sua solicitação, especifique o Amazon Resource Name (ARN) do recurso cujo valor de tag você deseja editar ou remover.

Para editar um valor de tag para uma chave de tag, use o parâmetro tags para especificar a chave de tag cujo valor você deseja alterar e especifique o novo valor de tag para a chave. Por exemplo, o comando a seguir altera o valor da tag de Production para Staging para a Stack chave de tag que é atribuída à regra de automação especificada: 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\":\"Staging\"}

Em que:

Para remover um valor de tag de uma chave de tag, não especifique um valor para o argumento value no parâmetro tags. Por exemplo:

C:\> aws macie2 tag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tags={\"Stack\":\"\"}

Se a operação for bem-sucedida, Macie retornará uma resposta HTTP 204 vazia. Caso contrário, Macie retornará uma resposta de HTTP 4 xx ou 500 que indica por que a operação falhou.

Siga estas etapas para remover uma ou mais tags de um recurso usando o console do Amazon Macie.

Para remover uma ou mais tags de um recurso de forma programática, use a UntagResourceoperação do Amazon Macie. API Em sua solicitação, use o resourceArn parâmetro para especificar o Amazon Resource Name (ARN) do recurso do qual remover uma tag. Use o parâmetro tagKeys para especificar a chave da tag a ser removida. Para remover somente um valor de tag específico (não uma chave de tag) de um recurso, edite a tag em vez de removê-la.

Se você estiver usando o AWS Command Line Interface (AWS CLI), execute o comando untag-resource e use o resource-arn parâmetro para especificar o recurso ARN do qual remover uma tag. Use o parâmetro tag-keys para especificar a chave da tag a ser removida. Por exemplo, o comando a seguir remove a tag Stack (tanto a chave quanto o valor da tag) do trabalho de descoberta de dados confidenciais especificado:

C:\> aws macie2 untag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tag-keys Stack

Onde resource-arn especifica a tarefa ARN da qual remover uma tag e Stack é a chave da tag a ser removida.

Para remover várias tags de um recurso, acrescente cada chave adicional como argumento para o parâmetro tag-keys. Por exemplo:

C:\> aws macie2 untag-resource ^
--resource-arn arn:aws:macie2:us-east-1:123456789012:classification-job/3ce05dbb7ec5505def334104bexample ^
--tag-keys Stack Owner

Onde resource-arn especifica a tarefa ARN da qual remover as tags e Stack e Owner são as chaves das tags a serem removidas.

Se a operação for bem-sucedida, Macie retornará uma resposta HTTP 204 vazia. Caso contrário, Macie retornará uma resposta de HTTP 4 xx ou 500 que indica por que a operação falhou.