使用表格存儲的 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='