本文由簡體中文內容自動轉碼而成。阿里雲不保證此自動轉碼的準確性、完整性及時效性。本文内容請以簡體中文版本為準。
首頁Drive and Photo Service網盤與相冊服務（開發者版）操作指南帳號管理群組管理
搜尋幫助內容

群組管理

更新時間：2024-12-10 08:52
產品
社區

本文檔描述PDS的群組管理功能，您可以通過PDS提供的預設用戶端使用群組管理功能，也可以參考該文檔調用API實現群組管理功能。

基本概念

  • 群組可以理解成企業的一個部門，群組下面可以添加使用者，也可以添加其他群組。

  • 群組成員有兩種類型，一種是使用者，一種是群組。

例如：

image

說明

  • 使用者可以加入多個群組，建議一個使用者加入的群組不超過10個，否則會降低查詢效能。

  • 群組只能在建立時選擇對應的父群組，暫時不支援移動。 如果建立群組時不選擇父群組則該群組作為根群組。

  • 群組層級最多不能超過10層。

API調用及樣本

1. 建立群組

如果需要建立一個根群組，需將is_root參數設定為true。 如果建立的不是根群組，則需要設定parent_group_id，並把is_root設定為false

請求樣本

// 建立根群組
{
  "group_name": "某公司", 
  "is_root": true
}

// 在某公司下建立研發部
{
  "group_name": "研發部", 
  "is_root": false,
  "parent_group_id": "929bf1cec48d4eb28a6cca0af29f1b8f"
}

響應樣本

{
  "domain_id": "bj3231",
  "group_id": "929bf1cec48d4eb28a6cca0af29f1b8f",
  "group_name": "某公司",
  "description": "",
  "created_at": 1677335855709,
  "updated_at": 1677335855709,
  "creator": "",
  "permission": null
}

2. 列舉群組成員

如需列舉所有根群組，則不傳group_id參數。

請求樣本

{
  "group_id": "929bf1cec48d4eb28a6cca0af29f1b8f", 
  "limit": 100
}

響應樣本

{
  "group_items": [
    {
      "domain_id": "bj3231",
      "group_id": "ef6a45fa25f54aacae08a501269de4e4",
      "group_name": "研發部",
      "description": "",
      "created_at": 1677336367210,
      "updated_at": 1677336367210,
      "creator": "",
      "permission": null
    }
  ],
  "user_items": [],
  "next_marker": ""

3. 新增成員到群組

此介面只允許添加使用者，群組可以在建立時通過parent_group_id來設定父群組

請求樣本

{
  "group_id": "ef6a45fa25f54aacae08a501269de4e4",
  "member_id": "39df109b4f4f428db75898bbb0644fa5",
  "member_type": "user"
}

響應樣本

204 NoContent

4. 從群組移除成員

此介面只允許移除使用者，群組只能先將成員移除後再刪除。

請求樣本

{
  "group_id": "ef6a45fa25f54aacae08a501269de4e4",
  "member_id": "39df109b4f4f428db75898bbb0644fa5",
  "member_type": "user"
}

響應樣本

204 NoContent

5. 刪除群組

此介面僅允許刪除沒有成員的群組。

請求樣本

{
  "group_id": "ef6a45fa25f54aacae08a501269de4e4"
}

響應樣本

204 NoContent

上一篇：帳號管理下一篇：檔案管理
  • 本頁導讀 （1, M）
  • 基本概念
  • API調用及樣本
  • 1. 建立群組
  • 2. 列舉群組成員
  • 3. 新增成員到群組
  • 4. 從群組移除成員
  • 5. 刪除群組
文檔反饋
phone 聯絡我們

立即和Alibaba Cloud在線服務人員進行交談，獲取您想了解的產品信息以及最新折扣。

alicare alicarealicarealicare