Etiquetado de recursos de conexiones

Una etiqueta es una etiqueta de atributo personalizada que usted o AWS asigna a un AWS recurso. Cada AWS etiqueta consta de dos partes:

• Una clave de etiqueta (por ejemplo, CostCenter, Environment o Project). Las claves de etiqueta distinguen entre mayúsculas y minúsculas.

• Un campo opcional que se denomina valor de etiqueta (por ejemplo, 111122223333 o Productiono 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 etiqueta, los valores de etiqueta distinguen entre mayúsculas y minúsculas.

En conjunto, se conocen como pares clave-valor.

Puedes usar la consola o la CLI para etiquetar los recursos.

Puede etiquetar los siguientes tipos de recursos en AWS CodeConnections:

• Conexiones

• Anfitriones

En estos pasos se da por sentado que ya ha instalado una versión reciente de la versión actual AWS CLI o que la ha actualizado. Para obtener más información, consulte Installing the AWS CLI en la Guía del usuario de AWS Command Line Interface .

Además de identificar, organizar y realizar un seguimiento del recurso mediante etiquetas, puede utilizar las etiquetas en las políticas AWS Identity and Access Management (IAM) para controlar quién puede ver el recurso e interactuar con él. Para ver ejemplos de políticas de acceso basadas en etiquetas, consulte Uso de etiquetas para controlar el acceso a AWS CodeConnections los recursos.

Etiquetado de recursos (consola)

Puede utilizar la consola para agregar, actualizar o eliminar etiquetas en un recurso de conexiones.

Temas

• Agregado de etiquetas a un recurso de conexiones (consola)
• Visualización de etiquetas de un recurso de conexiones (consola)
• Edición de etiquetas de un recurso de conexiones (consola)
• Eliminación de etiquetas de un recurso de conexiones (consola)

Agregado de etiquetas a un recurso de conexiones (consola)

Puede utilizar la consola para agregar etiquetas a una conexión o un alojamiento existente.

nota

Al crear una conexión para un proveedor instalado, como GitHub Enterprise Server, y también se crea un recurso de host para usted, las etiquetas durante la creación se añaden únicamente a la conexión. Esto permite etiquetar un alojamiento por separado si desea reutilizarlo para una conexión nueva. Si desea agregar etiquetas al alojamiento, siga los pasos a continuación.

Para agregar etiquetas para una conexión

1. Inicie sesión en la consola de . En el panel de navegación, seleccione Configuración.

2. En Settings (Configuración), elija Connections (Conexiones). Elija la pestaña Connections (Conexiones).

3. Elija la conexión que desea editar. Se muestra la página de configuración de conexión.

4. En Connection tags (Etiquetas de conexión), elija Edit (Editar). Se muestra la página Edit Connection tags (Editar etiquetas de conexión).

5. En los campos Key (Clave) y Value (Valor), escriba un par de claves para cada conjunto de etiquetas que desea añadir. (El campo Value (Valor) es opcional). Por ejemplo, en Key (Clave), escriba Project. En Valor, escriba ProjectA.

   

6. (Opcional) ElijaAdd tag (Añadir etiqueta) para añadir más filas y escribir más etiquetas.

7. Elija Enviar. Las etiquetas se encuentran en la configuración de la conexión.

Para agregar etiquetas para un alojamiento

1. Inicie sesión en la consola de . En el panel de navegación, seleccione Configuración.

2. En Settings (Configuración), elija Connections (Conexiones). Elija la pestaña Hosts (Alojamientos).

3. Elija el alojamiento que desea editar. Se muestra la página de configuración de alojamiento.

4. En Host tags (Etiquetas del alojamiento), elija Edit (Editar). Se muestra la página Host tags (Etiquetas del alojamiento).

5. En los campos Key (Clave) y Value (Valor), escriba un par de claves para cada conjunto de etiquetas que desea añadir. (El campo Value (Valor) es opcional). Por ejemplo, en Key (Clave), escriba Project. En Valor, escriba ProjectA.

   

6. (Opcional) Elija Add tag (Agregar etiqueta) para agregar más filas e ingresar más etiquetas para un alojamiento.

7. Elija Enviar. Las etiquetas se encuentran en la configuración del alojamiento.

Visualización de etiquetas de un recurso de conexiones (consola)

Puede utilizar la consola para ver las etiquetas de recursos existentes.

Para ver etiquetas de una conexión

1. Inicie sesión en la consola de . En el panel de navegación, seleccione Configuración.

2. En Settings (Configuración), elija Connections (Conexiones). Elija la pestaña Connections (Conexiones).

3. Elija la conexión que desea ver. Se muestra la página de configuración de conexión.

4. En Connection tags (Etiquetas de conexión), puede ver las etiquetas de la conexión en las columnas Key (Clave) y Value (Valor).

Para ver etiquetas de un alojamiento

1. Inicie sesión en la consola de . En el panel de navegación, seleccione Configuración.

2. En Settings (Configuración), elija Connections (Conexiones). Elija la pestaña Hosts (Alojamientos).

3. Elija el alojamiento que desea ver.

4. En Host tags (Etiquetas del alojamiento), puede ver las etiquetas del alojamiento en las columnas Key (Clave) y Value (Valor).

Edición de etiquetas de un recurso de conexiones (consola)

Puede utilizar la consola para editar las etiquetas que se han agregado a los recursos de conexiones.

Para editar etiquetas de una conexión

1. Inicie sesión en la consola de . En el panel de navegación, seleccione Configuración.

2. En Settings (Configuración), elija Connections (Conexiones). Elija la pestaña Connections (Conexiones).

3. Elija la conexión que desea editar. Se muestra la página de configuración de conexión.

4. En Connection tags (Etiquetas de conexión), elija Edit (Editar). Se muestra la página Connection tags (Etiquetas de conexión).

5. En los campos Key (Clave) y Value (Valor), actualice los valores que sean necesarios. Por ejemplo, para la clave Project, en Value (Valor), cambie ProjectA a ProjectB.

6. Elija Enviar.

Para editar etiquetas de un alojamiento

1. Inicie sesión en la consola de . En el panel de navegación, seleccione Configuración.

2. En Settings (Configuración), elija Connections (Conexiones). Elija la pestaña Hosts (Alojamientos).

3. Elija el alojamiento que desea editar. Se muestra la página de configuración de alojamiento.

4. En Host tags (Etiquetas del alojamiento), elija Edit (Editar). Se muestra la página Host tags (Etiquetas del alojamiento).

5. En los campos Key (Clave) y Value (Valor), actualice los valores que sean necesarios. Por ejemplo, para la clave Project, en Value (Valor), cambie ProjectA a ProjectB.

6. Elija Enviar.

Eliminación de etiquetas de un recurso de conexiones (consola)

Puede utilizar la consola para eliminar etiquetas de recursos de conexiones. Cuando se quitan etiquetas del recurso asociado, las etiquetas se eliminan.

Para eliminar etiquetas de una conexión

1. Inicie sesión en la consola de . En el panel de navegación, seleccione Configuración.

2. En Settings (Configuración), elija Connections (Conexiones). Elija la pestaña Connections (Conexiones).

3. Elija la conexión que desea editar. Se muestra la página de configuración de conexión.

4. En Connection tags (Etiquetas de conexión), elija Edit (Editar). Se muestra la página Connection tags (Etiquetas de conexión).

5. Junto a la clave y el valor de cada etiqueta que desea eliminar, elija Remove tag (Quitar etiqueta).

6. Elija Enviar.

Para eliminar etiquetas de un alojamiento

1. Inicie sesión en la consola de . En el panel de navegación, seleccione Configuración.

2. En Settings (Configuración), elija Connections (Conexiones). Elija la pestaña Hosts (Alojamientos).

3. Elija el alojamiento que desea editar. Se muestra la página de configuración de alojamiento.

4. En Host tags (Etiquetas del alojamiento), elija Edit (Editar). Se muestra la página Host tags (Etiquetas del alojamiento).

5. Junto a la clave y el valor de cada etiqueta que desea eliminar, elija Remove tag (Quitar etiqueta).

6. Elija Enviar.

Etiquete los recursos (CLI)

Puede usarlo CLI para ver, agregar, actualizar o eliminar etiquetas en un recurso de conexiones.

Temas

• Agregar etiquetas a un recurso de conexiones (CLI)
• Ver las etiquetas de un recurso de conexiones (CLI)
• Edite las etiquetas de un recurso de conexiones (CLI)
• Eliminar etiquetas de un recurso de conexiones (CLI)

Agregar etiquetas a un recurso de conexiones (CLI)

Puede usarlo AWS CLI para etiquetar los recursos en las conexiones.

En la terminal o en la línea de tag-resource comandos, ejecute el comando y especifique el nombre del recurso de Amazon (ARN) del recurso al que desea añadir etiquetas y la clave y el valor de la etiqueta que desea añadir. Puede agregar varias etiquetas.

Para agregar etiquetas para una conexión

1. Obtenga el ARN para su recurso. Utilice el list-connections comando que se muestra en Mostrar conexiones para obtener la conexiónARN.

2. En un terminal o en la línea de comandos, ejecute el comando tag-resource.

   Por ejemplo, utilice el siguiente comando para etiquetar una conexión con dos etiquetas, una clave de etiqueta denominada Project con el valor de etiqueta de ProjectA, y una clave de etiqueta llamada ReadOnly con el valor de etiqueta de true.

   aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true

   Si se ejecuta correctamente, este comando no devuelve nada.

Para agregar etiquetas para un alojamiento

1. Obtenga el ARN para su recurso. Utilice el list-hosts comando que se muestra en Enumeración de alojamientos para obtener el hostARN.

2. En un terminal o en la línea de comandos, ejecute el comando tag-resource.

   Por ejemplo, utilice el siguiente comando para etiquetar un host con dos etiquetas, una clave de etiqueta denominada Project con el valor de etiqueta de ProjectA, y una clave de etiqueta llamada IscontainerBased con el valor de etiqueta de true.

   aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605 --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true

   Si se ejecuta correctamente, este comando no devuelve nada.

Ver las etiquetas de un recurso de conexiones (CLI)

Puede utilizar el AWS CLI para ver las AWS etiquetas de un recurso de conexiones. Si no se han añadido etiquetas, la lista obtenida está vacía. Utilice el comando list-tags-for-resource para ver las etiquetas que se han agregado a una conexión o un alojamiento.

Para ver etiquetas de una conexión

1. ARNConsíguelo para tu recurso. Utilice el list-connections comando que se muestra en Mostrar conexiones para obtener la conexiónARN.

2. En un terminal o en la línea de comandos, ejecute el comando list-tags-for-resource. Por ejemplo, utilice el siguiente comando para ver una lista de claves de etiqueta y valores de etiqueta para una conexión.

   aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f

   Este comando devuelve las etiquetas asociadas al recurso. Este ejemplo muestra dos pares clave-valor devueltos para una conexión.

   {
       "Tags": [
           {
               "Key": "Project",
               "Value": "ProjectA"
           },
           {
               "Key": "ReadOnly",
               "Value": "true"
           }
       ]
   }

Para ver etiquetas de un alojamiento

1. Obtenga el ARN para su recurso. Utilice el list-hosts comando que se muestra en Enumeración de alojamientos para obtener el hostARN.

2. En un terminal o en la línea de comandos, ejecute el comando list-tags-for-resource. Por ejemplo, utilice el siguiente comando para ver una lista de claves de etiqueta y valores de etiqueta para un alojamiento.

   aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605

   Este comando devuelve las etiquetas asociadas al recurso. Este ejemplo muestra dos pares clave-valor devueltos para un alojamiento.

   {
       "Tags": [
           {
               "Key": "IscontainerBased",
               "Value": "true"
           },
           {
               "Key": "Project",
               "Value": "ProjectA"
           }
       ]
   }

Edite las etiquetas de un recurso de conexiones (CLI)

Puede utilizar el AWS CLI para editar la etiqueta de un recurso. Puede cambiar el valor de una clave existente o añadir otra clave.

En la terminal o en la línea ARN de comandos, ejecute el tag-resource comando especificando el recurso en el que desea actualizar una etiqueta y especifique la clave y el valor de la etiqueta que desea actualizar.

Cuando se editan etiquetas, todas las claves de etiquetas no especificadas se conservarán, mientras que todo lo que tenga la misma clave y un valor nuevo se actualizará. Las claves nuevas que se agregan con el comando de edición se agregan como un par clave-valor nuevo.

Para editar etiquetas de una conexión

1. Obtenga el ARN para su recurso. Utilice el list-connections comando que se muestra en Mostrar conexiones para obtener la conexiónARN.

2. En un terminal o en la línea de comandos, ejecute el comando tag-resource.

   En este ejemplo, el valor de la clave Project cambia a ProjectB.

   aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectB

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

Para editar etiquetas de un alojamiento

1. Obtenga el ARN para su recurso. Utilice el list-hosts comando que se muestra en Enumeración de alojamientos para obtener el hostARN.

2. En un terminal o en la línea de comandos, ejecute el comando tag-resource.

   En este ejemplo, el valor de la clave Project cambia a ProjectB.

   aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605 --tags Key=Project,Value=ProjectB

   Si se ejecuta correctamente, este comando no devuelve nada. Para verificar las etiquetas asociadas al alojamiento, ejecute el comando list-tags-for-resource.

Eliminar etiquetas de un recurso de conexiones (CLI)

Siga estos pasos para usar el AWS CLI para eliminar una etiqueta de un recurso. Cuando se quitan etiquetas del recurso asociado, las etiquetas se eliminan.

nota

Si elimina un recurso de conexión, todas las asociaciones de etiquetas se quitarán del recurso eliminado. No es necesario quitar las etiquetas antes de eliminar un recurso de conexión.

En la terminal o en la línea de untag-resource comandos, ejecute el comando y especifique el recurso ARN del que desea eliminar las etiquetas y la clave de etiqueta de la etiqueta que desea eliminar. Por ejemplo, para eliminar varias etiquetas de una conexión con las claves de etiquetas Project y ReadOnly, utilice el siguiente comando.

aws codestar-connections untag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tag-keys Project ReadOnly

Si se ejecuta correctamente, este comando no devuelve nada. Para ver las etiquetas asociadas al recurso, ejecute el comando list-tags-for-resource. El resultado indica que se han eliminado todas las etiquetas.

{
    "Tags": []
}