From b8a4b18a1ad3647d6f5622d4e3cafc1b9aef902f Mon Sep 17 00:00:00 2001 From: unknown Date: Tue, 22 Nov 2022 13:57:29 +0800 Subject: [PATCH] docs: update uniCloud strorage --- docs/uniCloud/client-sdk.md | 1 + docs/uniCloud/price.md | 4 +- docs/uniCloud/storage.md | 83 +++++++++++++++++++++++++++++++++++++ 3 files changed, 86 insertions(+), 2 deletions(-) diff --git a/docs/uniCloud/client-sdk.md b/docs/uniCloud/client-sdk.md index 7a42cbab2..3a09f50a3 100644 --- a/docs/uniCloud/client-sdk.md +++ b/docs/uniCloud/client-sdk.md @@ -27,6 +27,7 @@ uniCloud分为客户端和云端两部分，有些接口名称相同，参数也 |uniCloud.onRefreshToken() |监听token更新事件 [详情](#on-refresh-token) | |uniCloud.offRefreshToken() |移除监听token更新事件 [详情](#off-refresh-token) | |uniCloud.initSecureNetworkByWeixin() |在微信小程序安全网络请求发送之前与云函数握手 [详情](#init-secure-network-by-weixin) | +|uniCloud.getFileInfo() |阿里云迁移服务空间到商用版时，使用公测版云存储链接获取商用版云存储链接 [详情](storage.md#get-file-info) | ### 获取当前用户信息getCurrentUserInfo@client-getcurrentuserinfo diff --git a/docs/uniCloud/price.md b/docs/uniCloud/price.md index c2070d2bb..9aefe05bc 100644 --- a/docs/uniCloud/price.md +++ b/docs/uniCloud/price.md @@ -322,12 +322,12 @@ parseCollection() 阿里云提供了公测版一键迁移到商业版的功能。执行一键迁移后云存储、云函数、数据库都会被迁移到新服务空间。迁移过程中云函数、数据库均可正常访问，云存储无法写入（删除或上传文件） - 公测版不可迁移到商业版的免费版 -- 客户端需要重新打包以使用新服务空间，需要HBuilderX 3.6.10及以上版本 +- 客户端需要重新打包以使用新服务空间，需要`HBuilderX 3.6.10-alpha`或`HBuilderX 3.6.5`及以上版本 - 注意迁移后服务空间id会变，如果云函数内有用到相关逻辑请务必注意调整。短信、一键登录功能使用了服务空间白名单的也务必将新空间加到白名单内 - 旧服务空间云函数url化默认域名会保留一段时间（请求会被转发到新服务空间），在后续清理时会彻底删除 - 云函数url化自定义域名需要重新绑定 - 迁移到商业版后旧服务空间的数据库备份不会被迁移过来 -- 旧云存储url需要通过[uniCloud.getFileInfo]()接口获取新服务空间的cdn链接，需要HBuilderX 3.6.10及以上版本 +- 旧云存储url需要通过`uniCloud.getFileInfo`（云函数接口：[uniCloud.getFileInfo](storage.md#get-file-info)，客户端接口：[uniCloud.getFileInfo](storage.md#cloud-get-file-info)）接口获取新服务空间的cdn链接，需要`HBuilderX 3.6.10-alpha`或`HBuilderX 3.6.5`及以上版本 - 商业版云存储和云函数位于同一区域，云函数上传文件到云存储会比之前快很多 - 前端网页托管自定义域名需要重新绑定 - 前端网页托管不再提供文件变动自动刷新缓存功能，提供手动刷新功能 \ No newline at end of file diff --git a/docs/uniCloud/storage.md b/docs/uniCloud/storage.md index 93a39b3b1..ce7d70c24 100644 --- a/docs/uniCloud/storage.md +++ b/docs/uniCloud/storage.md @@ -207,6 +207,46 @@ uniCloud.getTempFileURL({ }); ``` +### getFileInfo(Object object)@get-file-info + +阿里云迁移服务空间后，旧云存储url需要通过此接口获取新服务空间的cdn链接 + +**平台兼容性** + +|阿里云 |腾讯云 | +|---- |---- | +|HBuilderX 3.6.10+（alpha版）、HBuilderX 3.6.5+（正式版） |不支持 | + +#### 请求参数 + +|字段 |类型 |必填 |默认值 |说明 |平台差异说明 | +|:-: |:-: |:-: |:-: |:-: |:-: | +|fileList |Array<String>|是 |- |要获取下载链接的文件 ID 组成的数组 |- | + +**请求参数中的fileList** + +|字段 |类型 |必填 |说明 | +|:-: |:-: |:-: |:-: | +|fileID |String |是 |旧云存储url | + +#### 响应参数 + +|字段 |类型 |说明 | +|:-: |:-: |:-: | +|fileList |Array<Object> |存储下载链接的数组 | + +**响应参数中的fileList** + +|字段 |类型 |说明 | +|:-: |:-: |:-: | +|fileId |string |文件 ID（从文件url中解析出的id） | +|gmtCreate |number |文件上传时间（精确到秒的时间戳） | +|gmtModified|number |文件更改时间（精确到秒的时间戳） | +|name |string |文件原始名称 | +|size |number |文件大小（Byte） | +|type |string |文件类型 | +|url |string |文件cdn链接 | + ### chooseAndUploadFile(Object object)@chooseanduploadfile > HBuilderX 3.1.0起支持 @@ -622,10 +662,53 @@ let result = await uniCloud.downloadFile({ }); ``` + +### getFileInfo(Object object)@get-file-info + +阿里云迁移服务空间后，旧云存储url需要通过此接口获取新服务空间的cdn链接 + +**平台兼容性** + +|阿里云 |腾讯云 | +|---- |---- | +|HBuilderX 3.6.10+（alpha版）、HBuilderX 3.6.5+（正式版） |不支持 | + +#### 请求参数 + +|字段 |类型 |必填 |默认值 |说明 |平台差异说明 | +|:-: |:-: |:-: |:-: |:-: |:-: | +|fileList |Array<String>|是 |- |要获取下载链接的文件 ID 组成的数组 |- | + +**请求参数中的fileList** + +|字段 |类型 |必填 |说明 | +|:-: |:-: |:-: |:-: | +|fileID |String |是 |旧云存储url | + +#### 响应参数 + +|字段 |类型 |说明 | +|:-: |:-: |:-: | +|fileList |Array<Object> |存储下载链接的数组 | + +**响应参数中的fileList** + +|字段 |类型 |说明 | +|:-: |:-: |:-: | +|fileId |string |文件 ID（从文件url中解析出的id） | +|gmtCreate |number |文件上传时间（精确到秒的时间戳） | +|gmtModified|number |文件更改时间（精确到秒的时间戳） | +|name |string |文件原始名称 | +|size |number |文件大小（Byte） | +|type |string |文件类型 | +|url |string |文件cdn链接 | + ## 数据处理 **阿里云** +> 阿里云商用版目前仍可使用此功能，但是未来可能会进行计费 + 使用阿里云作为服务商时，云存储支持直接使用**restful api**对资源进行处理，下表列出支持的操作类型。 如果你的数据库及云函数使用腾讯云，也是可以使用阿里云云存储的。详细用法参考：[连接多个服务空间](uniCloud/init.md) -- GitLab