En esta página, se describe cómo ver los detalles de las carpetas, actualizar la configuración de las carpetas y borrar carpetas con la Google Cloud consola, Google Cloud CLI o la API. Obtén información para modificar los nombres visibles de las carpetas y administrar la ubicación de las carpetas dentro de la jerarquía de tu organización.
Enumera carpetas y ve los detalles de las carpetas
Para enumerar carpetas o ver metadatos de una carpeta específica, como su nombre visible, ID superior y estado del ciclo de vida, debes tener la función Visualizador de carpetas (roles/resourcemanager.folderViewer) o la función Visualizador de la organización (roles/resourcemanager.organizationViewer).
Console
En la Google Cloud consola, abre la página Administrar recursos.
La lista de recursos muestra tu jerarquía como una tabla. Selecciona el recurso de tu organización.
Haz clic en la flecha junto al nombre de la organización para expandir la vista de árbol y ver sus carpetas secundarias.
Para realizar acciones, como mover, borrar o ver la configuración, haz clic en el botón Acciones al final de la fila de ese recurso específico.
Usa la barra Filtrar en la parte superior de la lista de recursos para buscar recursos por nombre, ID o etiqueta.
Usa el selector de proyectos
Usa el selector de proyectos en la barra de navegación superior para cambiar tu contexto activo a un proyecto o carpeta específicos.
En la barra de navegación superior de la Google Cloud consola, haz clic en el selector de proyectos. Este es el menú desplegable ubicado junto al Google Cloud logotipo.
En el cuadro de diálogo que aparece, selecciona tu organización en el menú desplegable para filtrar los resultados.
Explora la jerarquía o busca el proyecto o la carpeta a la que deseas cambiar. Si haces clic en un recurso en este selector, se cambia tu contexto global, lo que afecta los recursos que son visibles en otras páginas de servicios (como Compute Engine o Cloud Storage).
gcloud
Para obtener detalles de una carpeta, usa el comando resource-manager folders describe.
gcloud resource-manager folders describe FOLDER_ID
Reemplaza FOLDER_ID por el ID de la carpeta que deseas ver.
Para enumerar las carpetas secundarias de un recurso de organización, usa el comando resource-manager folders list.
gcloud resource-manager folders list \
--organization ORGANIZATION_ID
Reemplaza ORGANIZATION_ID por el ID del recurso de organización del que deseas ver una lista de las carpetas secundarias.
Para enumerar las carpetas secundarias de un recurso de carpeta, usa el comando resource-manager folders list.
gcloud resource-manager folders list \
--folder FOLDER_ID
Reemplaza FOLDER_ID por el ID del recurso de carpeta del que deseas ver una lista de las carpetas secundarias.
Para enumerar los proyectos dentro de un recurso de organización o carpeta, usa el comando projects list y el argumento filter.
gcloud projects list \
--filter=" parent.id: 'RESOURCE_ID' "
Reemplaza RESOURCE_ID por el ID del recurso de organización o carpeta del que deseas ver una lista de los proyectos secundarios.
REST
La solicitud de curl para obtener carpetas:
curl -X GET -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/FOLDER_ID
Reemplaza FOLDER_NAME por el nombre de la carpeta, como folders/123.
La solicitud de curl para enumerar carpetas:
curl -X GET -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/folders?parent=PARENT_NAME
Reemplaza PARENT_NAME por el nombre del recurso superior en el que creas la carpeta, como organizations/123 o folders/123.
Actualiza carpetas
Para actualizar el nombre visible de una carpeta, debes tener el rol Editor de carpetas (roles/resourcemanager.folderEditor) o el rol Administrador de carpetas (roles/resourcemanager.folderAdmin) en la carpeta.
Console
En la Google Cloud consola, abre la página Administrar recursos.
Haz clic en la flecha junto al nombre de la organización para expandir la vista de árbol y ver sus carpetas secundarias.
En la fila de la carpeta que deseas actualizar, haz clic en el menú Acciones al final de la fila y, luego, en Configuración.
Ingresa el nombre nuevo de la carpeta y haz clic en Guardar.
gcloud
Para actualizar el nombre visible de una carpeta, haz lo siguiente:
gcloud resource-manager folders update FOLDER_ID --display-name="NEW_DISPLAY_NAME"
Reemplaza lo siguiente:
FOLDER_ID: el ID de la carpeta que deseas actualizar.NEW_DISPLAY_NAME: el nuevo nombre visible de la carpeta.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- FOLDER_ID: el Google Cloud ID de la carpeta
- NEW_DISPLAY_NAME: el nuevo nombre visible de la carpeta
Método HTTP y URL:
PATCH https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName
Cuerpo JSON de la solicitud:
{
"displayName": "NEW_DISPLAY_NAME"
}
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 PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName"
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 PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"name": "operations/fc.1234567890abcdef",
"metadata": {
"@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperationMetadata",
"displayName": "NEW_DISPLAY_NAME",
"operationType": "UPDATE",
"resourceName": "folders/FOLDER_ID"
},
"done": false
}
Mueve una carpeta a otra
A fin de mover una carpeta a otra, debes tener el permiso resourcemanager.folders.move para las carpetas de origen y de destino.
Console
El proceso de mover carpetas a otras carpetas en la consola es similar al de mover proyectos.
- En la Google Cloud consola, abre la página Administrar recursos.
- Selecciona el recurso de tu organización en el menú desplegable Organización en la parte superior izquierda de la página.
- Haz clic en la fila de tu carpeta para seleccionarla de la lista de proyectos y carpetas.
- Haz clic en el menú de opciones (los puntos suspensivos verticales) de la fila y haz clic en Mover.
- Haz clic en Explorar para seleccionar la carpeta a la que deseas moverla.
- Haz clic en Mover.
gcloud
Para mover una carpeta dentro del recurso de la organización, ejecuta el siguiente comando en Google Cloud CLI:
gcloud resource-manager folders move FOLDER_ID \ --organization=PARENT_ID
Reemplaza lo siguiente:
FOLDER_ID: el ID de la carpeta que deseas mover.PARENT_ID: el ID del recurso de organización superior.
Para mover una carpeta dentro de otra carpeta, ejecuta el siguiente comando:
gcloud resource-manager folders move FOLDER_ID \ --folder=PARENT_ID
Reemplaza lo siguiente:
FOLDER_ID: el ID de la carpeta que deseas mover.PARENT_ID: el ID del recurso de organización o carpeta superior.
REST
El JSON de la solicitud luce así:
request_json= '{
destinationParent: "folders/DESTINATION_FOLDER_ID"
}'
La solicitud de curl para mover carpetas:
curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token} \
-d "$request_json" \
https://cloudresourcemanager.googleapis.com/v3/folders/DISPLAY_NAME:move
Reemplaza lo siguiente:
- DESTINATION_FOLDER_ID: el ID de la carpeta en la que mueves otra carpeta, por ejemplo,
98765. - DISPLAY_NAME: el nombre visible de la carpeta que mueves, por ejemplo "Mi carpeta genial".
La respuesta para mover carpetas luce así:
{
"name": "operations/fm.1234567890",
"metadata": {
"@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
"displayName": "DISPLAY_NAME",
"operationType": "MOVE"
}
}
La solicitud de curl para obtener operaciones luce así:
curl -H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/operations/fm.1234567890
La respuesta para obtener operaciones luce así:
{
"name": "operations/fm.1234567890",
"metadata": {
"@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
"displayName": "DISPLAY_NAME",
"operationType": "MOVE"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.resourcemanager.v3.Folder",
"name": "folders/12345",
"parent": "folders/98765",
"displayName": "DISPLAY_NAME",
"lifecycleState": "ACTIVE",
"createTime": "2017-07-19T23:29:26.018Z",
"updateTime": "2017-07-20T00:54:44.295Z"
}
}
Borra carpetas
Para borrar una carpeta, debes tener el rol Editor de carpetas (roles/resourcemanager.folderEditor) o el rol Administrador de carpetas (roles/resourcemanager.folderAdmin) en la carpeta.
Console
En la Google Cloud consola, abre la página Administrar recursos.
En la Google Cloud consola, ve a la página Administrar recursos.Haz clic en la flecha junto al nombre de la organización para expandir la vista de árbol y ver sus carpetas secundarias.
En la fila de la carpeta que deseas borrar, haz clic en el Menú de acciones al final de la fila y, luego, en Borrar.
En el diálogo de confirmación, escribe el ID o el nombre de la carpeta para confirmar y haz clic en Borrar.
gcloud
Para borrar una carpeta, ejecuta el siguiente comando:
gcloud resource-manager folders delete FOLDER_ID
Reemplaza lo siguiente:
FOLDER_ID: el ID de la carpeta que deseas borrar.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- FOLDER_ID: el Google Cloud ID de la carpeta
Método HTTP y URL:
DELETE https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"name": "operations/fc.1234567890abcdef",
"metadata": {
"@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperationMetadata",
"operationType": "DELETE",
"resourceName": "folders/FOLDER_ID"
},
"done": false
}
Información adicional
Cuando borras una carpeta, esta entra en un estado de eliminación temporal durante un período de retención de 30 días antes de que se borre de forma permanente o definitiva.
Estado de eliminación temporal: Durante el período de retención de 30 días, la carpeta se marca para su eliminación y ya no está activa. No puedes crear proyectos ni subcarpetas nuevos dentro de una carpeta borrada temporalmente.
Estado de eliminación definitiva: Después de 30 días, Google Cloud se quita la carpeta y sus metadatos de forma permanente. Esta acción es irreversible.
Recuperación: Si borras una carpeta por accidente, puedes recuperarla en un plazo de
30 días con el comando gcloud resource-manager folders undelete o
la API.
Requisitos previos y restricciones
- La carpeta debe estar vacía: No puedes borrar una carpeta que aún contenga proyectos o subcarpetas activos. Primero, debes mover o borrar todos los recursos secundarios.
- Permisos obligatorios: Para borrar o recuperar una carpeta, debes tener la función Editor de carpetas (
roles/resourcemanager.folderEditor) o Administrador de carpetas (roles/resourcemanager.folderAdmin).
Buscar
Para buscar carpetas que coincidan con la consulta especificada, usa gcloud alpha resource-manager
folders search y pasa la condición en la marca --query. El alcance de la búsqueda son todas las carpetas para las que el usuario tiene permiso de visualización.
gcloud alpha resource-manager folders search --query="name:vij*"
<table output showing the folders with names starting from vij eg. vijeta, vijay-folder>
gcloud alpha resource-manager folders search --query="state:DELETE_REQUESTED"
<table output showing folders for which delete has been requested>
Todas las carpetas para las que el usuario tiene permiso de visualización se pueden mostrar con el comando gcloud folders search.
gcloud folders search
<table output showing all viewable folders>
¿Qué sigue?
- Obtén información para administrar proyectos dentro de carpetas.
- Obtén información sobre las funciones y los permisos de las carpetas.