创建集合对象。

集合目前有多种类型， 同一集合类型内要保证名称唯一性。

调试

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

请求参数

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

系统规定参数。取值：CreateMetaCollection。
Name String 是 collection_name

集合名称,

长度限制:1-32字符
Comment String 否 this is a comment

集合备注

长度限制：1-64字符
ParentQualifiedName String 否 album.333508

父集合唯一标识
CollectionType String 是 ALBUM

集合类型

由于专辑下的类目是需要建立在专辑下的。

只有创建了专辑后，才能通过指定parentQualifiedName = 专辑的qualifiedName ， 创建专辑内的子类目

返回数据

名称 类型 示例值 描述
RequestId String E6F0DBDD-5AD****

Id of the request
QualifiedName String album.11111

集合的唯一标识
Success String true

调用是否成功。取值如下：

  • true：调用成功。
  • false：调用失败。
ErrorCode String NoPermission

错误码。
ErrorMessage String The specified parameters are invalid.

错误信息。
HttpStatusCode String 200

HTTP错误码。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateMetaCollection
&Name=collection_name
&Comment=this is a comment
&ParentQualifiedName=album.333508
&CollectionType=ALBUM、ALBUM_CATEGORY
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateMetaCollectionResponse>
    <RequestId>E6F0DBDD-5AD****</RequestId>
    <QualifiedName>album.1111</QualifiedName>
    <Success>true</Success>
    <ErrorCode>9999</ErrorCode>
    <ErrorMessage>The specified parameters are invalid.</ErrorMessage>
    <HttpStatusCode>200</HttpStatusCode>
</CreateMetaCollectionResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "E6F0DBDD-5AD****",
  "QualifiedName" : "album.1111",
  "Success" : "true",
  "ErrorCode" : "9999",
  "ErrorMessage" : "The specified parameters are invalid.",
  "HttpStatusCode" : "200"
}

错误码

访问错误中心查看更多错误码。