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

# Projetos de compilação de tags
<a name="how-to-tag-project"></a>

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`, `Project` ou `Secret`). 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, esses são conhecidos como pares de chave-valor. Para obter informações sobre o número máximo de tags em um projeto e as restrições em relação a chaves e valores das tags, consulte [Tags](limits.md#tag-limits).

As tags ajudam você a identificar e organizar seus AWS recursos. Muitos AWS serviços oferecem suporte à marcação, então você pode atribuir a mesma tag a recursos de serviços diferentes para indicar que os recursos estão relacionados. Por exemplo, você pode atribuir a mesma tag a um CodeBuild projeto que você atribui a um bucket do S3. Para obter mais informações sobre o uso de tags, consulte [Tagging Best Practices](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html).

Em CodeBuild, os recursos primários são o projeto e o grupo de relatórios. Você pode usar o CodeBuild console, o AWS CLI CodeBuild APIs, ou AWS SDKs para adicionar, gerenciar e remover tags de um projeto. Além de identificar, organizar e monitorar o projeto com as tags, é possível usá-las em políticas do IAM para ajudar a controlar quem pode visualizar e interagir com o projeto. Para obter exemplos de políticas de acesso baseadas em tags, consulte [Usando tags para controlar o acesso aos AWS CodeBuild recursos](auth-and-access-control-using-tags.md).

**Importante**  
Ao usar o recurso de capacidade reservada, os dados armazenados em cache nas instâncias da frota, incluindo arquivos de origem, camadas do Docker e diretórios em cache especificados no buildspec, podem ser acessados por outros projetos na mesma conta. Isso ocorre por design e permite que projetos dentro da mesma conta compartilhem instâncias de frota.

**Topics**
+ [

# Adicionar uma tag a um projeto
](how-to-tag-project-add.md)
+ [

# Visualizar tags de um projeto
](how-to-tag-project-list.md)
+ [

# Editar tags de um projeto
](how-to-tag-project-update.md)
+ [

# Remover uma tag de um projeto
](how-to-tag-project-delete.md)

# Adicionar uma tag a um projeto
<a name="how-to-tag-project-add"></a>

Adicionar tags a um projeto pode ajudar você a identificar e organizar seus AWS recursos e gerenciar o acesso a eles. Primeiro, adicione uma ou mais tags (pares de chave/valor) a um projeto. Lembre-se de que há limites no número de tags que é possível ter em um projeto. Há restrições com relação aos caracteres que é possível usar nos campos chave e valor. Para obter mais informações, consulte [Tags](limits.md#tag-limits). Depois que tiver tags, será possível criar políticas do IAM para gerenciar o acesso ao projeto com base nessas tags. Você pode usar o CodeBuild console ou o AWS CLI para adicionar tags a um projeto. 

**Importante**  
Ao usar o recurso de capacidade reservada, os dados armazenados em cache nas instâncias da frota, incluindo arquivos de origem, camadas do Docker e diretórios em cache especificados no buildspec, podem ser acessados por outros projetos na mesma conta. Isso ocorre por design e permite que projetos dentro da mesma conta compartilhem instâncias de frota.

Para obter mais informações sobre como adicionar tags a um projeto ao criá-lo, consulte [Adicionar uma tag a um projeto (console)](#how-to-tag-project-add-console).

**Importante**  
Antes de adicionar uma tag a um projeto, revise as políticas do IAM que podem usar tags para controlar o acesso a recursos, como projetos de compilação. Para obter exemplos de políticas de acesso baseadas em tags, consulte [Usando tags para controlar o acesso aos AWS CodeBuild recursos](auth-and-access-control-using-tags.md).

**Topics**
+ [

## Adicionar uma tag a um projeto (console)
](#how-to-tag-project-add-console)
+ [

## Adicionar uma tag a um projeto (AWS CLI)
](#how-to-tag-project-add-cli)

## Adicionar uma tag a um projeto (console)
<a name="how-to-tag-project-add-console"></a>

Você pode usar o CodeBuild console para adicionar uma ou mais tags a um CodeBuild projeto. 

1. Abra o CodeBuild console em [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).

1. Em **Projetos de compilação**, escolha o nome do projeto ao qual deseja adicionar tags.

1. No painel de navegação, selecione **Configurações**. Escolha **Tags do projeto de compilação**.

1. Se nenhuma tag tiver sido adicionada ao projeto, escolha **Adicionar tag**. Caso contrário, selecione **Edit (Editar)** e **Add tag (Adicionar tag)**.

1. Em **Chave**, insira um nome para a tag. É possível adicionar um valor opcional para a tag em **Valor**. 

1. (Opcional) Para adicionar outra tag, selecione **Adicionar tag** novamente.

1. Quando terminar de adicionar tags, selecione **Enviar**.

## Adicionar uma tag a um projeto (AWS CLI)
<a name="how-to-tag-project-add-cli"></a>

Para adicionar uma tag a um projeto ao criá-lo, consulte [Crie um projeto de compilação (AWS CLI)](create-project.md#create-project-cli). Em `create-project.json`, adicione as tags.

Nestas etapas, partimos do princípio de que você já instalou uma versão recente da AWS CLI ou atualizou para a versão atual. Para obter mais informações, consulte [Instalar a AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html).

Se houver êxito, o comando não retornará nada.

# Visualizar tags de um projeto
<a name="how-to-tag-project-list"></a>

As tags podem ajudar você a identificar e organizar seus AWS recursos e gerenciar o acesso a eles. Para obter mais informações sobre o uso de tags, consulte o informe [Práticas recomendadas de marcação](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf). Para obter exemplos de políticas de acesso baseadas em tags, consulte [Usando tags para controlar o acesso aos AWS CodeBuild recursos](auth-and-access-control-using-tags.md).

## Visualizar tags de um projeto (console)
<a name="how-to-tag-project-list-console"></a>

Você pode usar o CodeBuild console para visualizar as tags associadas a um CodeBuild projeto. 

1. Abra o CodeBuild console em [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).

1. Em **Projetos de compilação**, escolha o nome do projeto no qual deseja visualizar tags.

1. No painel de navegação, selecione **Configurações**. Escolha **Tags do projeto de compilação**. 

## Visualizar tags de um projeto (AWS CLI)
<a name="how-to-tag-project-list-cli"></a>

Para visualizar tags de um projeto de compilação, execute o comando a seguir. Use o nome do projeto para o parâmetro `--names`.

```
aws codebuild batch-get-projects --names your-project-name
```

Se tiver êxito, esse comando retornará informações formatadas em JSON sobre o projeto de compilação que incluem algo como o seguinte:

```
{
    "tags": {
        "Status": "Secret",
        "Team": "JanesProject"
    }
}
```

Se o projeto não tiver tags, a seção `tags` estará vazia:

```
"tags": []
```

# Editar tags de um projeto
<a name="how-to-tag-project-update"></a>

É possível alterar o valor de uma tag associada a um projeto. Também é possível alterar o nome da chave, o que é equivalente a excluir a tag atual e adicionar outra com o novo nome e o mesmo valor da outra chave. Lembre-se de que há limites com relação aos caracteres que podem ser usados nos campos chave e valor. Para obter mais informações, consulte [Tags](limits.md#tag-limits).

**Importante**  
A edição de tags de um projeto pode afetar o acesso a ele. Antes de editar o nome (chave) ou o valor de uma tag de um projeto, revise as políticas do IAM que podem usar essa chave ou esse valor para uma tag a fim de controlar o acesso a recursos, como projetos de compilação. Para obter exemplos de políticas de acesso baseadas em tags, consulte [Usando tags para controlar o acesso aos AWS CodeBuild recursos](auth-and-access-control-using-tags.md).

## Editar uma tag de um projeto (console)
<a name="how-to-tag-project-update-console"></a>

Você pode usar o CodeBuild console para editar as tags associadas a um CodeBuild projeto. 

1. Abra o CodeBuild console em [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).

1. Em **Projetos de compilação**, escolha o nome do projeto do qual deseja editar tags.

1. No painel de navegação, selecione **Configurações**. Escolha **Tags do projeto de compilação**. 

1. Escolha **Editar**.

1. Execute um destes procedimentos:
   + Para alterar a tag, insira um novo nome em **Chave**. Alterar o nome da tag é equivalente a excluir uma tag e adicionar outra tag com o novo nome de chave.
   + Para alterar o valor de uma tag, insira um novo valor. Se você deseja alterar o valor para nulo, exclua o valor atual e deixe o campo em branco.

1. Quando terminar de editar as tags, selecione **Enviar**.

## Editar tags de um projeto (AWS CLI)
<a name="how-to-tag-project-update-cli"></a>

 Para adicionar, alterar ou excluir tags de um projeto de compilação, consulte [Alterar configurações de um projeto de compilação (AWS CLI)](change-project.md#change-project-cli). Atualize a seção `tags` nos dados formatados em JSON usados para atualizar o projeto. 

# Remover uma tag de um projeto
<a name="how-to-tag-project-delete"></a>

É possível remover uma ou mais tags associadas a um projeto. A remoção de uma tag não exclui a tag de outros AWS recursos associados a essa tag.

**Importante**  
A remoção de tags de um projeto pode afetar o acesso a ele. Antes de remover uma tag de um projeto, revise as políticas do IAM que podem usar a chave ou o valor para uma tag a fim de controlar o acesso a recursos, como projetos de compilação. Para obter exemplos de políticas de acesso baseadas em tags, consulte [Usando tags para controlar o acesso aos AWS CodeBuild recursos](auth-and-access-control-using-tags.md).

## Remover uma tag de um projeto (console)
<a name="how-to-tag-project-delete-console"></a>

Você pode usar o CodeBuild console para remover a associação entre uma tag e um CodeBuild projeto. 

1. Abra o CodeBuild console em [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/).

1. Em **Projetos de compilação**, escolha o nome do projeto do qual deseja remover tags.

1. No painel de navegação, selecione **Configurações**. Escolha **Tags do projeto de compilação**. 

1. Escolha **Editar**.

1. Encontre a tag que deseja excluir e selecione **Remover tag**.

1. Quando terminar de excluir tags, selecione **Enviar**.

## Remover uma tag de um projeto (AWS CLI)
<a name="how-to-tag-project-delete-cli"></a>

 Para excluir uma ou mais tags de um projeto de compilação, consulte [Alterar configurações de um projeto de compilação (AWS CLI)](change-project.md#change-project-cli). Atualize a seção `tags` nos dados formatados em JSON com uma lista atualizada de tags que não contenha as que você deseja excluir. Se quiser excluir todas as tags, atualize a seção `tags` para:

```
"tags: []"
```

**nota**  
Se você excluir um projeto de CodeBuild compilação, todas as associações de tags serão removidas do projeto de compilação excluído. Não é necessário remover as tags antes de excluir um projeto de compilação.