开发者社区> 问答> 正文

云相册的API相簿接口CreateAlbum怎么使用



描述


创建一个相簿。

请求参数

参数名类型是否必须说明
ActionStringCreateAlbum
AlbumNameString指定相簿的名称
StoreNameStringPhotoStore的名称
RemarkString备注,支持长度为200的中英文字符,html标签将被转义。比如,如果备注中有<,在获取照片信息时<将被转义为<。
LibraryIdString照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。


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





返回参数

参数名类型说明
RequestIdString唯一标识本次请求的ID
CodeString响应状态码,Success表示成功的响应
MessageString响应状态详细描述
ActionStringCreateAlbum
AlbumAlbumAlbum对象


Album

参数名类型说明
Cover对象相册的封面
CtimeString创建的时间戳,单位:毫秒
IdLong相簿的唯一标识
MtimeString最后修改的时间戳,单位:毫秒
NameString相簿的名称
PhotosCountInteger相簿的中的照片数量
StateString相簿的状态
RemarkString备注


Cover

参数名类型说明
CtimeString创建的时间戳,单位:毫秒
FileIdString照片对应到存储在OSS上的文件名
HeightInteger照片的高度
IdLong记录的唯一标识
Md5String文件的Md5值。如果文件是以OSS分块上传方式上传的话,文件MD5为异步计算,在计算完成以前,MD5值为空。
MtimeString最后修改的时间戳,单位:毫秒
StateString文件的状态
TitleString照片的名称
WidthInteger照片的宽度
RemarkString照片封面的备注


返回示例


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>

展开
收起
云栖大讲堂 2017-10-27 10:28:47 2372 0
0 条回答
写回答
取消 提交回答
问答排行榜
最热
最新

相关电子书

更多
Spring Boot2.0实战Redis分布式缓存 立即下载
CUDA MATH API 立即下载
API PLAYBOOK 立即下载