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á.
# Edição de tags para recursos do Amazon Security Lake
Você pode editar as tags (chaves e valores) de um recurso do Amazon Security Lake usando o console do Security Lake ou a API Security Lake.
**Importante**
Editar as tags de um recurso pode afetar o acesso a ele. Antes de editar a chave ou o valor de uma tag para um recurso, revise todas as políticas AWS Identity and Access Management (IAM) que possam usar a tag para controlar o acesso aos recursos.
------
#### [ Console ]
Siga estas etapas para editar as tags de um recurso usando o console.
**Para editar de tags de um recurso**
1. Abra o console do Security Lake em [https://console.aws.amazon.com/securitylake/](https://console.aws.amazon.com/securitylake/).
1. Realize uma das seguintes ações, dependendo do tipo de recurso da tag a ser editada:
+ Para uma configuração de data lake, escolha **Regiões** no painel de navegação. Em seguida, na tabela **Regiões**, selecione a Região.
+ Para um assinante, escolha **Assinantes** no painel de navegação. Em seguida, na tabela **Meus assinantes**, selecione o assinante.
Se o assinante não aparecer na tabela, use o seletor Região da AWS no canto superior direito da página para selecionar a Região correspondente. A tabela lista somente os assinantes existentes da atual Região.
1. Escolha **Editar**.
1. Expanda a seção **Tags**. A seção **Tags** lista todas as tags atribuídas ao recurso atualmente.
1. Faça o seguinte:
+ Para adicionar um valor a uma chave existente, insira o valor na caixa **Valor** ao lado da chave de tag.
+ Para alterar uma chave existente, escolha **Remover** ao lado da tag. Depois, selecione **Adicionar nova tag**. Na caixa **Chave**, insira a nova chave de tag. Opcionalmente, insira um valor associado à tag na caixa **Valor**.
+ Para alterar o valor de uma tag existente, selecione **X** na caixa **Valor** que contém o valor. Em seguida, digite o novo valor da tag na caixa **Valor**.
+ Para remover o valor existente de uma tag, selecione **X** na caixa **Valor** que contém o valor.
+ Para remover uma tag existente (a chave da tag e o valor da tag), selecione **Remover** ao lado da tag.
Um recurso pode ter até 50 tags. 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. Depois de concluir a edição das tags, selecione **Salvar**.
------
#### [ API ]
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](tags-remove.md) e [adicione uma nova](tags-add.md).
Para editar ou remover somente o valor da tag associado a uma chave de tag, substitua o valor existente usando a [TagResource](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_TagResource.html)operação da API Security Lake. Se você estiver usando o AWS Command Line Interface (AWS CLI), execute o comando [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/securitylake/tag-resource.html). Na solicitação, especifique o nome do recurso da Amazon (ARN) cujo valor você quer editar ou remover.
Para editar um valor de tag, use o parâmetro `tags` para especificar a chave que terá seu valor alterado. Especifique também o novo valor da chave. Por exemplo, o AWS CLI comando a seguir altera o valor da tag de `Cloud` `On-Premises` para para a chave de `Environment` tag atribuída ao assinante especificado. Este exemplo está formatado para Linux, macOS ou Unix e usa o caractere de continuação de linha “barra invertida (\\)” para melhorar a legibilidade.
```
$ aws securitylake tag-resource \
--resource-arn {{arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab}} \
--tags key={{Environment}},value={{On-Premises}}
```
Em que:
+ `resource-arn` especifica o ARN do assinante.
+ `{{Environment}}` é a chave de tag associada ao valor da tag a ser alterado.
+ `{{On-Premises}}` é o novo valor da chave especificada (`{{Environment}}`).
Para remover um valor de tag de uma chave de tag, não especifique um valor para o argumento `value` da chave no parâmetro `tags`. Por exemplo:
```
$ aws securitylake tag-resource \
--resource-arn {{arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab}} \
--tags key={{Owner}},value=
```
Se a operação for bem-sucedida, o Security Lake retornará uma resposta HTTP 200 vazia. Caso contrário, o Security Lake retornará uma resposta HTTP 4 *xx* ou 500 que indica por que a operação falhou.
------
## Análise de tags para recursos do Amazon Security Lake
Você pode analisar as tags (chaves e valores) de um recurso do Amazon Security Lake usando o console do Security Lake ou a API Security Lake.
------
#### [ Console ]
Siga estas etapas para analisar as tags de um recurso usando o console.
**Para revisar as tags de um recurso**
1. Abra o console do Security Lake em [https://console.aws.amazon.com/securitylake/](https://console.aws.amazon.com/securitylake/).
1. Realize uma das seguintes ações, dependendo do tipo de recurso da tag a ser analisada:
+ Para uma configuração de data lake, escolha **Regiões** no painel de navegação. Na tabela **Regiões**, selecione a Região e escolha **Editar**. Expanda a seção **Tags**.
+ Para um assinante, escolha **Assinantes** no painel de navegação. Em seguida, na tabela **Meus assinantes**, selecione o nome de assinante.
Se o assinante não aparecer na tabela, use o seletor Região da AWS no canto superior direito da página para selecionar a Região correspondente. A tabela lista somente os assinantes existentes da atual Região.
A seção **Tags** lista todas as tags atribuídas ao recurso atualmente.
------
#### [ API ]
Para recuperar e revisar programaticamente as tags de um recurso existente, use a [ListTagsForResource](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_ListTagsForResource.html)operação da API Security Lake. Em sua solicitação, use o parâmetro `resourceArn` para especificar o nome do recurso da Amazon (ARN).
Se você estiver usando o AWS Command Line Interface (AWS CLI), execute o [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/securitylake/list-tags-for-resource.html)comando e use o `resource-arn` parâmetro para especificar o ARN do recurso. Por exemplo:
```
$ aws securitylake list-tags-for-resource --resource-arn {{arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab}}
```
No exemplo anterior, {{arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab}} é o ARN de um assinante existente.
Se a operação for bem-sucedida, o Security Lake retornará uma matriz `tags`. Cada objeto na matriz especifica uma tag (tanto a chave quanto o valor) que está atualmente atribuída ao recurso. Por exemplo:
```
{
"tags": [
{
"key": "Environment",
"value": "Cloud"
},
{
"key": "CostCenter",
"value": "12345"
},
{
"key": "Owner",
"value": ""
}
]
}
```
Em que `Environment`, `CostCenter` e `Owner` são as chaves de tag atribuídas ao recurso. `Cloud` é o valor da tag associado à chave da tag `Environment`. `12345` é o valor da tag associado à chave da tag `CostCenter`. A chave de tag `Owner` não tem nenhum valor associado.
------