全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 阿里云办公 培训与认证 物联网

ListMoments

更新时间:2017-09-20 17:56:49

描述

分批列出当前用户的时光相簿

请求参数

参数名 类型 是否必须 说明
Action String ListMoments
State String 指定时光的状态,服务端只返回指定状态的时光。可选值有active, inactive, 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=ListMoments
  2. &Cursor=0
  3. &Direction=forward
  4. &Size=1
  5. &State=active
  6. &StoreName=cloudphoto-demo
  7. &LibraryId=alice-001
  8. &<公共请求参数>

返回参数

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

Moments

参数名 类型 说明
Ctime String 创建的时间戳,单位:毫秒
Id Long 时光相簿的Id
LocationName String 时光相簿的拍摄地点
Mtime String 最后修改的时间戳,单位:毫秒
PhotosCount Integer 时光相簿中的照片总数
State String 时光相簿的状态
TakenAt Long 时光相簿的拍摄时间戳

返回示例

JSON格式

  1. {
  2. "TotalCount":29,
  3. "Action":"ListMoments",
  4. "Message":"success",
  5. "RequestId":"E26C0E58-1204-4262-928C-AC5A76BFE979",
  6. "Moments":[
  7. {
  8. "Mtime":1500380317681,
  9. "LocationName":"",
  10. "State":"active",
  11. "Id":824116383561293824,
  12. "Ctime":1500380317681,
  13. "TakenAt":1500307201000,
  14. "PhotosCount":1
  15. }
  16. ],
  17. "NextCursor":"1500380317681:824116383561293824",
  18. "Code":"Success"
  19. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <ListMomentsResponse>
  3. <Action>ListMoments</Action>
  4. <TotalCount>29</TotalCount>
  5. <Message>success</Message>
  6. <RequestId>7058AE4B-AEB9-4840-9E70-E9FF37E3B17D</RequestId>
  7. <Moments>
  8. <Moment>
  9. <Mtime>1500380317681</Mtime>
  10. <State>active</State>
  11. <LocationName/>
  12. <Ctime>1500380317681</Ctime>
  13. <Id>824116383561293824</Id>
  14. <TakenAt>1500307201000</TakenAt>
  15. <PhotosCount>1</PhotosCount>
  16. </Moment>
  17. </Moments>
  18. <NextCursor>1500380317681:824116383561293824</NextCursor>
  19. <Code>Success</Code>
  20. </ListMomentsResponse>
本文导读目录