全部產品
Search
文件中心

Drive and Photo Service:CreateDomain - 建立Domain

更新時間:Feb 26, 2026

建立 domain。

介面說明

如果您需要基於 PDS 做二次營運,並想針對您的租戶做一些細粒度控制,此時可以使用 PDS 的父子 Domain 功能。 詳情:請聯絡官方DingTalk群進行諮詢:23146118

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

POST /v2/domain/create HTTP/1.1

請求參數

名稱

類型

必填

描述

樣本值

body

object

請求體參數。

parent_domain_id

string

父 domain id 如果需要建立子 domain,可以設定該值,一般情況下不需要建立。 如果需要針對 PDS 做二次營運,可以聯絡 PDS 官網客服進行諮詢。

bj1

domain_name

string

domain 名稱

cloud drive

description

string

domain 描述

cloud drive dev

init_drive_enable

boolean

是否開通預設網盤。為 true 則所有使用者在第一次登入後都預設分配一個網盤。預設 false

true

init_drive_size

integer

init_drive_enable 為 true 時必選。 建立使用者時,預設網盤的大小,單位:Bytes。 預設為 0,此時建立的 drive 大小為 0,不可以上傳檔案,如果需要初始化 drive, 請設定該值。 -1 則表示不限大小。

1073741824

user_count_quota

integer

使用者數配額,表示該 domain 允許建立的使用者數量,為 0 表示不限制

50

size_quota

integer

容量配額,表示 domain 下所有 drive 的總 quota 大小,0 表示不限制

1099511627776

返回參數

名稱

類型

描述

樣本值

Domain

建立的域資訊

樣本

正常返回樣本

JSON格式

{
  "parent_domain_id": "",
  "domain_id": "",
  "domain_name": "",
  "description": "",
  "init_drive_enable": true,
  "init_drive_size": 0,
  "updated_at": "",
  "created_at": "",
  "size_quota": 0,
  "size_quota_used": 0,
  "user_count_quota": 0,
  "status": 0,
  "used_size": 0,
  "published_app_access_strategy": {
    "effect": "",
    "except_app_id_list": [
      ""
    ]
  },
  "watermark_config": {
    "enable_doc_preview": true,
    "display_access_user_name": true,
    "display_shareLink_creator_name": true,
    "display_custom_text": ""
  },
  "auth_config": {
    "key": {
      "enable": true,
      "app_id": "",
      "app_secret": "",
      "endpoint": "",
      "enterprise_id": "",
      "white_list_enable": true,
      "ldap_config": {
        "version": "",
        "host": "",
        "port": 0,
        "uid": "",
        "admin_dn": "",
        "global_uid": "",
        "admin_password": "",
        "base_dn": "",
        "display_name_key": "",
        "type": "",
        "sync_config": {
          "enabled": true,
          "group_object_class": "",
          "group_filter": "",
          "user_object_class": "",
          "user_filter": "",
          "cron": ""
        }
      },
      "ding_sync_config": {
        "enabled": true,
        "cron": "",
        "sync_mobile_enabled": true,
        "sync_email_enabled": true
      },
      "we_chat_sync_config": {
        "enabled": true,
        "tag_id": "",
        "cron": ""
      },
      "lark_sync_config": {
        "enabled": true,
        "cron": "",
        "sync_mobile_enabled": true,
        "sync_email_enabled": true
      }
    }
  },
  "sharable": true,
  "ali_owner_id": "",
  "archive_files_config": {
    "enabled": true,
    "version": ""
  },
  "uncompress_config": {
    "enabled": true,
    "version": ""
  },
  "multi_revision_config": {
    "revision_merge_enabled": true,
    "revision_count": 0,
    "revision_recycle_period": 0
  },
  "app_config": {
    "same_name_file_upload_mode": "",
    "web_client_download_mode": "",
    "single_file_upload_size_limit": 0,
    "allow_upload_file_category_list": [
      ""
    ],
    "allow_upload_custom_file_ext_list": [
      ""
    ]
  },
  "recycle_bin_config": {
    "auto_delete_enabled": true,
    "auto_delete_keep_second": 0,
    "delete_trash_normal_file_disabled": true
  },
  "office_preview_config": {
    "enabled": true
  },
  "office_edit_config": {
    "enabled": true
  },
  "share_link_detail": {
    "enable_office_editable": true
  },
  "endpoints": {
    "api_endpoint": "",
    "api_vpc_endpoint": "",
    "app_endpoint": "",
    "auth_endpoint": "",
    "mgmt_endpoint": "",
    "web_office_endpoint_list": "",
    "store_list": [
      {
        "store_id": "",
        "type": "",
        "bucket": "",
        "base_path": "",
        "role_arn": "",
        "ownership": "",
        "location": "",
        "public_endpoint": "",
        "vpc_endpoint": "",
        "acc_endpoint": "",
        "acc_oversea_endpoint": "",
        "cdn_endpoint": "",
        "endpoint": ""
      }
    ],
    "va_store_list": [
      {
        "store_id": "",
        "type": "",
        "bucket": "",
        "base_path": "",
        "role_arn": "",
        "ownership": "",
        "location": "",
        "public_endpoint": "",
        "vpc_endpoint": "",
        "acc_endpoint": "",
        "acc_oversea_endpoint": "",
        "cdn_endpoint": "",
        "endpoint": ""
      }
    ]
  },
  "data_hash_name": "",
  "store_redundancy_type": "LRS"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情