开发者社区> 问答> 正文

智能云相册中的公共请求参数类型



公共请求参数


公共请求参数是指每一个接口都需要使用到的参数:

名称类型必填项描述
FormatString返回值的类型,支持JSON与XML,默认为XML。
VersionStringAPI版本号,为日期形式:YYYY-MM-DD,本版本对应为2017-07-11。
AccessKeyIdString阿里云颁发给用户的访问服务所用的密钥ID,或者从您的业务服务器获取到的临时访问凭证中的临时密钥ID。
SignatureString签名结果串,关于签名的计算方法,请参见签名机制。
SignatureMethodString签名方式,目前支持HMAC-SHA1。
TimestampString请求的时间戳。日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ例如,2014-7-29T12:00:00Z(为北京时间2014年7月29日的20点0分0秒。
SignatureVersionString签名算法版本,目前版本是1.0。
SignatureNonceString唯一随机数,用于防止网络重放攻击。用户在不同请求间要使用不同的随机数值。
SecurityTokenString是(特定情况)STS凭证,如果客户端从业务服务器获取STS凭证后访问智能云相册服务,该参数为必选。
LibraryIdString是(特定情况)照片库的Id,如果使用AK认证的方式来对照片库进行操作,该参数为必选。如果使用STS认证的方式,LibraryId是通过SecurityToken中的RoleSessionName来进行传递,此时该参数为可选,如果提供了该参数,那么其值需要和RoleSessionName一致。

示例: http://cloudphoto.cn-shanghai.aliyuncs.com/
    ?Format=json
    &Version=2017-07-11
    &Signature=vpEEL0zFHfxXYzSFV0n7%2FZiFL9o%3D
    &SignatureMethod=Hmac-SHA1
    &SignatureNonce=9166ab59-f445-4005-911d-664c1570df0f
    &SignatureVersion=1.0
    &Action=ListPhotos
    &AccessKeyId=tkHh5O7431CgWayx  
    &Timestamp=2017-07-29T09%3A22%3A32Z
    &SecurityToken=<SecurityTokenFromBusinessServer>



公共返回参数


用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码RequestId给用户。
XML示例: <?xml version="1.0" encoding="UTF-8"?>
    <!—结果的根结点-->
    <接口名称+Response> <!—返回请求标签-->
        <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
        <!—返回结果数据-->
    </接口名称+Response>


Json示例: {
        "RequestId": "4C467B38-3910-447D-87BC-AC049166F216", /* 返回结果数据 */
    }


注意:文档中的返回示例为了便于阅读,做了格式化处理,实际返回结果是没有进行换行、缩进等处理。

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

相关电子书

更多
阿里云物联网平台属性,事件,服务详解 立即下载
低代码开发师(初级)实战教程 立即下载
阿里巴巴DevOps 最佳实践手册 立即下载