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

ListAlbumPhotos

更新时间:2017-09-20 17:55:43

描述

分批获取相簿中的照片列表

请求参数

参数名 类型 是否必须 说明
Action String ListAlbumPhotos
AlbumId Long 指定相簿的Id
State String 注意:State不是照片的状态,而是照片与相簿关系的状态。可选值为active(表示照片属于相簿中),removed(表示照片已从相簿中移除)和all(表示所有状态)
StoreName String PhotoStore的名称
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=ListAlbumPhotos
  2. &AlbumId=822504789718867968
  3. &Cursor=0
  4. &Direction=forward
  5. &Size=10
  6. &State=all
  7. &StoreName=cloudphoto-demo
  8. &LibraryId=alice-001
  9. &<公共请求参数>

返回参数

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

Results

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

返回示例

JSON格式

  1. {
  2. "TotalCount":1,
  3. "Action":"ListAlbumPhotos",
  4. "Message":"success",
  5. "RequestId":"33439FC2-4729-4D74-A629-95CCF67ADA4E",
  6. "NextCursor":"1501586905955:829177180117278720",
  7. "Results":[
  8. {
  9. "State":"active",
  10. "PhotoId":822522391505674240
  11. }
  12. ],
  13. "Code":"Success"
  14. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <ListAlbumPhotosResponse>
  3. <Action>ListAlbumPhotos</Action>
  4. <TotalCount>1</TotalCount>
  5. <Message>success</Message>
  6. <RequestId>010AA821-CE89-44BA-9861-3BDED9CF1095</RequestId>
  7. <NextCursor>1501586905955:829177180117278720</NextCursor>
  8. <Results>
  9. <Result>
  10. <State>active</State>
  11. <PhotoId>822522391505674240</PhotoId>
  12. </Result>
  13. </Results>
  14. <Code>Success</Code>
  15. </ListAlbumPhotosResponse>
本文导读目录