本页面介绍了如何使用 Google Cloud 控制台、Google Cloud CLI 或 API 查看文件夹详细信息、更新文件夹设置和删除文件夹。了解如何修改文件夹显示名称,以及如何管理组织层次结构中的文件夹放置位置。
列出文件夹并查看文件夹详细信息
如需列出文件夹或查看特定文件夹的元数据(例如其显示名称、父 ID 和生命周期状态),您必须拥有文件夹查看者角色 (roles/resourcemanager.folderViewer) 或 Organization Viewer 角色 (roles/resourcemanager.organizationViewer)。
控制台
在 Google Cloud 控制台中,打开管理资源页面。
资源列表以表格形式显示您的层次结构。选择您的组织资源。
点击组织名称旁边的箭头可展开树状视图并查看其子文件夹。
如需执行移动、删除或查看设置等操作,请点击相应资源所在行末尾的操作。
使用资源列表顶部的过滤条件栏按名称、ID 或标签搜索资源。
使用项目选择器
项目选择器位于导航栏中,不属于“资源管理器”主页面界面。使用此命令可将有效全局上下文切换到特定项目或文件夹。
点击项目选择器。在随即显示的对话框中,从下拉菜单中选择您的组织,以过滤结果。
浏览层次结构或搜索要切换到的项目或文件夹。 在此选择器中点击资源会更改您的全局上下文,从而影响其他服务页面(例如 Compute Engine 或 Cloud Storage)中显示的资源。
gcloud
如需获取某个文件夹的详细信息,请使用 resource-manager folders describe 命令。
gcloud resource-manager folders describe FOLDER_ID
将 FOLDER_ID 替换为您要查看的文件夹的 ID。
如需列出组织资源的子文件夹,请使用 resource-manager folders list 命令。
gcloud resource-manager folders list \
--organization ORGANIZATION_ID
将 ORGANIZATION_ID 替换为要查看的子文件夹列表所属的组织资源的 ID。
如需列出文件夹资源的子文件夹,请使用 resource-manager folders list 命令。
gcloud resource-manager folders list \
--folder FOLDER_ID
将 FOLDER_ID 替换为要查看的子文件夹列表所属的文件夹资源的 ID。
如需列出组织资源、文件夹资源或文件夹下的项目,请使用 projects list 命令和 filter 实参。
gcloud projects list \
--filter=" parent.id: 'RESOURCE_ID' "
将 RESOURCE_ID 替换为要查看的子项目列表所属的组织或文件夹资源的 ID。
REST
获取文件夹的 curl 请求:
curl -X GET -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/FOLDER_ID
将 FOLDER_NAME 替换为文件夹名称,例如 folders/123。
列出文件夹的 curl 请求:
curl -X GET -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/folders?parent=PARENT_NAME
将 PARENT_NAME 替换为您要在其中创建文件夹的父资源的名称,例如 organizations/123 或 folders/123。
更新文件夹
如需更新文件夹的显示名称,您必须拥有该文件夹的“文件夹编辑者”角色 (roles/resourcemanager.folderEditor) 或“Folder Admin”角色 (roles/resourcemanager.folderAdmin)。