新增"获取文件下载地址"示例

collections/_python-sdk/概述.md

@@ -31,3 +31,4 @@ sidebar:
 | [example_getfilelist.py](https://github.com/ucloud/ufile-sdk-python/blob/master/examples/example_getfilelist.py) | 前缀列表查询                             |
 | [example_listobjects.py](https://github.com/ucloud/ufile-sdk-python/blob/master/examples/example_listobjects.py) | 获取目录文件列表                         |
 | [example_copy.py](https://github.com/ucloud/ufile-sdk-python/blob/master/examples/example_copy.py) | 拷贝文件                                 |
+| [example_geturl.py](https://github.com/ucloud/ufile-sdk-python/blob/master/examples/example_geturl.py) | 获取文件下载地址                         |

collections/_python-sdk/获取下载URL.md

@@ -0,0 +1,73 @@
+---
+title: '创建存储空间'
+sidebar:
+  nav: python-sdk
+---
+
+## 使用说明
+  * 获取US3文件下载地址
+
+## 函数说明
+  * public_download_url(bucket, key)
+    * 功能: 获取文件下载地址
+    * 参数:
+      * bucket: 存储空间名称
+      * key: 文件名称
+    * 返回值: 文件下载地址
+
+  * private_download_url(bucket, key, expires=60, header=None, internal=False)
+    * 功能: 获取私有文件下载地址
+    * 参数:
+      * bucket: 存储空间名称
+      * key: 文件名称
+      * expires: 下载地址有效时间
+      * header: http 请求header，键值对类型分别为string，比如{'User-Agent': 'Google Chrome'}
+      * internal: 是否使用内网下载地址
+    * 返回值: 文件下载地址
+
+## 代码示例
+<div class="copyable" markdown="1">
+
+{% highlight python linenos %}
+# !/usr/bin/env python
+# -*- encoding: utf-8 -*-
+from ufile import filemanager
+
+public_key = ''  # 账户公钥
+private_key = ''  # 账户私钥
+
+bucket = ''  # 空间名称
+key = ''  # 文件在空间中的名称
+
+# 设置上传host后缀,外网可用后缀形如 .cn-bj.ufileos.com（cn-bj为北京地区，其他地区具体后缀可见控制台：对象存储-单地域空间管理-存储空间域名）
+# 默认值为'.cn-bj.ufileos.com'，如果上传文件的bucket所在地域不在北京，请务必设置此项
+upload_suffix = '.cn-bj.ufileos.com'
+# 设置下载host后缀，普通下载后缀即上传后缀，CDN下载后缀为 .ufile.ucloud.com.cn
+download_suffix = '.cn-bj.ufileos.com'
+
+getufile_handler = filemanager.FileManager(public_key, private_key, upload_suffix, download_suffix)
+
+# 判断文件是否存在
+_, resp = getufile_handler.head_file(bucket, key)
+assert resp.status_code == 200, "status: %d error: %s" % (resp.status_code, resp.error)
+
+# 获取公有空间下载url
+url = getufile_handler.public_download_url(bucket, key)
+print("公有云空间下载URL: %s" % url)
+
+# 获取私有空间下载url, expires为下载链接有效期，单位为秒
+url = getufile_handler.private_download_url(bucket, key, expires=60)
+print("私有云空间下载URL: %s" % url)
+{% endhighlight %}
+</div>
+* HTTP 返回状态码
+
+| 状态码 | 描述                     |
+| ------ | ------------------------ |
+| 200    | 文件或者数据下载成功     |
+| 206    | 文件或者数据范围下载成功 |
+| 400    | 不存在的空间             |
+| 403    | API公私钥错误            |
+| 401    | 下载签名错误             |
+| 404    | 下载文件或数据不存在     |
+| 416    | 文件范围请求不合法       |