UploadTicket
本页内容
原上传任务的短期整包上传指令。由 SDK 按返回的方法、地址和请求头发送文件,不附带平台 API 认证信息。
如何阅读本模型
先从下方相关接口确认该模型用于请求还是响应,再按字段层级读取。请求模型由调用方填写,响应模型由平台返回;同名字段在不同模型中可能含义不同。
应用、版本、任务和回执的区别见基本概念。需要一份可跟做的示例时,从相关接口进入对应产品指南。
字段定义
“必需”指字段所在的对象出现时,该字段是否必须存在。类型中含 null 表示值允许为空;未返回、null、空字符串和零分别处理。
| 字段 | 必需 | 说明 |
|---|---|---|
upload_id |
是 | 上传任务 ID,与创建上传任务响应的 data.id 相同。 查看取值约束
|
ticket |
是 | 用于传输文件的短期凭证,包含访问方法、地址和请求头。请按返回值发送请求。 |
ticket.url |
是 | 凭证授权的 HTTPS 存储地址,包含短期授权信息,仅传给实际传输方。 查看取值约束
|
ticket.method |
是 | 访问存储时使用的 HTTP 方法。 查看取值约束
|
ticket.headers |
是 | 访问存储时附带的请求头及值。 |
ticket.headers.* |
否 | 键名由本次票据给出,按原值传递。 |
ticket.expires_at |
是 | 有效截止时间,Unix 秒。使用临时凭据或凭证前应与当前时间比较。 |
相关接口
下面根据接口定义列出使用本模型的操作,包括嵌套在其他对象中的情况。接口示例展示完整请求和响应;模型本身不会增加任何权限。