IMM使用Marker而不是传统意义的Page/Limit进行翻页。传入的参数名为Marker ,标识着本次请求从该标记位开始向后列出。在返回值中称为NextMarker
,即您下次翻页所需要传入的Marker值。
在获取任何列表时,IMM不保证每次返回的数量(但总是小于最大数量限制)。当NextMarker不为空时,即便列表的总元素数量小于最大值(甚至为 0 ),也应将NextMarker传入进行翻页,以获取下一页的内容。
Remarks
RemarksA/RemarksB/RemarksC/RemarksD参数是为使用者预留的筛选参数。使用者可以自己将所需要的信息记录在这两个字段中。在搜索等场景下,这两个字段可以以前缀匹配的方式作为搜索条件。
RemarksArrayA / RemarksArrayA 用法同上,只是该类型存储的是字符串组成的数组。
使用场景如:
作为客户端权限字段存入:AdminGroup/AdminUserA/ 即可使用前缀过滤用户权限。
作为客户端的相对路径存入:nas://path/to/file
RemarksQuery
对 Remarks 字段进行复杂查询。支持四种查询方式:
PREFIX:前缀匹配。
NOT-PREFIX:非前缀匹配。
IN:全字匹配,必须完全符合 IN 中指定的任意一个字符串。
NOT-IN:全字匹配,必须不符合 NOT-IN 中指定的任意一个字符串。
对 RemarksArray 数组类型的查询,若为正向查询(无 NOT),则数组中有任意一项符合条件即可。反之(有 NOT),则数组中必须任意一项 均不 符合后续条件。
可以任选其中若干项条件进行查询。{
"PREFIX": "start-with-this",
"NOT-PREFIX": "not-start-with-this",
"IN": ["ONE","OF","THIS"],
"NOT-IN": ["NONE","FROM","THOSE"]
}
Video
列出视频详细的JSON Object,其中具体字段意义如下。
Parameter
Type
Comment
Project
string
Project
SetId
string
SetId
VideoUri
string
视频OSS Uri
RemarksA
string
RemarksB
string
RemarksC
string
RemarksD
string
ExternalId
string
外部ID,用于和您的应用层的 ID (如果有)进行绑定
CreateTime
string
视频加入Set的时间
ModifyTime
string
视频在Set内被修改的时间
VideoWidth
int
视频宽度
VideoHeight
int
视频高度
VideoFormat
string
视频格式,如mp4
VideoDuration
float
视频时长,单位秒
FileSize
int
文件大小
VideoFrames
int
帧数
SourceType
string
SourceUri
<