

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 un dominio en CodeArtifact
<a name="tag-domains"></a>

Las etiquetas son pares clave-valor asociados a los recursos de AWS. Puede aplicar etiquetas a sus dominios en CodeArtifact. Para obtener información sobre el etiquetado de CodeArtifact 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 utilizar la CLI para especificar etiquetas al crear un dominio. Puede utilizar la consola o la CLI para añadir o eliminar etiquetas, y para actualizar los valores de las etiquetas de un dominio. Puede agregar hasta 50 etiquetas a cada dominio.

**Topics**
+ [Etiquetado de dominios (CLI)](#tag-domains-tag-cli)
+ [Etiquetado de dominios (consola)](#tag-domains-console)

## Etiquetado de dominios (CLI)
<a name="tag-domains-tag-cli"></a>

Puede utilizar la CLI para administrar etiquetas de dominio.

**Topics**
+ [Agregado de etiquetas a un dominio (CLI)](#add-domains-tag-cli)
+ [Visualización de etiquetas de un dominio (CLI)](#list-domains-tag-cli)
+ [Edición de etiquetas de un dominio (CLI)](#update-domains-tag-cli)
+ [Eliminación de las etiquetas de un dominio (CLI)](#delete-domains-tag-cli)

### Agregado de etiquetas a un dominio (CLI)
<a name="add-domains-tag-cli"></a>

Puede utilizar la consola o la AWS CLI para etiquetar dominios.

Para añadir una etiqueta a un dominio al crearlo, consulte [Creación de un repositorio](create-repo.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) del dominio a la que desea añadir etiquetas, y la clave y el valor de la etiqueta que desea añadir.

**nota**  
Para obtener el ARN del dominio, ejecute el comando `describe-domain`:  

```
aws codeartifact describe-domain --domain {{my_domain}} --query domain.arn
```

Puede añadir más de una etiqueta a un dominio. Por ejemplo, para etiquetar un dominio {{my\_domain}} con dos etiquetas, una clave de etiqueta {{key1}} con el valor de etiqueta de {{value1}} y una clave de etiqueta {{key2}} con el valor de etiqueta de{{value2}}:

```
aws codeartifact tag-resource --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:domain/{{my_domain}} --tags key={{key1}},value={{value1}} key={{key2}},value={{value2}}
```

Si se ejecuta correctamente, este comando no genera ninguna salida.

### Visualización de etiquetas de un dominio (CLI)
<a name="list-domains-tag-cli"></a>

Sigue estos pasos para usar el AWS CLI para ver las AWS etiquetas de un dominio. Si no se han añadido etiquetas, la lista obtenida está vacía.

En el terminal o en la línea de comandos, ejecute el comando **list-tags-for-resource** con el nombre de recurso de Amazon (ARN) del dominio.

**nota**  
Para obtener el ARN del dominio, ejecute el comando `describe-domain`:  

```
aws codeartifact describe-domain --domain {{my_domain}} --query domain.arn
```

Por ejemplo, para ver una lista de claves y valores de etiquetas de un dominio denominado {{my\_domain}} con el valor `arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:domain/{{my_domain}}` ARN:

```
aws codeartifact list-tags-for-resource --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:domain/{{my_domain}}
```

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

```
{
    "tags": {
        "key1": "value1",
        "key2": "value2"
    }
}
```

### Edición de etiquetas de un dominio (CLI)
<a name="update-domains-tag-cli"></a>

Siga estos pasos para usar el AWS CLI para editar una etiqueta de un dominio. Puede cambiar el valor de una clave existente o añadir otra clave. También puede eliminar etiquetas de un dominio, 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 ARN del dominio en el que desea actualizar una etiqueta y especifique la clave y el valor de la etiqueta:

**nota**  
Para obtener el ARN del dominio, ejecute el comando `describe-domain`:  

```
aws codeartifact describe-domain --domain {{my_domain}} --query domain.arn
```

```
aws codeartifact tag-resource --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:domain/{{my_domain}} --tags key={{key1}},value={{newvalue1}}
```

Si se ejecuta correctamente, este comando no genera ninguna salida.

### Eliminación de las etiquetas de un dominio (CLI)
<a name="delete-domains-tag-cli"></a>

Sigue estos pasos para usar el AWS CLI para eliminar una etiqueta de un dominio.

**nota**  
Si elimina un dominio, todas las asociaciones de etiquetas se quitan del dominio eliminado. No es necesario eliminar las etiquetas antes de eliminar un dominio.

En el terminal o la línea de comandos, ejecute el comando **untag-resource**, especificando el ARN del dominio cuya etiqueta desea quitar y la clave de la etiqueta que desea quitar.

**nota**  
Para obtener el ARN del dominio, ejecute el comando `describe-domain`:  

```
aws codeartifact describe-domain --domain {{my_domain}} --query domain.arn
```

Por ejemplo, para eliminar varias etiquetas de un dominio denominado {{mydomain}} con las claves de etiqueta {{key1}} y{{key2}}:

```
aws codeartifact untag-resource --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:domain/{{my_domain}} --tag-keys {{key1}} {{key2}}
```

Si se ejecuta correctamente, este comando no genera ninguna salida. Tras eliminar las etiquetas, puede ver las etiquetas restantes del dominio con el comando `list-tags-for-resource`.

## Etiquetado de dominios (consola)
<a name="tag-domains-console"></a>

Puede utilizar la consola o la CLI para etiquetar recursos.

**Topics**
+ [Agregado de etiquetas a un dominio (consola)](#add-tag-domains-console)
+ [Visualización de etiquetas de un dominio (consola)](#list-tag-domains-console)
+ [Edición de etiquetas de un dominio (consola)](#update-tag-domains-console)
+ [Eliminación de las etiquetas de un dominio (consola)](#delete-tag-domains-console)

### Agregado de etiquetas a un dominio (consola)
<a name="add-tag-domains-console"></a>

Puede utilizar la consola para añadir etiquetas a un dominio existente.

1. Abre la AWS CodeArtifact consola en [https://console.aws.amazon.com/codesuite/codeartifact/home](https://console.aws.amazon.com/codesuite/codeartifact/home).

1. En la página **Dominios**, elija el dominio al que desea agregar etiquetas.

1. Amplíe la sección **Detalles**.

1. En **Etiquetas de dominio**, seleccione **Agregar etiquetas de dominio** si no hay etiquetas en el dominio o seleccione **Ver y editar etiquetas de dominio** si las hay.

1. Elija **Añadir nueva etiqueta**.

1. En los campos **Clave** y **Valor**, introduzca el texto para cada etiqueta que desee agregar. (El campo **Valor** es opcional). Por ejemplo, en **Clave**, escriba **Name**. En **Valor**, escriba **Test**.  
![La configuración del dominio.](http://docs.aws.amazon.com/es_es/codeartifact/latest/ug/images/domain-add-tag-console.png)

1. (Opcional) Haga clic en **Añadir etiqueta** para añadir más filas e introducir más etiquetas.

1. Elija **Actualizar dominio**.

### Visualización de etiquetas de un dominio (consola)
<a name="list-tag-domains-console"></a>

Puede utilizar la consola para obtener una lista de las etiquetas de los dominios existentes.

1. [Abre la consola en AWS CodeArtifact codeartifact/home. https://console.aws.amazon.com/codesuite/](https://console.aws.amazon.com/codesuite/codeartifact/home)

1. En la página **Dominios**, elija el dominio en el que quiere ver las etiquetas.

1. Amplíe la sección **Detalles**.

1. En **Etiquetas de dominio**, seleccione **Ver y editar etiquetas de dominio**.
**nota**  
Si no se ha agregado ninguna etiqueta a este dominio, la consola mostrará **Agregar etiquetas de dominio**.

### Edición de etiquetas de un dominio (consola)
<a name="update-tag-domains-console"></a>

Puede utilizar la consola para editar las etiquetas que se han añadido al dominio.

1. [Abre la consola en AWS CodeArtifact codeartifact/home. https://console.aws.amazon.com/codesuite/](https://console.aws.amazon.com/codesuite/codeartifact/home)

1. En la página **Dominios**, elija el dominio en el que quiere actualizar las etiquetas.

1. Amplíe la sección **Detalles**.

1. En **Etiquetas de dominio**, seleccione **Ver y editar etiquetas de dominio**.
**nota**  
Si no se ha agregado ninguna etiqueta a este dominio, la consola mostrará **Agregar etiquetas de dominio**.

1. En los campos **Clave** y **Valor**, actualice los valores que sean necesarios. Por ejemplo, para la clave **Name**, en **Valor**, cambie **Test** a **Prod**.

1. Elija **Actualizar dominio**.

### Eliminación de las etiquetas de un dominio (consola)
<a name="delete-tag-domains-console"></a>

Puede utilizar la consola para eliminar etiquetas de dominios.

1. [Abre la consola en AWS CodeArtifact codeartifact/home. https://console.aws.amazon.com/codesuite/](https://console.aws.amazon.com/codesuite/codeartifact/home)

1. En la página **Dominios**, elija el dominio del que quiere eliminar las etiquetas.

1. Amplíe la sección **Detalles**.

1. En **Etiquetas de dominio**, seleccione **Ver y editar etiquetas de dominio**.
**nota**  
Si no se ha agregado ninguna etiqueta a este dominio, la consola mostrará **Agregar etiquetas de dominio**.

1. Junto a la clave y el valor de cada etiqueta que desea eliminar, elija **Eliminar**.

1. Elija **Actualizar dominio**.