全部产品
云市场

GetAlbumsByNames

更新时间:2018-03-12 18:40:27

描述

根据相簿名称获取相簿信息

请求参数

参数名 类型 是否必须 说明
Action String GetAlbumsByNames
Name.1 String 需要获取的相簿名称。如果需要获取多个相簿的信息,请按照规则增加一个参数。比如2个相簿,另外一个参数为Name.2
StoreName String PhotoStore的名称
LibraryId String 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。

请求示例

  1. https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=GetAlbumsByNames
  2. &Name.1=demo-album-002
  3. &StoreName=cloudphoto-regression-store
  4. &<公共请求参数>

返回参数

参数名 类型 说明
RequestId String 唯一标识本次请求的ID
Code String 响应状态码,Success表示成功的响应
Message String 响应状态详细描述
Action String GetAlbumsByNames
Albums Album[] Album数组

Albums

参数名 类型 说明
Cover 对象 相册的封面
Ctime String 创建的时间戳,单位:毫秒
Id Long 相簿的Id
IdStr String 以字符串表示的相簿的Id
Mtime String 最后修改的时间戳,单位:毫秒
Name String 相簿的名称
PhotosCount Integer 相簿的中的照片数量
State String 相簿的状态

Cover

参数名 类型 说明
Ctime String 创建的时间戳,单位:毫秒
FileId String 照片对应到存储在OSS上的文件名
Height Integer 照片的高度
Id String 相簿封面照片的Id
IdStr String 以字符串表示的相簿封面照片的Id
IsVideo Boolean 是否为视频,取值为true/false。
Md5 String 文件的Md5值。如果文件是以OSS分块上传方式上传的话,文件MD5为异步计算,在计算完成以前,MD5值为空。
Mtime String 最后修改的时间戳,单位:毫秒
Remark String 备注
State String 照片的状态
Title String 照片的名称
Width Integer 照片的宽度

返回示例

JSON格式

  1. {
  2. "Action":"GetAlbumsByNames",
  3. "Message":"success",
  4. "RequestId":"DBA28C13-00F6-4478-8B26-748695687E0B",
  5. "Code":"Success",
  6. "Albums":[
  7. {
  8. "Name":"demo-album-002",
  9. "IdStr":"",
  10. "Mtime":1520848479597,
  11. "State":"active",
  12. "Id":837495818708848640,
  13. "Ctime":1503570223599,
  14. "Cover":{
  15. "IdStr":"859482159273005056",
  16. "IsVideo":false,
  17. "Md5":"cbaa9d159391f659ad83f9c74d0fb107",
  18. "Mtime":1508812175585,
  19. "State":"active",
  20. "Height":300,
  21. "Id":859482159273005056,
  22. "Ctime":1508812175585,
  23. "Width":400,
  24. "Remark":"",
  25. "Title":"testimage2.jpg",
  26. "FileId":"M_BHZsehRWOm2UqDi77ZMAAAAC5wZDIE"
  27. },
  28. "PhotosCount":1
  29. }
  30. ]
  31. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <GetAlbumsByNamesResponse>
  3. <Action>GetAlbumsByNames</Action>
  4. <Message>success</Message>
  5. <RequestId>A6CDE0C3-F568-4958-B955-3C9FD5EA1513</RequestId>
  6. <Code>Success</Code>
  7. <Albums>
  8. <Album>
  9. <IdStr/>
  10. <Name>demo-album-002</Name>
  11. <Mtime>1520848479597</Mtime>
  12. <State>active</State>
  13. <Cover>
  14. <IsVideo>false</IsVideo>
  15. <IdStr>859482159273005056</IdStr>
  16. <Mtime>1508812175585</Mtime>
  17. <Md5>cbaa9d159391f659ad83f9c74d0fb107</Md5>
  18. <State>active</State>
  19. <Height>300</Height>
  20. <Ctime>1508812175585</Ctime>
  21. <Id>859482159273005056</Id>
  22. <Width>400</Width>
  23. <Remark/>
  24. <FileId>M_BHZsehRWOm2UqDi77ZMAAAAC5wZDIE</FileId>
  25. <Title>testimage2.jpg</Title>
  26. </Cover>
  27. <Ctime>1503570223599</Ctime>
  28. <Id>837495818708848640</Id>
  29. <PhotosCount>1</PhotosCount>
  30. </Album>
  31. </Albums>
  32. </GetAlbumsByNamesResponse>