SearchShareLink - Drive and Photo Service: Central de Documentação do Alibaba Cloud

Pesquisa compartilhamentos.

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/share_link/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	O corpo da solicitação.
limit	integer	Não	O número máximo de compartilhamentos a serem retornados. Valores válidos: 1-100. Valor padrão: 100. O número de compartilhamentos retornados pode ser menor que o limite especificado.	50
marker	string	Não	Use o valor next_marker de uma resposta anterior para recuperar a próxima página de resultados. Se este parâmetro não for especificado, a primeira página de resultados será retornada.	NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg
return_total_count	boolean	Não	Especifica se deve retornar a contagem total de compartilhamentos correspondentes.	false
order_by	string	Não	O campo de ordenação. Por padrão, os resultados são ordenados por hora de criação em ordem decrescente. Valores válidos: share_name: O nome do compartilhamento. updated_at: A hora de atualização. description: A descrição. created_at: A hora de criação. Valores válidos: share_name : updated_at : description : created_at :	created_at
order_direction	string	Não	A ordem de classificação. Se o campo de ordenação for created_at ou updated_at, a ordem padrão é decrescente. Para outros campos de ordenação, a ordem padrão é crescente. Valores válidos: ASC: crescente DESC: decrescente Valores válidos: ASC : DESC :	ASC
creators	array	Não	Os IDs dos criadores. 1) Se este parâmetro não for especificado, o escopo de pesquisa dependerá da função do usuário: - Um administrador de drive ou superadministrador pode pesquisar compartilhamentos de todos os membros. - Um administrador de equipe pode pesquisar compartilhamentos dos membros da equipe. - Um usuário comum pode pesquisar apenas seus próprios compartilhamentos. Você só pode especificar IDs de usuário que estejam dentro do escopo de pesquisa da sua função, conforme descrito no ponto 1).
	string	Não	O ID de um criador.	c9b7a5aa04d14ae3867fdc886fa01da4
query	string	Não	As condições de consulta. 1) Campos suportados: 1.1 created_at: A hora de criação. 1.2 updated_at: A hora de atualização. 1.3 share_name_for_fuzzy: O nome do compartilhamento. A pesquisa aproximada (match) é suportada. 1.4 status: O status do compartilhamento. Valores válidos: enabled (ativo) ou disabled (desativado). 1.5 expired_time: A hora de expiração. Para pesquisar compartilhamentos que nunca expiram, defina expired_time='1970-01-01T00:00:00'. Para esses compartilhamentos, o campo expiration na resposta é uma string vazia. O intervalo de tempo expired_time<'1970-01-02T00:00:00' é reservado para uso do sistema e não representa uma hora de expiração válida.	created_at>='2022-01-18T02:50:00' and created_at<'2022-01-19T09:45:28' and share_name_for_fuzzy match 'HD.mp4' and status in ['enabled', 'disabled'] and expired_time='1970-01-01T00:00:00'

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O esquema da resposta.
items	array	A lista de compartilhamentos.
	ShareLink	Um compartilhamento.
next_marker	string	O próximo marcador.	NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg
total_count	integer	A contagem total.	101

Exemplos

Resposta de sucesso

JSON formato

{
  "items": [
    {
      "share_id": "7JQX1FswpQ8",
      "share_pwd": "abcF123x",
      "drive_id": "1",
      "file_id_list": [
        "[\"xx\"]"
      ],
      "expiration": "2020-06-28T11:33:00.000+08:00",
      "expired": false,
      "created_at": "2019-08-20T06:51:27.292Z",
      "updated_at": "2019-08-20T06:51:27.292Z",
      "description": "videos",
      "share_name": "video-1.MP4",
      "creator": "c9b7a5aa04d14ae3867fdc886fa01da4",
      "status": "enabled",
      "preview_count": 10,
      "save_count": 2,
      "download_count": 5,
      "report_count": 0,
      "video_preview_count": 1,
      "access_count": 4,
      "disable_preview": false,
      "disable_save": false,
      "disable_download": false,
      "preview_limit": 100,
      "save_limit": 100,
      "download_limit": 100,
      "share_all_files": true,
      "save_download_limit": 100,
      "office_editable": true
    }
  ],
  "next_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg",
  "total_count": 101
}

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.