ListTags
描述
全量列出当前照片库中照片的标签列表
请求参数
参数名 | 类型 | 是否必须 | 说明 |
---|---|---|---|
Action | String | 是 | ListTags |
StoreName | String | 是 | PhotoStore的名称 |
Lang | String | 否 | 指定返回标签文本的语言。系统内置标签仅支持简体中文。自定义标签:如果注册了该语言的文本则返回该语言的文本,没有注册该语言的文本则返回标签的标识。 |
LibraryId | String | 否 | 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。 |
请求示例
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=ListTags
&StoreName=cloudphoto-demo
&LibraryId=alice-001
&<公共请求参数>
返回参数
参数名 | 类型 | 说明 |
---|---|---|
RequestId | String | 唯一标识本次请求的ID |
Code | String | 响应状态码,Success表示成功的响应 |
Message | String | 响应状态详细描述 |
Action | String | ListTags |
Tags | Tag[] | Tag数组 |
Tags
参数名 | 类型 | 说明 |
---|---|---|
Cover | 对象 | 标签的封面照片 |
Id | String | 标签的唯一标识 |
IsSubTag | Boolean | 是否为二级标签,true 是二级标签,false 不是二级标签 |
ParentTag | String | 一级标签,IsSubTag 是 true 时,输出当前 tag 的一级标签; 为 false 时,即当前 tag 为一级标签,输出空字符串 |
Name | String | 标签的名称 |
Cover
参数名 | 类型 | 说明 |
---|---|---|
Ctime | String | 创建的时间戳,单位:毫秒 |
FileId | String | 照片对应到存储在OSS上的文件名 |
Height | Integer | 照片的高度 |
Id | Long | 记录的唯一标识 |
Md5 | String | 文件的Md5值。如果文件是以OSS分块上传方式上传的话,文件MD5为异步计算,在计算完成以前,MD5值为空。 |
Mtime | String | 最后修改的时间戳,单位:毫秒 |
Remark | String | 照片的备注 |
State | String | 文件的状态 |
Title | String | 照片的名称 |
Width | Integer | 照片的宽度 |
返回示例
JSON格式
{
"Tags":[
{
"Name":"舞蹈",
"Id":36864,
"IsSubTag":false,
"ParentTag":"",
"Cover":{
"Md5":"ac9cc6c68ae7f76d835e110a797baa14",
"Mtime":1500522991107,
"State":"active",
"Height":201,
"Id":824714799282655232,
"Ctime":1500522991107,
"Width":300,
"Title":"u=125227023,978057929&fm=26&gp=0.jpg",
"FileId":"To6bm_zeRbKSb0FJBWn2GwAAAApwZDIE",
"Remark": "Remark"
}
}
],
"Action":"ListTags",
"Message":"success",
"RequestId":"20BE5A2B-DB6B-410E-8F3B-D137165EAC98",
"Code":"Success"
}
XML格式
<?xml version="1.0" encoding="UTF-8"?>
<ListTagsResponse>
<Tags>
<Tag>
<Name>舞蹈</Name>
<IsSubTag>false</IsSubTag>
<ParentTag></ParentTag>
<Cover>
<Mtime>1500522991107</Mtime>
<Md5>ac9cc6c68ae7f76d835e110a797baa14</Md5>
<State>active</State>
<Height>201</Height>
<Ctime>1500522991107</Ctime>
<Id>824714799282655232</Id>
<Width>300</Width>
<FileId>To6bm_zeRbKSb0FJBWn2GwAAAApwZDIE</FileId>
<Title><![CDATA[u=125227023,978057929&fm=26&gp=0.jpg]]></Title>
<Remark><![CDATA[Remark]]></Remark>
</Cover>
<Id>36864</Id>
</Tag>
</Tags>
<Action>ListTags</Action>
<Message>success</Message>
<RequestId>584E5FCE-9A5B-4E8E-9C8F-27AD0ACDC007</RequestId>
<Code>Success</Code>
</ListTagsResponse>
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论