调用CreateSet接口创建媒体集。

注意事项

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

调试

您可以在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 CreateSet

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

Project String immtest

项目名称。

SetId String set001

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

如果未设置此参数,则系统会自动生成。

SetName String myset

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

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

返回数据

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

媒体集的修改时间。

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

VideoCount Integer 0

媒体集中的视频数量。

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

ImageCount Integer 0

媒体集中的图片数量。

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

RequestId String 6D74B3A9-5AC0-49F9-914D-E01589D363FC

当次请求的Request ID。

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

媒体集的创建时间。

SetName String myset

媒体集的显示名称。

SetId String set001

媒体集的唯一标识。

VideoLength Integer 0

媒体集中的视频时长,单位为秒。

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

FaceCount Integer 0

媒体集中的人脸数量。

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

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/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格式

HTTP/1.1 200 OK
Content-Type:application/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"
}