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

Cria um link de compartilhamento.

Descrição da operação

Um link de compartilhamento permite que usuários anônimos acessem um ou mais arquivos do drive de um usuário. As permissões do link de compartilhamento determinam o nível de acesso.

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

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
domain_id	string	Sim	O ID do domínio.
body	object	Não	O corpo da solicitação.
drive_id	string	Sim	O ID do drive.	1
share_all_files	boolean	Não	Defina como true para compartilhar todos os arquivos no drive.	true
file_id_list	array	Não	Uma lista de 1 a 100 IDs de arquivos para compartilhar. Este parâmetro é obrigatório quando share_all_files é false e é ignorado quando é true.	["520b217f13adf4fc24f2191991b1664ce045b393"]
	string	Não	O ID do arquivo a ser compartilhado.	9520943DC264
user_id	string	Não	O ID do usuário. Este parâmetro é obrigatório ao autenticar a solicitação com uma AccessKey (AK).	u123
share_pwd	string	Não	A senha para o link de compartilhamento. Deve ter entre 0 e 64 caracteres ASCII imprimíveis. Se este parâmetro não for definido ou for uma string vazia, o link de compartilhamento não exigirá senha.	abcF123x
expiration	string	Não	O tempo de expiração para o link de compartilhamento, especificado no formato RFC 3339 (por exemplo, "2020-06-28T11:33:00.000+08:00"). Para criar um link de compartilhamento que nunca expira, defina este parâmetro como uma string vazia ("").	2020-06-28T11:33:00.000+08:00
description	string	Não	Uma descrição para o link de compartilhamento, com 0 a 1.024 caracteres de comprimento.	百家讲坛合集
share_name	string	Não	O nome do compartilhamento. O comprimento deve estar entre 0 e 128 caracteres. Se não for especificado, o sistema usará o nome do arquivo correspondente ao primeiro ID em file_id_list.	LectureRoom-1.MP4
disable_preview	boolean	Não	Defina como true para impedir que os usuários visualizem os arquivos compartilhados.	false
disable_save	boolean	Não	Defina como true para impedir que os usuários salvem os arquivos compartilhados em seu próprio drive.	false
disable_download	boolean	Não	Defina como true para impedir que os usuários baixem os arquivos compartilhados.	false
preview_limit	integer	Não	O número máximo de vezes que os usuários podem visualizar os arquivos compartilhados. O valor deve ser 0 ou maior. Um valor 0 significa que não há limite.	100
save_limit	integer	Não	O número máximo de vezes que os usuários podem salvar os arquivos compartilhados. O valor deve ser 0 ou maior. Um valor 0 significa que não há limite.	100
download_limit	integer	Não	O número máximo de vezes que os usuários podem baixar os arquivos compartilhados. O valor deve ser 0 ou maior. Um valor 0 significa que não há limite.	100
require_login	boolean	Não	Se for true, os usuários devem fazer login para acessar o link de compartilhamento.	true
office_editable	boolean	Não	Defina como true para permitir a edição online dos documentos compartilhados.	true
creatable	boolean	Não	Defina como true para permitir que os usuários criem arquivos em pastas compartilhadas. Definir isso como true também requer a especificação de creatable_file_id_list.	true
creatable_file_id_list	array	Não	Uma lista de IDs de pastas onde os usuários podem fazer upload de arquivos.
	string	Não	O ID de uma pasta.	9520943DC264

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	ShareLink	O objeto do link de compartilhamento criado.

Exemplos

Resposta de sucesso

JSON formato

{
  "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
}

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.