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

AI 助理
備案控制臺
文檔
輸入文檔關鍵字查找
首頁 輕量消息隊列（原 MNS） 開發參考 客戶端SDK API定義和說明 請求協議說明

請求協議說明

更新時間：
產品詳情
我的收藏

本文介紹使用輕量消息隊列（原 MNS）發送HTTP請求調用API時的請求結構、公共參數、返回結果及簽名認證方式。

請求結構

服務地址

輕量消息隊列（原 MNS）支持多個地域，每個地域分別提供了公網訪問地址、內網訪問地址。更多信息，請參見功能開服和接入點。

請求方法

輕量消息隊列（原 MNS）支持通過HTTP協議進行請求通信。使用HTTP的PUT、POST、GET、DELETE等HTTP Method發送不同的請求。

發送的請求需要帶上正確的請求參數、請求頭和請求正文，請求及返回結果都使用UTF-8字符集進行編碼。

公共參數

公共請求參數（Header）

參數

是否必選

說明

Authorization

是

驗證字符串。更多信息，請參見請求簽名機制。

Content-Length

是

HTTP消息體的長度。

Content-Type

是

請求內容的MIME類型，目前請求僅支持text或xml格式。

Content-MD5

否

HTTP消息體的MD5值。更多信息，請參見The Content-MD5 Header Field。

Date

是

請求的構造時間。目前只支持GMT格式，如果和SMQ的服務器時間前后差異超過15分鐘將返回本次請求非法。

Host

針對HTTP/1.1為必選，針對HTTP/1.0為可選。

從阿里云官網獲取AccountId，從API文檔中獲取各地域SMQ訪問地址，格式如下：$AccountId.mns.cn-hangzhou.aliyuncs.com。

x-mns-version

是

調用SMQ接口的版本號。當前版本為2015-06-06。

x-mns-date

否

Date替代字段。用于解決部分瀏覽器上用戶程序無法設置HTTP請求Date字段的場景。

公共返回參數

參數

說明

Content-Length

HTTP消息體返回的長度。

Connection

HTTP連接狀態。

Date

響應的返回時間，目前只支持GMT格式。

Server

請求響應的SMQ服務器名。

x-mns-request-id

此次Request操作的編號。

x-mns-version

SMQ接口的版本編號，當前版本是2015-06-06。

返回結果

調用API服務后返回數據采用統一格式。返回的HTTP狀態碼為2xx，說明調用成功；返回的HTTP狀態碼為4xx或5xx，說明調用失敗。調用成功返回的數據格式為XML格式。

XML返回結果包括請求是否成功信息和具體的業務數據。示例如下：

    <?xml version="1.0" encoding="utf-8"?> 
    <!--結果的根結點--> 
    <根節點 xmlns="http://mns.aliyuncs.com/doc/v1/">
    <!--返回的子節點-->
    </根節點>

調用接口出錯后，將不會返回結果數據，HTTP請求返回一個4xx或5xx的HTTP狀態碼。返回的消息體中是具體的錯誤代碼及錯誤信息。另外還包含一個全局唯一的請求ID：RequestId和一個您本次請求訪問的站點ID：HostId。

具體的錯誤信息。請參見錯誤碼。

請求簽名機制

簽名機制介紹

輕量消息隊列（原 MNS）服務會對每個訪問的請求進行驗證，每個請求向輕量消息隊列（原 MNS）提交時，都需要在該請求的Header中包含簽名。輕量消息隊列（原 MNS） SDK已實現自動完成簽名，建議您采用SDK的方式發起請求，即可免去手動簽名的過程。

簽名過程可分為如下步驟：

步驟一：構造待簽名字符串（StringToSign）

按照以下偽代碼構造待簽名的字符串（StringToSign）

StringToSign = HttpMethod + "\n" 
         + CONTENT-MD5 + "\n"     
         + CONTENT-TYPE + "\n" 
         + DATE + "\n" 
         + CanonicalizedMNSHeaders
         + CanonicalizedResource;

參數

描述

HttpMethod

大寫的HTTP方法。例如：PUT、GET、POST、DELETE。

Content-Md5

請求內容數據的MD5值，若無則為空。

CONTENT-TYPE

請求內容的類型，若無則為空。

DATE

本次操作的時間。

  • 格式為：Thu, 07 Mar 2012 18:49:58 GMT。如果用x-mns-date替代DATE，則DATE不能填空，需用x-mns-date的值替換。

  • 此參數不能為空，目前只支持GMT格式。

  • 如果請求時間和輕量消息隊列（原 MNS）服務器時間相差超過15分鐘，輕量消息隊列（原 MNS）會判定此請求不合法，返回錯誤碼400。更多錯誤信息及錯誤碼，請參見錯誤碼。

CanonicalizedMNSHeaders

HTTP中的x-mns-開頭的字段組合。該字段在簽名驗證前需要符合以下規范：

  • Header的key需要變成小寫（toLowerCase）。

  • Header自小到大排序。

  • 拼接偽代碼。

    // 原始請求Header
Map<String, String> httpHeaders = request.getHeaders();
// 排序和小寫
sortHeadersKeyAndToLowerCase(httpHeaders);
// 拼接
Set<String> keySet = httpHeaders.keySet();
for (String key : keySet) {
    if (key.startsWith("x-mns-")) {
        CanonicalizedMNSHeaders.append(key).append(":")
            .append(httpHeaders.get(key)).append("\n");
    }
}

CanonicalizedResource

HTTP所請求資源的URI，是指對應訂閱配置的HTTP接收端地址去除域名端口的部分。例如配置的接收端地址是http://123.123.XX.XX:8080/api/test?code=200，則URI是/api/test?code=200；如果接收端地址是http://www.aliyun.com/mns/help，則URI是/mns/help。

步驟二：計算簽名值（Signature）

Signature = Base64( HMAC-SHA1( ${AccessSecret}, UTF-8-Encoding-Of(${StringToSign})) )

其中，各參數的含義如下：

參數

說明

Base64

Base64編碼。

HMAC-SHA1

簽名的方法采用RFC 2104中定義的HMAC-SHA1方法。

AccessSecret

阿里云用戶AccessKey Secret，和簽名的AccessKey ID對應。

UTF-8-Encoding-Of

指UTF-8 格式。

StringToSign

自定義構建的待簽名字符串，即步驟一：構造待簽名字符串（StringToSign）生成的值。

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

addHeader("Authorization","MNS " +  ${AccessKeyId}+ ":" + ${Signature})

Key為常量的字符串Authorization，Value為基于AccessKeyId和Sigature兩個變量拼接成的字符串，整體格式為MNS ${accessKeyId}:${Signature}。其中Sigature為輕量消息隊列（原 MNS）自定義構建的簽名，即步驟二：計算簽名值（Signature）生成的值。

簽名示例

請求示例如下：

PUT /queues/$queueName?metaOverride=true HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Wed, 08 Mar 2012 12:00:00 GMT
Authorization: MNS 15B4D3461F177624****:xQE0diMbL****f3YB+FIEXAMPLE=

<?xml version="1.0" encoding="UTF-8"  ?>
<Queue xmlns="http://mns.aliyuncs.com/doc/v1/">
<VisibilityTimeout >60</VisibilityTimeout>
<MaximumMessageSize>1024</MaximumMessageSize>
<MessageRetentionPeriod>120</MessageRetentionPeriod>
<DelaySeconds>30</DelaySeconds>
</Queue>

返回示例如下：

示例一

如果傳入的AccessKeyId不存在或disabled，返回403 Forbidden。

Content-Type: text/xml
Content-Length: 314
Date: Wed, 18Mar 2012 08:04:06 GMT
x-mns-request-id: 512B2A634403E52B1956****

<?xml version="1.0" encoding="utf-8"?>
<Error xmlns="http://mns.aliyuncs.com/doc/v1/">
<Code>AccessIDAuthError</Code>
<Message>
    AccessID authentication fail, please check your AccessID and retry.
</Message>
<RequestId>512B2A634403E52B1956****</RequestId>
<HostId>mns.cn-hangzhou.aliyuncs.com</HostId>
</Error>

示例二

如果簽名驗證的時候，Header中沒有傳入Date或者格式不正確，返回403 Forbidden。

Content-Type: text/xml
Content-Length: 274
Date: Wed, 18Mar 2012 08:04:06 GMT
x-mns-request-id: 512B2A634403E52B1956****

<?xml version="1.0" encoding="UTF-8"?>
<Error xmlns="http://mns.aliyuncs.com/doc/v1/">
<Code>InvalidArgument</Code>
<Message>Date Header is invalid or missing.</Message>
<RequestId>7E1A5CF258F535884403****</RequestId>
<HostId>mns.cn-hangzhou.aliyuncs.com</HostId>
</Error>

示例三

傳入請求的時間在輕量消息隊列（原 MNS）服務器當前時間之后的15分鐘以內，否則返回408超時。

Content-Type: text/xml
Content-Length: 283
Date: Wed, 11 May 2011 09:01:51 GMT
x-mns-request-id: 512B2A634403E52B1956****

<?xml version="1.0"  encoding="UTF-8"?>
<Error xmlns="http://mns.aliyuncs.com/doc/v1/">
<Code>TimeExpired</Code>
<Message>
        The http request you sent is expired.
</Message>
<RequestId>512B2A634403E52B1956****</RequestId>
<HostId>mns.cn-hangzhou.aliyuncs.com</HostId>
</Error>