调用ListSets接口获取媒体集列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
RegionId | String | 否 | cn-hangzhou |
项目所在地域的ID。 地域Endpoint格式为 |
Action | String | 是 | ListSets |
操作接口名称,固定取值为ListSets。 |
Project | String | 是 | immtest |
项目名称。 |
Marker | String | 否 | Set-00 |
从Marker开始按字典序返回媒体集信息列表。如果不设置此参数,则从头开始返回媒体集。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | FEEDE356-C928-4A36-951A-6EB5A5923BEB |
当次请求的Request ID。 |
Sets | Array of Sets |
媒体集列表。 |
|
VideoCount | Integer | 0 |
媒体集中的视频数量。 当媒体集中存在视频时,此参数才有效。 |
CreateTime | String | 2020-11-19T07:49:01.975Z |
媒体集的创建时间。 |
VideoLength | Integer | 0 |
媒体集中的视频时长,单位为秒。 当媒体集中存在视频时,此参数才有效。 |
SetId | String | Set-435b5855-d100-4408-95f4-f2e901fa0694 |
媒体集的唯一标识。 |
ImageCount | Integer | 6 |
媒体集中的图片数量。 当媒体集中存在图片时,此参数才有效。 |
FaceCount | Integer | 5 |
媒体集中的人脸数量。 当媒体集中存在人脸信息时,此参数才有效。 |
SetName | String | mysetname |
媒体集的显示名称。 如果创建媒体集时未设置此参数,则返回值为空。 |
ModifyTime | String | 2020-11-19T07:49:01.975Z |
媒体集的修改时间。 创建媒体集后,如果未更新过媒体集,则媒体集的修改时间和媒体集的创建时间相同。 |
NextMarker | String | Set-e8dd5e4e-99f7-43d4-80d5-3456a5bd5077 |
下一次列出媒体集信息时以此值为Marker,将未返回的结果返回。 当媒体集未全部返回时,此参数才有值。 |
示例
请求示例
http(s)://[Endpoint]/?Action=ListSets
&Project=immtest
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RequestId>FEEDE356-C928-4A36-951A-6EB5A5923BEB</RequestId>
<Sets>
<ModifyTime>2020-11-19T07:49:01.975Z</ModifyTime>
<ImageCount>6</ImageCount>
<CreateTime>2020-11-19T07:49:01.975Z</CreateTime>
<SetName>mysetname</SetName>
<SetId>Set-435b5855-d100-4408-95f4-f2e901fa0694</SetId>
<FaceCount>5</FaceCount>
</Sets>
<NextMarker>Set-e8dd5e4e-99f7-43d4-80d5-3456a5bd5077</NextMarker>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "FEEDE356-C928-4A36-951A-6EB5A5923BEB",
"Sets" : {
"ModifyTime" : "2020-11-19T07:49:01.975Z",
"ImageCount" : 6,
"CreateTime" : "2020-11-19T07:49:01.975Z",
"SetName" : "mysetname",
"SetId" : "Set-435b5855-d100-4408-95f4-f2e901fa0694",
"FaceCount" : 5
},
"NextMarker" : "Set-e8dd5e4e-99f7-43d4-80d5-3456a5bd5077"
}