使用表格存储的 API__开发指南_表格存储-阿里云

• instance：实例名称。实例由用户创建，可以在表格存储控制台查看云账户下拥有的实例信息。大小写不敏感。

• region：阿里云服务节点。表格存储服务会部署在多个地理位置不同的阿里云服务节点内。创建实例时需要制定阿里云节点，可以在表格存储控制台查看实例所在的阿里云服务节点名称。大小写不敏感。

• operation：表格存储操作名称。可以在 API 操作总览一章查看所有的表格存储操作名。大小写敏感。

如下所示的 URL 是华东 1（杭州）节点，实例名称为 myInstance 的 ListTable 请求的目标 URL。

https://myInstance.cn-hangzhou.ots.aliyuncs.com/ListTable

HTTP Request Header

表格存储规定 HTTP 请求的 Header 必须包含以下信息:

• x-ots-date：请求发出时间。日期格式采用 rfc822 标准，并使用 UTC 时间，格式为“%a, %d %b %Y %H:%M:%S GMT”。

• x-ots-apiversion：API 的版本号。版本号是一个日期字符串，本文档对应的 API 版本号为 2014-08-08。

• x-ots-accesskeyid：用户的 AccessKeyID。

• x-ots-instancename：实例名称。

• x-ots-contentmd5：对 HTTP body 中计算出的 MD5，使用 base64 进行编码。

• x-ots-signature：请求的签名。签名计算方式如下:

    Signature = base64(HmacSha1(AccessKeySecret, StringToSign));
    StringToSign = CanonicalURI + 'n' + HTTPRequestMethod + 'nn' + CanonicalHeaders
    CanonicalHeaders = LowerCase (HeaderName1) + ':' + Trim(HeaderValue1) + 'n' + ... + LowerCase (HeaderNameN) + ':' + Trim(HeaderValueN) + 'n'

  上述伪代码中使用到的函数的说明:

  • HmacSha1：Hmac-Sha1 加密算法。计算表格存储请求签名时请将 StringToSign 作为消息，AccessKeySecret 作为密钥。

  • base64：base64 编码算法。

  • LowerCase：将字符串中的字母全部变成小写。

  • Trim：去除字符串首尾处的空白字符。

• CanonicalURI：HTTP URL 中的路径部分。如下面示例中，CanonicalURI 为 /ListTable：

    https://myInstance.cn-hangzhou.ots.aliyuncs.com/ListTable

• HTTPRequestMethod：HTTP 请求方法。如 GET、POST 或 PUT 等，表格存储的 HTTP API 只支持 POST 方法。注意 POST 需要大写。

• CanonicalHeaders：CanonicalHeaders 是表格存储 HTTP header 按照以下规则构造的字符串（不包括 x-ots-signature 头）:

  • 需要包含且只包含所有以“x-ots-”开头的表格存储标准头。

  • header 项名称全部小写，值必须经过 trim 去除空格。

  • header 项按照名字的字典序从小到大排序。

  • header 项的名称和值之间以“:”相隔。

  • 每个 header 之间以换行符相隔。

表格存储会对 HTTP 请求进行以下验证:

POST /ListTable HTTP/1.0
x-ots-date: Tue, 12 Aug 2014 10:23:03 GMT
x-ots-apiversion:2014-08-08
x-ots-accesskeyid: 29j2NtzlUr8hjP8b
x-ots-contentmd5: 1B2M2Y8AsgTpgAmY7PhCfg==
x-ots-instancename: naketest

stringToSign = '/ListTablenPOSTnnx-ots-accesskeyid:29j2NtzlUr8hjP8bnx-ots-apiversion:2014-08-08nx-ots-contentmd5:1B2M2Y8AsgTpgAmY7PhCfg==nx-ots-date:Tue, 12 Aug 2014 10:23:03 GMTnx-ots-instancename:naketestn'
signature = base64(HmacSha1('8AKqXmNBkl85QK70cAOuH4bBd3gS0J', stringToSign))
  = '4xap392B7EBpN+RmlHgNowjoG1w='

/ListTable
x-ots-contentmd5: 1B2M2Y8AsgTpgAmY7PhCfg==
x-ots-requestid: 0005006c-0e81-db74-4a34-ce0a5df229a1
x-ots-contenttype: protocol buffer
x-ots-date:Tue, 12 Aug 2014 10:23:03 GMT

stringToSign = 'x-ots-contentmd5:1B2M2Y8AsgTpgAmY7PhCfg==nx-ots-contenttype:protocol buffernx-ots-date:Tue, 12 Aug 2014 10:23:03 GMTnx-ots-requestid:0005006c-0e81-db74-4a34-ce0a5df229a1n/ListTable'
authorization = 'OTS ' + AccessKeyID +  ':' + base64(HmacSha1('8AKqXmNBkl85QK70cAOuH4bBd3gS0J', stringToSign))
  = 'OTS 29j2NtzlUr8hjP8b:Y24MHhVti5UhSCW5qsUSDvT9SOk='