Todos os produtos
Search
Central de documentação

Drive and Photo Service:ListDrive

Última atualização: Jul 04, 2026

Lista as 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/list 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.

limit

integer

Não

O número máximo de unidades a serem retornadas. Valores válidos: 1 a 100. Valor padrão: 100.

100

marker

string

Não

O marcador de paginação. Se especificado, a consulta começa a partir da unidade que segue o marcador em ordem alfabética. Se omitido, a consulta começa do início da lista.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

owner

string

Não

O ID do proprietário. Se omitido, as unidades de todos os proprietários são retornadas.

c9b7a5aa04d14ae3867fdc886fa01da4

owner_type

string

Não

O tipo de proprietário. Valores válidos:

user: Um usuário individual.
group: Um grupo de usuários.

Se omitido, as unidades de todos os tipos de proprietário são retornadas.

user

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O corpo da resposta.

items

array

Uma lista de unidades.

Drive

Informações da unidade.

next_marker

string

O marcador para recuperar a próxima página de resultados. Se não houver mais resultados disponíveis, este parâmetro estará vazio.

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.