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
ouProject
). Chaves de tag fazem distinção entre maiúsculas e 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. Como chaves de tag, os valores das tags diferenciam maiúsculas de minúsculas.
Juntos, são conhecidos como pares de chave/valor.
Você pode usar o console ou o CLI para marcar recursos.
Você pode marcar os seguintes tipos de recursos em 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 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.
Marcar recursos (console)
É possível usar o console para adicionar, atualizar ou remover tags em um recurso de conexões.
Tópicos
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
-
Faça login no console do . No painel de navegação, escolha Settings (Configurações).
-
Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Connections (Conexões).
-
Escolha a conexão que deseja editar. A página de configurações de conexão é exibida.
-
Em Connection tags (Tags da conexão), escolha Edit (Editar). A página Edit Connection tags (Editar tags da conexão) é exibida.
-
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, informeProjectA
. -
(Opcional) Escolha Add tag (Adicionar tag) para adicionar mais linhas e inserir mais tags.
-
Selecione Enviar. As tags são listadas em configurações da conexão.
Para adicionar etiquetas a um host
-
Faça login no console do . No painel de navegação, escolha Settings (Configurações).
-
Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Hosts.
-
Selecione o host que deseja editar. A página de configurações do host é exibida.
-
Em Host tags (Tags do host), escolha Edit (Editar). A página Host tags (Tags do host) é exibida.
-
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, informeProjectA
. -
(Opcional) Escolha Add tag (Adicionar tag) para adicionar mais linhas e inserir mais tags para um host.
-
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
-
Faça login no console do . No painel de navegação, escolha Settings (Configurações).
-
Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Connections (Conexões).
-
Escolha a conexão que deseja visualizar. A página de configurações de conexão é exibida.
-
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
-
Faça login no console do . No painel de navegação, escolha Settings (Configurações).
-
Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Hosts.
-
Escolha o host que deseja visualizar.
-
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
-
Faça login no console do . No painel de navegação, escolha Settings (Configurações).
-
Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Connections (Conexões).
-
Escolha a conexão que deseja editar. A página de configurações de conexão é exibida.
-
Em Connection tags (Tags da conexão), escolha Edit (Editar). A página Connection tags (Tags da conexão) é exibida.
-
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), altereProjectA
paraProjectB
. -
Selecione Enviar.
Para editar etiquetas de um host
-
Faça login no console do . No painel de navegação, escolha Settings (Configurações).
-
Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Hosts.
-
Selecione o host que deseja editar. A página de configurações do host é exibida.
-
Em Host tags (Tags do host), escolha Edit (Editar). A página Host tags (Tags do host) é exibida.
-
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), altereProjectA
paraProjectB
. -
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
-
Faça login no console do . No painel de navegação, escolha Settings (Configurações).
-
Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Connections (Conexões).
-
Escolha a conexão que deseja editar. A página de configurações de conexão é exibida.
-
Em Connection tags (Tags da conexão), escolha Edit (Editar). A página Connection tags (Tags da conexão) é exibida.
-
Ao lado da chave e do valor para cada tag que você deseja excluir, escolha Remove tag (Remover tag).
-
Selecione Enviar.
Para remover etiquetas de um host
-
Faça login no console do . No painel de navegação, escolha Settings (Configurações).
-
Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Hosts.
-
Selecione o host que deseja editar. A página de configurações do host é exibida.
-
Em Host tags (Tags do host), escolha Edit (Editar). A página Host tags (Tags do host) é exibida.
-
Ao lado da chave e do valor para cada tag que você deseja excluir, escolha Remove tag (Remover tag).
-
Selecione Enviar.
Recursos de tag (CLI)
Você pode usar o CLI para visualizar, adicionar, atualizar ou remover tags em um recurso de conexões.
Tópicos
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 tag-resource comando, especificando o Amazon Resource Name (ARN) do recurso ao qual você deseja adicionar 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
-
Obtenha o ARN para seu recurso. Use o list-connections comando mostrado em Listar Conexões para obter a conexãoARN.
-
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 deProjectA
e uma chave de tagReadOnly
com o valor de tag detrue
.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
-
Obtenha o ARN para seu recurso. Use o list-hosts comando mostrado em Listar hosts para obter o hostARN.
-
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 deProjectA
e uma chave de tagIscontainerBased
com o valor de tag detrue
.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=trueSe houver êxito, o comando não retornará nada.
Exibir 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
-
Obtenha o ARN para seu recurso. Use o list-connections comando mostrado em Listar Conexões para obter a conexãoARN.
-
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-dfcab0bc441fEsse 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
-
Obtenha o ARN para seu recurso. Use o list-hosts comando mostrado em Listar hosts para obter o hostARN.
-
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-28aef605Esse 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 tag-resource comando, especificando o ARN recurso em que você deseja atualizar uma tag e especifique a chave e o valor da tag a serem atualizados.
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
-
Obtenha o ARN para seu recurso. Use o list-connections comando mostrado em Listar Conexões para obter a conexãoARN.
-
No terminal ou na linha de comando, execute o comando tag-resource.
Neste exemplo, o valor da chave
Project
é alterado paraProjectB
.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=ProjectBSe 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
-
Obtenha o ARN para seu recurso. Use o list-hosts comando mostrado em Listar hosts para obter o hostARN.
-
No terminal ou na linha de comando, execute o comando tag-resource.
Neste exemplo, o valor da chave
Project
é alterado paraProjectB
.aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:
account_id
:host/My-Host-28aef605 --tags Key=Project,Value=ProjectBSe 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 untag-resource comando, especificando o recurso ARN do qual você deseja remover as tags e a chave da tag que você deseja remover. Por exemplo, para remover várias tags em uma conexão com as chaves Project
de tagReadOnly
, 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-keysProject
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": [] }