Recursos de conexões de tags - Console do Developer Tools
Marcar recursos (console)Recursos de tag (CLI)

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). 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 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 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.

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).

  2. Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Connections (Conexões).

  3. Escolha a conexão que deseja editar. A página de configurações de conexão é exibida.

  4. Em Connection tags (Tags da conexão), escolha Edit (Editar). A página Edit Connection tags (Editar tags da conexão) é exibida.

  5. 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.

    Connection tags interface with fields for Key and Value, and buttons to Add tag and Remove tag.

  6. (Opcional) Escolha Add tag (Adicionar tag) para adicionar mais linhas e inserir mais tags.

  7. 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).

  2. Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Hosts.

  3. Selecione o host que deseja editar. A página de configurações do host é exibida.

  4. Em Host tags (Tags do host), escolha Edit (Editar). A página Host tags (Tags do host) é exibida.

  5. 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.

    Edit Host tags interface with fields for Key and Value, and buttons to Add tag and Remove tag.

  6. (Opcional) Escolha Add tag (Adicionar tag) para adicionar mais linhas e inserir mais tags para um host.

  7. 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).

  2. Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Connections (Conexões).

  3. Escolha a conexão que deseja visualizar. A página de configurações de conexão é exibida.

  4. 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).

  2. Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Hosts.

  3. Escolha o host que deseja visualizar.

  4. 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).

  2. Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Connections (Conexões).

  3. Escolha a conexão que deseja editar. A página de configurações de conexão é exibida.

  4. Em Connection tags (Tags da conexão), escolha Edit (Editar). A página Connection tags (Tags da conexão) é exibida.

  5. 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.

  6. Selecione Enviar.

Para editar etiquetas de um host

  1. Faça login no console do . No painel de navegação, escolha Settings (Configurações).

  2. Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Hosts.

  3. Selecione o host que deseja editar. A página de configurações do host é exibida.

  4. Em Host tags (Tags do host), escolha Edit (Editar). A página Host tags (Tags do host) é exibida.

  5. 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.

  6. 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).

  2. Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Connections (Conexões).

  3. Escolha a conexão que deseja editar. A página de configurações de conexão é exibida.

  4. Em Connection tags (Tags da conexão), escolha Edit (Editar). A página Connection tags (Tags da conexão) é exibida.

  5. Ao lado da chave e do valor para cada tag que você deseja excluir, escolha Remove tag (Remover tag).

  6. Selecione Enviar.

Para remover etiquetas de um host

  1. Faça login no console do . No painel de navegação, escolha Settings (Configurações).

  2. Em Settings (Configurações), escolha Connections (Conexões). Escolha a guia Hosts.

  3. Selecione o host que deseja editar. A página de configurações do host é exibida.

  4. Em Host tags (Tags do host), escolha Edit (Editar). A página Host tags (Tags do host) é exibida.

  5. Ao lado da chave e do valor para cada tag que você deseja excluir, escolha Remove tag (Remover tag).

  6. Selecione Enviar.

Recursos de tag (CLI)

É possível usar a CLI para adicionar, atualizar ou remover tags em um recurso de conexões.

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 para obter o ARN da conexão.

  2. 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 chamada Projeto com o valor de tag de Projecta e uma chave de tag chamada ReadOnlycom o valor de tag 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 para obter o ARN do host.

  2. 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 chamada Projeto com o valor de tag de Projecta e uma chave de tag chamada IscontainerBasedcom o valor de tag 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 para obter o ARN da conexão.

  2. 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 para obter o ARN do host.

  2. 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 para obter o ARN da conexão.

  2. 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 para obter o ARN do host.

  2. 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 de tag Project e 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": []
}