› 推特 ›阿里云技术文档›正文

CreateAlbum_相簿接口_API手册_智能云相册

admin 阿里云技术文档 2020-02-11 210 0

阿里云服务器优惠

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>

版权声明

本文仅代表作者观点，不代表本站立场。
本文系作者授权发表，未经许可，不得转载。

评论

-----