From 484ba24be99b83b9d17441c3288bf64bb2217631 Mon Sep 17 00:00:00 2001 From: Youlegu Date: Thu, 17 Aug 2023 11:13:52 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E"=E8=8E=B7=E5=8F=96=E6=96=87?= =?UTF-8?q?=E4=BB=B6=E4=B8=8B=E8=BD=BD=E5=9C=B0=E5=9D=80"=E7=A4=BA?= =?UTF-8?q?=E4=BE=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../_python-sdk/\346\246\202\350\277\260.md" | 1 + ...345\217\226\344\270\213\350\275\275URL.md" | 73 +++++++++++++++++++ 2 files changed, 74 insertions(+) create mode 100644 "collections/_python-sdk/\350\216\267\345\217\226\344\270\213\350\275\275URL.md" diff --git "a/collections/_python-sdk/\346\246\202\350\277\260.md" "b/collections/_python-sdk/\346\246\202\350\277\260.md" index bad27ac..1e94b96 100644 --- "a/collections/_python-sdk/\346\246\202\350\277\260.md" +++ "b/collections/_python-sdk/\346\246\202\350\277\260.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) | 获取文件下载地址 | diff --git "a/collections/_python-sdk/\350\216\267\345\217\226\344\270\213\350\275\275URL.md" "b/collections/_python-sdk/\350\216\267\345\217\226\344\270\213\350\275\275URL.md" new file mode 100644 index 0000000..74daa99 --- /dev/null +++ "b/collections/_python-sdk/\350\216\267\345\217\226\344\270\213\350\275\275URL.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: 是否使用内网下载地址 + * 返回值: 文件下载地址 + +## 代码示例 +
+ +{% 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 %} +
+* HTTP 返回状态码 + +| 状态码 | 描述 | +| ------ | ------------------------ | +| 200 | 文件或者数据下载成功 | +| 206 | 文件或者数据范围下载成功 | +| 400 | 不存在的空间 | +| 403 | API公私钥错误 | +| 401 | 下载签名错误 | +| 404 | 下载文件或数据不存在 | +| 416 | 文件范围请求不合法 |