云相册的API相簿接口CreateAlbum怎么使用
描述
创建一个相簿。
请求参数
| 参数名 | 类型 | 是否必须 | 说明 |
| Action | String | 是 | CreateAlbum |
| AlbumName | String | 是 | 指定相簿的名称 |
| StoreName | String | 是 | PhotoStore的名称 |
| Remark | String | 否 | 备注，支持长度为200的中英文字符，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>
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
您提到的操作是使用阿里云的Cloud Photo服务来创建一个相簿。Cloud Photo是阿里云提供的一项图片存储与管理服务，它帮助用户高效地存储、管理和分发照片资源。下面是对您请求参数的详细说明及如何构造请求的一个简要指南：
请求参数说明
-
Action: 必须参数，固定值为
CreateAlbum，表示执行创建相簿的操作。 -
AlbumName: 必须参数，类型为String。这是您要创建的相簿的名称，确保这个名称对于您管理相册是有意义的。
-
StoreName: 必须参数，类型为String。指定了相簿所属的PhotoStore名称。PhotoStore可以理解为存储空间或者相册库的概念，在Cloud Photo服务中用于组织和分类您的相簿。
-
Remark: 可选参数，类型为String。允许您为相簿添加备注信息，长度限制为200个字符，支持中英文，但请注意，任何HTML标签将会被转义处理，以保证数据的安全性。
-
LibraryId: 可选参数，类型为String。当使用Access Key（AK）认证方式时，此参数是必须的；如果采用STS（Security Token Service）认证，则可选。LibraryId是照片库的标识符，用于指定操作的具体目标照片库。如果您不确定是否需要此参数，请参考阿里云官方文档关于不同认证方式的说明。
请求示例解析
- URL结构:
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=CreateAlbum&AlbumName=我的旅行相册&StoreName=TravelMemories&Remark=记录每一次美好的旅程
在这个示例中，我们通过HTTP GET请求创建了一个名为“我的旅行相册”的相簿，归属于名为“TravelMemories”的PhotoStore，并添加了一段备注描述旅程的美好记忆。请注意，实际请求可能还需要包含身份验证信息（如AccessKeyId、Signature等），这些通常通过HTTP头或查询参数传递，具体取决于您使用的认证方式。
为了成功发起这样的请求，您需要根据阿里云API文档准备相应的认证签名和其他可能需要的头部信息。建议使用阿里云提供的SDK（如Python SDK、Java SDK等）来简化这一过程，这些SDK会自动处理签名和请求构建，使得调用更加便捷和安全。
