Crea y actualiza etiquetas para los proyectos

En este documento, se proporcionan detalles para crear y actualizar etiquetas de proyectos con la API de Resource Manager y la consola de Google Cloud. Proporciona detalles sobre cómo comprender los costos con etiquetas y los servicios que las admiten.

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.

    Abrir 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 de etiqueta para cada etiqueta que desees 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.

REST

Para crear un proyecto nuevo con una etiqueta, establece el campo labels cuando crees el proyecto.

Solicitud:

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

{
 "labels": {
  "color": "red"
 },
 "name": "myproject",
 "projectId": "our-project-123"
}

Respuesta:

{
 "projectNumber": "333197460082",
 "projectId": "our-project-123",
 "lifecycleState": "ACTIVE",
 "name": "myproject",
 "labels": {
  "color": "red"
 },
 "createTime": "2016-01-12T22:18:28.633Z",
}

Para agregar etiquetas a proyectos existentes, sigue estos pasos:

Una vez que agregues etiquetas, podrás filtrar proyectos según ellas. Si quieres obtener detalles sobre el uso de etiquetas para filtrar proyectos, consulta la sección sobre cómo enumerar proyectos.

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.

    Abrir 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 quieres editar y, luego, realiza los cambios que desees.
    2. Para borrar una etiqueta, coloca 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 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 a 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 quieres editar y, luego, realiza los cambios que desees.
    2. Para borrar una etiqueta, coloca el puntero sobre la clave o el valor y, luego, haz clic en .

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

REST

Para actualizar las etiquetas de un proyecto, haz lo siguiente:

  • Obtén el objeto project con el método projects.get().

  • Modifica las etiquetas que deseas actualizar.

  • Llama al método projects.patch.

En el siguiente ejemplo, se actualiza la etiqueta color:blue:

En el siguiente fragmento de código, se cambia el valor de la etiqueta color de blue a red.

Solicitud:

PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NAME
{
  updateMask=labels
}

En el ejemplo anterior, PROJECT_NAME es el nombre del proyecto que deseas actualizar.

Cuerpo JSON de la solicitud:

{
    "labels":
      {
        "color": "red"
      }
}

Respuesta:

{
    "projects": [
    {
        "name": "projects/123456789012",
        "parent": "folders/123456789012",
        "projectId": "my-project",
        "state": "ACTIVE",
        "displayName": "PROJECT_NAME"
        "createTime": "2013-11-13T20:31:53.308Z"
        "updateTime": "2013-11-13T20:35:42.308Z"
        "etag": "BwWUlZ6XEfY="
        "labels": {
            "color": "red"
        },
    }
    ]
}