描述
全量列出当前照片库中照片的标签列表
请求参数
参数名 | 类型 | 是否必须 | 说明 |
Action | String | 是 | ListTags |
StoreName | String | 是 | PhotoStore的名称 |
LibraryId | String | 否 | 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。 |
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=ListTags
&StoreName=cloudphoto-demo
&LibraryId=alice-001
&<公共请求参数>
参数名 | 类型 | 说明 |
RequestId | String | 唯一标识本次请求的ID |
Code | String | 响应状态码,Success表示成功的响应 |
Message | String | 响应状态详细描述 |
Action | String | ListTags |
Tags | Tag[] | Tag数组 |
参数名 | 类型 | 说明 |
Cover | 对象 | 标签的封面照片 |
Id | String | 标签的唯一标识 |
IsSubTag | Boolean | 是否为二级标签,true 是二级标签,false 不是二级标签 |
ParentTag | String | 一级标签,IsSubTag 是 true 时,输出当前 tag 的一级标签; 为 false 时,即当前 tag 为一级标签,输出空字符串 |
Name | String | 标签的名称 |
参数名 | 类型 | 说明 |
Ctime | String | 创建的时间戳,单位:毫秒 |
FileId | String | 照片对应到存储在OSS上的文件名 |
Height | Integer | 照片的高度 |
Id | Long | 记录的唯一标识 |
Md5 | String | 文件的Md5值。如果文件是以OSS分块上传方式上传的话,文件MD5为异步计算,在计算完成以前,MD5值为空。 |
Mtime | String | 最后修改的时间戳,单位:毫秒 |
Remark | String | 照片的备注 |
State | String | 文件的状态 |
Title | String | 照片的名称 |
Width | Integer | 照片的宽度 |
{
"Tags":[
{
"Name":"舞蹈",
"Id":36864,
"IsSubTag":false,
"ParentTag":"",
"Cover":{
"Md5":"ac9cc6c68ae7f76d835e110a797baa14",
"Mtime":1500522991107,
"State":"active",
"Height":201,
"Id":824714799282655232,
"Ctime":1500522991107,
"Width":300,
"Title":"u=125227023,978057929&fm=26&gp=0.jpg",
"FileId":"To6bm_zeRbKSb0F
Wn2GwAAAApwZDIE",
"Remark": "Remark"
}
}
],
"Action":"ListTags",
"Message":"success",
"RequestId":"20BE5A2B-DB6B-410E-8F3B-D137165EAC98",
"Code":"Success"
}
<?xml version="1.0" encoding="UTF-8"?>
<ListTagsResponse>
<Tags>
<Tag>
<Name>舞蹈</Name>
<IsSubTag>false</IsSubTag>
<ParentTag></ParentTag>
<Cover>
<Mtime>1500522991107</Mtime>
<Md5>ac9cc6c68ae7f76d835e110a797baa14</Md5>
<State>active</State>
<Height>201</Height>
<Ctime>1500522991107</Ctime>
<Id>824714799282655232</Id>
<Width>300</Width>
<FileId>To6bm_zeRbKSb0FWn2GwAAAApwZDIE</FileId>
<Title><![CDATA[u=125227023,978057929&fm=26&gp=0.jpg]]></Title>
<Remark><![CDATA[Remark]]></Remark>
</Cover>
<Id>36864</Id>
</Tag>
</Tags>
<Action>ListTags</Action>
<Message>success</Message>
<RequestId>584E5FCE-9A5B-4E8E-9C8F-27AD0ACDC007</RequestId>
<Code>Success</Code>
</ListTagsResponse>
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
您提到的请求示例是关于使用阿里云Cloud Photo服务来全量列出照片库中所有照片的标签列表。Cloud Photo是阿里云提供的一种图片存储与管理服务,它支持对照片进行智能分析并打上标签,便于用户管理和搜索。
Action: 必须参数,指定要执行的操作。在这个例子中,ListTags
表示请求列出照片库中的所有标签。
StoreName: 必须参数,指定了Photo Store的名称。Photo Store是Cloud Photo服务中用于存储和管理照片的逻辑空间。
LibraryId: 可选参数,当使用Access Key(AK)认证时,这个参数是必须的,用来标识特定的照片库。如果采用Security Token Service (STS)认证,则可能不需要此参数,因为STS token本身已经包含了足够的权限信息。STS是一种临时授权机制,允许用户给予第三方应用有限的访问权限,而无需暴露长期的Access Key和Secret Key。
URL结构:https://cloudphoto.cn-shanghai.aliyuncs.com/
是Cloud Photo服务的API接入点,其中.cn-shanghai.aliyuncs.com
表明该请求指向的是阿里云上海区域的服务端点。不同的阿里云区域会有不同的端点地址。
查询字符串:在URL后面通过?
开始添加请求参数,格式为key=value&key2=value2...
。在这个例子中,只展示了Action=ListTags
这一部分,实际请求时还需包含其他必填参数,如StoreName
,以及根据认证方式决定是否需要的LibraryId
。
构造完整请求:确保在实际发起请求时,除了Action
和StoreName
外,根据您的认证方式正确添加LibraryId
(如果需要)以及其他可能的认证信息(如签名、时间戳等),以完成整个HTTP请求。
认证方式选择:如果您计划在服务器到服务器的通信中使用此API,通常推荐使用AK认证。若涉及第三方应用或临时授权场景,考虑使用STS认证,以提高安全性。
查看文档:详细操作指南和参数说明,请参考阿里云官方文档的Cloud Photo服务部分,以获取最新的API调用方法、错误码解释及示例代码等。
测试与调试:利用阿里云提供的OpenAPI Explorer工具,可以在线构建和测试API请求,帮助您快速验证请求参数和响应结果,无需事先部署代码。