すべての Simple Log Service (SLS) API リクエストは、認証、圧縮、コンテンツネゴシエーション用の共通 HTTP ヘッダーセットをサポートします。
パラメーター
次の表は、SLS RESTful API の共通リクエストヘッダーを示します。
| ヘッダー名 | データ型 | 必須 | 説明 |
| Accept | String | いいえ | 期待されるレスポンスフォーマット。有効な値：application/json、application/x-protobuf。GET リクエストのみに適用されます。使用可能な値は API によって異なります。 |
| Accept-Encoding | String | いいえ | 期待されるレスポンスの圧縮形式。有効な値：lz4、deflate、または空 (圧縮なし)。GET リクエストのみに適用されます。使用可能な値は API によって異なります。 |
| Authorization | String | はい | リクエスト署名に従って計算されたリクエスト署名文字列。 |
| Content-Length | Number | いいえ | HTTP リクエストボディの長さ (RFC 2616)。リクエストにボディがない場合は不要です。 |
| Content-MD5 | String | いいえ | リクエストボディの MD5 ハッシュ (大文字)。リクエストにボディがない場合は不要です。 |
| Content-Type | String | いいえ | HTTP リクエストボディのタイプ (RFC 2616)。サポートされているフォーマットには application/json や application/x-protobuf などがあります。リクエストにボディがない場合は不要です。使用可能な値は API によって異なります。 |
| Date | String | はい | GMT でのリクエストタイムスタンプ、RFC 1123 形式。例：Mon, 3 Jan 2010 08:33:47 GMT。 |
| Host | String | はい | エンドポイントの完全なホスト名。プロトコルプレフィックス ( http:// など) は含みません。例：big-game.cn-hangzhou.sls.aliyuncs.com。 |
| x-log-apiversion | String | はい | API バージョン。現在のバージョンは 0.6.0 です。 |
| x-log-bodyrawsize | Number | いいえ | リクエストボディの生 (圧縮されていない) サイズ (バイト単位)。リクエストにボディがない場合は 0 に設定します。圧縮されたリクエストの場合は、圧縮前のサイズを指定します。有効な範囲：0～3,145,728。ボディが圧縮されている場合のみ必須です。 |
| x-log-compresstype | String | いいえ | リクエストボディの圧縮アルゴリズム。有効な値：lz4、deflate (RFC 1951、RFC 1950 による zlib 形式)。ボディが圧縮されていない場合は、このヘッダーを省略します。 |
| x-log-date | String | いいえ | Date と同じ形式のリクエストタイムスタンプ。指定された場合、サーバー側の時刻検証において Date ヘッダーを上書きしますが、署名計算には使用されません。x-log-date が指定されている場合でも、標準の Date ヘッダーは引き続き必須です。 |
| x-log-signaturemethod | String | はい | 署名アルゴリズム。サポートされている値は hmac-sha1 のみです。 |
| x-acs-security-token | String | いいえ | STS の一時的な認証情報を使用してデータを送信する場合のみ必須です。 |
説明
Dateヘッダーの値は、サーバー時刻から 15 分以内である必要があります。それ以外の場合、リクエストは拒否されます。x-log-dateヘッダーが存在する場合、タイムスキューチェックはDateの代わりにx-log-dateの値を使用します。x-log-compresstypeが設定されている場合、リクエストボディには圧縮されたデータが含まれている必要があります。Content-LengthとContent-MD5は、圧縮されたボディから計算します。- プラットフォームまたは HTTP ライブラリが
Dateヘッダーを自動で設定する場合、x-log-dateを使用して署名計算用の正しいタイムスタンプを指定してください。サーバーは、x-log-dateが存在する場合はそれを基に、それ以外の場合は標準のDateヘッダーを基に署名を検証します。
例
POST / HTTP/1.1
Authorization: LOG <yourAccessKeyId>:<yourSignature>
x-log-bodyrawsize: 80
User-Agent: sls-java-sdk-v-0.6.1
x-log-apiversion: 0.6.0
Host: my-project-test.cn-shanghai.log.aliyuncs.com
x-log-signaturemethod: hmac-sha1
Date: Sun, 27 May 2018 07:43:26 GMT
Content-Type: application/json
Content-MD5: A7967D81EFF5E3CD447FB6D8DF294E20
Content-Length: 80
Connection: Keep-Alive