调用ListSets接口获取媒体集列表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
RegionId String cn-hangzhou

项目所在地域的ID。

地域Endpoint格式为imm.RegionId.aliyuncs.com,例如当RegionId为cn-hangzhou时,地域Endpoint为imm.cn-hangzhou.aliyuncs.com。

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"
}