Crea y actualiza etiquetas para los proyectos

Las etiquetas te permiten organizar tus proyectos de Google Cloud y hacer un seguimiento de los costos en todos los equipos o entornos. Para administrar las etiquetas de los proyectos, puedes usar la consola deGoogle Cloud , Google Cloud CLI o la API de Cloud Resource Manager.

Las etiquetas se aplican solo a los proyectos. Las carpetas y los recursos de organización no admiten etiquetas, y las etiquetas que adjuntas a un proyecto no se propagan automáticamente a los recursos secundarios. Para aplicar o actualizar etiquetas en recursos de servicio específicos, como instancias de Compute Engine o buckets de Cloud Storage, consulta la documentación del recurso o los servicios que admiten etiquetas. Por ejemplo, Pub/Sub admite etiquetas para la facturación de la capacidad de procesamiento de temas y suscripciones, pero los SKU de facturación de salida no admiten etiquetas.

Crea etiquetas para proyectos

Console

Para agregar etiquetas a un solo proyecto, sigue estos pasos:

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

    Abre la página Etiquetas

  2. Selecciona tu proyecto del menú desplegable Seleccionar un proyecto.

  3. Para agregar una nueva entrada de etiqueta, haz clic en + Agregar etiqueta y, luego, ingresa una clave y valor de etiqueta para cada etiqueta que desees agregar.

  4. Cuando termines de agregar etiquetas, haz clic en Guardar.

Para agregar etiquetas a más de un proyecto al mismo tiempo, sigue estos pasos:

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

    Abrir la página Administrar recursos

  2. En la página Administrar recursos, selecciona los proyectos a los que deseas agregar etiquetas.

  3. En el panel de información, en la pestaña Etiquetas, haz clic en + Agregar etiqueta y, luego, ingresa una clave y un valor para cada etiqueta que quieras agregar.

  4. Cuando termines de agregar etiquetas, haz clic en Guardar.

Luego de agregar las etiquetas, puedes escribir una clave o valor de etiqueta en el cuadro de filtro sobre la lista de proyectos para filtrar proyectos. El cuadro de filtro sugerirá claves y valores para que puedas obtener una vista previa de los resultados.

gcloud

Para crear un proyecto nuevo con etiquetas con gcloud CLI, usa el comando gcloud projects create con la marca --labels:

gcloud projects create PROJECT_ID \
    --labels=KEY1=VALUE1,KEY2=VALUE2

Para agregar etiquetas a un proyecto existente, usa el comando gcloud projects update con la marca --update-labels:

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

Aquí:

  • PROJECT_ID es el ID del proyecto que deseas crear o actualizar.
  • KEY1=VALUE1 es un par clave-valor para la etiqueta que deseas agregar.

REST

Para crear un proyecto nuevo con una etiqueta, incluye el campo labels cuando realices una solicitud POST al método projects.create:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "PROJECT_ID",
    "displayName": "PROJECT_NAME",
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects"

Para agregar etiquetas a un proyecto existente, usa el método projects.patch:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

Actualiza las etiquetas de los proyectos

Console

Para actualizar las etiquetas de un solo proyecto, sigue estos pasos:

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

    Abre la página Etiquetas

  2. Selecciona tu proyecto del menú desplegable Seleccionar un proyecto.

  3. Actualiza las etiquetas de tu proyecto:

    1. Para editar una etiqueta, haz clic en el valor que deseas editar y, luego, realiza los cambios que quieras.
    2. Para borrar una etiqueta, mantén el puntero sobre la clave o el valor y, luego, haz clic en .

  4. Cuando termines de actualizar las etiquetas, haz clic en Guardar.

Para actualizar las etiquetas de más de un proyecto al mismo tiempo, sigue estos pasos:

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

    Abrir la página Administrar recursos

  2. En la página Administrar recursos, selecciona los proyectos para los que deseas actualizar las etiquetas.

  3. En el panel de información, haz clic en la pestaña Etiquetas y actualiza las etiquetas de los proyectos seleccionados:

    1. Para editar una etiqueta, haz clic en el valor que deseas editar y, luego, realiza los cambios que quieras.
    2. Para borrar una etiqueta, mantén el puntero sobre la clave o el valor y, luego, haz clic en .

  4. Cuando termines de actualizar las etiquetas, haz clic en Guardar.

gcloud

Para actualizar las etiquetas de un proyecto con gcloud CLI, usa el comando gcloud projects update con la marca --update-labels, --remove-labels o --clear-labels.

Para agregar o actualizar etiquetas, sigue estos pasos:

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

Para quitar etiquetas específicas, haz lo siguiente:

gcloud projects update PROJECT_ID \
    --remove-labels=KEY1,KEY2

Para quitar todas las etiquetas de un proyecto, haz lo siguiente:

gcloud projects update PROJECT_ID \
    --clear-labels

REST

Para actualizar las etiquetas de un proyecto con la API, envía una solicitud PATCH al método projects.patch:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "color": "red"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

En el ejemplo anterior, PROJECT_ID es el ID del proyecto que deseas actualizar.