云相册的API相簿接口AddAlbumPhotos怎么使用
描述
批量将照片添加到相簿。
请求参数
| 参数名 | 类型 | 是否必须 | 说明 |
| Action | String | 是 | AddAlbumPhotos |
| AlbumId | String | 是 | 指定相簿的ID |
| PhotoId.1 | String | 是 | 照片的ID，如果有多张照片，请按照规则增加一个参数，比如2张照片，另外一个参数为PhotoId.2 |
| StoreName | String | 是 | PhotoStore的名称 |
| LibraryId | String | 否 | 照片库标识。采用AK认证时必选，采用STS认证时可选。了解不同认证方式的区别。 |
请求示例
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=AddAlbumPhotos
&AlbumId=822505561525329920
&PhotoId.1=822296943836270592
&StoreName=cloudphoto-demo
&LibraryId=alice-001
&<公共请求参数>返回参数
| 参数名 | 类型 | 说明 |
| RequestId | String | 唯一标识本次请求的ID |
| Code | String | 响应状态码，Success表示成功的响应 |
| Message | String | 响应状态详细描述 |
| Action | String | AddAlbumPhotos |
| Results | 数组 | 详见结果信息 |
Results
| 参数名 | 类型 | 说明 |
| Code | String | 状态码 |
| Id | Long | 对应对象的唯一标识 |
| Message | String | 详细信息 |
返回示例
JSON格式
{
"Results":[
{
"Message":"success",
"Id":822296943836270592,
"Code":"Success"
}
],
"Action":"AddAlbumPhotos",
"Message":"success",
"RequestId":"FD6C4A75-2965-4B04-93D6-C0660279F86F",
"Code":"Success"
}
XML格式
<?xml version="1.0" encoding="UTF-8"?>
<AddAlbumPhotosResponse>
<Results>
<Result>
<Message>success</Message>
<Id>822296943836270592</Id>
<Code>Success</Code>
</Result>
</Results>
<Action>AddAlbumPhotos</Action>
<Message>success</Message>
<RequestId>789A9AA8-6C46-4498-B937-3221A3D0FBC0</RequestId>
<Code>Success</Code>
</AddAlbumPhotosResponse>
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
您提到的操作是使用阿里云的Cloud Photo服务来批量将照片添加到指定的相簿中。Cloud Photo是阿里云提供的一项图片存储与管理服务，它允许用户上传、管理和分享照片资源。下面是对您描述的操作请求参数和示例的详细解析：
请求参数说明
-
Action: 必须参数，表示要执行的操作类型。在这个场景中，值应为
AddAlbumPhotos，意味着操作是向相簿添加照片。 -
AlbumId: 必须参数，用于指定目标相簿的唯一ID。您需要事先知道或获取到这个相簿的ID。
-
PhotoId.N: 是必须参数，其中N是一个数字序号（如
.1,.2等），表示多张照片的ID。如果要添加多张照片，需要按照这个格式依次增加参数，例如，第一张照片用PhotoId.1，第二张用PhotoId.2，以此类推。 -
StoreName: 必须参数，表示存储空间的名称，即您的PhotoStore名称。
-
LibraryId: 可选参数，代表照片库的标识。在使用Access Key（AK）认证时，此参数是必需的；而采用Security Token Service (STS)认证方式时，则可以省略。STS是一种临时授权机制，适用于给第三方应用或短期访问权限分配。
请求示例解析
-
URL:
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=AddAlbumPhotos这个URL是调用Cloud Photo服务的基地址，加上了操作Action作为查询参数。请注意，实际使用时还需根据具体需求添加其他必要参数。
-
完整请求示例:
假设我们要向相簿ID为
my_album_id的相簿中添加两张照片，照片ID分别为photo_123和photo_456，存储空间名为my_store_name，且使用AK认证方式，请求可能如下所示（注意，实际请求通常通过HTTP POST方法发送，并且参数会放在请求体中以JSON格式传递，这里为了简洁直接展示在URL中）：https://cloudphoto.cn-shanghai.aliyuncs.com/ ?Action=AddAlbumPhotos &AlbumId=my_album_id &PhotoId.1=photo_123 &PhotoId.2=photo_456 &StoreName=my_store_name &LibraryId=your_library_id_if_needed
请记得替换上述示例中的占位符（如my_album_id、photo_123等）为实际的值，并确保在正式调用API前，已经正确配置了认证信息（AK/SK或STS Token），以及了解并遵守阿里云的服务使用规则和限制。
