全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
智能云相册

ListTagPhotos

更新时间:2017-09-20 18:00:17

描述

分批列出当前照片库中的指定标签的照片列表

请求参数

参数名 类型 是否必须 说明
Action String ListTagPhotos
State String 注意:State不是照片的状态,而是照片与标签关系的状态。可选值为active(表示照片有这个标签),removed(表示该标签已从该照片中移除)和all(表示所有状态)
StoreName String PhotoStore的名称
TagId Integer 标签的ID
Cursor String 指定拉取数据的游标。默认值为0,表示从最老的数据开始分批获取。
Direction String 指定拉取数据的方向,可选值为backward和forward。forward表示获取比指定游标更新的数据,backward表示获取比指定游标更老的数据。默认值为forward
Size Integer 指定服务端返回的最大记录条数,最大值为500。默认值为50。
LibraryId String 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。

请求示例

  1. https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=ListTagPhotos
  2. &Cursor=0
  3. &Direction=forward
  4. &Size=1
  5. &State=active
  6. &StoreName=cloudphoto-demo
  7. &TagId=169979904
  8. &LibraryId=alice-001
  9. &<公共请求参数>

返回参数

参数名 类型 说明
RequestId String 唯一标识本次请求的ID
Code String 响应状态码,Success表示成功的响应
Message String 响应状态详细描述
Action String ListTagPhotos
NextCursor String 表示获取下一批数据的起始游标,如果为EOF则表示没有数据了。
Results 数组 详见结果信息
TotalCount String 符合条件的记录总数

Results

参数名 类型 说明
PhotoId Long 照片的唯一ID
State String 照片与标签的关系的状态

返回示例

JSON格式

  1. {
  2. "TotalCount":6,
  3. "Action":"ListTagPhotos",
  4. "Message":"success",
  5. "RequestId":"7A8A7A66-D0DE-4147-9845-433F3B5B88E2",
  6. "NextCursor":"1500380319000000:824116387264872453",
  7. "Results":[
  8. {
  9. "State":"active",
  10. "PhotoId":824116383510962176
  11. }
  12. ],
  13. "Code":"Success"
  14. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <ListTagPhotosResponse>
  3. <Action>ListTagPhotos</Action>
  4. <TotalCount>6</TotalCount>
  5. <Message>success</Message>
  6. <RequestId>CDCCCEE9-572F-48C4-ACC3-41CF072CFA52</RequestId>
  7. <NextCursor>1500380319000000:824116387264872453</NextCursor>
  8. <Results>
  9. <Result>
  10. <State>active</State>
  11. <PhotoId>824116383510962176</PhotoId>
  12. </Result>
  13. </Results>
  14. <Code>Success</Code>
  15. </ListTagPhotosResponse>
本文导读目录