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

Obtém a URL de download de um arquivo.

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/file/get_download_url HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
domain_id	string	Sim
body	object	Não	Parâmetros do corpo da solicitação.
share_id	string	Não	O ID do compartilhamento. Se você acessar o arquivo por meio de um compartilhamento, inclua o cabeçalho `x-share-token` para autenticação e forneça este campo. Nesse caso, o campo `drive_id` é ignorado. Caso contrário, use um par de AccessKey ou um token de acesso para autenticação e forneça o campo `drive_id`. Você deve especificar `share_id` ou `drive_id`.	7JQX1FswpQ8
drive_id	string	Não	O ID do drive.	1
file_id	string	Sim	O ID do arquivo.	9520943DC264
file_name	string	Não	O nome do arquivo. O comprimento máximo é de 1.024 caracteres.	1.txt
expire_sec	integer	Não	O tempo de vida (TTL) da URL de download, em segundos. O valor máximo é 115200. O valor padrão é 900.	100
response_content_type	string	Não		video/mp4

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O esquema de resposta.
url	string	A URL pública de download. Se você ativar endpoints de dados inteligentes, o sistema seleciona a melhor linha de rede para o cliente e retorna uma URL de download com o nome de domínio correspondente.	https://data.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt
internal_url	string	A URL de download para uso dentro de uma Virtual Private Cloud (VPC). Este campo não é utilizado se você ativar endpoints de dados inteligentes. Nesse caso, o sistema retorna automaticamente a URL apropriada no campo url. Para usar este campo, entre em contato com o suporte técnico do PDS.	https://data-vpc.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt
cdn_url	string	A URL de download da Content Delivery Network (CDN). Este campo não é utilizado se você ativar endpoints de dados inteligentes. Nesse caso, o sistema retorna automaticamente a URL apropriada no campo url. Para usar este campo, entre em contato com o suporte técnico do PDS.	https://data-cdn.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt
expiration	string	O horário de expiração da URL de download.	2022-01-02T15:04:05.999Z07:00
size	integer	O tamanho do arquivo, em bytes.	10
crc64_hash	string	O valor CRC-64.	5498595269368962671
content_hash	string	O hash do conteúdo do arquivo.	EA4942AA8761213890A5C386F88E6464D2C31CA1
content_hash_name	string	O nome do algoritmo de hash para o conteúdo do arquivo.	sha1

Exemplos

Resposta de sucesso

JSON formato

{
  "url": "https://data.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt",
  "internal_url": "https://data-vpc.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt",
  "cdn_url": "https://data-cdn.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt",
  "expiration": "2022-01-02T15:04:05.999Z07:00",
  "size": 10,
  "crc64_hash": "5498595269368962671",
  "content_hash": "EA4942AA8761213890A5C386F88E6464D2C31CA1",
  "content_hash_name": "sha1"
}

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.