Simple Message Queue (formerly MNS):リクエストプロトコル

パラメーター

必須

説明

Authorization

はい

認証文字列です。詳細については、「リクエスト署名方法」をご参照ください。

Content-Length

はい

HTTP リクエストボディの長さです。

Content-Type

はい

リクエストコンテンツの MIME タイプです。現在、テキスト形式および XML 形式のみサポートされています。

Content-MD5

いいえ

HTTP リクエストボディの MD5 ハッシュです。詳細については、「The Content-MD5 Header Field」をご参照ください。

Date

はい

リクエスト作成時刻です。時刻は GMT 形式である必要があります。リクエスト時刻と SMQ サーバー時刻の差が 15 分を超える場合、そのリクエストは無効とみなされます。

Host

HTTP/1.1 の場合は必須です。HTTP/1.0 の場合は任意です。

リクエストエンドポイントです。形式は $AccountId.mns.cn-hangzhou.aliyuncs.com です。アカウント ID は Alibaba Cloud ウェブサイトから取得してください。ご利用のリージョンに対応する SMQ エンドポイントは、API ドキュメントで確認してください。

x-mns-version

はい

使用する SMQ API のバージョンです。現在のバージョンは 2015-06-06 です。

x-mns-date

いいえ

Date ヘッダーの代替です。クライアントまたはブラウザ環境により標準の Date ヘッダーを設定できない場合に、このヘッダーを使用してください。

パラメーター

説明

Content-Length

HTTP レスポンスボディの長さです。

Connection

HTTP 接続のステータスです。

Date

応答が生成された時刻（GMT 形式）です。

Server

リクエストを処理した SMQ サーバーの名前です。

x-mns-request-id

リクエストの一意な ID です。

x-mns-version

SMQ API のバージョンです。現在のバージョンは 2015-06-06 です。

パラメーター

説明

HttpMethod

大文字の HTTP リクエストメソッドです。例：PUT、GET、POST、DELETE。

Content-Md5

リクエストボディの MD5 ハッシュです。これはオプションです。リクエストに Content-MD5 ヘッダーが含まれていない場合は、ここに空文字列を使用します。

CONTENT-TYPE

リクエストボディのコンテンツタイプです。リクエストに Content-Type ヘッダーが含まれていない場合は、ここに空文字列を使用します。

DATE

リクエストの日時です。

• 形式は次のとおりです：Thu, 07 Mar 2012 18:49:58 GMT。x-mns-date を使用して DATE を置き換える場合、DATE は空にできず、x-mns-date の値に設定する必要があります。

• このフィールドは空にできません。GMT 形式のみサポートされています。

• リクエスト時刻と Simple Message Queue (SMQ, formerly MNS) サーバー時刻の差が 15 分を超える場合、サービス はそのリクエストを無効とみなし、400 エラーコードを返します。詳細については、「エラーコード」をご参照ください。

CanonicalizedMNSHeaders

x-mns- プレフィックスで始まるすべての HTTP ヘッダーを連結したものです。これらのヘッダーは以下のように処理する必要があります。

• ヘッダーキーを小文字に変換します。

• キーでアルファベット順にソートします。

• 以下の擬似コードに示すようにヘッダーを連結します。

  // 元のリクエストヘッダー
  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 です。

パラメーター

説明

Base64

Base64 エンコーディング方式です。

HMAC-SHA1

署名アルゴリズムです。SMQ は RFC 2104 で定義されている HMAC-SHA1 方式を使用します。

AccessKey Secret

ご利用の AccessKey Secret です。これは署名で使用される AccessKey ID に対応します。

UTF-8-Encoding-Of

UTF-8 エンコード形式です。

StringToSign

ステップ 1：署名対象文字列の作成 で作成された署名対象文字列です。