DescribeFileUploadSignedUrl_小程序Serverless_API文档-阿里云OpenAPI开发者门户

流控信息

当前云产品API请求速率暂未透出。

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

mpserverless:DescribeFileUploadSignedUrl	Create	全部资源 *	无	无

字段名称	字段详情
Filenamestring	原始的文件名称。展开详情示例值:wlop29.jpg
Sizeinteger<int64>	文件大小，单位字节。注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:41836
SpaceIdstring	服务空间 ID。示例值:mp-0e16bb12-14af-****-b24c-5ac1a9a7bb9f参考取值来源: ListSpace CreateSpace DescribeSpaces
ContentTypestring	文件类型：.pdf .xls .xlsx .doc .docx .ppt .pptx .txt 示例值:png
FileIdstring	自定义上传文件路径，支持多级目录，路径支持字母、数字、中文、横线、下横线、点符号，总长度不超过 1024，必须以"/"开头，例如：展开详情示例值:/abc/edf/hello.jpg

字段名称	字段详情
SignUrlstring	上传文件地址。示例值:https://bsppub.oss-cn-shanghai.aliyuncs.com/FBPSBVMO-myspace/41552d60-52de-xxx-a713-43e879b0717a.JPG?OSSAccessKeyId=LTAI**************&Expires=1582152512&Signature=sek1B0Xm2r*tNvfX9tX%2BBJxA%3D
RequestIdstring	请求 ID。示例值:E9A50E1B-5ECE-42D4-B261-C07D1BBE68DE
Idstring	文件唯一标识。示例值:2fada31e-8fa5-****-b595-9698cd6b5f06
OssCallbackUrlstring	上传结果回调地址。示例值:https://api.next.bspapp.com/oss_upload_callback
Overwriteboolean	含义是该上传请求是否会覆盖文件。展开详情示例值:true

在获取到上传文件地址 SignUrl 之后，需要使用 PUT 对该地址上传文件。 PUT 请求必须在 headers 携带回调地址参数，该参数构造方法如下：

第一步：构造字符串 {"callbackUrl":"....","callbackBody":"{\"fileId\":\"....\",\"spaceId\":\"....\"}","callbackBodyType":"application/json"} 分别将参数 OssCallbackUrl、Id 以及 SpaceId 替换到上面的空缺部分。
第二步：对上述字符串进行 base64 编码。
第三步：在上传文件时添加 header x-oss-callback，值为第二步计算得到的字符串。

注意请求参数 ContentType 也是签名计算的一部分，因此在上传文件时您需要添加 header Content-Type，并确保值和入参一致。