CreateAlbum
描述
创建一个相簿。
请求参数
参数名 | 类型 | 是否必须 | 说明 |
---|---|---|---|
Action | String | 是 | CreateAlbum |
AlbumName | String | 是 | 指定相簿的名称 |
StoreName | String | 是 | PhotoStore的名称 |
Remark | String | 否 | 备注,支持长度为200的中英文字符。如果Remark的内容有可能被显示在网页中,请在显示时对Remark内容做html转义以防止被注入攻击。 |
LibraryId | String | 否 | 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。 |
请求示例
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=CreateAlbum
&AlbumName=demo-album-001
&StoreName=cloudphoto-demo
&LibraryId=alice-001
&<公共请求参数>
返回参数
参数名 | 类型 | 说明 |
---|---|---|
RequestId | String | 唯一标识本次请求的ID |
Code | String | 响应状态码,Success表示成功的响应 |
Message | String | 响应状态详细描述 |
Action | String | CreateAlbum |
Album | Album | Album对象 |
Album
参数名 | 类型 | 说明 |
---|---|---|
Cover | 对象 | 相册的封面 |
Ctime | String | 创建的时间戳,单位:毫秒 |
Id | Long | 相簿的唯一标识 |
Mtime | String | 最后修改的时间戳,单位:毫秒 |
Name | String | 相簿的名称 |
PhotosCount | Integer | 相簿的中的照片数量 |
State | String | 相簿的状态 |
Remark | String | 备注 |
Cover
参数名 | 类型 | 说明 |
---|---|---|
Ctime | String | 创建的时间戳,单位:毫秒 |
FileId | String | 照片对应到存储在OSS上的文件名 |
Height | Integer | 照片的高度 |
Id | Long | 记录的唯一标识 |
Md5 | String | 文件的Md5值。如果文件是以OSS分块上传方式上传的话,文件MD5为异步计算,在计算完成以前,MD5值为空。 |
Mtime | String | 最后修改的时间戳,单位:毫秒 |
State | String | 文件的状态 |
Title | String | 照片的名称 |
Width | Integer | 照片的宽度 |
Remark | String | 照片封面的备注 |
返回示例
JSON格式
{
"Action":"CreateAlbum",
"Message":"success",
"RequestId":"E3E781AB-8526-4FF2-A1EE-6685A0B4AA5B",
"Code":"Success",
"Album":{
"Name":"demo-album-001",
"Mtime":1500088237451000,
"State":"active",
"Id":822891310280093696,
"Ctime":1500088237451000,
"Cover":{
"Md5":"",
"Mtime":0,
"State":"",
"Height":0,
"Id":0,
"Ctime":0,
"Width":0,
"Title":"",
"FileId":"",
"Remark":""
},
"PhotosCount":0
}
}
XML格式
<?xml version="1.0" encoding="UTF-8"?>
<CreateAlbumResponse>
<Action>CreateAlbum</Action>
<Message>success</Message>
<RequestId>5355E5A1-84C2-4A63-ADF7-DDEA90BEB68F</RequestId>
<Code>Success</Code>
<Album>
<Name>demo-album-1</Name>
<Mtime>1499996267782000</Mtime>
<State>active</State>
<Cover>
<Mtime>0</Mtime>
<Md5/>
<State/>
<Height>0</Height>
<Ctime>0</Ctime>
<Id>0</Id>
<Width>0</Width>
<FileId/>
<Title/>
<Remark/>
</Cover>
<Ctime>1499996267782000</Ctime>
<Id>822505561525329920</Id>
<PhotosCount>0</PhotosCount>
</Album>
</CreateAlbumResponse>
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论