建立資料夾

Google Cloud 資料夾可讓您在資源階層中將專案分組及整理。您可以使用資料夾委派管理職責、強制執行環境專屬的組織政策,以及簡化各部門的成本管理作業。

資料夾是Google Cloud 資源階層中的節點,可包含專案、其他資料夾,或兩者兼具,並位於組織資源底下。您也可以將共用相同 Identity and Access Management (IAM) 角色、拒絕政策或組織政策的資源分組。雖然資料夾可以包含多個子資料夾或資源,但每個資料夾或資源只能有一個上層。

資料夾階層範例

在下圖中,組織資源「Company」包含代表「Standard Workloads」、「Regulated Workloads」和「Shared infrastructure」的資料夾。在「Regulated Workloads」下方,資料夾會依環境分為「Non-Prod Environment」和「正式環境」。「正式環境」資料夾進一步分為「客戶專用 (受限)」和「內部專用 (標準)」資料夾,以強制執行以政策為中心的存取控管。「測試專案」、「開發專案」和「正式環境專案」等專案包含專案所需的資源。這項功能可讓您靈活地在適當的精細程度,指派允許、拒絕或組織政策。

包含工作負載、環境和專案的資料夾階層。

您可以使用資料夾層級的允許和拒絕政策,控管資料夾內資源的存取權。舉例來說,如果使用者獲得資料夾的運算執行個體管理員角色,就會擁有該資料夾中所有專案的運算執行個體管理員角色。

事前準備

資料夾功能僅適用於擁有組織資源的 Google Workspace 和 Cloud Identity 客戶。如要進一步瞭解如何取得組織資源,請參閱「取得組織資源」。

如果您想探索使用資料夾的最佳方法,我們建議您:

  1. 參閱使用 IAM 控制資料夾的存取權。該主題說明如何控制存取資料夾和其中資源的人員和存取權限。
  2. 瞭解如何設定資料夾權限。資料夾支援多種不同的 IAM 角色。如要廣泛設定權限,讓使用者查看專案結構,請在組織資源層級,為整個網域授予組織檢視者和資料夾檢視者角色。如要限制資料夾階層分支的瀏覽權限,請在您希望使用者查看的資料夾上授予「資料夾檢視者」角色。
  3. 建立資料夾。規劃如何整理 Cloud 資源時,建議您先建立一個資料夾做為沙箱,在其中實驗哪種階層最適合貴機構的資源。請將資料夾想成資源之間的分界線,以及存取和設定政策的附加點。您可以選擇為屬於不同部門的資源建立資料夾,並將管理員角色指派給資料夾來委派管理員權限。資料夾也可用於將屬於應用程式或不同環境 (例如開發、正式、測試) 的資源分組。使用巢狀資料夾模擬這些不同的情境。

常見的做法是建立資料夾,然後在其中加入其他資料夾或專案,如先前的資源階層結構所示。這種結構稱作「資料夾階層」。建立資料夾階層時,請記住下列事項:

  • 資料夾最多可建立 10 (十) 層巢狀結構。
  • 上層資料夾最多只能包含 300 個資料夾。這裡指的是下一層的子資料夾,這些子資料夾可以包含更多資料夾或專案。
  • 在階層的同個層級中,資料夾顯示名稱不能重複。

設定管理資料夾的權限

如要存取及管理資料夾,請將資料夾專屬的 IAM 角色指派給特定使用者群組。如要進一步瞭解這些角色,請參閱「使用 IAM 控管資料夾存取權」。此外,建議您參閱最佳做法,找出最適合的資料夾權限設定。

如要管理整個組織資源的資料夾,您必須具備資料夾管理員角色。這個角色授予的權限可讓使用者建立、編輯、刪除、移動及變更資料夾的 IAM 權限,也能在資料夾之間移動專案。

一開始,只有組織管理員可以指派組織資源的資料夾管理員角色。後續獲派這個角色的帳戶,可以將角色授予其他帳戶。

如要設定資料夾權限,請按照下列步驟操作:

控制台

  1. 在 Google Cloud 控制台中,開啟「Manage resources」(管理資源) 頁面。

    前往「Manage resources」(管理資源)

  2. 如果資訊面板未開啟,請按一下「顯示資訊面板」。
  3. 在「Resources」(資源) 表格中,展開包含資料夾的組織。
  4. 從組織下的資源清單中,選取要管理的資料夾。
  5. 在資訊面板中,按一下「Add Principal」(新增主體)。
  6. 在「Add principals」(新增主體) 欄位中,輸入要授予權限的電子郵件地址。
  7. 在「Select a role」(請選擇角色) 選單中,選取「Resource Manager」類別,然後選取要授予的角色,例如「Folder Admin」(資料夾管理員)。
  8. 按一下「儲存」,授予新角色。

gcloud

如要使用 Google Cloud CLI 將資料夾管理員角色授予主體,請執行下列指令:

    gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
    --member=user:USER_ID \
    --role=roles/resourcemanager.folderAdmin

REST

要求 JSON:

request_json= '{ policy: { version: "1", bindings: [ { role: "roles/folderAdmin",
members: [ "user:admin@myorganization.com", ] }, { role: "roles/folderCreator",
members: [ "user:admin@myorganization.com", ] } , { role: "roles/folderMover",
members: [ "user:admin@myorganization.com", ] } , ] } }'

curl 要求:

curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
-d "$request_json" \
https://cloudresourcemanager.googleapis.com/v3/ORGANIZATION_NAME:setIamPolicy

將 ORGANIZATION_NAME 替換為要設定允許政策的組織名稱,例如 organizations/123。

建立資料夾

您必須在父項層級擁有資料夾管理員或資料夾建立者角色,才能建立資料夾。舉例來說,如要在組織層級建立資料夾,您必須具備組織層級的其中一個角色。

在建立資料夾的過程中,您必須指定資料夾名稱。資料夾名稱必須符合以下要求:

  • 名稱可以包含字母、數字、空格、連字號和底線。
  • 資料夾顯示名稱的開頭和結尾必須是字母或數字。
  • 名稱必須介於 3 至 30 個半形字元之間。
  • 名稱不得與同一父項下的其他資料夾相同。

如要建立資料夾,請按照下列步驟操作:

控制台

如要建立資料夾,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Manage resources」(管理資源) 頁面:

    開啟「Manage resources」(管理資源) 頁面

  2. 按一下「建立資料夾」,然後選取下列其中一個選項:

  3. 在「Folder name」(資料夾名稱) 方塊中輸入新的資料夾名稱。

  4. 在「Parent resource」(上層資源) 下方,按一下「Browse」(瀏覽),然後選取要在哪個組織資源或資料夾下建立新資料夾。

    1. 點選「建立」。

gcloud

您可以使用 Google Cloud CLI,透過程式輔助方式建立資料夾。

如要使用 gcloud 指令列工具在組織資源下建立資料夾,請執行下列指令。

gcloud resource-manager folders create \
   --display-name=DISPLAY_NAME \
   --organization=ORGANIZATION_ID

若要在其他資料夾下建立資料夾:

gcloud resource-manager folders create \
   --display-name=DISPLAY_NAME \
   --folder=FOLDER_ID

更改下列內容:

  • DISPLAY_NAME:資料夾的顯示名稱。同一父項下的資料夾不能使用相同的顯示名稱。顯示名稱的開頭和結尾必須是字母或數字。顯示名稱可包含字母、數字、空格、連字號和底線,且長度不可超過 30 個字元。
  • ORGANIZATION_ID:如果父項是組織資源,則為父項組織資源的 ID。
  • FOLDER_ID:上層資料夾的 ID (如果上層是資料夾)。

API

您可以透過 API 要求來建立資料夾。

JSON 要求:

request_json= '{
  display_name: DISPLAY_NAME,
  parent: ORGANIZATION_NAME
}'

「建立資料夾」curl 要求:

curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
-d "$request_json" \
https://cloudresourcemanager.googleapis.com/v3/folders

其中:

  • DISPLAY_NAME:新資料夾的顯示名稱,例如「My Awesome Folder」。
  • ORGANIZATION_NAME:您要在其中建立資料夾的組織資源名稱,例如 organizations/123。

「建立資料夾」回應:

如果呼叫成功註冊作業,回應主體會包含 Operation 的執行個體。

{
  "name": "operations/fc.123456789",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "CREATE"
  }
}

「取得作業」curl 要求:

curl -H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/operations/fc.123456789

「取得作業」回應:

{
  "name": "operations/fc.123456789",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "CREATE"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.Folder",
    "name": "folders/12345",
    "parent": "organizations/123",
    "displayName": "DISPLAY_NAME",
    "lifecycleState": "ACTIVE",
    "createTime": "2017-07-19T23:29:26.018Z",
    "updateTime": "2017-07-19T23:29:26.046Z"
  }
}

在建立資料夾時新增標記

標記可用於建立資源的註解。您可以在建立資料夾時新增標記。如要這麼做,您必須授予標記使用者角色。如要進一步瞭解這個角色包含的權限,請參閱「建立及管理標記」。您只能透過下列其中一種方式,為標記鍵/值組合新增命名空間:

gcloud

如要在建立資料夾時新增標記,請執行下列指令:

  gcloud resource-manager folders create \
      --display-name=DISPLAY_NAME \
      --organization=ORGANIZATION_ID\
      --tags=KEY_VALUE_PAIRS

更改下列內容:

  • DISPLAY_NAME:資料夾的顯示名稱。
  • ORGANIZATION_ID:上層組織資源的專屬 ID。
  • KEY_VALUE_PAIRS:以逗號分隔的清單,其中包含可指派給資源的鍵/值組合。以半形逗號分隔的鍵/值組合範例如下:123/environment=production, 456/create=testresource。

REST

下列程式碼片段是 JSON 要求,可建立資料夾並新增標記。

  POST https://cloudresourcemanager.googleapis.com/v3/folders/
  Authorization: *************
  Content-Type: application/json

  {
    "display_name": "our-folder-456",
    "parent": "organizations/123",
    "tags": {
      "123/environment": "production",
      "123/costCenter": "marketing"
    }
  }

擷取資料夾 ID

您可以使用 Google Cloud 控制台或 Google Cloud CLI 擷取資料夾 ID。

控制台

  1. 在 Google Cloud 控制台中,開啟「Manage resources」(管理資源) 頁面。
  2. 在資源清單中找出資料夾。資料夾 ID 會顯示在資料夾顯示名稱旁的「ID」欄中。

gcloud

如要找出資料夾 ID,請執行下列指令:

gcloud resource-manager folders list --organization=ORGANIZATION_ID

傳播延遲

建立新資料夾後,資料夾可能需要一些時間,才能在我們的全球系統中傳播,並顯示在 Google Cloud 控制台中。這項傳播延遲通常會在幾分鐘內解決,但在極少數情況下可能需要更長時間。您可以使用 gcloud 指令列工具或 API,立即驗證資料夾是否建立。

刪除資料夾

如要刪除資料夾,您必須具備資料夾管理員角色 (roles/resourcemanager.folderAdmin) 或資料夾編輯者角色 (roles/resourcemanager.folderEditor)。資料夾必須清空才能刪除。如需詳細操作說明,請參閱「刪除資料夾」。

設定資料夾存取權

若要設定資料夾的存取權,您必須在父項層級擁有資料夾 IAM 管理員或資料夾管理員角色。

控制台

  1. 在 Google Cloud 控制台中,開啟「Manage Resources」(管理資源) 頁面。

    開啟「管理資源」頁面

  2. 按一下左上角的「Organization」(組織) 下拉式選單,然後選取組織資源。

  3. 找出要變更權限的專案,然後勾選旁邊的核取方塊。

    1. 在右側「Info panel」(資訊面板) 的「Permissions」(權限) 下方,輸入要新增的成員的電子郵件地址。

    2. 在「Select a role」(選取角色) 下拉式選單中,選取要授予這些成員的角色。

    3. 按一下「Add」(新增)。系統會顯示通知,確認成員的新角色已新增或更新。

gcloud

您可以使用 Google Cloud CLI 或 REST API,透過程式輔助方式設定資料夾存取權。

gcloud resource-manager folders \
    add-iam-policy-binding FOLDER_ID \
    --member=user:email1@example.com \
    --role=roles/resourcemanager.folderEditor
gcloud resource-manager folders \
    add-iam-policy-binding FOLDER_ID \
    --member=user:email1@example.com \
    --role=roles/resourcemanager.folderViewer

您也可以使用以下程式碼:

gcloud resource-manager folders \
    set-iam-policy FOLDER_ID POLICY_FILE

更改下列內容:

  • FOLDER_ID:新資料夾的 ID
  • POLICY_FILE:資料夾政策檔案的路徑

API

setIamPolicy 方法會設定資料夾的存取控管政策,取代任何現有政策。resource 欄位應為資料夾的資源名稱,例如 folders/1234。

 request_json= '{
   policy: {
     version: "1",
     bindings: [
       {
         role: "roles/resourcemanager.folderEditor",
         members: [
           "user:email1@example.com",
           "user:email2@example.com",
         ]
       }
     ]
   }
 }'

curl 要求:

   curl -X POST -H "Content-Type: application/json" \
   -H "Authorization: Bearer ${bearer_token}" \
   -d "$request_json" \
   https://cloudresourcemanager.googleapis.com/v3/FOLDER_ID:setIamPolicy

將 FOLDER_ID 替換成要設定 IAM 政策的資料夾名稱,例如 folders/123。

處理長時間執行的作業

某些資料夾作業 (例如建立或遷移) 需要全域傳播,因此會由 Google Cloud 非同步處理。如要避免封鎖終端機或自動化指令碼,可以使用 --async 旗標。

使用這個旗標時,指令會立即傳回長時間執行的作業 (LRO) 物件。接著,您可以在方便時使用 operation_id 輪詢完成狀態。--async 旗標僅支援 folders create 和 folders move 指令。

如要使用這個旗標,請按照下列步驟操作:

  1. 啟動非同步工作。請參考下列指令範例:

    gcloud resource-manager folders create \
        --display-name="Test Async Folder" \
        --organization=2518 \
        --async
    

    輸出內容會提供作業名稱 (例如 fc.8572) 並顯示 done: false。

    回應範例:

    name: operations/fc.8572
    metadata:
    operation_type: CREATE
    display_name: Awe-Inspiring Async Folder
    destination_parent: organizations/2518
    done: false
    
  2. 查看營業狀態。如要確認工作是否完成,請使用 operations describe 指令,並附上前一步驟提供的 ID。

    gcloud beta resource-manager operations describe fc.8572
    

    done 為 true 時,回應區塊會包含新建立資源的完整詳細資料。

    name: operations/fc.8572
    done: true
    response:
      name: folders/6428
      display_name: Awe-Inspiring Async Folder
      lifecycle_state: ACTIVE
      create_time: '2024-03-20T10:00:00Z'
    

後續步驟