Todos os produtos
Search
Central de documentação

Drive and Photo Service:SearchDrive

Última atualização: Jul 04, 2026

Consulta unidades.

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/search HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

domain_id

string

Sim

body

object

Não

Os parâmetros do corpo da solicitação.

drive_name

string

Não

O nome da unidade.

My personal space

limit

integer

Não

O número máximo de unidades a serem retornadas. O valor deve ser de 1 a 100. Valor padrão: 100.

100

marker

string

Não

O token de paginação. O servidor retorna os resultados em ordem alfabética, começando pela entrada após o marcador. Se este parâmetro for omitido, a consulta começará do início da lista.
Valor padrão: nenhum

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

owner

string

Não

O ID do proprietário.

c9b7a5aa04d14ae3867fdc886fa01da4

owner_type

string

Não

O tipo de proprietário. Valores válidos:\n\nuser: Um usuário individual.
group: Um grupo de usuários.

user

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O corpo da resposta.

items

array

A lista de unidades.

Drive

As informações da unidade.

next_marker

string

O token usado para recuperar a próxima página de resultados. Este parâmetro não é retornado quando todos os resultados foram recuperados.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

Exemplos

Resposta de sucesso

JSON formato

{
  "items": [
    {
      "domain_id": "bj1",
      "drive_id": "1",
      "drive_name": "drv1",
      "description": "vipdrive",
      "owner": "c9b7a5aa04d14ae3867fdc886fa01da4",
      "owner_type": "user",
      "drive_type": "normal",
      "status": "enabled",
      "used_size": 20480,
      "total_size": 204800,
      "created_at": "2019-08-20T06:51:27.292Z",
      "creator": "c9b7a5aa04d14ae3867fdc886fa01da4"
    }
  ],
  "next_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg"
}

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.