Todos os produtos
Search
Central de documentação

Drive and Photo Service:CreateDomain

Última atualização: Jul 04, 2026

Cria um domínio.

Descrição da operação

Use o recurso de domínio pai-filho para implementar operações personalizadas no PDS ou aplicar controles granulares a locatários. Para mais informações, entre em contato pelo grupo oficial do DingTalk: 23146118.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

POST /v2/domain/create HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

body

object

Não

O corpo da solicitação.

parent_domain_id

string

Não

O ID do domínio pai. Defina este parâmetro para criar um domínio filho. Este parâmetro é opcional. Para informações sobre a implementação de operações personalizadas, entre em contato com o atendimento ao cliente do PDS.

bj1

domain_name

string

Sim

O nome do domínio.

cloud drive

description

string

Não

A descrição do domínio.

cloud drive dev

init_drive_enable

boolean

Não

Especifica se um drive padrão deve ser ativado para os usuários. Se definido como true, um drive é provisionado automaticamente para cada usuário no primeiro login. O valor padrão é false.

true

init_drive_size

integer

Não

Este parâmetro é obrigatório se init_drive_enable estiver definido como true. O tamanho do drive padrão para novos usuários, em bytes. O valor padrão é 0, que cria um drive com capacidade zero, impedindo que os usuários façam upload de arquivos. Para fornecer armazenamento inicial, você deve definir este parâmetro. O valor -1 indica tamanho ilimitado.

1073741824

user_count_quota

integer

Não

A cota de contagem de usuários para o domínio. Especifica o número máximo de usuários que podem ser criados. O valor 0 indica sem limite.

50

size_quota

integer

Não

A cota total de armazenamento para o domínio, em bytes. Este valor representa o limite de armazenamento combinado para todos os drives dentro do domínio. O valor 0 indica sem limite.

1099511627776

store_redundancy_type

string

Não

O tipo de redundância de armazenamento. Valores válidos:

  • LRS: Locally Redundant Storage

  • ZRS: Zone-Redundant Storage

LRS

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

Domain

Os detalhes do domínio criado.

Exemplos

Resposta de sucesso

JSON formato

{
  "parent_domain_id": "bj1",
  "domain_id": "bj2",
  "domain_name": "pdsdomain",
  "description": "my domain",
  "init_drive_enable": true,
  "init_drive_size": 1073741824,
  "updated_at": "2019-08-20T06:51:27.292Z",
  "created_at": "2019-08-20T06:51:27.292Z",
  "size_quota": 1099511627776,
  "size_quota_used": 1099511627776,
  "user_count_quota": 50,
  "status": 1,
  "used_size": 1099511627776,
  "published_app_access_strategy": {
    "effect": "deny",
    "except_app_id_list": [
      "8ovxCTRUDdbpVWBP"
    ]
  },
  "sharable": false,
  "data_hash_name": "sha1",
  "store_redundancy_type": "LRS"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.