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

AI 助理
備案控制臺
文檔
輸入文檔關(guān)鍵字查找
首頁 阿里云SDK 產(chǎn)品概述 請求結(jié)構(gòu)和簽名機(jī)制 V2版本請求體&簽名機(jī)制（不推薦） V2版本ROA風(fēng)格請求體&簽名機(jī)制

V2版本ROA風(fēng)格請求體&簽名機(jī)制

更新時間：
我的收藏

本文介紹了阿里云 OpenAPI 的 ROA風(fēng)格接口，包括ROA OpenAPI 請求的組成部分，如何通過這些組成部分構(gòu)造一個 OpenAPI 請求，如何獲取返回結(jié)果以及簽名機(jī)制等。阿里云 ROA OpenAPI 向開發(fā)者提供HTTP接口，如果您想要自研阿里云ROA調(diào)用風(fēng)格的OpenAPI SDK，您可以參看本文，來構(gòu)造 HTTP 請求調(diào)用對應(yīng)的 OpenAPI 。

重要

不再推薦使用該訪問方式，請移步參考V3版本請求體&簽名機(jī)制。

HTTP 請求結(jié)構(gòu)

一個完整的阿里云 OpenAPI 請求，包含以下部分。

名稱

是否必選

描述

示例值

協(xié)議

是

您可以查閱不同云產(chǎn)品的 API 參考文檔進(jìn)行配置。支持通過HTTP或HTTPS協(xié)議進(jìn)行請求通信。為了獲得更高的安全性，推薦您使用HTTPS協(xié)議發(fā)送請求。取值范圍為https://或者 http://。

https://

服務(wù)地址

是

即 Endpoint。您可以查閱不同云產(chǎn)品的服務(wù)接入地址文檔，查閱不同服務(wù)區(qū)域下的服務(wù)地址。

cs.aliyuncs.com

resource_URI_parameters

是

接口URL，包括接口路徑和位置在 path、 query的接口請求參數(shù)。

/clusters/{cluster_id}/triggers

RequestHeader

是

請求頭信息，通常包含API的版本、Host、Authorization等信息。后文將詳細(xì)說明，請參見RequestHeader（請求頭）

x-acs-action

RequestBody

是

定義在 body 中的業(yè)務(wù)請求參數(shù)，建議您在阿里云 OpenAPI 開發(fā)者門戶進(jìn)行試用。

cluster_id

HTTPMethod

是

請求使用的方法，ROA接口請求方法包括PUT、POST、GET、DELETE。

POST

RequestHeader（請求頭）

一個完整的阿里云 OpenAPI 請求，包含以下部分。

名稱

類型

是否必選

描述

示例值

x-acs-action

String

是

API的名稱。您可以訪問阿里云 OpenAPI 開發(fā)者門戶，搜索您想調(diào)用的 OpenAPI

CreateTrigger

x-acs-version

String

是

API 版本。您可以訪問阿里云 OpenAPI 開發(fā)者門戶，查看您調(diào)用 OpenAPI 對應(yīng)的 API 版本

2015-12-15

Accept

String

否

指定接口返回?cái)?shù)據(jù)的格式。ROA 只支持固定值 application/json

application/json

Authorization

String

非匿名請求必須

用于驗(yàn)證請求合法性的認(rèn)證信息，格式為AccessKeyId:Signature。其中AccessKeyId 為用戶的訪問密鑰ID。您可以在RAM 控制臺查看您的 AccessKeyId。如需創(chuàng)建 AccessKey，請參見創(chuàng)建AccessKey。

Signature為請求簽名，取值參見簽名機(jī)制。

acs testid:D9uFJAJgLL+dryjBfQK+YeqGtoY=

x-acs-signature-nonce

String

否

簽名唯一隨機(jī)數(shù)。用于防止網(wǎng)絡(luò)重放攻擊，建議您每次請求都使用不同的隨機(jī)數(shù)。

15215528852396

Date

String

是

當(dāng)前時間戳，有效期為15分鐘，即生成時間戳后需要在15分鐘內(nèi)發(fā)起請求。HTTP 1.1協(xié)議中規(guī)定的 GMT 時間，例如：Tue 9 Apr 2019 07:35:29 GMT。

Tue 9 Apr 2022 07:35:29 GMT

x-acs-signature-method

String

非匿名請求必須

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

HMAC-SHA1

Content-MD5

String

否

HTTP請求正文的128-bit MD5散列值轉(zhuǎn)換成BASE64編碼的結(jié)果。

Gtl/0jNYHf8t9Lq8Xlpaqw==

Host

String

是

即服務(wù)地址，參見HTTP 請求結(jié)構(gòu)。

cs.aliyuncs.com

接口請求構(gòu)造

一個完整的接口請求構(gòu)造如下：

HTTPMethod /resource_URI_parameters
RequestHeader
RequestBody

請求參數(shù)由公共請求頭和API自定義參數(shù)組成。公共請求頭中包含API版本號、身份驗(yàn)證等信息。

示例：

POST /clusters/test_cluster_id/triggers HTTP/1.1
{
    "x-acs-action":"CreateTrigger",
    "x-acs-version":"2015-12-15",
    "Accept":"application/json",
    "Authorization": "acs testid:D9uFJAJgLL+dryjBfQK+YeqGtoY=",
    "x-acs-signature-nonce":"15215528852396",
    "Date":"Tue 9 Apr 2022 07:35:29 GMT",
    "x-acs-signature-method":"HMAC-SHA1",
    "Content-MD5":"Gtl/0jNYHf8t9Lq8Xlpaqw=="
    "Host":"cs.aliyuncs.com"    
}
{
  	"cluster_id":"test_cluster_id",
  	"project_id":"default/nginx-test",
  	"action":"redeploy",
  	"type":"deployment"
}

請求編碼

請求及返回結(jié)果都使用UTF-8字符集進(jìn)行編碼。

接口返回結(jié)果

每次接口調(diào)用請求，無論成功與否，系統(tǒng)都會返回一個唯一識別碼RequestId。調(diào)用API服務(wù)后返回?cái)?shù)據(jù)采用統(tǒng)一格式。接口調(diào)用成功后，會返回接口的返回參數(shù)請求 ID，HTTP 狀態(tài)碼為 2xx（不顯示在響應(yīng)正文中）。響應(yīng)正文示例如下：

{
    "RequestId": "4C467B38-3910-447D-87BC-AC049166F216"/* 返回結(jié)果數(shù)據(jù) */
}

接口調(diào)用出錯后，會返回請求ID、服務(wù)節(jié)點(diǎn)、錯誤碼和錯誤信息，HTTP 狀態(tài)碼為 4xx 或者 5xx。示例如下：

{
    "code": "400", /* 錯誤碼 */
    "message": "Cluster permission denied", /* 錯誤信息 */
    "requestId": "A026BC61-0523-5A6D-A5F3-314A3D92FD50", /* 請求 ID */
    "status": 400 /* 業(yè)務(wù)字段 */
}

接口調(diào)用出錯后，您可以根據(jù)返回的RequestId，在阿里云OpenAPI開發(fā)者門戶-診斷中排查。此外，您還可以查閱公共錯誤碼以及API 錯誤中心。當(dāng)您無法排查錯誤時，可以提交工單，并在工單中注明Host（服務(wù)地址，參見HTTP 請求結(jié)構(gòu)）和RequestId。

簽名機(jī)制

為保證API的安全調(diào)用，在調(diào)用API時阿里云會對每個API請求通過簽名（Signature）進(jìn)行身份驗(yàn)證。無論使用HTTP還是HTTPS協(xié)議提交請求，都需要在請求中包含簽名信息。本文指導(dǎo)您如何進(jìn)行簽名處理。

對于每一次HTTP或者HTTPS協(xié)議請求，阿里云會根據(jù)訪問中的簽名信息驗(yàn)證訪問請求者身份。您在訪問時簽名信息時，請按照以下方法對請求進(jìn)行簽名處理：

步驟一：構(gòu)造規(guī)范化請求頭

阿里云規(guī)范化請求頭（CanonicalizedHeaders）是非標(biāo)準(zhǔn)HTTP頭部信息。它是指請求中出現(xiàn)的以x-acs-為前綴的參數(shù)信息，構(gòu)造方法如下：

  • 將所有以x-acs-為前綴的HTTP請求頭的名稱轉(zhuǎn)換成小寫字母。如X-acs-Meta-Name: TaoBao轉(zhuǎn)換成

    x-acs-meta-name: TaoBao。阿里云規(guī)范請求頭的名稱大小寫不敏感，建議全小寫。

  • 如果一個公共請求頭的值過長，則需要處理其中的\t、\n、\r、\f分隔符，將其替換成英文半角的空格。

  • 將上一步得到的所有HTTP阿里云規(guī)范頭按照字典順序進(jìn)行升序排列。

  • 刪除請求頭的名稱和值之間的分隔符兩端出現(xiàn)的任何空格。例如x-acs-oss-meta-name :TaoBao,Alipay轉(zhuǎn)換成x-acs-oss-meta-name:TaoBao,Alipay。

  • 在每一個請求頭后添加一個\n分隔符（包括最后一個請求頭），然后將所有請求頭拼接在一起即獲得CanonicalizedHeaders。

步驟二：構(gòu)造規(guī)范化資源

規(guī)范化資源（CanonicalizedResource） 表示您想要訪問資源的規(guī)范描述，具體構(gòu)造方式如下：

  1. 將請求的查詢字符串（queryString）中的參數(shù)按照參數(shù)名稱的字典序重新排序，并以&分隔符連接生成已排序查詢字符串。

  2. 將請求資源路徑（指URL中host與查詢字符串之間的部分，包含host之后的/但不包含查詢字符串前的?）與已排序查詢字符串以?拼接，得到規(guī)范化資源。當(dāng)查詢字符串不存在時，直接用請求資源路徑作為規(guī)范化資源。

示例

原始請求URL：

http://demo-product.aliyuncs.com/instances?status=ONLINE&group=test_group

規(guī)范化資源：

/instances?group=test_group&status=ONLINE

步驟三：構(gòu)造待簽名字符串

按照以下偽代碼構(gòu)造待簽名字符串（stringToSign）：

String stringToSign = 
    HTTPMethod + "\n" +
    Accept + "\n" +
    ContentMD5 + "\n" +
    ContentType + "\n" +
    Date + "\n" +
    CanonicalizedHeaders +
    CanonicalizedResource

參數(shù)

描述

HTTPMethod

大寫的HTTP方法名，例如POST、GET。

Accept

Accept請求頭的值，當(dāng)請求頭不存在時，使用空字符串代替。

ContentMD5

Content-MD5請求頭的值，當(dāng)請求頭不存在時，使用空字符串代替。

ContentType

Content-Type請求頭的值，當(dāng)請求頭不存在時，使用空字符串代替。

Date

Date請求頭的值。

CanonicalizedHeaders

步驟一：構(gòu)造規(guī)范化請求頭中獲得的規(guī)范化請求頭。

CanonicalizedResource

步驟二：構(gòu)造規(guī)范化資源中獲得的規(guī)范化資源。

步驟四：計(jì)算簽名

根據(jù)RFC2104的定義，按照HMAC-SHA1算法對上一步生成的待簽名字符串進(jìn)行簽名計(jì)算，并以Base64編碼規(guī)則將計(jì)算結(jié)果編碼成字符串，即得到最終的簽名值（signature）。

String signature = Base64(HMAC_SHA1(SigningKey, stringToSign))
重要

計(jì)算簽名時使用的SigningKey值就是您的AccessKey Secret。更多信息，請參見創(chuàng)建AccessKey。

步驟五：將簽名添加到請求中

計(jì)算出簽名結(jié)果 signature后，按照以下規(guī)則拼接字符串，并將結(jié)果作為 Authorization 請求頭的值。

String Authorization = "acs " + AccessKeyId + ":" + signature

簽名示例

本示例以調(diào)用 容器服務(wù)Kubernetes版（CS） CreateTrigger為應(yīng)用創(chuàng)建觸發(fā)器為例。假設(shè)您獲得了AccessKeyID 為 testid， AccessKeySecret 為 testsecret，x-acs-signature-nonce 為 15215528852396，Date 為 Tue 9 Apr 2022 07:35:29 GMT。簽名流程如下：

  1. 構(gòu)造規(guī)范化請求頭。

x-acs-signature-method:HMAC-SHA1
x-acs-signature-nonce:15215528852396
x-acs-signature-version:1.0
x-acs-version:2015-12-15

  1. 構(gòu)造規(guī)范化資源。

/clusters/test_cluster_id/triggers

  1. 構(gòu)造待簽名字符串。

POST
application/json
Gtl/0jNYHf8t9Lq8Xlpaqw==
application/json
Tue 9 Apr 2022 07:35:29 GMT
x-acs-signature-method:HMAC-SHA1
x-acs-signature-nonce:15215528852396
x-acs-signature-version:1.0
x-acs-version:2015-12-15
/clusters/test_cluster_id/triggers

  1. 計(jì)算簽名。

acs testid:D9uFJAJgLL+dryjBfQK+YeqGtoY=

  1. 將簽名添加到請求中。

POST /clusters/test_cluster_id/triggers HTTP/1.1
 /* headers */
{
    "accept": "application/json",
    "date": "Tue 9 Apr 2022 07:35:29 GMT",
    "host": "cs.cn-hangzhou.aliyuncs.com",
    "x-acs-signature-nonce": "15215528852396",
    "x-acs-signature-method": "HMAC-SHA1",
    "x-acs-signature-version": "1.0",
    "x-acs-version": "2015-12-15",
    "content-type": "application/json",
    "content-md5": "Gtl/0jNYHf8t9Lq8Xlpaqw==",
    "authorization": "acs testid:D9uFJAJgLL+dryjBfQK+YeqGtoY="
}
/* body */
{
    "project_id": "default/nginx-test",
    "cluster_id": "test_cluster_id",
    "action": "redeploy",
    "type": "deployment"
}

相關(guān)文檔

區(qū)分ROA風(fēng)格和RPC風(fēng)格