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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ListSets

操作接口名称,固定取值为ListSets。

Project String immtest

项目名称。

RegionId String cn-hangzhou

项目所在地域的ID。

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

Marker String Set-00

从Marker开始按字典序返回媒体集信息列表。如果不设置此参数,则从头开始返回媒体集。

返回数据

名称 类型 示例值 描述
NextMarker String Set-e8dd5e4e-99f7-43d4-80d5-3456a5bd5077

下一次列出媒体集信息时以此值为Marker,将未返回的结果返回。

当媒体集未全部返回时,此参数才有值。

RequestId String FEEDE356-C928-4A36-951A-6EB5A5923BEB

当次请求的Request ID。

Sets Array of Sets

媒体集列表。

CreateTime String 2020-11-19T07:49:01.975Z

媒体集的创建时间

FaceCount Integer 5

当媒体集中存在人脸信息时,此参数才有效。

媒体集中的人脸数量。

ImageCount Integer 6

当媒体集中存在图片时,此参数才有效。

媒体集中的图片数量。

ModifyTime String 2020-11-19T07:49:01.975Z

媒体集的修改时间。

创建媒体集后,如果未更新过媒体集,则媒体集的修改时间和媒体集的创建时间相同。

SetId String Set-435b5855-d100-4408-95f4-f2e901fa0694

媒体集的唯一标识。

SetName String mysetname

媒体集的显示名称。

如果创建媒体集时未设置此参数,则返回值为空。

VideoCount Integer 0

当媒体集中存在视频时,此参数才有效。

媒体集中的视频数量。

VideoLength Integer 0

当媒体集中存在视频时,此参数才有效。

媒体集中的视频时长。

示例

请求示例

http(s)://[Endpoint]/?Action=ListSets
&Project=immtest
&<公共请求参数>

正常返回示例

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 格式

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