All Products
Search
Document Center

Drive and Photo Service:GetDomain

Last Updated:Aug 04, 2025

Get domain information.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request syntax

POST /v2/domain/get HTTP/1.1

Request parameters

ParameterTypeRequiredDescriptionExample
bodyobjectNo

The request parameters.

domain_idstringYes

The ID of the domain.

bj1
get_quota_usedbooleanNo

Specifies whether to return the used quota of the domain. Default value: false. If the quota of the domain is greater than 0 and you set this parameter to true, the used quota of the domain is returned.

true

Response parameters

ParameterTypeDescriptionExample
Domain

The information about the domain.

Examples

Sample success responses

JSONformat

{
  "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": "deny",
    "except_app_id_list": [
      "8ovxCTRUDdbpVWBP"
    ]
  },
  "watermark_config": {
    "enable_on_preview": true,
    "enable_doc_preview": true,
    "display_access_user_name": true,
    "display_shareLink_creator_name": true
  },
  "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": ""
      },
      "we_chat_sync_config": {
        "enabled": true,
        "tag_id": "",
        "cron": ""
      }
    }
  },
  "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": ""
      }
    ]
  }
}

Error codes

For a list of error codes, visit the Service error codes.