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

# Marque um funil em CodePipeline
<a name="pipelines-tag"></a>

As tags são pares de valores-chave associados AWS aos recursos. Você pode aplicar tags aos pipelines no CodePipeline. Para obter informações sobre marcação de CodePipeline recursos, casos de uso, restrições de valor e chave de tag e tipos de recursos compatíveis, consulte. [Marcando atributos](tag-resources.md)

Você pode usar a CLI para especificar tags ao criar um pipeline. Você pode usar o console ou a CLI para adicionar ou remover tags e atualizar os valores de tags em um pipeline. Você pode adicionar até 50 tags para cada pipeline.

**Topics**
+ [Marcar pipelines (console)](#pipelines-tag-console)
+ [Marcar pipelines (CLI)](#pipelines-tag-cli)

## Marcar pipelines (console)
<a name="pipelines-tag-console"></a>

Você pode usar o console ou a CLI para marcar recursos. Os pipelines são os únicos recursos do CodePipeline que podem ser gerenciados com o console ou a CLI.

**Topics**
+ [Adicionar tags a um pipeline (console)](#pipelines-tag-add-console)
+ [Visualizar tags de um pipeline (console)](#pipelines-tag-list-console)
+ [Editar tags de um pipeline (console)](#pipelines-tag-update-console)
+ [Remover tags de um pipeline (console)](#pipelines-tag-delete-console)

### Adicionar tags a um pipeline (console)
<a name="pipelines-tag-add-console"></a>

Você pode usar o console para adicionar tags a um pipeline existente.

1. Faça login no Console de gerenciamento da AWS e abra o CodePipeline console em [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).

1. Na página **Pipelines**, selecione o pipeline ao qual você deseja adicionar tags.

1. No painel de navegação, escolha **Settings (Configurações)**.

1. Em **Pipeline tags (Tags do pipeline)**, escolha **Edit (Editar)**.

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 de pipeline.

### Visualizar tags de um pipeline (console)
<a name="pipelines-tag-list-console"></a>

Você pode usar o console para listar tags de pipelines existentes.

1. Faça login no Console de gerenciamento da AWS e abra o CodePipeline console em [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).

1. Na página **Pipelines**, selecione o pipeline no qual você deseja visualizar tags.

1. No painel de navegação, escolha **Settings (Configurações)**.

1. Em **Pipeline tags (Tags do pipeline)**, visualize as tags para o pipeline nas colunas **Key (Chave)** e **Value (Valor)**.

### Editar tags de um pipeline (console)
<a name="pipelines-tag-update-console"></a>

Você pode usar o console para editar as tags adicionadas a pipelines.

1. Faça login no Console de gerenciamento da AWS e abra o CodePipeline console em [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).

1. Na página **Pipelines**, selecione o pipeline no qual você deseja atualizar tags.

1. No painel de navegação, escolha **Settings (Configurações)**.

1. Em **Pipeline tags (Tags do pipeline)**, escolha **Edit (Editar)**.

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 pipeline (console)
<a name="pipelines-tag-delete-console"></a>

Você pode usar o console para excluir tags de pipelines. Ao remover tags do recurso associado, as tags são excluídas.

1. Faça login no Console de gerenciamento da AWS e abra o CodePipeline console em [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).

1. Na página **Pipelines**, selecione o pipeline do qual você deseja remover tags.

1. No painel de navegação, escolha **Settings (Configurações)**.

1. Em **Pipeline tags (Tags do pipeline)**, escolha **Edit (Editar)**.

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

1. Selecione **Enviar**.

## Marcar pipelines (CLI)
<a name="pipelines-tag-cli"></a>

Você pode usar a CLI para marcar recursos. Você deve usar o console para gerenciar tags em pipelines.

**Topics**
+ [Adicionar tags a um pipeline (CLI)](#pipelines-tag-add-cli)
+ [Visualizar tags de um pipeline (CLI)](#pipelines-tag-list-cli)
+ [Editar tags de um pipeline (CLI)](#pipelines-tag-update-cli)
+ [Remover tags de um pipeline (CLI)](#pipelines-tag-delete-cli)

### Adicionar tags a um pipeline (CLI)
<a name="pipelines-tag-add-cli"></a>

Você pode usar o console ou o AWS CLI para marcar pipelines.

Para adicionar uma tag a um pipeline ao criá-lo, consulte [Criar um pipeline, estágios e ações](pipelines-create.md).

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

No terminal ou na linha de comando, execute o comando **tag-resource**, especificando o nome de recurso da Amazon (ARN) do pipeline no qual você deseja adicionar tags e a chave e o valor da tag que você deseja adicionar. Você pode adicionar mais de uma tag a um pipeline. Por exemplo, para marcar um pipeline chamado {{MyPipeline}} com duas tags, uma chave de tag {{DeploymentEnvironment}} com o valor de tag de {{Test}} e uma chave de tag {{IscontainerBased}} com o valor de tag de{{true}}:

```
aws codepipeline tag-resource --resource-arn arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:{{MyPipeline}} --tags key={{Project}},value={{ProjectA}} key={{IscontainerBased}},value={{true}}
```

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

### Visualizar tags de um pipeline (CLI)
<a name="pipelines-tag-list-cli"></a>

Siga estas etapas para usar o AWS CLI para visualizar as AWS tags de um pipeline. Se não foram adicionadas tags, a lista retornará vazia.

No terminal ou na linha de comando, execute o comando **list-tags-for-resource**. Por exemplo, para ver uma lista de chaves e valores de tag para um pipeline chamado {{MyPipeline}} com o valor `arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:{{MyPipeline}}` ARN:

```
aws codepipeline list-tags-for-resource --resource-arn arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:{{MyPipeline}}
```

Se houver êxito, o comando retornará informações semelhantes às seguintes:

```
{
    "tags": {
        "Project": "ProjectA",
        "IscontainerBased": "true"
    }
}
```

### Editar tags de um pipeline (CLI)
<a name="pipelines-tag-update-cli"></a>

Siga estas etapas para usar o AWS CLI para editar uma tag para um funil. Você pode alterar o valor para uma chave existente ou adicionar outra chave. Você também pode remover tags de um pipeline, como mostrado na próxima seção.

No terminal ou na linha de comando, execute o comando **tag-resource**, especificando o ARN do pipeline em que você deseja atualizar uma tag e especifique a chave e o valor da tag:

```
aws codepipeline tag-resource --resource-arn arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:{{MyPipeline}} --tags key={{Project}},value={{ProjectA}}
```

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

### Remover tags de um pipeline (CLI)
<a name="pipelines-tag-delete-cli"></a>

Siga estas etapas para usar o AWS CLI para remover uma tag de um pipeline. Ao remover tags do recurso associado, as tags são excluídas.

**nota**  
Se você excluir um pipeline, todas as associações de tag serão removidas do pipeline excluído. Você não precisa remover as tags antes de excluir um pipeline.

No terminal ou na linha de comando, execute o comando **untag-resource**, especificando o ARN do pipeline de onde você deseja remover tags e a chave da tag que você deseja remover. Por exemplo, para remover várias tags em um pipeline chamado {{MyPipeline}} com as chaves de tag {{Project}} e{{IscontainerBased}}:

```
aws codepipeline untag-resource --resource-arn arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:{{MyPipeline}} --tag-keys {{Project}} {{IscontainerBased}}
```

Se houver êxito, o comando não retornará nada. Para verificar as tags associadas ao pipeline, execute o comando **list-tags-for-resource**.