获取文件下载地址。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /v2/file/get_download_url HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| domain_id |
string |
是 |
||
| body |
object |
否 |
请求体参数。 |
|
| share_id |
string |
否 |
分享 id。
如果通过分享操作文件，请携带 |
7JQX1FswpQ8 |
| drive_id |
string |
否 |
空间 id。 |
1 |
| file_id |
string |
是 |
文件 id。 |
9520943DC264 |
| file_name |
string |
否 |
文件名，最长 1024 字符。 |
1.txt |
| expire_sec |
integer |
否 |
下载地址过期时间，单位为秒，最长 115200 秒，默认为 900 秒。 |
100 |
| response_content_type |
string |
否 |
video/mp4 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response。 |
||
| url |
string |
公网下载地址 （开启智能数据域名后，根据客户网络情况选取最优线路，返回对应域名下载地址）。 |
https://data.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt |
| internal_url |
string |
vpc 内下载地址 （开启智能数据域名后将不使用该字段，根据请求该参数会自适应返回在 URL 字段值内，如需使用该字段请联系 PDS 技术支持）。 |
https://data-vpc.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt |
| cdn_url |
string |
cdn 下载地址 （开启智能数据域名后不使用该字段，根据请求该参数会自适应返回在 URL 字段值内，如需使用该字段请联系 PDS 技术支持）。 |
https://data-cdn.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt |
| expiration |
string |
下载链接的过期时间。 |
2022-01-02T15:04:05.999Z07:00 |
| size |
integer |
文件大小，单位：byte。 |
10 |
| crc64_hash |
string |
crc64 值。 |
5498595269368962671 |
| content_hash |
string |
文件内容 hash。 |
EA4942AA8761213890A5C386F88E6464D2C31CA1 |
| content_hash_name |
string |
文件内容 hash 算法名。 |
sha1 |
示例
正常返回示例
JSON格式
{
"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"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。