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á.
# Recursos de conexões de tags
Uma *tag* é um rótulo de atributo personalizado que você atribui ou AWS atribui a um AWS recurso. Cada AWS tag tem duas partes:
+ Uma *chave de tag* (por exemplo `CostCenter`, `Environment` ou `Project`). As chaves de tag diferenciam maiúsculas de minúsculas
+ Um campo opcional conhecido como um *valor de tag* (por exemplo, `111122223333`, `Production` ou um nome de equipe). Omitir o valor da tag é o mesmo que usar uma string vazia. Assim como as chaves de tag, os valores de tag diferenciam maiúsculas de minúsculas.
Juntos, são conhecidos como *pares de chave/valor*.
Você pode usar o console ou a CLI para marcar recursos.
Você pode marcar os seguintes tipos de recursos na AWS CodeConnections:
+ Conexões
+ Hosts
Essas etapas pressupõem que você já tenha instalado uma versão recente do AWS CLI ou atualizado para a versão atual. Para obter mais informações, consulte [Instalar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) no *Guia do usuário da AWS Command Line Interface *.
Além de identificar, organizar e rastrear seu recurso com tags, você pode usar tags nas políticas AWS Identity and Access Management (IAM) para ajudar a controlar quem pode visualizar e interagir com seu recurso. Para obter exemplos de políticas de acesso baseadas em tags, consulte [Usando tags para controlar o acesso aos AWS CodeConnections recursos](connections-tag-based-access-control.md).
**Topics**
+ [Marcar recursos (console)](#connections-tag-console)
+ [Recursos de tag (CLI)](#connections-tag-cli)
## Marcar recursos (console)
É possível usar o console para adicionar, atualizar ou remover tags em um recurso de conexões.
**Topics**
+ [Adicionar tags a um recurso de conexões (console)](#connections-tag-console-add)
+ [Visualizar tags para um recurso de conexões (console)](#connections-tag-console-view)
+ [Editar tags para um recurso de conexões (console)](#connections-tag-console-edit)
+ [Remover tags de um recurso de conexões (console)](#connections-tag-console-remove)
### Adicionar tags a um recurso de conexões (console)
Você pode usar o console para adicionar tags a uma conexão ou a um host existente.
**nota**
Quando você cria uma conexão para um provedor instalado, como o GitHub Enterprise Server, e um recurso de host também é criado para você, as tags durante a criação são adicionadas somente à conexão. Isso permite que você marque um host separadamente se quiser reutilizá-lo para uma nova conexão. Se quiser adicionar tags ao host, use as etapas aqui.
****Para adicionar etiquetas a uma conexão****
1. Faça login no console do . No painel de navegação, escolha **Settings (Configurações)**.
1. Em **Settings** (Configurações), escolha **Connections** (Conexões). Escolha a guia **Connections (Conexões)**.
1. Escolha a conexão que deseja editar. A página de configurações de conexão é exibida.
1. Em **Connection tags** (Tags da conexão), escolha **Edit** (Editar). A página **Edit Connection tags** (Editar tags da conexão) é exibida.
1. Nos campos **Key (Chave)** e **Value (Valor)**, insira um par de chaves para cada conjunto de tags que você deseja adicionar. (O campo **Value (Valor)** é opcional.) Por exemplo, em **Key (Chave)**, insira **Project**. Em **Valor**, informe **ProjectA**.
1. (Opcional) Escolha **Add tag (Adicionar tag)** para adicionar mais linhas e inserir mais tags.
1. Selecione **Enviar**. As tags são listadas em configurações da conexão.
****Para adicionar etiquetas a um host****
1. Faça login no console do . No painel de navegação, escolha **Settings (Configurações)**.
1. Em **Settings** (Configurações), escolha **Connections** (Conexões). Escolha a guia **Hosts**.
1. Selecione o host que deseja editar. A página de configurações do host é exibida.
1. Em **Host tags** (Tags do host), escolha **Edit** (Editar). A página **Host tags** (Tags do host) é exibida.
1. Nos campos **Key (Chave)** e **Value (Valor)**, insira um par de chaves para cada conjunto de tags que você deseja adicionar. (O campo **Value (Valor)** é opcional.) Por exemplo, em **Key (Chave)**, insira **Project**. Em **Valor**, informe **ProjectA**.
1. (Opcional) Escolha **Add tag** (Adicionar tag) para adicionar mais linhas e inserir mais tags para um host.
1. Selecione **Enviar**. As tags são listadas nas configurações do host.
### Visualizar tags para um recurso de conexões (console)
Você pode usar o console para visualizar as tags para recursos existentes.
**Para visualizar etiquetas de uma conexão**
1. Faça login no console do . No painel de navegação, escolha **Settings (Configurações)**.
1. Em **Settings** (Configurações), escolha **Connections** (Conexões). Escolha a guia **Connections (Conexões)**.
1. Escolha a conexão que deseja visualizar. A página de configurações de conexão é exibida.
1. Em **Connection tags** (Tags da conexão), visualize as tags para a conexão nas colunas **Key** (Chave) e **Value** (Valor).
**Para visualizar etiquetas de um host**
1. Faça login no console do . No painel de navegação, escolha **Settings (Configurações)**.
1. Em **Settings** (Configurações), escolha **Connections** (Conexões). Escolha a guia **Hosts**.
1. Escolha o host que deseja visualizar.
1. Em **Host tags** (Tags do host), visualize as tags para o host nas colunas **Key** (Chave) e **Value** (Valor).
### Editar tags para um recurso de conexões (console)
Você pode usar o console para editar tags que foram adicionadas a recursos de conexões.
**Para editar etiquetas de uma conexão**
1. Faça login no console do . No painel de navegação, escolha **Settings (Configurações)**.
1. Em **Settings** (Configurações), escolha **Connections** (Conexões). Escolha a guia **Connections (Conexões)**.
1. Escolha a conexão que deseja editar. A página de configurações de conexão é exibida.
1. Em **Connection tags** (Tags da conexão), escolha **Edit** (Editar). A página **Connection tags** (Tags da conexão) é exibida.
1. Nos campos **Key (Chave)** e **Value (Valor)**, atualize os valores em cada campo conforme necessário. Por exemplo, para a chave **Project**, em **Value (Valor)**, altere **ProjectA** para **ProjectB**.
1. Selecione **Enviar**.
**Para editar etiquetas de um host**
1. Faça login no console do . No painel de navegação, escolha **Settings (Configurações)**.
1. Em **Settings** (Configurações), escolha **Connections** (Conexões). Escolha a guia **Hosts**.
1. Selecione o host que deseja editar. A página de configurações do host é exibida.
1. Em **Host tags** (Tags do host), escolha **Edit** (Editar). A página **Host tags** (Tags do host) é exibida.
1. Nos campos **Key (Chave)** e **Value (Valor)**, atualize os valores em cada campo conforme necessário. Por exemplo, para a chave **Project**, em **Value (Valor)**, altere **ProjectA** para **ProjectB**.
1. Selecione **Enviar**.
### Remover tags de um recurso de conexões (console)
Você pode usar o console para remover tags de recursos de conexão. Ao remover tags do recurso associado, as tags são excluídas.
**Para remover etiquetas de uma conexão**
1. Faça login no console do . No painel de navegação, escolha **Settings (Configurações)**.
1. Em **Settings** (Configurações), escolha **Connections** (Conexões). Escolha a guia **Connections (Conexões)**.
1. Escolha a conexão que deseja editar. A página de configurações de conexão é exibida.
1. Em **Connection tags** (Tags da conexão), escolha **Edit** (Editar). A página **Connection tags** (Tags da conexão) é exibida.
1. Ao lado da chave e do valor para cada tag que você deseja excluir, escolha **Remove tag (Remover tag)**.
1. Selecione **Enviar**.
**Para remover etiquetas de um host**
1. Faça login no console do . No painel de navegação, escolha **Settings (Configurações)**.
1. Em **Settings** (Configurações), escolha **Connections** (Conexões). Escolha a guia **Hosts**.
1. Selecione o host que deseja editar. A página de configurações do host é exibida.
1. Em **Host tags** (Tags do host), escolha **Edit** (Editar). A página **Host tags** (Tags do host) é exibida.
1. Ao lado da chave e do valor para cada tag que você deseja excluir, escolha **Remove tag (Remover tag)**.
1. Selecione **Enviar**.
## Recursos de tag (CLI)
É possível usar a CLI para adicionar, atualizar ou remover tags em um recurso de conexões.
**Topics**
+ [Adicionar tags a um recurso de conexões (CLI)](#connections-tag-add)
+ [Visualizar tags para um recurso de conexões (CLI)](#connections-tag-view)
+ [Editar tags para um recurso de conexões (CLI)](#connections-tag-edit)
+ [Remover tags de um recurso de conexões (CLI)](#connections-tag-delete)
### Adicionar tags a um recurso de conexões (CLI)
Você pode usar o AWS CLI para marcar recursos em conexões.
No terminal ou na linha de comando, execute o comando **tag-resource**, especificando o nome de recurso da Amazon (ARN) do recurso no qual você deseja incluir tags e a chave e o valor da tag que você deseja adicionar. É possível adicionar mais de uma tag.
****Para adicionar etiquetas a uma conexão****
1. Obtenha o ARN para o seu recurso. Use o comando **list-connections** mostrado em [Listar Conexões](connections-list.md) para obter o ARN da conexão.
1. No terminal ou na linha de comando, execute o comando **tag-resource**.
Por exemplo, use o comando a seguir para marcar uma conexão com duas tags, uma chave de tag {{Project}} com o valor de tag de {{ProjectA}} e uma chave de tag {{ReadOnly}} com o valor de tag de{{true}}.
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key={{Project}},Value={{ProjectA}} Key={{IscontainerBased}},Value={{true}}
```
Se houver êxito, o comando não retornará nada.
****Para adicionar etiquetas a um host****
1. Obtenha o ARN para o seu recurso. Use o comando **list-hosts** mostrado em [Listar hosts](connections-host-list.md) para obter o ARN do host.
1. No terminal ou na linha de comando, execute o comando **tag-resource**.
Por exemplo, use o comando a seguir para marcar um host com duas tags, uma chave de tag {{Project}} com o valor de tag de {{ProjectA}} e uma chave de tag {{IscontainerBased}} com o valor de tag de{{true}}.
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:host/My-Host-28aef605 --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true
```
Se houver êxito, o comando não retornará nada.
### Visualizar tags para um recurso de conexões (CLI)
Você pode usar o AWS CLI para visualizar as AWS tags de um recurso de conexões. Se não foram adicionadas tags, a lista retornará vazia. Use o comando **list-tags-for-resource** para visualizar tags adicionadas a uma conexão ou um host.
****Para visualizar etiquetas de uma conexão****
1. Obtenha o ARN para o seu recurso. Use o comando **list-connections** mostrado em [Listar Conexões](connections-list.md) para obter o ARN da conexão.
1. No terminal ou na linha de comando, execute o comando **list-tags-for-resource**. Por exemplo, use o comando a seguir para visualizar uma lista de chaves e valores de tag para uma conexão.
```
aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f
```
Esse comando retorna as tags associadas ao recurso. Este exemplo mostra dois pares de chave e valor retornados para uma conexão.
```
{
"Tags": [
{
"Key": "Project",
"Value": "ProjectA"
},
{
"Key": "ReadOnly",
"Value": "true"
}
]
}
```
****Para visualizar etiquetas de um host****
1. Obtenha o ARN para o seu recurso. Use o comando **list-hosts** mostrado em [Listar hosts](connections-host-list.md) para obter o ARN do host.
1. No terminal ou na linha de comando, execute o comando **list-tags-for-resource**. Por exemplo, use o comando a seguir para visualizar uma lista de chaves e valores de tag para um host.
```
aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:host/My-Host-28aef605
```
Esse comando retorna as tags associadas ao recurso. Este exemplo mostra dois pares de chave e valor retornados para um host.
```
{
"Tags": [
{
"Key": "IscontainerBased",
"Value": "true"
},
{
"Key": "Project",
"Value": "ProjectA"
}
]
}
```
### Editar tags para um recurso de conexões (CLI)
Você pode usar o AWS CLI para editar uma tag para um recurso. Você pode alterar o valor para uma chave existente ou adicionar outra chave.
No terminal ou na linha de comando, execute o comando **tag-resource**, especificando o ARN do recurso em que você deseja atualizar uma tag e especifique a chave e o valor da tag a ser atualizada.
Quando você editar tags, todas as chaves de tag não especificadas serão mantidas, enquanto qualquer outra coisa com a mesma chave, mas um novo valor, será atualizada. Novas chaves que são adicionadas com o comando edit são adicionadas como um novo par chave-valor.
****Para editar etiquetas de uma conexão****
1. Obtenha o ARN para o seu recurso. Use o comando **list-connections** mostrado em [Listar Conexões](connections-list.md) para obter o ARN da conexão.
1. No terminal ou na linha de comando, execute o comando **tag-resource**.
Neste exemplo, o valor da chave `Project` é alterado para `ProjectB`.
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectB
```
Se houver êxito, o comando não retornará nada. Para verificar as tags associadas à conexão, execute o comando **list-tags-for-resource**.
****Para editar etiquetas de um host****
1. Obtenha o ARN para o seu recurso. Use o comando **list-hosts** mostrado em [Listar hosts](connections-host-list.md) para obter o ARN do host.
1. No terminal ou na linha de comando, execute o comando **tag-resource**.
Neste exemplo, o valor da chave `Project` é alterado para `ProjectB`.
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:host/My-Host-28aef605 --tags Key=Project,Value=ProjectB
```
Se houver êxito, o comando não retornará nada. Para verificar as tags associadas ao host, execute o comando **list-tags-for-resource**.
### Remover tags de um recurso de conexões (CLI)
Siga estas etapas para usar o AWS CLI para remover uma tag de um recurso. Ao remover tags do recurso associado, as tags são excluídas.
**nota**
Se você excluir um recurso de conexão, todas as associações de tags serão removidas do recurso excluído. Não é necessário remover tags antes de excluir um recurso de conexão.
No terminal ou na linha de comando, execute o comando **untag-resource**, especificando o ARN do recurso de onde você deseja remover tags e a chave da tag a ser removida. Por exemplo, para remover várias tags em uma conexão com as chaves {{Project}} de tag{{ReadOnly}}, use o comando a seguir.
```
aws codestar-connections untag-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tag-keys {{Project}} {{ReadOnly}}
```
Se houver êxito, o comando não retornará nada. Para verificar as tags associadas ao recurso, execute o comando **list-tags-for-resource**. A saída mostra que todas as tags foram removidas.
```
{
"Tags": []
}
```