OSS RESTful API では、一連の共通リクエストヘッダーとレスポンスヘッダーを使用します。
共通リクエストヘッダー
次の表では、OSS RESTful API リクエストで使用する共通リクエストヘッダーについて説明します。
|
名前 |
型 |
値の例 |
説明 |
|
Authorization |
文字列 |
OSS4-HMAC-SHA256 Credential=**** |
匿名ではないリクエストを認証します。このヘッダーの計算方法については、「署名バージョン 4 (推奨)」をご参照ください。 デフォルト値:なし |
|
Content-Length |
文字列 |
556 |
RFC 2616 で定義されている HTTP リクエストコンテンツの長さ。 デフォルト値:なし |
|
Content-Type |
文字列 |
application/xml |
RFC 2616 で定義されている HTTP リクエストのコンテンツタイプ。 デフォルト値:なし |
|
Date |
文字列 |
Sun, 05 Sep 2021 23:00:00 GMT |
HTTP 1.1 で指定された GMT 時刻。 デフォルト値:なし |
|
Host |
文字列 |
oss-example.oss-cn-hangzhou.aliyuncs.com |
エンドポイントは デフォルト値:なし |
|
x-oss-security-token |
文字列 |
CAISowJ1q6Ft5B2yfSjIr5feHsPhtYh3+pONd2uCglI3dvxVt7DB1Tz2IHxMdHJsCeAcs/Q0lGFR5/sflqJIRoReREvCUcZr8sy2SqEGos2T1fau5Jko1be0ewHKeQKZsebWZ+LmNpy/Ht6md1HDkAJq3LL+bk/Mdle5MJqP+/kFC9MMRVuAcCZhDtVbLRcYgq18D3bKMuu3ORPHm3fZCFES2jBxkmRi86+ysIP+phPVlw/90fRH5dazcJW0Zsx0OJo6Wcq+3+FqM6DQlTNM6hwNtoUO1fYUommb54nDXwQIvUjfbtC5qIM/cFVLAYEhALNBofTGkvl1h/fejYyfyWwWYbkFCHiPFNr9kJCUSbr4a4sjF6zyPnPWycyCLYXleLzhxPWd/2kagAF6qLNY5paXF18NyRP0PISqxlWBuSQldMS3avlblTFB7apY8CUiAQcSY3uDYUhuxU+KFBxpGaq8c1SU5ARo+1JBA5nXhFlY2nbDnWONxa0mvNvE3XJ0FZJnDS7WBHyOMjC8nmw2GfaQ4bxQ0D2+20yrDNevWSSqnwh0qXMI3zY5**** |
Security Token Service (STS) からの一時的な認証情報を使用して OSS にアクセスする場合にのみ必須です。「AssumeRole - ロールの一時的な認証情報を取得する」をご参照ください。 |
共通レスポンスヘッダー
次の表では、OSS RESTful API が返す共通レスポンスヘッダーについて説明します。
|
名前 |
型 |
値の例 |
説明 |
|
Content-Length |
文字列 |
556 |
RFC 2616 で定義されている HTTP レスポンスコンテンツの長さ。 デフォルト値:なし |
|
Connection |
列挙型 |
keep-alive |
クライアントと OSS 間の接続状態。 有効な値:keep-alive および close デフォルト値:なし |
|
Date |
文字列 |
Sun, 05 Sep 2021 23:00:00 GMT |
HTTP 1.1 で指定された GMT 時刻。 デフォルト値:なし |
|
ETag |
文字列 |
5B3C1A2E053D763E1B002CC607C5A0FE1**** |
オブジェクトコンテンツを識別するエンティティタグ。PutObject で作成されたオブジェクトの場合、ETag はコンテンツの MD5 ハッシュです。他の方法で作成されたオブジェクトの場合、ETag は特定のルールに基づく一意の値であり、MD5 ハッシュではありません。ETag を使用してコンテンツの変更を検出します。 デフォルト値:なし |
|
Server |
文字列 |
AliyunOSS |
レスポンスを生成したサーバー。 デフォルト値:AliyunOSS |
|
x-oss-request-id |
文字列 |
534B371674E88A4D8906**** |
リクエストを一意に識別する UUID。トラブルシューティングのためにこの ID をテクニカルサポートに提供してください。「リクエスト ID の取得」をご参照ください。 デフォルト値:なし |