Cómo ver y actualizar proyectos

En esta página, se explica cómo recuperar metadatos del proyecto y modificar la configuración existente del proyecto. También puedes buscar proyectos específicos dentro de tu jerarquía de recursos según su estado o nombres visibles.

Cómo encontrar el nombre, el número y el ID del proyecto

Para interactuar con los recursos de Google Cloud , debes proporcionar la información de identificación del proyecto en cada solicitud. Un proyecto se identifica por el ID y el número de proyecto.

Console

Ve a la página Bienvenida en la consola de Google Cloud .
Ir a Bienvenida
En el selector de proyectos que se encuentra en la parte superior de la página, selecciona tu proyecto.

Nota: En el selector de proyectos, se pueden mostrar hasta 4,000 recursos. Si no ves un recurso que debería aparecer, ve a la página Administrar recursos y filtra la lista con el nombre de ese recurso.

El nombre, el número y el ID del proyecto aparecen después del encabezado Bienvenido.

Obtén un proyecto existente

Para obtener los metadatos detallados de un proyecto Google Cloud específico, como el estado del ciclo de vida, la hora de creación y el recurso principal del proyecto, usa Google Cloud CLI o la API.

Debes tener el estado de propietario del proyecto o los permisos del rol de navegador (roles/browser) para acceder a los detalles del proyecto.

gcloud

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

PROJECT_ID: Es el ID del proyecto de Google Cloud .

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud projects describe PROJECT_ID

Windows (PowerShell)

gcloud projects describe PROJECT_ID

Windows (cmd.exe)

gcloud projects describe PROJECT_ID

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es el ID del proyecto de Google Cloud .

Método HTTP y URL:

GET https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID

Cuerpo JSON de la solicitud:

{}

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID"

PowerShell

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
    "projectNumber": "464036093014",
    "projectId": "our-project-123",
    "lifecycleState": "ACTIVE",
    "name": "my project",
    "labels": {
        "mylabel": "prod"
    },
    "createTime": "2016-01-07T21:59:43.314Z"
}

Enumera todos los proyectos de un recurso.

Para enumerar todos los proyectos que son elementos secundarios directos de un recurso, usa el método projects.list de la versión 3 y especifica el recurso principal en la consulta:

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

FOLDER_ID: El ID de la carpeta Google Cloud

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
    "parent": "folders/662951040570"
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
    "projectNumber": "464036093014",
    "projectId": "our-project-123",
    "lifecycleState": "ACTIVE",
    "name": "my project",
    "labels": {
        "mylabel": "prod"
    },
    "createTime": "2016-01-07T21:59:43.314Z"
}

Busca proyectos

Para encontrar proyectos que coincidan con criterios específicos, como un prefijo de nombre visible o un estado del ciclo de vida específico, usa el método projects.search o el comando gcloud alpha resource-manager projects search.

El alcance de la búsqueda incluye todos los proyectos para los que tienes el permiso resourcemanager.projects.get.

Sintaxis de las consultas

Puedes filtrar tu búsqueda con la marca --query (gcloud) o el parámetro query (API). Estos son algunos de los filtros de búsqueda más comunes:

displayName: Es el nombre descriptivo del proyecto.
state: Es el estado del ciclo de vida del proyecto, por ejemplo, ACTIVE o DELETE_REQUESTED.
parent.type y parent.id: Filtran los resultados por una organización o carpeta específica.

Permisos

Si especificas un elemento superior en la consulta (por ejemplo, parent:folders/123), debes tener permisos de resourcemanager.projects.list en ese elemento superior. Si tienes este permiso, todos los proyectos del superior se mostrarán después de que se hayan aplicado los filtros restantes.

Si no tienes este permiso, todos los proyectos en los que tienes el permiso resourcemanager.projects.get se mostrarán después de que se hayan aplicado los filtros restantes.

Si no especificas un elemento superior, los resultados incluirán todos los proyectos en los que tengas permisos de resourcemanager.projects.get.

gcloud

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

PROJECT_ID: Es el ID del proyecto de Google Cloud .

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud alpha projects search --query="name:z*"

Windows (PowerShell)

gcloud alpha projects search --query="name:z*"

Windows (cmd.exe)

gcloud alpha projects search --query="name:z*"

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

The response contains the projects with names starting with 'z'

REST

Método HTTP y URL:

GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain

Cuerpo JSON de la solicitud:

{}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
      "projects": [
        {
          "name": "projects/951040570662",
          "parent": "folders/662951040570",
          "projectId": "tokyo-rain-123",
          "state": "ACTIVE",
          "displayName": "Tokyo Rain",
          "createTime": "2013-11-13T20:31:53.308Z",
          "updateTime": "2013-11-13T20:31:53.308Z",
          "etag": "BwWUlZ6XEfY="
        }
      ]
}

Actualiza proyectos

Puedes ver el nombre, las etiquetas y los identificadores del proyecto. Para obtener más información sobre cómo actualizar proyectos, consulta la página de referencia de la API del proyecto. Para actualizar proyectos, usa uno de los siguientes métodos:

Console

Para actualizar el nombre o las etiquetas de un proyecto con la consola de Google Cloud , haz lo siguiente:

En la consola de Google Cloud , ve a la página Configuración de IAM y administración.
Ir a Configuración de IAM y administración

Los pasos restantes aparecen en la consola de Google Cloud .
En la parte superior de la pantalla, haz clic en la lista desplegable de selección de proyectos.
En la ventana Seleccionar desde que aparece, haz clic en la lista desplegable de las organizaciones y, luego, selecciona tu organización. Si eres un usuario de prueba gratuita, omite este paso, ya que la lista de organizaciones no aparece.
Selecciona tu proyecto en la lista que aparece.
Para cambiar el nombre del proyecto, edita el Nombre del proyecto y, luego, haz clic en Guardar.
Para agregar o editar etiquetas, ve a la sección Etiquetas de la página y haz clic en Administrar etiquetas. Para obtener información sobre cómo agregar o actualizar claves y valores de etiquetas, consulta Crea y administra etiquetas.
Para cambiar las etiquetas, haz clic en Etiquetas en el navegador izquierdo.
Obtén más información para usar etiquetas.

gcloud

En la consola de Google Cloud , activa Cloud Shell.

Activa Cloud Shell

En la parte inferior de la consola de Google Cloud , se inicia una sesión de Cloud Shell que muestra una ventana emergente con una línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.
Para actualizar el nombre o las etiquetas de un proyecto, usa el comando gcloud alpha projects update:
```
gcloud alpha projects update PROJECT_ID \
   --name=NAME \
   --update-labels=KEY=VALUE, ...
```
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID del proyecto que deseas actualizar.
- NAME: Es el nuevo nombre que deseas asignar al proyecto.
- KEY: Es la clave de una etiqueta que deseas actualizar.
- VALUE: Es el valor de una etiqueta que deseas actualizar.
Para obtener más información y marcas adicionales que se pueden usar con este comando, consulta el SDK de Google Cloud CLI.

REST

Para actualizar un proyecto, haz lo siguiente:

Obtén el objeto project con el método projects.get.
Modifica los campos que deseas actualizar.
Realiza una llamada al método projects.patch.

En el siguiente ejemplo, se actualiza el nombre visible del proyecto a myproject y se establece la etiqueta color en red:

Solicitud:

PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NUMBER?updateMask=displayName,labels

En este comando, PROJECT_NUMBER es el ID numérico del proyecto que deseas actualizar.

Cuerpo JSON de la solicitud:

{
  "displayName": "myproject",
  "labels": {
    "color": "red"
  }
}

Respuesta:

{
  "projects": [
    {
      "name": "projects/951054970012",
      "parent": "folders/662951040570",
      "projectId": "Osaka-rain-234",
      "state": "ACTIVE",
      "displayName": "myproject",
      "createTime": "2013-11-13T20:31:53.308Z",
      "updateTime": "2013-11-13T20:35:42.308Z",
      "etag": "BwWUlZ6XEfY=",
      "labels": {
        "color": "red"
      }
    }
  ]
}

¿Qué sigue?

Obtén información para mover un proyecto dentro de tu jerarquía de recursos.
Obtén más información para migrar un proyecto de un recurso de organización a otro.

Cómo ver y actualizar proyectos Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Cómo encontrar el nombre, el número y el ID del proyecto

Console

Obtén un proyecto existente

gcloud

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

Enumera todos los proyectos de un recurso.

REST

curl

PowerShell

Busca proyectos

gcloud

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

Actualiza proyectos

Console

gcloud

REST

¿Qué sigue?

Cómo ver y actualizar proyectos