Todos os produtos
Search
Central de documentação

Drive and Photo Service:CreateDrive

Última atualização: Jul 04, 2026

Cria um drive.

Descrição da operação

Antes de criar um drive, certifique-se de que o usuário ou grupo especificado não tenha um drive atribuído.

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/drive/create HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

domain_id

string

Sim

body

object

Não

O corpo da solicitação.

drive_name

string

Sim

O nome do drive. O nome pode ter até 128 caracteres.

My personal space

owner

string

Sim

O ID do proprietário.

3b3d7245c159488da17d081ad6c64687

owner_type

string

Sim

O tipo de proprietário. Valores válidos:\n\nuser
group

Valores válidos:

  • user :

    user.

  • group :

    group.

user

description

string

Não

A descrição. A descrição pode ter até 1024 caracteres.

vip空间

drive_type

string

Não

O tipo de drive. Atualmente, apenas normal é suportado.

Valores válidos:

  • normal :

    normal.

normal

status

string

Não

O status. Valores válidos:\n\nenabled: O drive está disponível.
disabled: O drive está indisponível.
\n\nO valor padrão é enabled.

Valores válidos:

  • disabled :

    disabled.

  • enabled :

    enabled.

enabled

total_size

integer

Não

O tamanho total do drive em bytes. Por padrão, o tamanho é ilimitado.

1024

default

boolean

Não

Especifica se o drive é o drive padrão. O valor padrão é false.

true

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A resposta.

domain_id

string

O ID do domínio.

bj1

drive_id

string

O ID do drive.

1

drive_name

string

O nome do drive.

My personal space

description

string

A descrição.

vip空间

owner

string

O ID do proprietário.

3b3d7245c159488da17d081ad6c64687

owner_type

string

O tipo de proprietário.

user

drive_type

string

O tipo de drive.

normal

used_size

integer

O espaço utilizado em bytes.

1024

total_size

integer

O tamanho total do drive em bytes.

1024

creator

string

O ID do criador.

c9b7a5aa04d14ae3867fdc886fa01da4

created_at

string

A hora de criação.

2024-08-14T03:14:28.109Z

status

string

O status.

enabled

Exemplos

Resposta de sucesso

JSON formato

{
  "domain_id": "bj1",
  "drive_id": "1",
  "drive_name": "My personal space",
  "description": "VIP space",
  "owner": "3b3d7245c159488da17d081ad6c64687\n",
  "owner_type": "user",
  "drive_type": "normal",
  "used_size": 1024,
  "total_size": 1024,
  "creator": "c9b7a5aa04d14ae3867fdc886fa01da4",
  "created_at": "2024-08-14T03:14:28.109Z",
  "status": "enabled"
}

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.