このトピックでは、一般的なHTTPリクエストヘッダーとレスポンスヘッダーについて説明します。
共通リクエストヘッダー
Object Storage Service (OSS) では、共通のHTTPリクエストヘッダーがRESTful APIに使用されます。 これらのリクエストヘッダーは、すべてのOSSリクエストで使用できます。 次の表に、リクエストヘッダーを示します。
ヘッダー | データ型 | 例 | 説明 |
権限付与 | String | OSS nxj7dtlhcyl5hpvnhi:COS3OQkfQPnKmYZTEHYv2 ****** | 非匿名リクエストの有効性を検証するために使用する認証情報。 承認ヘッダーの計算方法の詳細については、「承認ヘッダーに署名を含める」をご参照ください。 デフォルトでは、このヘッダーは空のままです。 |
コンテンツ長 | String | 556 | RFC 2616で定義されているHTTPリクエストのコンテンツ長。 詳細については、RFC 2616をご参照ください。 デフォルトでは、このヘッダーは空のままです。 |
コンテンツタイプ | String | アプリケーション /xml | RFC 2616で定義されているHTTPリクエストのコンテンツタイプ。 詳細については、RFC 2616をご参照ください。 デフォルトでは、このヘッダーは空のままです。 |
日付 | String | 9月2021日日曜日23:00:00 GMT | リクエストが作成された時刻。 時間は、HTTP 1.1で指定されたGMT時間である必要があります。 デフォルトでは、このヘッダーは空のままです。 |
ホスト | String | oss-example.oss-cn-hangzhou.aliyuncs.com | ドメイン名。 形式は デフォルトでは、このヘッダーは空のままです。 |
x-oss-security-token | String | CAISowJ1q6Ft5B2yfSjIr5feHsPhtYh3 + pONd2uCglI3dvxVt7DB1Tz2IHxMdHJsCeAcs/Q0lGFR5/sflqJIRoReREvCUcZr8sy2SqEGos2T1fau5Jko1be0ewHKeQKZsebWZ + LmNpy/Ht6md1HDkAJq3LL + bk/Mdle5MJqP + kFC9MMRVuAcCZhDtVbLRcYgq18D3bKMuu3ORPHm3fZCFES2jBxkmRi86 + ysIP + phPVlw/90fRH5dazcJW0Zsx0OJo6Wcq + 3 + FqM6DQlTNM6hwNtoUO1fYUommb54nDXwQIvUjfbtC5qIM/cFVLAYEhALNBofTGkvl1h/fejYyfyWwWYbkFCHiPFNr9kJCUSbr4a4sjF6zyPnPWycyCLYXleLzhxPWd/2kagAF6qLNY5paXF18NyRP0PISqxlWBuSQldMS3avlblTFB7apY8CUiAQcSY3uDYUhuxU + KFBxpGaq8c1SU5ARo + 1JBA5nXhFlY2nbDnWONxa0mvNvE3XJ0FZJnDS7WBHyOMjC8nmw2GfaQ4bxQ0D2 **** | このヘッダーは、一時的なアクセス資格情報を使用してOSSリソースにアクセスする場合にのみ必要です。 それ以外の場合は、このヘッダーを空のままにします。 セキュリティトークンの取得方法の詳細については、「AssumeRole」をご参照ください。 |
共通レスポンスヘッダー
OSSでは、一般的なHTTPレスポンスヘッダーがRESTful APIに使用されます。 これらのレスポンスヘッダーは、すべてのOSSリクエストで使用できます。 次の表に、レスポンスヘッダーを示します。
ヘッダー | データ型 | 例 | 説明 |
コンテンツ長 | String | 556 | RFC 2616で定義されているHTTPリクエストのコンテンツ長。 詳細については、RFC 2616をご参照ください。 デフォルトでは、このヘッダーは空のままです。 |
接続 | 列挙 | keep-alive | クライアントとOSSサーバー間の接続ステータス。 有効な値: keep-aliveおよびclose デフォルトでは、このヘッダーは空のままです。 |
日付 | String | 9月2021日日曜日23:00:00 GMT | リクエストが作成された時刻。 時間は、HTTP 1.1で指定されたGMT時間である必要があります。 デフォルトでは、このヘッダーは空のままです。 |
ETag | String | 5B3C1A2E053D763E1B002CC607C5A0FE1 **** | オブジェクトの作成時にオブジェクトのコンテンツを識別するために作成されるエンティティタグ (ETag) 。 PutObjectリクエストを使用してオブジェクトが作成された場合、オブジェクトのETagはオブジェクトコンテンツのMD5ハッシュになります。 オブジェクトが他のメソッドを使用して作成される場合、ETagは特定のアルゴリズムに基づいて生成される一意の値です。 オブジェクトのETagを使用して、オブジェクトの内容が変更されているかどうかを確認できます。 デフォルトでは、このヘッダーは空のままです。 |
サーバー | String | AliyunOSS | 応答を生成するサーバー。 デフォルト値: AliyunOSS |
x-oss-request-id | String | 534B371674E88A4D8906 **** | リクエストを識別するために使用されるUUID。 問題が発生した場合は、テクニカルサポートに連絡してリクエストIDを入力し、問題を特定して解決します。 リクエストIDの取得方法の詳細については、「リクエストIDの取得」をご参照ください。 デフォルトでは、このヘッダーは空のままです。 |