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

UploadParts

本页内容

原上传任务的分片列表。按序号和 uploaded 核对需要补传的片,使用 next_after 继续读取。

如何阅读本模型

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

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

字段定义

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

字段必需说明
items 是

与当前请求条件匹配的记录。数组元素的字段见下方各行。

类型:object[]

items[].part_number 是

分片序号,从 1 开始。

类型:integer

查看取值约束
  • 最小值 1
  • 最大值 1024
items[].size_bytes 是

文件大小,单位为字节。

类型:integer

查看取值约束
  • 最小值 1
  • 最大值 33554432
items[].sha256 是

实际文件、分片或导出内容的 SHA-256,小写十六进制。

类型:string

查看取值约束
  • 格式 ^[a-f0-9]{64}$
items[].uploaded 是

平台已确认该片的暂存对象存在。最终内容校验和合并仍在整个上传任务的校验阶段执行。

类型:boolean

查看取值约束

已确认暂存对象存在;最终内容校验与合并在异步 validating 阶段执行。查询 U.state=succeeded 之后才表示版本发布完成。

next_after 是

传入下一次分片查询的 after。为空表示已到末页。

类型:string | null

查看取值约束
  • 格式 ^[1-9][0-9]{0,3}$

相关接口

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

作为成功响应