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 uma ação personalizada em CodePipeline
As tags são pares de valores-chave associados AWS aos recursos. Você pode usar o console ou a CLI para aplicar tags às suas ações personalizadas 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 adicionar, remover e atualizar os valores de tags em uma ação personalizada. Você pode adicionar até 50 tags para cada ação personalizada.
**Topics**
+ [Adicionar tags a uma ação personalizada](#customactions-tag-add)
+ [Visualizar tags para uma ação personalizada](#customactions-tag-list)
+ [Editar tags para uma ação personalizada](#customactions-tag-update)
+ [Remover tags de uma ação personalizada](#customactions-tag-delete)
## Adicionar tags a uma ação personalizada
Siga estas etapas para usar o AWS CLI para adicionar uma tag a uma ação personalizada. Para adicionar uma tag a uma ação personalizada ao criá-la, consulte [Crie e adicione uma ação personalizada no CodePipeline](actions-create-custom-action.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) da ação personalizada na 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 uma ação personalizada. Por exemplo, para marcar uma ação personalizada com duas tags, uma chave de tag {{TestActionType}} com o valor de tag de {{UnitTest}} e uma chave de tag {{ApplicationName}} com o valor de tag de{{MyApplication}}:
```
aws codepipeline tag-resource --resource-arn arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:actiontype:{{Owner}}/{{Category}}/{{Provider}}/{{Version}} --tags key={{TestActionType}},value={{UnitTest}} key={{ApplicationName}},value={{MyApplication}}
```
Se houver êxito, o comando não retornará nada.
## Visualizar tags para uma ação personalizada
Siga estas etapas para usar o AWS CLI para visualizar as AWS tags de uma ação personalizada. 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 visualizar uma lista de chaves de tag e valores de tag para uma ação personalizada com o ARN `arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:actiontype:{{Owner}}/{{Category}}/{{Provider}}/{{Version}}`:
```
aws codepipeline list-tags-for-resource --resource-arn arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:actiontype:{{Owner}}/{{Category}}/{{Provider}}/{{Version}}
```
Se houver êxito, o comando retornará informações semelhantes às seguintes:
```
{
"tags": {
"TestActionType": "UnitTest",
"ApplicationName": "MyApplication"
}
}
```
## Editar tags para uma ação personalizada
Siga estas etapas para usar o AWS CLI para editar uma tag para uma ação personalizada. Você pode alterar o valor para uma chave existente ou adicionar outra chave. Você também pode remover tags de uma ação personalizada, como mostrado na próxima seção.
No terminal ou na linha de comando, execute o comando **tag-resource**, especificando o nome de recurso da Amazon (ARN) da ação personalizada onde 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}}:actiontype:{{Owner}}/{{Category}}/{{Provider}}/{{Version}} --tags key={{TestActionType}},value={{IntegrationTest}}
```
## Remover tags de uma ação personalizada
Siga estas etapas para usar o AWS CLI para remover uma tag de uma ação personalizada. Ao remover tags do recurso associado, as tags são excluídas.
**nota**
Se você excluir uma ação personalizada, todas as associações de tag são removidas da ação personalizada excluída. Você não precisa remover tags antes de excluir uma ação personalizada.
No terminal ou na linha de comando, execute o comando **untag-resource**, especificando o ARN da ação personalizada da qual deseja remover tags e a chave da tag que deseja remover. Por exemplo, para remover uma tag em uma ação personalizada com a chave da tag{{TestActionType}}:
```
aws codepipeline untag-resource --resource-arn arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:actiontype:{{Owner}}/{{Category}}/{{Provider}}/{{Version}} --tag-keys {{TestActionType}}
```
Se houver êxito, o comando não retornará nada. Para verificar as tags associadas com a ação personalizada, execute o comando **list-tags-for-resource**.