日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

V2版本RPC風格請求體&簽名機制

更新時間:

本文介紹了阿里云 OpenAPI 的 RPC 風格接口,涵蓋請求的組成部分、如何構造 OpenAPI 請求、獲取返回結果的方法以及簽名機制等。阿里云 RPC OpenAPI 向開發者提供 HTTP 接口,方便自研阿里云 RPC 調用風格的 OpenAPI SDK。

重要

不再推薦使用該訪問方式,請移步參考V3版本請求體&簽名機制

RPC 風格簡介

RPC(Remote Procedure Call)是一種允許客戶端以類似本地函數調用方式遠程調用服務端方法的協議。阿里云的 RPC 接口主要支持以下兩種 HTTP 方法:

  • GET:用于從服務器獲取資源。

  • POST:用于向服務器提交數據或請求操作。

HTTP 請求結構

一個完整的阿里云 RPC 請求由以下部分組成:

名稱

是否必選

描述

示例值

協議

支持通過HTTPHTTPS協議進行請求通信。為了獲得更高的安全性,推薦您使用HTTPS協議發送請求。

https://

服務地址

即 Endpoint。您可以查閱不同云產品的服務接入地址文檔,在OpenAPI中的服務區域可查找。

ecs.aliyuncs.com

公共請求參數

阿里云 OpenAPI 的公共請求參數,更多信息,請參見下文公共請求參數

Action

接口自定義請求參數

每個 OpenAPI 自定義的請求參數,建議您在阿里云 OpenAPI 開發者門戶進行試用。

RegionId

HTTPMethod

RPC 請求 Method 支持 POST 或者 GET。

GET

公共請求參數

每個 RPC 請求都需包含以下關鍵參數:

名稱

類型

是否必選

描述

示例值

Action

String

API 的名稱。您可以訪問阿里云 OpenAPI 開發者門戶,搜索您想調用的 OpenAPI 。

CreateInstance

Version

String

API 版本。您可以訪問阿里云 OpenAPI 開發者門戶,查看您調用 OpenAPI 對應的 API 版本。例如短信服務產品,您可以通過查看云產品主頁中看到API 版本為 2017-05-25。

2014-05-26

Format

String

指定返回數據格式,可選 JSON 或 XML,默認為 XML。

JSON

AccessKeyId

String

阿里云訪問密鑰 ID。您可以在RAM 控制臺查看您的 AccessKeyId。如需創建 AccessKey,請參見創建AccessKey

yourAccessKeyId

SignatureNonce

String

簽名唯一隨機數。用于防止網絡重放攻擊,建議您每一次請求都使用不同的隨機數,隨機數位數無限制。

15215528852396

Timestamp

String

當前時間戳,有效期為31分鐘,即生成時間戳后需要在31分鐘內發起請求。按照時間格式標準表示,并需要使用 UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ

示例:2018-01-01T12:00:00Z表示北京時間2018年01月01日20點00分00秒。

2018-01-01T12:00:00Z

SignatureMethod

String

簽名方式。目前為固定值 HMAC-SHA1

HMAC-SHA1

SignatureVersion

String

簽名算法版本。目前為固定值 1.0

1.0

Signature

String

請求簽名,用戶請求的身份驗證。更多信息,請參見后文簽名機制

Pc5WB8gokVn0xfeu%2FZV%2BiNM1dgI%3D

接口請求構造

步驟一:構造接口 URL

  • 接口 URL 由以下部分組成:[協議][服務地址]?[公共參數][業務請求參數]

  • POST 方法應將業務參數放于請求體中,GET 方法的參數則在 URL 查詢字符串中。

  • 對請求參數進行規范化編碼。例如: Timestamp 的參數值為 2016-02-23T12:46:24Z ,編碼后為 2016-02-23T12%3A46%3A24Z 。編碼方式請參見參數編碼方式

接口 URL 示例:

http://ecs.aliyuncs.com/?SignatureVersion=1.0&Action=DescribeDedicatedHosts&Format=XML&SignatureNonce=3ee8c1b8-xxxx-xxxx-xxxx-xxxxxxxxx&Version=2014-05-26&AccessKeyId=testid&Signature=OLeaidS1JvxuMvnyHOwuJ%2BuX5qY%3D&SignatureMethod=HMAC-SHA1&Timestamp=2016-02-23T12%3A46%3A24Z&RegionId=cn-hangzhou&Status=Available

步驟二:發起接口調用

  • GET 方法可使用瀏覽器、curl 或者 wget 等工具發起請求。

  • POST方法需在請求體中傳入業務請求參數,并設置請求頭的Content-Typeapplication/x-www-form-urlencoded

接口返回結果

返回結果主要有 XML 和 JSON 兩種格式,默認為 XML ,可通過公共請求參數Format指定返回結果的格式。

說明

為了便于您查看,API 文檔返回示例均進行了換行和縮進等處理,實際返回結果無換行和縮進處理。

當接口調用成功時,將返回請求 ID,HTTP 狀態碼為 2xx(不顯示在響應正文中)。成功響應示例如下:

  • XML :

<?xml version="1.0" encoding="UTF-8"?> <!--結果的根結點-->
<ActionResponse> <!--返回請求標簽-->
    <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId> <!--返回結果數據-->
</ActionResponse>
  • JSON :

{
    "RequestId": "4C467B38-3910-447D-87BC-AC049166F216" /* 返回結果數據 */
}

接口調用出錯時,返回請求 ID、服務節點、錯誤碼和錯誤信息,HTTP 狀態碼為 4xx 或 5xx。錯誤響應示例如下:

  • XML :

<?xml version="1.0" encoding="UTF-8"?><!--結果的根結點-->
<Error>
    <RequestId>540CFF28-407A-40B5-B6A5-74Bxxxxxxxxx</RequestId> <!--請求 ID-->
    <HostId>ecs.aliyuncs.com</HostId> <!--服務節點-->
    <Code>MissingParameter.CommandId</Code> <!--錯誤碼-->
    <Message>The input parameter “CommandId” that is mandatory for processing this request is not supplied.</Message> <!--錯誤信息-->
</Error>
  • JSON :

{
    "RequestId": "540CFF28-407A-40B5-B6A5-74Bxxxxxxxxx", /* 請求 ID */
    "HostId": "ecs.aliyuncs.com", /* 服務節點 */
    "Code": "MissingParameter.CommandId", /* 錯誤碼 */
    "Message": "The input parameter “CommandId” that is mandatory for processing this request is not supplied." /* 錯誤信息 */
}
說明

接口調用出錯后,您可以根據返回的 RequestId,在阿里云OpenAPI開發者門戶-診斷中排查。此外,您還可以查閱公共錯誤碼以及API 錯誤中心。當您無法排查錯誤時,可以提交工單,并在工單中注明服務節點 HostId 和 RequestId。

簽名機制

為了確保 API 的安全性,每個請求都需通過簽名(Signature)進行身份驗證。以下是簽名計算的步驟:

步驟一:構造規范化請求字符串

1、參數排序:按照參數首字母的字典順序對參數排序,排序參數包括公共請求參數和接口自定義參數(即 OpenAPI 文檔中的請求參數),不包括公共請求參數中的Signature參數。 公共請求參數詳情,請參見上文公共請求參數。偽代碼如下:

// 例:參數名集合 {b, a, C} 排序后為 {C, a, b}
sortParams = sorted(params.keys())

2、編碼參數:使用 UTF-8 字符集按照RFC3986規則編碼請求參數和參數取值,編碼具體規則請參看參數編碼方式。為方便表述,我們將此步驟的編碼方法,命名為 encodeURIComponent。偽代碼如下:

// 例:請求參數為測試,參數取值為中文 編碼后分別是%E6%B5%8B%E8%AF%95和%E4%B8%AD%E6%96%87
encodeURIComponent(sortParams.keys, sortParams.values)

3、連接參數:使用等號(=)連接第二步得到的編碼后請求參數和參數值。然后用&連接所有參數。注意參數排序與第1步一致。偽代碼如下:

// 例:編碼后請求參數為test,參數取值為testvalue,則拼接為test=testvalue
encodeURIComponentParam.key=encodeURIComponentParam.value

得到了規范化請求字符串CanonicalizedQueryString

步驟二:構造簽名字符串

1、構造待簽名字符串 stringToSign。該字符串構造規則的偽代碼如下:

String stringToSign =
  HTTPMethod + "&" + // HTTPMethod:發送請求的 HTTP 方法,例如 GET。
  encodeURIComponent("/") + "&" + // encodeURIComponent 為步驟一第2步的編碼方法
  encodeURIComponent(CanonicalizedQueryString) // CanonicalizedQueryString 為步驟一獲取的規范化請求字符串。

2、計算簽名。按照RFC2104的定義,通過您傳入的 AccessKeyId 對應的密鑰 AccessSecret,使用 HMAC-SHA1的簽名算法,計算待簽名字符串StringToSign的簽名。其中 Base64() 為編碼計算函數,HMAC_SHA1() 為 HMAC_SHA1 簽名函數,返回值為 HMAC_SHA1 加密后原始字節,而非16進制字符串,UTF_8_Encoding_Of() 是 UTF-8 字符編碼函數,偽代碼如下:

String signature = Base64(HMAC_SHA1(AccessSecret + "&", UTF_8_Encoding_Of(stringToSign)))

使用 HMAC-SHA1 簽名算法,計算得到的公共參數 Signature 的簽名值 signature

簽名示例

本示例以調用 ECS DescribeDedicatedHosts查詢一臺或多臺專有宿主機的詳細信息為例。假設 AccessKeyID 為 testid, AccessKeySecret 為 testsecret,SignatureNonce 為 edb2b34af0af9a6d14deaf7c1a5315eb, Timestamp 為 2023-03-13T08:34:30Z,簽名流程如下:

  1. 構造規范化請求字符串。

    http://ecs.aliyuncs.com/?AccessKeyId=testid&Action=DescribeDedicatedHosts&Format=JSON&RegionId=cn-beijing&SignatureMethod=HMAC-SHA1&SignatureNonce=edb2b34af0af9a6d14deaf7c1a5315eb&SignatureVersion=1.0&Tag.1.Key=testkey&Tag.1.Value=testvalue&Timestamp=2023-03-13T08%3A34%3A30Z&Version=2014-05-26
  2. 構造待簽名字符串stringToSign

    GET&%2F&AccessKeyId%3Dtestid%26Action%3DDescribeDedicatedHosts%26Format%3DJSON%26RegionId%3Dcn-beijing%26SignatureMethod%3DHMAC-SHA1%26SignatureNonce%3Dedb2b34af0af9a6d14deaf7c1a5315eb%26SignatureVersion%3D1.0%26Tag.1.Key%3Dtestkey%26Tag.1.Value%3Dtestvalue%26Timestamp%3D2023-03-13T08%253A34%253A30Z%26Version%3D2014-05-26
  3. 計算簽名值。例如 AccessKeySecret=testsecret,用于計算的 Key 為testsecret&(注意:加上后綴&)。計算得到的簽名值為fRmq1o6saIIjVlawOy+o6jDU9JQ=。偽代碼如下:

    String Signature = Base64(HMAC_SHA1(AccessSecret + "&",UTF_8_Encoding_Of(stringToSign)))
  4. 得到完整的URL。添加RFC3986規則編碼后的Signature=fRmq1o6saIIjVlawOy%2Bo6jDU9JQ%3D第1步的 URL 中。

    https://ecs.cn-beijing.aliyuncs.com/?AccessKeyId=testid&Action=DescribeDedicatedHosts&Format=JSON&RegionId=cn-beijing&SignatureMethod=HMAC-SHA1&SignatureNonce=edb2b34af0af9a6d14deaf7c1a5315eb&SignatureVersion=1.0&Tag.1.Key=testkey&Tag.1.Value=testvalue&Timestamp=2023-03-13T08%3A34%3A30Z&Version=2014-05-26&Signature=fRmq1o6saIIjVlawOy%2Bo6jDU9JQ%3D
重要

Version 字段值和域名是對應關系(服務域名和 Version 值請參看對應云產品 OpenAPI 云產品主頁),錯誤的域名或 Version 值可能導致 InvalidVersion 錯誤。

通過第4步得到的 URL,您可以使用瀏覽器、curl 或者 wget 等工具發起HTTP請求調用DescribeDedicatedHosts,查詢一臺或多臺專有宿主機的詳細信息。

附錄

參數編碼方式

在阿里云 OpenAPI 調用中,請求參數和參數值需使用 UTF-8 字符集按照RFC3986規則進行編碼。具體編碼規則如下:

  • 字符 A~Z、a~z、0~9 以及字符-_.~不編碼。

  • 對其他 ASCII 碼字符進行編碼。編碼格式為%加上16進制的 ASCII 碼。例如半角雙引號(")將被編碼為 %22

  • 非 ASCII 碼通過 UTF-8 編碼。

  • 空格編碼成%20,不使用加號(+)表示空格。

相關文檔

區分ROA風格和RPC風格