

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Etiquete una acción personalizada en CodePipeline
<a name="customactions-tag"></a>

Las etiquetas son pares clave-valor asociados AWS a los recursos. Puede utilizar la consola o la CLI para aplicar etiquetas a las acciones personalizadas de CodePipeline. Para obtener información sobre el etiquetado de CodePipeline recursos, los casos de uso, las restricciones de clave y valor de las etiquetas y los tipos de recursos compatibles, consulte. [Etiquetado de recursos](tag-resources.md)

Puede agregar, eliminar y actualizar los valores de las etiquetas de una acción personalizada. Puede añadir hasta 50 etiquetas a cada acción personalizada. 

**Topics**
+ [Incorporación de etiquetas en una acción personalizada](#customactions-tag-add)
+ [Visualización de las etiquetas de una acción personalizada](#customactions-tag-list)
+ [Edición de las etiquetas de una acción personalizada](#customactions-tag-update)
+ [Eliminación de etiquetas de una acción personalizada](#customactions-tag-delete)

## Incorporación de etiquetas en una acción personalizada
<a name="customactions-tag-add"></a>

Siga estos pasos para utilizar el AWS CLI para añadir una etiqueta a una acción personalizada. Para añadir una etiqueta a una acción personalizada al crearla, consulte [Crear y añadir una acción personalizada en CodePipeline](actions-create-custom-action.md).

En estos pasos, se presupone que ya ha instalado una versión reciente de la AWS CLI o que la ha actualizado a la versión actual. Para obtener más información, consulte [Instalación de la AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html).

En el terminal o la línea de comandos, ejecute el comando **tag-resource**, especificando el nombre de recurso de Amazon (ARN) de la acción personalizada a la que desea añadir la etiqueta, y la clave y el valor de la etiqueta que desea añadir. Puede añadir más de una etiqueta a una acción personalizada. Por ejemplo, para etiquetar una acción personalizada con dos etiquetas, una clave de etiqueta {{TestActionType}} con el valor de etiqueta de {{UnitTest}} y una clave de etiqueta {{ApplicationName}} con el valor de etiqueta 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}}
```

Si se ejecuta correctamente, este comando no devuelve nada.

## Visualización de las etiquetas de una acción personalizada
<a name="customactions-tag-list"></a>

Sigue estos pasos para utilizarla AWS CLI para ver las AWS etiquetas de una acción personalizada. Si no se han añadido etiquetas, la lista obtenida está vacía.

En el terminal o la línea de comandos, ejecute el comando **list-tags-for-resource**. Por ejemplo, para ver una lista de las claves y los valores de las etiquetas para una acción personalizada con el 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}}
```

Si se ejecuta correctamente, este comando proporciona información similar a la siguiente:

```
{
    "tags": {
        "TestActionType": "UnitTest",
        "ApplicationName": "MyApplication"
    }
}
```

## Edición de las etiquetas de una acción personalizada
<a name="customactions-tag-update"></a>

Sigue estos pasos para usar el AWS CLI para editar una etiqueta para una acción personalizada. Puede cambiar el valor de una clave existente o añadir otra clave. También puede eliminar etiquetas de una acción personalizada, tal y como se muestra en la sección siguiente.

En el terminal o la línea de comandos, ejecute el comando **tag-resource**, especificando el nombre de recurso de Amazon (ARN) de la acción personalizada en la que desea actualizar una etiqueta, y especifique la clave y el valor de la etiqueta:

```
aws codepipeline tag-resource --resource-arn arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:actiontype:{{Owner}}/{{Category}}/{{Provider}}/{{Version}} --tags key={{TestActionType}},value={{IntegrationTest}}
```

## Eliminación de etiquetas de una acción personalizada
<a name="customactions-tag-delete"></a>

Sigue estos pasos para usar el AWS CLI para eliminar una etiqueta de una acción personalizada. Cuando se quitan etiquetas del recurso asociado, las etiquetas se eliminan.

**nota**  
Si se elimina una acción personalizada, todas las asociaciones de etiquetas se quitan de la acción personalizada eliminada. No es necesario eliminar las etiquetas antes de eliminar una acción personalizada.

En el terminal o la línea de comandos, ejecute el comando **untag-resource**, especificando el ARN de la acción personalizada en la que desea eliminar las etiquetas y la clave de etiqueta de la etiqueta que desea eliminar. Por ejemplo, para eliminar una etiqueta de una acción personalizada con la clave de etiqueta{{TestActionType}}:

```
aws codepipeline untag-resource --resource-arn arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:actiontype:{{Owner}}/{{Category}}/{{Provider}}/{{Version}} --tag-keys {{TestActionType}}
```

Si se ejecuta correctamente, este comando no devuelve nada. Para verificar las etiquetas asociadas a la acción personalizada, ejecute el comando **list-tags-for-resource**.