Puedes ver los detalles de las carpetas, actualizar los nombres visibles, mover carpetas y borrar las que no sean necesarias con la consola de Google Cloud , Google Cloud CLI o la API de Cloud Resource Manager. La administración de carpetas te permite organizar tus recursos y mantener tu jerarquía de recursos de Google Cloud a medida que evolucionan los proyectos y los equipos.
Enumera carpetas y consulta sus detalles
Para enumerar carpetas o ver los metadatos de una carpeta específica, como su nombre visible, el ID superior y
el estado del ciclo de vida, debes tener el rol de visualizador de carpetas (roles/resourcemanager.folderViewer)
o el de visualizador de la organización (roles/resourcemanager.organizationViewer).
Console
En la consola de Google Cloud , abre la página Administrar recursos.
En la lista de recursos, se 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 Acciones al final de la fila de ese recurso específico.
Usa la barra Filtro que se encuentra en la parte superior de la lista de recursos para buscarlos por nombre, ID o etiqueta.
Usa el selector de proyectos
El selector de proyectos se encuentra en la barra de navegación y no forma parte de la interfaz principal de la página de Resource Manager. Úsala para cambiar tu contexto global activo a un proyecto o una carpeta específicos.
Haz clic en el selector de proyectos. 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 quieres cambiar. Si haces clic en un recurso de este selector, se cambia tu contexto global, lo que afecta los recursos que se muestran en otras páginas de servicio (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 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 para el que deseas ver una lista de carpetas secundarias.
Para enumerar los proyectos de un recurso de organización o carpeta, usa
el comando projects list con el argumento filter.
gcloud projects list \
--filter=" parent.id: 'RESOURCE_ID' "
Reemplaza RESOURCE_ID por el ID del recurso de organización o carpeta para el que deseas ver una lista de 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 crearás la carpeta, como organizations/123 o folders/123.
Actualiza carpetas
Para actualizar el nombre visible de una carpeta, debes tener el rol de editor de carpetas (roles/resourcemanager.folderEditor)
o el de administrador de carpetas (roles/resourcemanager.folderAdmin) en la carpeta.
Console
En la consola de Google Cloud , 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, sigue estos pasos:
gcloud resource-manager folders update FOLDER_ID --display-name="NEW_DISPLAY_NAME"
Reemplaza lo siguiente:
FOLDER_ID: Es el ID de la carpeta que deseas actualizar.NEW_DISPLAY_NAME: Es 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 ID de la carpeta de Google Cloud
- NEW_DISPLAY_NAME: Es 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
}
Cómo mover 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 Console es similar al de mover proyectos.
- En la consola de Google Cloud , abre la página Administrar recursos.
- Selecciona el recurso de organización en el menú desplegable Organización que se encuentra 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, luego, en Mover.
- Haz clic en Explorar para seleccionar la carpeta a la que deseas moverla.
- Haz clic en Mover.
gcloud
Para mover una carpeta al recurso de 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: Es el ID de la carpeta que deseas mover.PARENT_ID: Es 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: Es el ID de la carpeta que deseas mover.PARENT_ID: Es el ID del recurso o la carpeta de la organización 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: Es el ID de la carpeta en la que
moverás otra carpeta, por ejemplo,
98765. - DISPLAY_NAME: Es el nombre visible de la carpeta que se moverá, por ejemplo, "Mi carpeta increíble".
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 de editor de carpetas (roles/resourcemanager.folderEditor)
o el rol de administrador de carpetas (roles/resourcemanager.folderAdmin) en la carpeta.
Console
En la consola de Google Cloud , abre la página Administrar recursos.
En la consola de Google Cloud , 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ú Acciones que se encuentra 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: Es 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 ID de la carpeta de Google Cloud
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 borrado no definitivo durante un período de retención de 30 días antes de borrarse de forma permanente o definitiva.
Estado de eliminación no definitiva: 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 nuevos ni subcarpetas dentro de una carpeta borrada de forma no definitiva.
Estado de eliminación definitiva: Después de 30 días, Google Cloud quita de forma permanente la carpeta y sus metadatos. Esta acción es irreversible.
Recuperar: Si borras una carpeta por accidente, puedes restablecerla 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 necesarios: Para borrar o recuperar una carpeta, debes tener el rol de 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 más información para administrar proyectos dentro de carpetas.
- Obtén más información sobre los roles y permisos para las carpetas.