查看、更新和删除文件夹

本页面介绍了如何使用 Google Cloud 控制台、Google Cloud CLI 或 API 查看文件夹详细信息、更新文件夹设置和删除文件夹。了解如何修改文件夹显示名称,以及如何管理组织层次结构中的文件夹放置位置。

列出文件夹并查看文件夹详细信息

如需列出文件夹或查看特定文件夹的元数据(例如其显示名称、父 ID 和生命周期状态),您必须拥有文件夹查看者角色 (roles/resourcemanager.folderViewer) 或 Organization Viewer 角色 (roles/resourcemanager.organizationViewer)。

控制台

  1. 在 Google Cloud 控制台中,打开管理资源页面。

    打开“管理资源”页面

  2. 资源列表以表格形式显示您的层次结构。选择您的组织资源。

  3. 点击组织名称旁边的箭头可展开树状视图并查看其子文件夹。

  4. 如需执行移动、删除或查看设置等操作,请点击相应资源所在行末尾的操作

  5. 使用资源列表顶部的过滤条件栏按名称、ID 或标签搜索资源。

使用项目选择器

项目选择器位于导航栏中,不属于“资源管理器”主页面界面。使用此命令可将有效全局上下文切换到特定项目或文件夹。

  1. 点击项目选择器。在随即显示的对话框中,从下拉菜单中选择您的组织,以过滤结果。

  2. 浏览层次结构或搜索要切换到的项目或文件夹。 在此选择器中点击资源会更改您的全局上下文,从而影响其他服务页面(例如 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/123folders/123

更新文件夹

如需更新文件夹的显示名称,您必须拥有该文件夹的“文件夹编辑者”角色 (roles/resourcemanager.folderEditor) 或“Folder Admin”角色 (roles/resourcemanager.folderAdmin)。

控制台