跳转到主要内容
1签 (OneSign)

UploadPartTicket

本页内容

指定分片的短期传输指令。交给 SDK 自动传输,完成后仍向平台确认;不能在分片之间交换凭证。

如何阅读本模型

先从下方相关接口确认该模型用于请求还是响应,再按字段层级读取。请求模型由调用方填写,响应模型由平台返回;同名字段在不同模型中可能含义不同。

应用、版本、任务和回执的区别见基本概念。需要一份可跟做的示例时,从相关接口进入对应产品指南。

字段定义

“必需”指字段所在的对象出现时,该字段是否必须存在。类型中含 null 表示值允许为空;未返回、null、空字符串和零分别处理。

字段必需说明
upload_id 是

上传任务 ID,与创建上传任务响应的 data.id 相同。

类型:string

查看取值约束
  • 格式 ^U[a-f0-9]{32}$
ticket 是

该片的短期上传指令。交给 SDK 自动传输,业务代码不选择或配置存储。自行实现 HTTP 时,严格按返回的方法、请求头和表单字段发送。

类型:object

查看取值约束

平台返回该片的短期上传指令,由 SDK 按方法、请求头或表单字段自动传输。自行实现 HTTP 时,按返回指令发送;浏览器的 Content-Length 由浏览器根据文件字节生成。分片确认只表示暂存成功,整个安装包校验并返回版本 ID 后才可使用。

ticket.url 是

凭证授权的 HTTPS 存储地址,包含短期授权信息,仅传给实际传输方。

类型:string

查看取值约束
  • 数据格式 uri
ticket.method 是

访问存储时使用的 HTTP 方法。

类型:string

查看取值约束
  • 可选值 PUT / POST
ticket.headers 是

访问存储时附带的请求头及值。

类型:object

ticket.headers.* 否

键名由本次票据给出,按原值传递。

类型:string

ticket.expires_at 是

有效截止时间,Unix 秒。使用临时凭据或凭证前应与当前时间比较。

类型:integer

ticket.kind 否

平台生成的传输指令类型,由 SDK 自动识别;业务代码无需填写或选择。省略时沿用兼容传输指令。

类型:string

查看取值约束
  • 可选值 s3 / oss / local / qiniu
ticket.encoding 否

存储请求编码,multipart 表示构造表单上传。

类型:string

查看取值约束
  • 固定值 multipart
ticket.fields 否

存储服务要求的表单字段,连同文件字节一起提交。

类型:object

ticket.fields.key 是

存储访问凭证指定的对象键,按原值提交。

类型:string

ticket.fields.token 是

仅对指定对象有效的短期存储令牌。

类型:string

part_number 是

分片序号,从 1 开始。

类型:integer

查看取值约束
  • 最小值 1
  • 最大值 1024

相关接口

下面根据接口定义列出使用本模型的操作,包括嵌套在其他对象中的情况。接口示例展示完整请求和响应;模型本身不会增加任何权限。

作为成功响应