公共参数 公共请求参数是指每个接口都需要使用到的请求参数。
参数名称 类型 必选 描述 Format String 否 返回值的类型,支持 JSON 与 XML。默认为 JSON。 Version String 是 API 版本号为日期形式:YYYY-MM-DD,本版本为 2017-06-26
。 AccessKeyId String 是 阿里云颁发给用户的访问服务所用的密钥 ID。 Signature String 是 签名结果串。 SignatureMethod String 是 签名方式,目前支持 HMAC-SHA1。 Timestamp String 是 请求的时间戳。日期格式按照 ISO8601 标准表示,使用 UTC 时间,具体为 YYYY-MM-DDThh:mm:ssZ。例如,2017-05-26T12:00:00Z。 SignatureVersion String 是 签名算法版本,目前版本是 1.0。 SecurityToken String 否 使用STS凭证类型时,要求传入。 SignatureNonce String 否 唯一随机数,用于防止网络重放攻击。用户在不同请求间要使用不同的随机数值。 请求示例 GET https://nas.cn-hangzhou.aliyuncs.com/?Action=
&Format=xml &Version=2017-06-26 &AccessKeyId=key-test &Signature=Pc5***3D &SignatureMethod=HMAC-SHA1 &SignatureNonce=15215528852396 &SignatureVersion=1.0 &Timestamp=2012-06-01T12:00:00Z … 公共返回参数 用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码 RequestId 给用户。
参数名称 类型 描述 RequestId Integer 系统返回的唯一识别码。 返回示例 XML示例
<接口名称+response> 6D9F62C5-BF52-447C-AA34-C77F7AFCCC12 JSON示例{ "RequestId": "4C467B38-3910-447D-87BC-AC049166F216", /* 返回结果数据 */ } 公共请求参数是指每个接口都需要使用到的请求参数。
参数名称 类型 必选 描述 Format String 否 返回值的类型,支持 JSON 与 XML。默认为 JSON。 Version String 是 API 版本号为日期形式:YYYY-MM-DD,本版本为 2017-06-26
。 AccessKeyId String 是 阿里云颁发给用户的访问服务所用的密钥 ID。 Signature String 是 签名结果串。 SignatureMethod String 是 签名方式,目前支持 HMAC-SHA1。 Timestamp String 是 请求的时间戳。日期格式按照 ISO8601 标准表示,使用 UTC 时间,具体为 YYYY-MM-DDThh:mm:ssZ。例如,2017-05-26T12:00:00Z。 SignatureVersion String 是 签名算法版本,目前版本是 1.0。 SecurityToken String 否 使用STS凭证类型时,要求传入。 SignatureNonce String 否 唯一随机数,用于防止网络重放攻击。用户在不同请求间要使用不同的随机数值。 请求示例 GET https://nas.cn-hangzhou.aliyuncs.com/?Action=
&Format=xml &Version=2017-06-26 &AccessKeyId=key-test &Signature=Pc5***3D &SignatureMethod=HMAC-SHA1 &SignatureNonce=15215528852396 &SignatureVersion=1.0 &Timestamp=2012-06-01T12:00:00Z … 公共返回参数 用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码 RequestId 给用户。
参数名称 类型 描述 RequestId Integer 系统返回的唯一识别码。 返回示例 XML示例
<接口名称+response> 6D9F62C5-BF52-447C-AA34-C77F7AFCCC12 JSON示例{ "RequestId": "4C467B38-3910-447D-87BC-AC049166F216", /* 返回结果数据 */ }
文件存储CPFS的API请求具有特定的结构,包括服务地址、通信协议、请求方法、请求参数、字符编码、SDK等信息。
说明 CPFS的请求结构与NAS相同,使用NAS的服务地址和SDK。 服务地址 CPFS API的服务接入地址格式为:nas.aliyuncs.com和nas.[RegionId.]aliyuncs.com。其中,RegionId是指服务区域,用户根据自己所在区域调用指定区域的API。 目前已开通服务的区域如下:
开通区域 RegionId 服务接入地址 北京 cn-beijing nas.cn-beijing.aliyuncs.com 上海 cn-shanghai nas.cn-shanghai.aliyuncs.com 杭州 cn-hangzhou nas.cn-hangzhou.aliyuncs.com 深圳 cn-shenzhen nas.cn-shenzhen.aliyuncs.com 张家口 cn-zhangjiakou nas.cn-zhangjiakou.aliyuncs.com 呼和浩特 cn-huhehaote nas.cn-huhehaote.aliyuncs.com 通信协议 支持HTTP或HTTPS协议进行请求通信。为了获得更高的安全性,推荐您使用HTTPS通道发送请求。
请求方法 支持HTTP GET方法发送请求,这种方式下请求参数需要包含在请求的URL中。
请求参数 每个请求都需要指定要执行的操作,即Action参数(例如CreateLDAPConfig),以及每个操作都需要包含的公共请求参数和指定操作所特有的请求参数。
字符编码 请求及返回结果都使用UTF-8字符集进行编码。
使用 SDK 目前CPFS支持JAVA、Python 和PHP语言的SDK开发。
建议您使用SDK,相比手动发起HTTP请求,SDK可以帮助您省去繁琐的HTTP报文封装和签名操作。
各语言SDK的Github下载地址如下:
Java: NAS Java SDK Python: NAS Python SDK PHP: NAS PHP SDK .Net: NAS .Net SDK
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。