› 推特 ›阿里云技术文档›正文

ListTags_标签接口_API手册_智能云相册

admin 阿里云技术文档 2020-02-11 230 0
阿里云服务器优惠

ListTags

描述

全量列出当前照片库中照片的标签列表

请求参数

参数名 类型 是否必须 说明
Action String 是 ListTags
StoreName String 是 PhotoStore的名称
Lang String 否 指定返回标签文本的语言。系统内置标签仅支持简体中文。自定义标签：如果注册了该语言的文本则返回该语言的文本，没有注册该语言的文本则返回标签的标识。
LibraryId String 否 照片库标识。采用AK认证时必选，采用STS认证时可选。了解不同认证方式的区别。

请求示例

  1. https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=ListTags
  2. &StoreName=cloudphoto-demo
  3. &LibraryId=alice-001
  4. &<公共请求参数>

返回参数

参数名 类型 说明
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格式

  1. {
  2.     "Tags":[
  3.         {
  4.             "Name":"舞蹈",
  5.             "Id":36864,
  6.             "IsSubTag":false,
  7.             "ParentTag":"",
  8.             "Cover":{
  9.                 "Md5":"ac9cc6c68ae7f76d835e110a797baa14",
  10.                 "Mtime":1500522991107,
  11.                 "State":"active",
  12.                 "Height":201,
  13.                 "Id":824714799282655232,
  14.                 "Ctime":1500522991107,
  15.                 "Width":300,
  16.                 "Title":"u=125227023,978057929&fm=26&gp=0.jpg",
  17.                 "FileId":"To6bm_zeRbKSb0FJBWn2GwAAAApwZDIE",
  18.                 "Remark": "Remark"
  19.             }
  20.         }
  21.     ],
  22.     "Action":"ListTags",
  23.     "Message":"success",
  24.     "RequestId":"20BE5A2B-DB6B-410E-8F3B-D137165EAC98",
  25.     "Code":"Success"
  26. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <ListTagsResponse>
  3.   <Tags>
  4.     <Tag>
  5.       <Name>舞蹈</Name>
  6.       <IsSubTag>false</IsSubTag>
  7.       <ParentTag></ParentTag>
  8.       <Cover>
  9.         <Mtime>1500522991107</Mtime>
  10.         <Md5>ac9cc6c68ae7f76d835e110a797baa14</Md5>
  11.         <State>active</State>
  12.         <Height>201</Height>
  13.         <Ctime>1500522991107</Ctime>
  14.         <Id>824714799282655232</Id>
  15.         <Width>300</Width>
  16.         <FileId>To6bm_zeRbKSb0FJBWn2GwAAAApwZDIE</FileId>
  17.         <Title><![CDATA[u=125227023,978057929&fm=26&gp=0.jpg]]></Title>
  18.         <Remark><![CDATA[Remark]]></Remark>
  19.       </Cover>
  20.       <Id>36864</Id>
  21.     </Tag>
  22.   </Tags>
  23.   <Action>ListTags</Action>
  24.   <Message>success</Message>
  25.   <RequestId>584E5FCE-9A5B-4E8E-9C8F-27AD0ACDC007</RequestId>
  26.   <Code>Success</Code>
  27. </ListTagsResponse>
版权声明

本文仅代表作者观点，不代表本站立场。
本文系作者授权发表，未经许可，不得转载。

评论

-----