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.
# Etiquetar repositorios en AWS CodeCommit
Una *etiqueta* es una etiqueta de atributo personalizada que usted o AWS asigna a un AWS recurso. AWS las etiquetas son diferentes de las etiquetas de Git, que se pueden aplicar a las confirmaciones. Cada AWS etiqueta consta de dos partes:
+ Una *clave de etiqueta* (por ejemplo, `CostCenter`, `Environment`, `Project` o `Secret`). Las claves de etiquetas distinguen entre mayúsculas y minúsculas.
+ Un campo opcional que se denomina *valor de etiqueta* (por ejemplo, `111122223333`, `Production` o el nombre de un equipo). Omitir el valor de etiqueta es lo mismo que utilizar una cadena vacía. Al igual que las claves de etiquetas, los valores de las etiquetas distinguen mayúsculas de minúsculas.
En conjunto, se conocen como pares clave-valor. Para conocer los límites del número de etiquetas que puede tener en un repositorio y las restricciones sobre las claves y valores de las etiquetas, consulte [Límites](limits.md#limits-tags).
Las etiquetas ayudan a identificar y organizar AWS los recursos. Muchos AWS servicios admiten el etiquetado, por lo que puede asignar la misma etiqueta a los recursos de diferentes servicios para indicar que los recursos están relacionados. Por ejemplo, puede asignar la misma etiqueta a un CodeCommit repositorio que a un bucket de Amazon S3. Para obtener más información sobre las estrategias de etiquetado, consulte [Tagging AWS](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) Resources.
En CodeCommit, el recurso principal es un repositorio. Puede utilizar la CodeCommit consola, la AWS CLI CodeCommit APIs, o AWS SDKs para añadir, gestionar y eliminar etiquetas de un repositorio. Además de utilizar etiquetas para identificar, organizar y realizar el seguimiento de del repositorio, puede utilizarlas en las políticas de IAM para ayudar a controlar quién puede ver e interactuar con el repositorio. Para ver ejemplos de políticas de acceso basadas en etiquetas, consulte [Ejemplo 5: denegar o permitir acciones en repositorios con etiquetas](customer-managed-policies.md#identity-based-policies-example-5).
**Topics**
+ [Añadir una etiqueta a un repositorio](how-to-tag-repository-add.md)
+ [Visualización de etiquetas para un repositorio](how-to-tag-repository-list.md)
+ [Editar etiquetas de un repositorio](how-to-tag-repository-update.md)
+ [Eliminar una etiqueta de un repositorio](how-to-tag-repository-delete.md)
# Añadir una etiqueta a un repositorio
Añadir etiquetas a un repositorio puede ayudarte a identificar y organizar tus AWS recursos y a gestionar el acceso a ellos. En primer lugar, añada una o más etiquetas (pares clave-valor) a un repositorio. Tenga en cuenta que hay límites en el número de etiquetas que puede tener en un repositorio. Existen restricciones sobre los caracteres que se pueden utilizar en los campos de clave y valor. Para obtener más información, consulte [Límites](limits.md#limits-tags). Después de tener etiquetas, puede crear políticas de IAM para administrar el acceso al repositorio basándose en estas etiquetas. Puedes usar la CodeCommit consola o la AWS CLI para añadir etiquetas a un repositorio.
**importante**
Añadir etiquetas a un repositorio puede afectar al acceso a dicho repositorio. Antes de añadir una etiqueta a un repositorio, asegúrese de revisar las políticas de IAM que puedan utilizar etiquetas para controlar el acceso a recursos como los repositorios. Para ver ejemplos de políticas de acceso basadas en etiquetas, consulte [Ejemplo 5: denegar o permitir acciones en repositorios con etiquetas](customer-managed-policies.md#identity-based-policies-example-5).
Para obtener más información sobre cómo añadir etiquetas a un repositorio al crearlo, consulte [Crear un repositorio (Consola)](how-to-create-repository.md#how-to-create-repository-console).
**Topics**
+ [Añadir una etiqueta a un repositorio (consola)](#how-to-tag-repository-add-console)
+ [Añadir una etiqueta a un repositorio (AWS CLI)](#how-to-tag-repository-add-cli)
## Añadir una etiqueta a un repositorio (consola)
Puede utilizar la CodeCommit consola para añadir una o más etiquetas a un CodeCommit repositorio.
1. Abre la CodeCommit consola en [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. En **Repositories (Repositorios)**, elija el nombre del repositorio al que desea añadir etiquetas.
1. En el panel de navegación, seleccione **Configuración**. Elija **Repository tags (Etiquetas de repositorio)**.
1. Si no se han añadido etiquetas al repositorio, seleccione **Add tag (Añadir etiqueta)**. De lo contrario, elija **Edit (Editar)** y, a continuación, seleccione **Add tag (Añadir etiqueta)**.
1. En **Clave**, escriba un nombre para la etiqueta. Puede agregar un valor opcional para la etiqueta en **Valor**.
![\[Añadir una etiqueta a un repositorio\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-repository-tags-edit.png)
1. (Opcional) Para añadir otra etiqueta, vuelva a elegir **Add tag (Añadir etiqueta)**.
1. Cuando haya terminado de añadir etiquetas, seleccione **Submit (Enviar)**.
## Añadir una etiqueta a un repositorio (AWS CLI)
Sigue estos pasos para usar el para añadir una etiqueta AWS CLI a un repositorio. CodeCommit Para agregar una etiqueta a un repositorio al crearlo, consulte [Creación de un repositorio (AWS CLI)](how-to-create-repository.md#how-to-create-repository-cli).
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 en la línea de comandos, ejecute el comando **tag-resource**, especificando el nombre de recurso de Amazon (ARN) del repositorio al que desea agregar etiquetas y la clave y el valor de la etiqueta que desea agregar. Puede agregar más de una etiqueta a un repositorio. Por ejemplo, para etiquetar un repositorio *MyDemoRepo* con dos etiquetas, una clave de etiqueta *Status* con el valor de etiqueta de *Secret* y una clave de etiqueta *Team* con el valor de etiqueta de*Saanvi*:
```
aws codecommit tag-resource --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo --tags Status=Secret,Team=Saanvi
```
Si se ejecuta correctamente, este comando no devuelve nada.
# Visualización de etiquetas para un repositorio
Las etiquetas pueden ayudarte a identificar y organizar tus AWS recursos y a administrar el acceso a ellos. Para obtener más información sobre las estrategias de etiquetado, consulte [Etiquetado AWS](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) de recursos. Para ver ejemplos de políticas de acceso basadas en etiquetas, consulte [Ejemplo 5: denegar o permitir acciones en repositorios con etiquetas](customer-managed-policies.md#identity-based-policies-example-5).
## Ver etiquetas de un repositorio (consola)
Puedes usar la CodeCommit consola para ver las etiquetas asociadas a un CodeCommit repositorio.
1. Abre la CodeCommit consola en [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. En **Repositories (Repositorios)**, elija el nombre del repositorio cuyas etiquetas desea ver.
1. En el panel de navegación, seleccione **Configuración**. Elija **Repository tags (Etiquetas de repositorio)**.
![\[Ver las etiquetas de un repositorio\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-repository-tags-view.png)
## Ver etiquetas de un repositorio (AWS CLI)
Sigue estos pasos para usar el AWS CLI para ver las AWS etiquetas de un repositorio. CodeCommit 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 de etiqueta y valores de etiquetas para un repositorio denominado *MyDemoRepo* con el ARN *arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo*:
```
aws codecommit list-tags-for-resource --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo
```
Si se ejecuta correctamente, este comando proporciona información similar a la siguiente:
```
{
"tags": {
"Status": "Secret",
"Team": "Saanvi"
}
}
```
# Editar etiquetas de un repositorio
Puede cambiar el valor de una etiqueta asociada a un repositorio. También puede cambiar el nombre de la clave, lo que equivale a eliminar la etiqueta actual y añadir otra distinta con el nuevo nombre y el mismo valor que la otra clave. Tenga en cuenta que hay límites en los caracteres que puede utilizar en los campos de clave y valor. Para obtener más información, consulte [Límites](limits.md#limits-tags).
**importante**
Editar las etiquetas de un repositorio puede afectar al acceso a dicho repositorio. Antes de editar el nombre (clave) o valor de una etiqueta de un repositorio, asegúrese de revisar cualquier política de IAM que pueda usar la clave o el valor de una etiqueta para controlar el acceso a recursos como los repositorios. Para ver ejemplos de políticas de acceso basadas en etiquetas, consulte [Ejemplo 5: denegar o permitir acciones en repositorios con etiquetas](customer-managed-policies.md#identity-based-policies-example-5).
## Editar una etiqueta de un repositorio (consola)
Puede utilizar la CodeCommit consola para editar las etiquetas asociadas a un CodeCommit repositorio.
1. Abre la CodeCommit consola en [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. En **Repositories (Repositorios)**, elija el nombre del repositorio cuyas etiquetas desea editar.
1. En el panel de navegación, seleccione **Configuración**. Elija **Repository tags (Etiquetas de repositorio)**.
1. Elija **Edit (Edición de)**.
1.
![\[Edición del valor de una etiqueta de un repositorio\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-repository-tags-edit2.png)
Realice una de las siguientes acciones:
+ Para cambiar la etiqueta, escriba un nuevo nombre en **Key (Clave)**. Cambiar el nombre de la etiqueta equivale a quitar una etiqueta y añadir otra nueva con el nuevo nombre de clave.
+ Para cambiar el valor de una etiqueta, escriba un nuevo valor. Si desea cambiar el valor por nada, elimine el valor actual y deje el campo en blanco.
1. Cuando haya terminado de editar las etiquetas, seleccione **Submit (Enviar)**.
## Editar etiquetas de un repositorio (AWS CLI)
Sigue estos pasos para usar el AWS CLI para actualizar una etiqueta de un repositorio. CodeCommit Puede cambiar el valor de una clave existente o añadir otra clave.
En el terminal o en la línea de comandos, ejecute el comando **tag-resource**, especificando el nombre de recurso de Amazon (ARN) del repositorio donde desea actualizar una etiqueta, y especifique la clave y el valor de la etiqueta:
```
aws codecommit tag-resource --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo --tags Team=Li
```
# Eliminar una etiqueta de un repositorio
Puede eliminar una o más etiquetas asociadas a un repositorio. Al eliminar una etiqueta, no se elimina la etiqueta de otros AWS recursos que estén asociados a esa etiqueta.
**importante**
Eliminar las etiquetas de un repositorio puede afectar al acceso a dicho repositorio. Antes de eliminar una etiqueta de un repositorio, asegúrese de revisar cualquier política de IAM que pueda utilizar la clave o el valor de una etiqueta para controlar el acceso a recursos como los repositorios. Para ver ejemplos de políticas de acceso basadas en etiquetas, consulte [Ejemplo 5: denegar o permitir acciones en repositorios con etiquetas](customer-managed-policies.md#identity-based-policies-example-5).
## Eliminar una etiqueta de un repositorio (consola)
Puedes usar la CodeCommit consola para eliminar la asociación entre una etiqueta y un CodeCommit repositorio.
1. Abre la CodeCommit consola en [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. En **Repositories (Repositorios)**, elija el nombre del repositorio cuyas etiquetas desea eliminar.
1. En el panel de navegación, seleccione **Configuración**. Elija **Repository tags (Etiquetas de repositorio)**.
1. Elija **Edit (Edición de)**.
1. Busque la etiqueta que desea eliminar y, a continuación, seleccione **Remove tag (Eliminar etiqueta)**.
1. Cuando haya terminado de eliminar las etiquetas, seleccione **Submit (Enviar)**.
## Eliminar una etiqueta de un repositorio (AWS CLI)
Sigue estos pasos para usar el AWS CLI para eliminar una etiqueta de un repositorio. CodeCommit Al quitar una etiqueta no la elimina, sino que simplemente elimina la asociación entre la etiqueta y el repositorio.
**nota**
Si eliminas un CodeCommit repositorio, todas las asociaciones de etiquetas se eliminarán del repositorio eliminado. No es necesario quitar las etiquetas antes de eliminar un repositorio.
En el terminal o en la línea de comandos, ejecute el comando **untag-resource**, especificando el nombre de recurso de Amazon (ARN) del repositorio donde desea quitar etiquetas y la clave de la etiqueta que desea quitar. Por ejemplo, para eliminar una etiqueta de un repositorio denominado *MyDemoRepo* con la clave de etiqueta*Status*:
```
aws codecommit untag-resource --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo --tag-keys Status
```
Si se ejecuta correctamente, este comando no devuelve nada. Para verificar las etiquetas asociadas con el repositorio, ejecute el comando **list-tags-for-resource**.