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

ListMomentPhotos

更新时间:2017-09-20 17:57:16

描述

分批列出时光相簿中的照片

请求参数

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

返回参数

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

Results

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

返回示例

JSON格式

  1. {
  2. "TotalCount":1,
  3. "Action":"ListMomentPhotos",
  4. "Message":"success",
  5. "RequestId":"296E0490-FBFD-4DDC-976D-64DE5A18A361",
  6. "NextCursor":"1500380317688:824116383590653952",
  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. <ListMomentPhotosResponse>
  3. <Action>ListMomentPhotos</Action>
  4. <TotalCount>1</TotalCount>
  5. <Message>success</Message>
  6. <RequestId>BA202C9A-B302-44C0-8293-B70EA8C31EF7</RequestId>
  7. <NextCursor>1500380317688:824116383590653952</NextCursor>
  8. <Results>
  9. <Result>
  10. <State>active</State>
  11. <PhotoId>824116383510962176</PhotoId>
  12. </Result>
  13. </Results>
  14. <Code>Success</Code>
  15. </ListMomentPhotosResponse>
本文导读目录