GetAlbumsByNames
描述
根据相簿名称获取相簿信息
请求参数
参数名 | 类型 | 是否必须 | 说明 |
---|---|---|---|
Action | String | 是 | GetAlbumsByNames |
Name.1 | String | 是 | 需要获取的相簿名称。如果需要获取多个相簿的信息,请按照规则增加一个参数。比如2个相簿,另外一个参数为Name.2 |
StoreName | String | 是 | PhotoStore的名称 |
LibraryId | String | 否 | 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。 |
请求示例
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=GetAlbumsByNames
&Name.1=demo-album-002
&StoreName=cloudphoto-regression-store
&<公共请求参数>
返回参数
参数名 | 类型 | 说明 |
---|---|---|
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格式
{
"Action":"GetAlbumsByNames",
"Message":"success",
"RequestId":"DBA28C13-00F6-4478-8B26-748695687E0B",
"Code":"Success",
"Albums":[
{
"Name":"demo-album-002",
"IdStr":"",
"Mtime":1520848479597,
"State":"active",
"Id":837495818708848640,
"Ctime":1503570223599,
"Cover":{
"IdStr":"859482159273005056",
"IsVideo":false,
"Md5":"cbaa9d159391f659ad83f9c74d0fb107",
"Mtime":1508812175585,
"State":"active",
"Height":300,
"Id":859482159273005056,
"Ctime":1508812175585,
"Width":400,
"Remark":"",
"Title":"testimage2.jpg",
"FileId":"M_BHZsehRWOm2UqDi77ZMAAAAC5wZDIE"
},
"PhotosCount":1
}
]
}
XML格式
<?xml version="1.0" encoding="UTF-8"?>
<GetAlbumsByNamesResponse>
<Action>GetAlbumsByNames</Action>
<Message>success</Message>
<RequestId>A6CDE0C3-F568-4958-B955-3C9FD5EA1513</RequestId>
<Code>Success</Code>
<Albums>
<Album>
<IdStr/>
<Name>demo-album-002</Name>
<Mtime>1520848479597</Mtime>
<State>active</State>
<Cover>
<IsVideo>false</IsVideo>
<IdStr>859482159273005056</IdStr>
<Mtime>1508812175585</Mtime>
<Md5>cbaa9d159391f659ad83f9c74d0fb107</Md5>
<State>active</State>
<Height>300</Height>
<Ctime>1508812175585</Ctime>
<Id>859482159273005056</Id>
<Width>400</Width>
<Remark/>
<FileId>M_BHZsehRWOm2UqDi77ZMAAAAC5wZDIE</FileId>
<Title>testimage2.jpg</Title>
</Cover>
<Ctime>1503570223599</Ctime>
<Id>837495818708848640</Id>
<PhotosCount>1</PhotosCount>
</Album>
</Albums>
</GetAlbumsByNamesResponse>
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论