全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
智能云相册

CreateAlbum

更新时间:2017-12-05 19:53:47

描述

创建一个相簿。

请求参数

参数名 类型 是否必须 说明
Action String CreateAlbum
AlbumName String 指定相簿的名称
StoreName String PhotoStore的名称
Remark String 备注,支持长度为200的中英文字符。如果Remark的内容有可能被显示在网页中,请在显示时对Remark内容做html转义以防止被注入攻击。
LibraryId String 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。

请求示例

  1. https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=CreateAlbum
  2. &AlbumName=demo-album-001
  3. &StoreName=cloudphoto-demo
  4. &LibraryId=alice-001
  5. &<公共请求参数>

返回参数

参数名 类型 说明
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格式

  1. {
  2. "Action":"CreateAlbum",
  3. "Message":"success",
  4. "RequestId":"E3E781AB-8526-4FF2-A1EE-6685A0B4AA5B",
  5. "Code":"Success",
  6. "Album":{
  7. "Name":"demo-album-001",
  8. "Mtime":1500088237451000,
  9. "State":"active",
  10. "Id":822891310280093696,
  11. "Ctime":1500088237451000,
  12. "Cover":{
  13. "Md5":"",
  14. "Mtime":0,
  15. "State":"",
  16. "Height":0,
  17. "Id":0,
  18. "Ctime":0,
  19. "Width":0,
  20. "Title":"",
  21. "FileId":"",
  22. "Remark":""
  23. },
  24. "PhotosCount":0
  25. }
  26. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <CreateAlbumResponse>
  3. <Action>CreateAlbum</Action>
  4. <Message>success</Message>
  5. <RequestId>5355E5A1-84C2-4A63-ADF7-DDEA90BEB68F</RequestId>
  6. <Code>Success</Code>
  7. <Album>
  8. <Name>demo-album-1</Name>
  9. <Mtime>1499996267782000</Mtime>
  10. <State>active</State>
  11. <Cover>
  12. <Mtime>0</Mtime>
  13. <Md5/>
  14. <State/>
  15. <Height>0</Height>
  16. <Ctime>0</Ctime>
  17. <Id>0</Id>
  18. <Width>0</Width>
  19. <FileId/>
  20. <Title/>
  21. <Remark/>
  22. </Cover>
  23. <Ctime>1499996267782000</Ctime>
  24. <Id>822505561525329920</Id>
  25. <PhotosCount>0</PhotosCount>
  26. </Album>
  27. </CreateAlbumResponse>
本文导读目录