Crear y actualizar etiquetas de proyectos

En este documento se explica cómo crear y actualizar etiquetas de proyectos mediante la API Resource Manager y la Google Cloud consola. Proporciona detalles sobre cómo entender los costes mediante etiquetas y los servicios que admiten etiquetas.

Crear etiquetas para proyectos

Consola

Para añadir 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. Seleccione su proyecto en el menú desplegable Seleccionar un proyecto.

  3. Para añadir una nueva entrada de etiqueta, haz clic en + Añadir etiqueta e introduce una clave y un valor para cada etiqueta que quieras añadir.

  4. Cuando termines de añadir etiquetas, haz clic en Guardar.

Para añadir etiquetas a más de un proyecto a la vez, sigue estos pasos:

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

    Abrir la página Gestionar recursos

  2. En la página Gestionar recursos, seleccione los proyectos a los que quiera añadir etiquetas.

  3. En el panel de información, en la pestaña Etiquetas, haz clic en + Añadir etiqueta e introduce una clave y un valor para cada etiqueta que quieras añadir.

  4. Cuando termines de añadir etiquetas, haz clic en Guardar.

Una vez que hayas añadido etiquetas, puedes filtrar los proyectos escribiendo una clave o un valor de etiqueta en el cuadro de filtro situado encima de la lista de proyectos. El cuadro de filtro sugerirá claves y valores para que puedas previsualizar los resultados.

REST

Para crear un proyecto nuevo con una etiqueta, define el campo labels al crear 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 añadir etiquetas a proyectos ya creados, sigue estos pasos:

Una vez que hayas añadido etiquetas, podrás filtrar los proyectos por ellas. Para obtener más información sobre cómo usar etiquetas para filtrar proyectos, consulta el artículo Listar proyectos.

Actualizar etiquetas de proyectos

Consola

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. Seleccione su proyecto en el menú desplegable Seleccionar un proyecto.

  3. Actualiza las etiquetas de tu proyecto:

    1. Para editar una etiqueta, haz clic en el valor que quieras editar y, a continuación, haz los cambios que quieras.
    2. Para eliminar una etiqueta, coloca el puntero sobre la clave o el valor y haz clic en .

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

Para actualizar las etiquetas de más de un proyecto a la vez, sigue estos pasos:

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

    Abrir la página Gestionar recursos

  2. En la página Gestionar recursos, selecciona los proyectos a los que quieras añadir etiquetas.

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

    1. Para editar una etiqueta, haz clic en el valor que quieras editar y, a continuación, haz los cambios que quieras.
    2. Para eliminar una etiqueta, coloca el puntero sobre la clave o el valor y haz clic en .

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

REST

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

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

  • Modifica las etiquetas que quieras actualizar.

  • Llama al método projects.patch.

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

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

Solicitud:

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

Donde PROJECT_NAME es el nombre del proyecto que quieres 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"
        },
    }
    ]
}