Todos os produtos
Search
Central de documentação

Drive and Photo Service:SearchDomains

Última atualização: Jul 04, 2026

Pesquisa domínios.

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

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

body

object

Não

Os parâmetros da solicitação.

name

string

Não

O nome do domínio. Há suporte para pesquisa aproximada.

Hello Drive

marker

string

Não

O token de paginação usado na próxima solicitação para recuperar uma nova página de resultados. Você não precisa especificar este parâmetro na primeira solicitação. Você deve especificar o token obtido na consulta anterior como o valor de marker.
Por padrão, este parâmetro está vazio.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

limit

integer

Não

O número máximo de resultados a serem retornados. Valores válidos: 1 a 100. Valor padrão: 100.\n\nO número de resultados retornados deve ser menor ou igual ao número especificado.

50

order_by

string

Não

A regra de classificação. Defina o valor como created_at, o que especifica que os resultados são classificados com base na hora em que o domínio foi criado.

created_at

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

items

array

Os domínios consultados.

Domain

O domínio consultado.

next_marker

string

Um token de paginação. Ele pode ser usado na próxima solicitação para recuperar uma nova página de resultados. Se next_marker estiver vazio, não há próxima página.

NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

Exemplos

Resposta de sucesso

JSON formato

{
  "items": [
    {
      "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"
    }
  ],
  "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.