RDB:共通リクエスト・レスポンス
処理概要
RDB APIの日付型要素のタイムゾーンはUTCです。
RDB APIを使用する際の共通リクエストパラメーター、レスポンスを説明します。
リクエストパラメーター
要素名 | 説明 | 形式 | シグネチャーバージョンごとの必須対応 | ||
---|---|---|---|---|---|
2 | 4(ヘッダー) | 4(パラメーター) | |||
Action | アクション名 | パラメーター | ○ | ||
NiftyAccessKeyId/AWSAccessKeyId/AccessKeyId | アクセスキーID(どれか1つ必須) | パラメーター | ○ | ||
Expires | AWSのリクエスト期限パラメーター | パラメーター | |||
Signature※1 | シグネチャー | パラメーター | ○ | ||
SignatureMethod |
シグネチャーメソッド 指定可能な値 : HmacSHA1 | HmacSHA256 |
パラメーター | ○ | ||
SignatureVersion |
認証バージョン 指定可能な値 : 2 |
パラメーター | ○ | ||
Timestamp |
APIへのリクエスト日時 形式 : YYYY-MM-DDThh:mm:ssZ |
パラメーター | |||
Date※2 | リクエスト日時、シグネチャー算出に使用 | ヘッダー | |||
X-Nifty-Date | X-Amz-Date※3 | リクエスト日時、シグネチャー算出に使用 | ヘッダー | |||
X-Nifty-Authorization | X-Amzn-Authorization | 算出されたシグネチャーから生成した認証文字列 | ヘッダー | |||
X-Nifty-Nonce | X-Amz-Nonce | ユーザー任意の文字列、シグネチャー算出に使用 | ヘッダー | |||
X-Nifty-Date | X-Amz-Date | リクエスト日時、シグネチャー算出に使用 |
ヘッダー パラメーター |
○ | ○ | |
Authorization | 算出されたシグネチャーから生成した認証文字列 | ヘッダー | ○ | ||
X-Nifty-Algorithm | X-Amz-Algorithm |
シグネチャーの暗号方式 指定可能な値 : AWS4-HMAC-SHA256 | NIFTY4-HMAC-SHA256 |
パラメーター | ○ | ||
X-Nifty-Credential | X-Amz-Credential | アクセスキーID/日付/リージョン名/サービス名/固定文字の順 | パラメーター | ○ | ||
X-Nifty-Signature | X-Amz-Signature | リクエスト時の認証用文字列 | パラメーター | ○ | ||
X-Nifty-SignedHeaders | X-Amz-SignedHeaders | 認証用文字列作成時に利用されたヘッダー名のリスト(;区切り) | パラメーター | ○ |
- ※注1シグネチャーの生成については「API:シグネチャー」をご参照ください。
- ※注2「X-Nifty-Date」または「X-Amz-Date」と Dateヘッダーが指定された場合、Dateヘッダーが無視されます。
- ※注3「X-Nifty-xxx」系、「X-Amz-xxx」系はどちらかに統一して指定する必要があります。
レスポンス
要素名 | 説明 | 値 | 備考 |
---|---|---|---|
ResponseMetadata | 共通メタ情報ルート | − | |
RequestId | リクエストID | − |