调用CreateSet接口创建媒体集。

注意事项

  • 由于媒体集中的媒体数量有限制，因此需要使用者规划单个媒体集的使用范围。
  • 由于各个媒体集间无法联合搜索，因此推荐将互不干涉的媒体文件独立存放到不同媒体集中。

调试

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

请求参数

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

操作接口名称，固定取值为CreateSet。
Project String 是 immtest

项目名称。
RegionId String 否 cn-hangzhou

项目所在地域的ID。

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

SetId String 否 set001

媒体集的唯一标识，只能由英文、数字和短横线（-）组成。

如果未设置此参数，则系统会自动生成。
SetName String 否 myset

媒体集的显示名称，支持使用中文。

如果未设置此参数，则默认值为空。

返回数据

名称 类型 示例值 描述
CreateTime String 2020-11-19T07:49:20.094Z

媒体集的创建时间。
FaceCount Integer 0

媒体集中的人脸数量。

当媒体集中存在人脸信息时，才显示此参数。
ImageCount Integer 0

媒体集中的图片数量。

当媒体集中存在图片时，才显示此参数。
ModifyTime String 2020-11-19T07:49:20.094Z

媒体集的修改时间。

创建媒体集后，如果未更新过媒体集，则媒体集的修改时间和媒体集的创建时间相同。
RequestId String 6D74B3A9-5AC0-49F9-914D-E01589D363FC

当次请求的Request ID。
SetId String set001

媒体集的唯一标识。
SetName String myset

媒体集的显示名称。
VideoCount Integer 0

媒体集中的视频数量。

当媒体集中存在视频时，才显示此参数。
VideoLength Integer 0

媒体集中的视频时长。

当媒体集中存在视频时，才显示此参数。

示例

请求示例

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

正常返回示例

XML 格式 

<ModifyTime>2020-11-19T07:49:20.094Z</ModifyTime>
<RequestId>6D74B3A9-5AC0-49F9-914D-E01589D363FC</RequestId>
<CreateTime>2020-11-19T07:49:20.094Z</CreateTime>
<SetName>myset</SetName>
<SetId>set001</SetId>

JSON 格式 

{
    "ModifyTime": "2020-11-19T07:49:20.094Z",
    "RequestId": "6D74B3A9-5AC0-49F9-914D-E01589D363FC",
    "CreateTime": "2020-11-19T07:49:20.094Z",
    "SetName": "myset",
    "SetId": "set001"
}