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 del proyecto y el número de proyecto.

gcloud projects describe PROJECT_ID

gcloud projects describe PROJECT_ID --format="value(projectNumber)"

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 projects describe PROJECT_ID

gcloud projects describe PROJECT_ID

gcloud projects describe PROJECT_ID

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

{}

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"

$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

{
    "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:

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

{
    "parent": "folders/662951040570"
}

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"

$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

{
    "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 principal en la búsqueda (por ejemplo, parent:folders/123), debes tener permisos de resourcemanager.projects.list en ese elemento principal. 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 alpha projects search --query="name:z*"

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