Crea y administra etiquetas

Console

Para crear una clave de etiqueta, haz lo siguiente:

1. Abre la página Etiquetas en la consola de Google Cloud.

   Abre la página Etiquetas

2. En el Selector de alcance en la parte superior de la página, selecciona la organización o el proyecto en el que deseas crear una clave de etiqueta.

3. Haz clic en add Crear.

4. En el cuadro Clave de la etiqueta, ingresa el nombre visible de la clave de la etiqueta. Esto se convierte en parte del nombre con espacio de nombres de tu etiqueta.

5. En el cuadro Descripción de la clave de la etiqueta, ingresa una descripción de la clave de la etiqueta.

6. Si deseas agregar valores de etiqueta a esta clave, haz clic en add Agregar valor para cada valor de etiqueta que desees crear.

7. En el cuadro Valor de la etiqueta, ingresa el nombre visible del valor de la etiqueta. Esto se convierte en parte del nombre con espacio de nombres de tu etiqueta.

8. En el cuadro Descripción del valor de la etiqueta, ingresa una descripción del valor de la etiqueta.

9. Cuando termines de agregar valores de etiqueta, haz clic en Crear clave de etiqueta.

gcloud

Para crear una clave de etiqueta, usa el comando gcloud resource-manager tags keys create:

gcloud resource-manager tags keys create SHORT_NAME \
    --parent=RESOURCE_ID

Aquí:

• SHORT_NAME es el nombre visible de tu clave de etiqueta; por ejemplo: environment.

• RESOURCE_ID es el ID de la organización superior o del recurso del proyecto de esta clave de etiqueta, por ejemplo, organizations/123456789012, projects/test-project123 o projects/234567890123. Para obtener información sobre cómo obtener el ID de tu organización, consulta la sección sobre cómo crear y administrar organizaciones. Para obtener información sobre cómo obtener el ID de tu proyecto, consulta Crea y administra proyectos.

Deberías recibir una respuesta similar a la que figura a continuación:

Creating tag key environment in organization 1234567890...
<blocking wait until creation completes>
name: tagKeys/123456789012
short_name: environment
namespaced_name: 123456789012/environment
parent: organizations/123456789012

Terraform

Usa el recurso google_tags_tag_key.

Antes de crear claves de etiqueta con Terraform, habilita la API de Cloud Resource Manager.

En el siguiente ejemplo, se crean claves de etiqueta llamadas env y department:

data "google_project" "default" {}

resource "google_tags_tag_key" "env_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "env"
}

resource "google_tags_tag_key" "department_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "department"
}

Para aplicar tu configuración de Terraform en un proyecto de Google Cloud, completa los pasos de las siguientes secciones.

Prepara Cloud Shell

1. Inicia Cloud Shell

2. Establece el proyecto de Google Cloud predeterminado en el que deseas aplicar tus configuraciones de Terraform.

   Solo necesitas ejecutar este comando una vez por proyecto y puedes ejecutarlo en cualquier directorio.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Las variables de entorno se anulan si configuras valores explícitos en el archivo de configuración de Terraform.

Prepara el directorio

Cada archivo de configuración de Terraform debe tener su propio directorio (también llamado módulo raíz).

1. En Cloud Shell, crea un directorio y un archivo nuevo dentro de ese directorio. El nombre del archivo debe tener la extensión .tf, por ejemplo, main.tf. En este instructivo, el archivo se denomina main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Si sigues un instructivo, puedes copiar el código de muestra en cada sección o paso.

   Copia el código de muestra en el main.tf recién creado.

   De manera opcional, copia el código de GitHub. Esto se recomienda cuando el fragmento de Terraform es parte de una solución de extremo a extremo.

3. Revisa y modifica los parámetros de muestra que se aplicarán a tu entorno.
4. Guarda los cambios.
5. Inicializa Terraform. Solo debes hacerlo una vez por directorio.

   terraform init

   De manera opcional, incluye la opción -upgrade para usar la última versión del proveedor de Google:

   terraform init -upgrade

Aplica los cambios

1. Revisa la configuración y verifica que los recursos que creará o actualizará Terraform coincidan con tus expectativas:

   terraform plan

   Corrige la configuración según sea necesario.

2. Para aplicar la configuración de Terraform, ejecuta el siguiente comando y, luego, escribe yes cuando se te solicite:

   terraform apply

   Espera hasta que Terraform muestre el mensaje “¡Aplicación completa!”.

3. Abre tu proyecto de Google Cloud para ver los resultados. En la consola de Google Cloud, navega a tus recursos en la IU para asegurarte de que Terraform los haya creado o actualizado.

API

Para crear una clave de etiqueta, crea una representación JSON de la clave. Para obtener más información sobre el formato de una clave de etiqueta, consulta la Referencia de TagKey.

Luego, usa el método tagKeys.create:

POST https://cloudresourcemanager.googleapis.com/v3/tagKeys/ -d

Cuerpo JSON de la solicitud:

{
    "parent": RESOURCE_ID,
    "shortName": SHORT_NAME,
    "description": DESCRIPTION,
}

Aquí:

• SHORT_NAME es el nombre visible de tu clave de etiqueta; por ejemplo: environment.

• RESOURCE_ID es el ID de la organización superior o del recurso del proyecto de esta clave de etiqueta, por ejemplo, organizations/123456789012, projects/test-project123 o projects/234567890123. Para obtener información sobre cómo obtener el ID de tu organización, consulta la sección sobre cómo crear y administrar organizaciones. Para obtener información sobre cómo obtener el ID de tu proyecto, consulta Crea y administra proyectos.

• DESCRIPTION es una descripción de la clave y no más de 256 caracteres.

Console

Para ver una etiqueta creada, haz lo siguiente:

1. Abre la página Etiquetas en la consola de Google Cloud.

   Abre la página Etiquetas

2. En el Selector de alcance en la parte superior de la página, selecciona la organización o el proyecto que contiene tu etiqueta.

3. Todas las etiquetas de la organización o el proyecto seleccionados aparecen en la lista. Haz clic en la etiqueta para la que deseas ver la clave de la etiqueta.

gcloud

Para mostrar la información relacionada con una clave de etiqueta determinada, usa el comando gcloud resource-manager tags keys describe:

gcloud resource-manager tags keys describe TAGKEY_NAME

TAGKEY_NAME es el ID permanente o el nombre de espacio de nombres de la clave de etiqueta para la que deseas mostrar información; por ejemplo: tagKeys/123456789012 o project-id/environment.

Deberías recibir una respuesta similar a la que figura a continuación:

name: tagKeys/123456789012
short_name: environment
namespaced_name: 123456789012/environment
parent: organizations/123456789012

API

Para mostrar la información relacionada con una clave de etiqueta determinada, usa el método tagKeys.get:

GET https://cloudresourcemanager.googleapis.com/v3/{name=TAGKEY_NAME}

TAGKEY_NAME es el ID permanente de la clave de etiqueta para la que deseas mostrar información; por ejemplo: tagKeys/123456789012.

Para mostrar la información relacionada con una clave de etiqueta determinada con su nombre de espacio de nombres, usa el método tagKeys.getNamespaced:

GET https://cloudresourcemanager.googleapis.com/v3/tagKeys/namespaced?name={TAGKEY_NAMESPACED_NAME}

TAGKEY_NAMESPACED_NAME es el nombre con espacio de nombres de la clave de etiqueta y tiene el formato parentNamespace/tagKeyShortName.

Console

Para crear un valor de etiqueta, haz lo siguiente:

1. Abre la página Etiquetas en la consola de Google Cloud.

   Abre la página Etiquetas

2. En el Selector de alcance en la parte superior de la página, selecciona la organización o el proyecto en el que deseas crear un valor de etiqueta.

3. En la lista de etiquetas, haz clic en la etiqueta a la que deseas agregar un valor nuevo.

4. Haz clic en add Agregar valor.

5. En el cuadro Valor de la etiqueta, ingresa el nombre visible del valor de la etiqueta. Esto se convierte en parte del nombre con espacio de nombres de tu etiqueta.

6. En el cuadro Descripción del valor de la etiqueta, ingresa una descripción del valor de la etiqueta.

7. Haz clic en Guardar.

gcloud

Para crear un valor de etiqueta, usa el comando gcloud resource-manager tags values create. Debes especificar la clave con la que se crea este valor:

gcloud resource-manager tags values create TAGVALUE_SHORTNAME \
    --parent=TAGKEY_NAME

Aquí:

• TAGVALUE_SHORTNAME es el nombre corto del valor de etiqueta nuevo; por ejemplo: production.

• TAGKEY_NAME es el ID permanente o el nombre de espacio de nombres de la clave de etiqueta superior; por ejemplo: tagKeys/4567890123.

Deberías recibir una respuesta similar a la que figura a continuación:

Creating tag value production in tag key 123456789012/environment...
<blocking wait until creation completes>
name: tagValues/7890123456
short_name: production
namespaced_name: 123456789012/environment/production
parent: tagKeys/123456789012

Terraform

Usa el recurso google_tags_tag_value.

Antes de crear valores de etiquetas con Terraform, habilita la API de Cloud Resource Manager.

En el siguiente ejemplo, se crean valores de etiqueta llamados prod y sales:

data "google_project" "default" {}

resource "google_tags_tag_key" "env_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "env1"
}

resource "google_tags_tag_key" "department_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "department1"
}

resource "google_tags_tag_value" "env_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.env_tag_key.name}"
  short_name = "prod"
}

resource "google_tags_tag_value" "department_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.department_tag_key.name}"
  short_name = "sales"
}

Para aplicar tu configuración de Terraform en un proyecto de Google Cloud, completa los pasos de las siguientes secciones.

Prepara Cloud Shell

1. Inicia Cloud Shell

2. Establece el proyecto de Google Cloud predeterminado en el que deseas aplicar tus configuraciones de Terraform.

   Solo necesitas ejecutar este comando una vez por proyecto y puedes ejecutarlo en cualquier directorio.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Las variables de entorno se anulan si configuras valores explícitos en el archivo de configuración de Terraform.

Prepara el directorio

Cada archivo de configuración de Terraform debe tener su propio directorio (también llamado módulo raíz).

1. En Cloud Shell, crea un directorio y un archivo nuevo dentro de ese directorio. El nombre del archivo debe tener la extensión .tf, por ejemplo, main.tf. En este instructivo, el archivo se denomina main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Si sigues un instructivo, puedes copiar el código de muestra en cada sección o paso.

   Copia el código de muestra en el main.tf recién creado.

   De manera opcional, copia el código de GitHub. Esto se recomienda cuando el fragmento de Terraform es parte de una solución de extremo a extremo.

3. Revisa y modifica los parámetros de muestra que se aplicarán a tu entorno.
4. Guarda los cambios.
5. Inicializa Terraform. Solo debes hacerlo una vez por directorio.

   terraform init

   De manera opcional, incluye la opción -upgrade para usar la última versión del proveedor de Google:

   terraform init -upgrade

Aplica los cambios

1. Revisa la configuración y verifica que los recursos que creará o actualizará Terraform coincidan con tus expectativas:

   terraform plan

   Corrige la configuración según sea necesario.

2. Para aplicar la configuración de Terraform, ejecuta el siguiente comando y, luego, escribe yes cuando se te solicite:

   terraform apply

   Espera hasta que Terraform muestre el mensaje “¡Aplicación completa!”.

3. Abre tu proyecto de Google Cloud para ver los resultados. En la consola de Google Cloud, navega a tus recursos en la IU para asegurarte de que Terraform los haya creado o actualizado.

API

Para crear un valor de etiqueta, crea una representación JSON del valor. Para obtener más información sobre el formato de un valor de etiqueta, consulta la referencia de TagValue.

Luego, usa el método tagValues.create:

POST https://cloudresourcemanager.googleapis.com/v3/tagValues/ -d

Cuerpo JSON de la solicitud:

{
    "parent": TAGKEY_NAME,
    "shortName": SHORT_NAME,
    "description": DESCRIPTION,
}

Aquí:

• TAGKEY_NAME es el ID permanente de la clave de la etiqueta principal; por ejemplo:tagKeys/4567890123.

• SHORT_NAME es el nombre visible de tu valor de etiqueta; por ejemplo: environment.

• DESCRIPTION es una descripción del valor y no puede tener más de 256 caracteres. Una vez que hayas creado el valor, puedes encontrar el nombre visible y legible por humanos único, llamado namespacedName, que tiene un espacio de nombres dentro de su recurso superior, y un ID permanente global único, llamado name.

Console

Para ver una etiqueta creada, haz lo siguiente:

1. Abre la página Etiquetas en la consola de Google Cloud.

   Abre la página Etiquetas

2. En el Selector de alcance en la parte superior de la página, selecciona la organización o el proyecto que contiene tu etiqueta.

3. Todas las etiquetas que creaste en esta organización o proyecto aparecerán en la lista. Haz clic en la etiqueta para la que deseas ver los valores.

gcloud

Para mostrar la información relacionada con un valor de etiqueta determinado, usa el comando gcloud resource-manager tags values describe:

gcloud resource-manager tags values describe TAGVALUE_NAME

TAGVALUE_NAME es el ID permanente o el nombre con espacio de nombres del valor de la etiqueta; por ejemplo: tagValues/4567890123 o 123456789012/environment/production.

Deberías recibir una respuesta similar a la que figura a continuación:

name: tagValues/456789012345
short_name: production
namespaced_name: 123456789012/environment/production
parent: tagKeys/123456789012

API

Para mostrar la información relacionada con un valor de etiqueta determinado, usa el método tagValues.get:

GET https://cloudresourcemanager.googleapis.com/v3/{name=TAGVALUE_NAME}

TAGVALUE_NAME es el ID permanente del valor de la etiqueta; por ejemplo: tagValues/4567890123.

Para mostrar la información relacionada con un valor de etiqueta determinado con su nombre con espacio de nombres, usa el método tagValues.getNamespaced:

GET https://cloudresourcemanager.googleapis.com/v3/tagValues/namespaced?name={TAGVALUE_NAMESPACED_NAME}

TAGVALUE_NAMESPACED_NAME es el nombre con espacio de nombres del valor de la etiqueta y tiene el formato parentNamespace/tagKeyShortName/tagValueShortName.

Console

Para actualizar la descripción de una clave de etiqueta, haz lo siguiente:

1. Abre la página Etiquetas en la consola de Google Cloud.

   Abre la página Etiquetas

2. En el Selector de alcance en la parte superior de la página, selecciona la organización o el proyecto que contiene la clave de tu etiqueta.

3. Haz clic en more_vert Acciones junto a la clave de etiqueta que deseas actualizar y, luego, en Ver detalles.

4. Haz clic en edit Editar junto a Descripción, cerca de la parte superior de la pantalla.

5. Actualiza la descripción de la clave de etiqueta

6. Haz clic en Guardar.

gcloud

Para modificar la descripción de una clave de etiqueta, usa el comando gcloud resource-manager tags keys update:

gcloud resource-manager tags keys update TAGKEY_NAME \
    --description=NEW_DESCRIPTION

Aquí:

• TAGKEY_NAME es el ID permanente o el nombre de espacio de nombres de la clave que se va a actualizar; por ejemplo: tagKeys/123456789012.

• NEW_DESCRIPTION es una string de no más de 256 caracteres para usar como descripción nueva.

Deberías recibir una respuesta similar a la que figura a continuación:

name: tagKeys/123456789012
short_name: environment
namespaced_name: 123456789012/environment
description: "new description"
parent: organizations/123456789012

API

Para modificar la descripción de una clave de etiqueta, usa el método tagKeys.patch:

PATCH https://cloudresourcemanager.googleapis.com/v3/{tagKey.name=TAGKEY_NAME} -d

Cuerpo JSON de la solicitud:

{
    "description": DESCRIPTION,
}

Aquí:

• TAGKEY_NAME es el ID permanente de la clave de etiqueta; por ejemplo: tagKeys/123456789012.

• DESCRIPTION es una descripción de la clave y no más de 256 caracteres.

Console

Para actualizar la descripción de un valor de etiqueta, haz lo siguiente:

1. Abre la página Etiquetas en la consola de Google Cloud.

   Abre la página Etiquetas

2. En el Selector de alcance en la parte superior de la página, selecciona la organización o el proyecto que contiene el valor de tu etiqueta.

3. Haz clic en more_vert Acciones junto a la clave de etiqueta del valor que deseas actualizar y, luego, en Ver detalles.

4. Haz clic en more_vert Acciones junto al valor de la etiqueta que deseas actualizar y, luego, en Ver detalles.

5. Haz clic en edit Editar junto a Descripción cerca de la parte superior de la pantalla.

6. Actualiza la descripción del valor de la etiqueta.

7. Haz clic en Guardar.

gcloud

Para modificar la descripción de un valor de etiqueta, usa el comando gcloud resource-manager tags values update:

gcloud resource-manager tags values update TAGVALUE_NAME \
    --description="NEW_DESCRIPTION"

Aquí:

• TAGVALUE_NAME es el ID permanente o el nombre de espacio de nombres del valor de la etiqueta que se actualizará; por ejemplo: tagValues/4567890123.

• NEW_DESCRIPTION es una string de no más de 256 caracteres para usar como descripción nueva.

Deberías recibir una respuesta similar a la que figura a continuación:

short_name: production
namespaced_name: 123456789012/environment/production
parent: tagKeys/123456789012
description: "new description"

API

Para modificar la descripción de una clave de etiqueta, usa el comando tagValues.patch:

PATCH https://cloudresourcemanager.googleapis.com/v3/{tagKey.name=TAGVALUE_NAME} -d

Cuerpo JSON de la solicitud:

{
    "description": DESCRIPTION,
}

Aquí:

• TAGVALUE_NAME es el nombre de ID permanente del valor de la etiqueta; por ejemplo: tagValues/4567890123.

• DESCRIPTION es una descripción de la clave y no más de 256 caracteres.

Console

Para ver todas las etiquetas, haz lo siguiente:

1. Abre la página Etiquetas en la consola de Google Cloud.

   Abre la página Etiquetas

2. En el Selector de alcance en la parte superior de la página, selecciona la organización o el proyecto que contiene tus etiquetas.

3. Todas las etiquetas que creaste en esta organización o proyecto aparecerán en la lista.

gcloud

Para mostrar una lista de todas las claves de etiqueta creadas en una organización o un recurso de proyecto, usa el comando gcloud resource-manager tags keys list:

gcloud resource-manager tags keys list --parent=RESOURCE_ID

RESOURCE_ID es el ID de la organización o el recurso del proyecto para el que deseas encontrar claves de etiquetas adjuntas.

• Se debe proporcionar un ID de organización o proyecto en el formato organizations/ORGANIZATION_ID o projects/PROJECT_NAME; por ejemplo: organizations/123456789012 y projects/test-project123. Para obtener información sobre cómo obtener el ID de tu organización, consulta la sección sobre cómo crear y administrar organizaciones. Para obtener información sobre cómo obtener el ID de tu proyecto, consulta Crea y administra proyectos. Deberías recibir una respuesta similar a la que figura a continuación:

NAME                     SHORT_NAME      DESCRIPTION
tagKeys/123456789012     environment     description of tag key

API

Para mostrar una lista de todas las claves de etiqueta de un recurso determinado, usa el método tagKeys.list con el recurso superior especificado en la consulta:

GET https://cloudresourcemanager.googleapis.com/v3/tagKeys

{
    "parent": "RESOURCE_ID"
}

RESOURCE_ID es el ID de la organización o el recurso del proyecto para el que deseas encontrar claves de etiquetas adjuntas; por ejemplo: organizations/123456789012 y projects/test-project123.

Console

Para ver todos los valores de etiqueta adjuntos a una clave de etiqueta, haz lo siguiente:

1. Abre la página Etiquetas en la consola de Google Cloud.

   Abre la página Etiquetas

2. En el Selector de alcance en la parte superior de la página, selecciona la organización o el proyecto que contiene la clave de tu etiqueta.

3. Haz clic en more_vert Acciones junto a la clave de etiqueta que contiene los valores de etiqueta que deseas encontrar y, luego, haz clic en Ver detalles.

4. Todos los valores de etiqueta que creaste con esta clave de etiqueta aparecerán en la lista.

gcloud

Para mostrar una lista de todos los valores de etiqueta adjuntos a una clave, usa el comando gcloud resource-manager tags values list:

gcloud resource-manager tags values list --parent=TAGKEY_NAME

TAGKEY_NAME es el ID permanente o el nombre de espacio de nombres de la clave de etiqueta para la que deseas encontrar los valores adjuntos; por ejemplo: tagKeys/123456789012 o 1234567/environment.

Deberías recibir una respuesta similar a la que figura a continuación:

NAME                     SHORT_NAME
tagValues/123456789012   production

API

Para mostrar una lista de todos los valores de etiqueta adjuntos a una clave, usa el método tagValues.list con la clave de etiqueta superior especificada en la consulta:

GET https://cloudresourcemanager.googleapis.com/v3/tagValues

{
    "parent": "TAGKEY_NAME"
}

TAGKEY_NAME es el nombre de ID permanente de la clave de etiqueta; por ejemplo: tagKeys/123456789012.

Claves de etiquetas

Para administrar el acceso de los usuarios a una clave de etiqueta, haz lo siguiente:

1. Abre la página Etiquetas en la consola de Google Cloud.

   Abre la página Etiquetas

2. En el Selector de alcance en la parte superior de la página, selecciona la organización o el proyecto que contiene la clave de etiqueta en la que deseas administrar el acceso.

3. Haz clic en la casilla de verificación junto a la etiqueta para la que deseas administrar el acceso.

4. Haz clic en person Administrar acceso.

5. Para agregar un rol a un principal, haz clic en person_add Agregar principal.

   1. En el cuadro de texto Principales nuevas, ingresa la dirección de correo electrónico de la principal a la que deseas otorgar un rol nuevo.

   2. Selecciona un rol en el menú desplegable Selecciona un rol. Si deseas agregar más de un rol, haz clic en add Agregar otro rol.

   3. Haz clic en Guardar.

6. Para editar el rol de una principal, haz clic en edit Editar junto a la principal que deseas editar.

   1. Para cambiar los roles asignados a los principales en esta etiqueta, haz clic en el menú desplegable Rol y elige un rol nuevo.

   2. Si deseas agregar más roles, haz clic en add Agregar otra función.

   3. Para borrar un rol de esta principal en esta etiqueta, haz clic en delete Borrar rol junto al rol que deseas borrar.

   4. Haz clic en Guardar.

7. Para borrar el rol de un usuario principal, haz clic en delete Borrar rol junto al rol que deseas borrar.

   1. Haz clic en Eliminar.

Valores de la etiqueta

Para administrar el acceso de los usuarios a un valor de etiqueta, haz lo siguiente:

1. Abre la página Etiquetas en la consola de Google Cloud.

   Abre la página Etiquetas

2. En el Selector de alcance en la parte superior de la página, selecciona la organización o el proyecto que contiene la clave de etiqueta para la que deseas administrar el acceso.

3. Haz clic en more_vert Acciones junto a la clave de etiqueta del valor para el que deseas administrar el acceso y, luego, en Ver detalles.

4. Haz clic en person Administrar acceso.

5. Para agregar un rol a un principal, haz clic en person_add Agregar principal.

   1. En el cuadro de texto Principales nuevas, ingresa la dirección de correo electrónico de la principal a la que deseas otorgar un rol nuevo.

   2. Selecciona un rol en el menú desplegable Selecciona un rol. Si deseas agregar más de un rol, haz clic en add Agregar otro rol.

   3. Haz clic en Guardar.

6. Para editar el rol de una principal, haz clic en edit Editar junto a la principal que deseas editar.

   1. Para cambiar los roles asignados a los principales en esta etiqueta, haz clic en el menú desplegable Rol y elige un rol nuevo.

   2. Si deseas agregar más roles, haz clic en add Agregar otra función.

   3. Para borrar un rol de esta principal en esta etiqueta, haz clic en delete Borrar rol junto al rol que deseas borrar.

   4. Haz clic en Guardar.

7. Para borrar el rol de un usuario principal, haz clic en delete Borrar rol junto al rol que deseas borrar.

   1. Haz clic en Eliminar.

Console

Para adjuntar una etiqueta a un recurso de organización, carpeta o proyecto, haz lo siguiente:

1. Abre la página Administrar recursos en la consola de Google Cloud.

   Abre la página Administrar recursos

2. Haz clic en la organización, la carpeta o el proyecto al que deseas adjuntar una etiqueta.

3. Haz clic en label_importantEtiquetas.

4. En el panel Etiquetas, haz clic en Seleccionar permiso.

5. Selecciona la organización o el proyecto que contiene tus etiquetas y, luego, haz clic en Abrir.

6. En el panel Etiquetas, selecciona Agregar etiqueta.

7. En el campo Clave, selecciona la clave de la etiqueta que deseas adjuntar de la lista. Para filtrar la lista, escribe palabras clave.

8. En el campo Valor, selecciona el valor de la etiqueta que deseas adjuntar de la lista. Para filtrar la lista, escribe palabras clave.

9. Si deseas adjuntar más etiquetas, haz clic en add Agregar etiqueta y, luego, selecciona la clave y el valor de cada una.

10. Haz clic en Guardar.

11. En el cuadro de diálogo Confirmar, haz clic en Confirmar para adjuntar la etiqueta.

12. Aparecerá una notificación para confirmar que se actualizaron tus etiquetas. Las etiquetas nuevas aparecen en la columna Etiquetas de la página Administrar recursos.

gcloud

Para adjuntar una etiqueta a un recurso, debes crear un recurso de vinculación de etiquetas con el comando gcloud resource-manager tags bindings create:

gcloud resource-manager tags bindings create \
--tag-value=TAGVALUE_NAME \
--parent=RESOURCE_ID \
--location=LOCATION

Aquí:

• TAGVALUE_NAME es el ID permanente o el nombre de espacio de nombres del valor de la etiqueta que se adjuntará; por ejemplo: tagValues/4567890123 o 12345678/environment/production.

• RESOURCE_ID es el ID completo del recurso, incluido el nombre de dominio de la API para identificar el tipo de recurso (//cloudresourcemanager.googleapis.com/). Por ejemplo, para adjuntar una etiqueta a projects/7890123456, el ID completo sería el siguiente: //cloudresourcemanager.googleapis.com/projects/7890123456.

• LOCATION es la ubicación de tu recurso. Si adjuntas una etiqueta a un recurso global, como una carpeta o un proyecto, debes omitir esta marca. Si adjuntas una etiqueta a un recurso regional, como una instancia de Compute Engine, debes especificar la ubicación, por ejemplo, us-central1.

API

Para adjuntar una etiqueta a un recurso, primero debes crear una representación JSON de una vinculación de etiqueta que incluya el ID permanente o el nombre del espacio de nombres del valor de la etiqueta y el ID permanente del recurso. Para obtener más información sobre el formato de una vinculación de etiqueta, consulta la Referencia de TagBinding.

Si adjuntas la etiqueta a un recurso global, como una organización, usa el método tagBindings.create con el nombre de host del extremo global:

POST https://cloudresourcemanager.googleapis.com/v3/tagBindings

Si adjuntas la etiqueta a un recurso regional, como una instancia de Compute Engine, usa el método tagBindings.create con el extremo regional en el que se encuentra el recurso.

POST https://LOCATION-cloudresourcemanager.googleapis.com/v3/tagBindings

Cuerpo JSON de la solicitud:

{
    "parent": RESOURCE_ID,
    "tagValue": TAGVALUE_NAME,
}

O

{
    "parent": RESOURCE_ID,
    "tagValueNamespacedName": TAGVALUE_NAMESPACED_NAME,
}

Aquí:

• RESOURCE_ID es el ID completo del recurso, incluido el nombre de dominio de la API para identificar el tipo de recurso (//cloudresourcemanager.googleapis.com/). Por ejemplo, para adjuntar una etiqueta a projects/7890123456, el ID completo sería el siguiente: //cloudresourcemanager.googleapis.com/projects/7890123456.

• TAGVALUE_NAME es el ID permanente del valor de la etiqueta que se adjunta; por ejemplo: tagValues/4567890123.

• TAGVALUE_NAMESPACED_NAME es el nombre con espacio de nombres del valor de la etiqueta que se adjunta y tiene el siguiente formato: parentNamespace/tagKeyShortName/tagValueShortName.

Console

Para ver todas las etiquetas que se adjuntan a un recurso o que este hereda, haz lo siguiente:

1. Abre la página Administrar recursos en la consola de Google Cloud.

   Abre la página Administrar recursos

2. Busca tu organización, carpeta o proyecto en la lista de recursos.

3. Las etiquetas adjuntas al recurso aparecen en la columna Etiquetas. Las etiquetas que se hereden se marcarán como lanHeredado.

gcloud

Para obtener una lista de vinculaciones de etiquetas adjuntas a un recurso, usa el comando gcloud resource-manager tags bindings list: Si agregas la marca --effective, también se mostrará una lista de etiquetas heredadas por este recurso.

gcloud resource-manager tags bindings list \
    --parent=RESOURCE_ID \
    --location=LOCATION

Aquí:

• RESOURCE_ID es el ID completo del recurso; por ejemplo: //cloudresourcemanager.googleapis.com/projects/7890123456.

• LOCATION es la ubicación de tu recurso. Si enumeras las etiquetas adjuntas a un recurso global, como una carpeta o un proyecto, debes omitir esta marca. Si adjuntas una etiqueta a un recurso regional, como una instancia de Compute Engine, debes especificar la ubicación, por ejemplo, us-central1.

Deberías recibir una respuesta similar a la que figura a continuación:

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
tagValue: tagValues/567890123456
resource: //cloudresourcemanager.googleapis.com/projects/7890123456

Si agregas la marca --effective al comando tags bindings list, también se mostrará una lista de todas las etiquetas heredadas por este recurso. Deberías recibir una respuesta similar a la que figura a continuación:

namespacedTagKey: 961309089256/environment
namespacedTagValue: 961309089256/environment/production
tagKey: tagKeys/417628178507
tagValue: tagValues/247197504380
inherited: true

Si todas las etiquetas evaluadas en un recurso se adjuntan directamente, el campo inherited es falso y se omite.

API

Para obtener una lista de vinculaciones de etiquetas adjuntas directamente a un recurso global, como una organización, usa el método tagBindings.list y especifica el recurso superior en la consulta:

GET https://cloudresourcemanager.googleapis.com/v3/tagBindings

{
    "parent": "RESOURCE_ID"
}

Si deseas enumerar las vinculaciones de etiquetas conectadas a un recurso regional, como las instancias de Compute Engine, usa el método tagBindings.list con el extremo regional en el que se encuentra tu recurso.

GET https://LOCATION-cloudresourcemanager.googleapis.com/v3/tagBindings

{
    "parent": "RESOURCE_ID"
}

Aquí:

• RESOURCE_ID es el ID completo del recurso; por ejemplo: //cloudresourcemanager.googleapis.com/projects/7890123456.

• LOCATION es el extremo regional para tu recurso; por ejemplo: us-central1.

Si se ejecuta de forma correcta, el cuerpo de la respuesta debe incluir una lista de objetos TagBinding. Por ejemplo:

name: tagBindings/cloudresourcemanager.googleapis.com/projects/7890123456/567890123456
tagValue: tagValues/567890123456
resource: //cloudresourcemanager.googleapis.com/projects/7890123456

Console

Para desconectar una etiqueta de un recurso de organización, carpeta o proyecto, haz lo siguiente:

1. Abre la página Administrar recursos en la consola de Google Cloud.

   Abre la página Administrar recursos

2. Haz clic en la organización, la carpeta o el proyecto de los que deseas desconectar una etiqueta.

3. Haz clic en label_importantEtiquetas.

4. En el panel Etiquetas, junto a la etiqueta que deseas desconectar, haz clic en delete Borrar elemento.

5. Haz clic en Guardar.

6. En el cuadro de diálogo Confirmar, haz clic en Confirmar para desconectar la etiqueta.

7. Aparecerá una notificación para confirmar que se actualizaron tus etiquetas. La lista actualizada de etiquetas aparecerá en la columna Etiquetas de la página Administrar recursos.

gcloud

Para borrar una vinculación de etiqueta, usa el comando gcloud resource-manager tags bindings delete:

gcloud resource-manager tags bindings delete \
--tag-value=TAGVALUE_NAME \
--parent=RESOURCE_ID \
--location=LOCATION

Aquí:

• TAGVALUE_NAME es el ID permanente o el nombre de espacio de nombres del valor de la etiqueta que se adjunta; por ejemplo: tagValues/567890123456.

• RESOURCE_ID es el ID completo del recurso. Por ejemplo: //cloudresourcemanager.googleapis.com/projects/7890123456

• LOCATION es la ubicación de tu recurso. Si borras una vinculación de etiqueta adjunta a un recurso global, como una carpeta o un proyecto, debes omitir esta marca. Si borras una vinculación de etiqueta adjunta a un recurso regional, como una instancia de Compute Engine, debes especificar la ubicación, por ejemplo, us-central1.

API

Para borrar una vinculación de etiqueta que se adjunta a un recurso global, como una organización, usa el metodo tagBindings.delete:

DELETE https://cloudresourcemanager.googleapis.com/v3/{name=TAGBINDINGS_NAME}

Si deseas borrar una vinculación de etiqueta que se adjunta a un recurso regional, como una instancia de Compute Engine, usa el método tagBindings.delete con el extremo regional en el que se encuentra el recurso.

DELETE https://LOCATION-cloudresourcemanager.googleapis.com/v3/{name=TAGBINDINGS_NAME}

Aquí:

• TAGBINDINGS_NAME es el ID permanente de TagBinding; por ejemplo: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F1234567890/tagValues/567890123456.

• LOCATION es el extremo regional para tu recurso; por ejemplo: us-central1.

gcloud

Para crear una retención de etiquetas, usa el comando gcloud resource-manager tags holds create de gcloud CLI:

  gcloud resource-manager tags holds create TAGVALUE_NAME \
  --holder=HOLDER_NAME \
  --location=LOCATION

Aquí:

• TAGVALUE_NAME es el ID permanente o el nombre de espacio de nombres del valor de la etiqueta para el que se debe crear esta retención de etiquetas; por ejemplo: tagValues/567890123456.

• HOLDER_NAME es el nombre del recurso al que se adjunta el valor de la etiqueta. Debe tener menos de 200 caracteres.

• LOCATION es la ubicación de tu recurso. Si creas una retención de etiquetas para un recurso global, como un proyecto de Google Cloud, debes omitir esta marca. Si creas una retención de etiquetas para un recurso regional o zonal, debes especificar la ubicación, por ejemplo, us-central1.

API

Para crear una retención de etiqueta para un valor de etiqueta, primero debes crear una representación JSON de una retención de etiqueta. Esta referencia JSON debe incluir una referencia al recurso al que se adjunta el valor de la etiqueta. Para obtener más información sobre el formato de una retención de etiquetas, consulta la referencia de TagHolds.

Si creas una retención de etiquetas para un valor de etiqueta adjunto a un recurso global, como una organización, usa el método tagHolds.create con el nombre de host del extremo global:

POST https://cloudresourcemanager.googleapis.com/v3/tagValues/TAGVALUE_NAME/tagHolds

Si creas una retención de etiquetas para un valor de etiqueta adjunto a un recurso regional, como una instancia de Compute Engine, usa el método tagHolds.create con el extremo regional en el que se encuentra tu recurso.

POST https://LOCATION-cloudresourcemanager.googleapis.com/v3/TAGVALUE_NAME/tagHolds

Cuerpo JSON de la solicitud:

{
    "holder":HOLDER_NAME,
    "origin":ORIGIN_NAME
}

Aquí:

• TAGVALUE_NAME es el ID permanente del valor de la etiqueta que se adjunta; por ejemplo: tagValues/4567890123.

• HOLDER_NAME es el nombre del recurso al que se adjunta el valor de la etiqueta. Debe tener menos de 200 caracteres.

• ORIGIN_NAME es una cadena opcional que representa el origen de esta solicitud. Este campo debe incluir información comprensible para las personas para distinguir los orígenes entre sí. Debe tener menos de 200 caracteres.

gcloud

Para enumerar las retenciones de etiquetas que se encuentran debajo de un valor de etiqueta, usa el comando gcloud resource-manager tags holds list de gcloud CLI:

  gcloud resource-manager tags holds list TAGVALUE_NAME \
  --location=LOCATION

Aquí:

• TAGVALUE_NAME es el ID permanente o el nombre de espacio de nombres del valor de la etiqueta; por ejemplo: tagValues/567890123456.

• LOCATION es la ubicación de tu recurso. Si buscas retenciones de etiquetas creadas de forma global, debes omitir esta marca. Si buscas retenciones de etiquetas en un recurso regional o zonal, debes especificar la ubicación, por ejemplo, us-central1.

API

Para obtener una lista de retenciones de etiquetas con un valor de etiqueta, usa el método GET tagHolds y especifica el valor de la etiqueta superior en la URL:

GET https://cloudresourcemanager.googleapis.com/v3/{TAGVALUE_NAME}/tagHolds

Aquí:

• TAGVALUE_NAME es el ID permanente o el nombre de espacio de nombres del valor de la etiqueta; por ejemplo: tagValues/567890123456.

gcloud

Para borrar una retención de etiqueta, usa el comando gcloud resource-manager tags holds delete de gcloud CLI:

  gcloud resource-manager tags holds delete TAGHOLD_NAME \
  --location=LOCATION

Aquí:

• TAGHOLD_NAME es el nombre con espacio de nombres de la retención de etiquetas, que se puede encontrar con el comando list. Por ejemplo: tagValues/1012910994523/tagHolds/d1c8f5e2-2954-43d6-8f46-5f812ab48c37

• LOCATION es la ubicación de tu recurso. Si borras una retención de etiqueta que se encuentra bajo un valor de etiqueta adjunto a un recurso global, como una carpeta o un proyecto, debes omitir esta marca. Si borras una retención de etiquetas creada a partir de un proceso regional o zonal, debes especificar la ubicación, por ejemplo, us-central1.

API

Para borrar un valor de etiqueta, usa el método tagHolds.delete:

DELETE https://cloudresourcemanager.googleapis.com/v3/{TAGVALUE_NAME}/tagHolds/{TAGHOLD_NAME}

Aquí:

• TAGVALUE_NAME es el ID permanente del valor de la etiqueta al que se adjunta la retención de etiquetas que deseas borrar; por ejemplo: tagValues/567890123456.

• TAGHOLD_NAME es el nombre con espacio de nombres de la retención de etiquetas que deseas borrar, que se puede encontrar con el comando list. Por ejemplo: tagValues/1012910994523/tagHolds/d1c8f5e2-2954-43d6-8f46-5f812ab48c37

Console

Para borrar un valor de etiqueta, haz lo siguiente:

1. Abre la página Etiquetas en la consola de Google Cloud.

   Abre la página Etiquetas

2. En el Selector de alcance en la parte superior de la página, selecciona la organización o el proyecto que contiene el valor de tu etiqueta.

3. Haz clic en more_vert Acciones junto a la clave de etiqueta que contiene el valor de etiqueta que deseas borrar y, luego, en Ver detalles.

4. En la lista de valores de etiqueta asociados con esta clave de etiqueta, haz clic en el valor de etiqueta que deseas borrar.

5. Haz clic en la casilla de verificación junto al valor de la etiqueta que deseas borrar y, luego, haz clic en delete Borrar valores.

6. Haz clic en Confirm.

gcloud

Para borrar un valor de etiqueta, usa el comando gcloud resource-manager tag values delete:

gcloud resource-manager tags values delete TAGVALUE_NAME

TAGVALUE_NAME es el ID permanente o el nombre de espacio de nombres del valor de la etiqueta que deseas borrar; por ejemplo: tagValues/567890123456.

API

Para borrar un valor de etiqueta, usa el método tagValues.delete:

DELETE https://cloudresourcemanager.googleapis.com/v3/{name=TAGVALUE_NAME}

TAGVALUE_NAME es el ID permanente del valor de la etiqueta que deseas borrar; por ejemplo: tagValues/567890123456.

Console

Para borrar una clave de etiqueta, haz lo siguiente:

1. Abre la página Etiquetas en la consola de Google Cloud.

   Abre la página Etiquetas

2. En el Selector de alcance en la parte superior de la página, selecciona la organización o el proyecto que contiene la clave de etiqueta.

3. Haz clic en la casilla de verificación junto a la clave de etiqueta que deseas borrar.

4. Haz clic en delete Borrar etiquetas.

5. Haz clic en Confirm.

gcloud

Para borrar una clave de etiqueta, usa el comando gcloud resource-manager tags keys delete:

gcloud resource-manager tags keys delete TAGKEYS_NAME

TAGKEYS_NAME es el ID permanente o el nombre de espacio de nombres de la clave de etiqueta que deseas borrar; por ejemplo: tagKeys/123456789012.

API

Para borrar una clave de etiqueta, usa el método tagKeys.delete:

DELETE https://cloudresourcemanager.googleapis.com/v3/{name=TAGKEYS_NAME}

TAGKEYS_NAME es el ID permanente de la clave de etiqueta que deseas borrar; por ejemplo: tagKeys/123456789012.