Analisar e editar tags para recursos do Macie

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

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

Também é possível usar a operação ListTagsForResource da API do Amazon Macie. Na sua solicitação, use o parâmetro resourceArn para especificar o nome do recurso da Amazon (ARN) para esse recurso. Se você estiver usando a AWS CLI, execute o comando list-tags-for-resource e use o parâmetro resource-arn 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": ""
    }
}

Em que 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 da tag Owner não tem um valor de tag associado.

Para exibir uma lista de todos os recursos do Macie que possuem tags, e todas as tags que estão associadas a cada um desses recursos, use a operação GetResources da API de tags do AWS Resource Groups. 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 parâmetro resource-type-filters como macie2. Por exemplo:

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

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

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 de tag, 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 operação TagResource da API do Amazon Macie. Se você estiver usando a AWS Command Line Interface (AWS CLI), poderá fazer isso executando o comando tag-resource. Na sua solicitação, especifique o nome do recurso da Amazon (ARN) cujo valor da 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, o Macie retornará uma resposta HTTP 204 vazia. Caso contrário, o Macie retornará uma resposta HTTP 4xx ou 500, que indica o motivo de a operação ter falhado.