创建集合对象。
集合目前有多种类型, 同一集合类型内要保证名称唯一性。
调试
您可以在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 | 调用是否成功。取值如下:
|
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"
}
错误码
访问错误中心查看更多错误码。