Object Storage Service:ヘッダーに V4 署名を含める (推奨)

パラメーター

説明

HTTP Verb

PUT、GET、POST、HEAD、DELETE、OPTIONS などの HTTP リクエストメソッドです。

Canonical URI

URI エンコード済みのリソースパスです。リソースパスにはクエリ文字列は含まれません。フォワードスラッシュ（/）をエンコードしないでください。

• リクエスト対象が OSS サービスの場合、リソースパスは / であり、URI エンコード済みリソースパスは UriEncode("/") です。

• リクエストのターゲットがバケットの場合、リソースパスは /examplebucket/ となり、URI エンコードされたリソースパスは UriEncode("/examplebucket/") です。

• リクエスト対象がバケット内のオブジェクトの場合、リソースパスは /examplebucket/exampleobject であり、URI エンコード済みリソースパスは UriEncode("/examplebucket/exampleobject") です。

Canonical Query String

URI エンコードされたクエリパラメーターで、辞書順にソートされます。

• クエリパラメーターに名前と値の両方が含まれる場合、各パラメーターの名前と値をそれぞれ URI エンコードします。次に、エンコード済みの名前でパラメーターを辞書式にソートします。ソートはエンコード後に実行されることに注意してください。エンコード済みの名前と値を接続するには、= を使用します。異なるパラメーターを連結するには、& を使用します。

  • クエリパラメーター: prefix=somePrefix&marker=someMarker&max-keys=20

  • 正規クエリパラメーター:

    UriEncode("marker")+"="+UriEncode("someMarker")+"&"+UriEncode("max-keys")+"="+UriEncode("20")+"&"+UriEncode("prefix")+"="+UriEncode("somePrefix")

• クエリパラメーターに名前のみが含まれる場合、パラメーター名を URI エンコードします。

  • クエリパラメーター: ?acl

  • 正規クエリパラメーター: UriEncode("acl")

• クエリパラメーターが存在しない場合（リクエストURIに?が含まれていない場合）、正規化されたクエリ文字列をEmpty 文字列（""）に設定します。

Canonical Headers

リクエストヘッダーのリストです。

リクエストヘッダーは次の 3 つのカテゴリに分類されます。

• リクエストに存在し、署名計算に参加する必要があるヘッダー:

  • x-oss-content-sha256: 現在、UNSIGNED-PAYLOAD のみがサポートされています。

• リクエストに存在する場合に署名計算に参加するヘッダー:

  • Content-Type

  • Content-MD5

  • x-oss-*: x-oss- で始まるその他のリクエストヘッダーです。たとえば、STS AccessKey を使用してアクセスする場合、SecurityToken は x-oss-security-token:security-token を使用して指定します。また、リクエスト時刻は x-oss-date を使用して指定し、そのフォーマットは ISO 8601 標準時刻フォーマットに準拠している必要があります（例: 20231203T121212Z）。

• AdditionalHeaders で指定されたオプションのリクエストヘッダー。

形式は次のとおりです。

Lowercase(<HeaderName1>) + ":" + Trim(<value>) + "\n"
Lowercase(<HeaderName2>) + ":" + Trim(<value>) + "\n"
...
Lowercase(<HeaderNameN>) + ":" + Trim(<value>) + "\n"

例:

content-disposition:attachment
content-length:3
content-md5:ICy5YqxZB1uWSwcVLSNLcA==
content-type:text/plain
x-oss-content-sha256:UNSIGNED-PAYLOAD
x-oss-date:20250328T101048Z

Additional Headers

署名計算用のオプションのリクエストヘッダーを指定します (必須ヘッダーは指定しないでください)。小文字のヘッダー名のみを含め、辞書順にソートし、セミコロン (;) で区切ります。これは AdditionalHeaders と一致している必要があります。

例:

content-disposition;content-length

Hashed PayLoad

リクエストペイロードの SHA256 ハッシュ値の 16 進数表現です。現在、UNSIGNED-PAYLOAD のみがサポートされています。

パラメーター

説明

OSS4-HMAC-SHA256

署名ハッシュアルゴリズムです。その値は OSS4-HMAC-SHA256 である必要があります。

TimeStamp

現在の UTC 時刻です。その形式は 20250320T083322Z のような ISO8601 である必要があります。

Scope

キーを派生させるためのパラメーターセットです。このセットは、日付、リージョン、およびサービスを指定します。したがって、派生キーで計算された署名は、指定された日付、リージョン、およびサービスに対してのみ有効です。

形式は次のとおりです。

<SignDate>/<SignRegion>/oss/aliyun_v4_request

説明は次のとおりです。

• SignDate: 署名に参加する日付です。YYYYMMDD 形式です。

• SignRegion: 署名に使用される リージョン ID。例: cn-hangzhou。

• oss: 署名に参加するサービス名です。oss に固定されています。

• aliyun_v4_request: 署名に参加するバージョンです。aliyun_v4_request に固定されています。

CanonicalRequest

構築された正規リクエストです。

パラメーター

値

AccessKeyId

LTAI****************

AccessKeySecret

yourAccessKeySecret

Timestamp

20250411T064124Z

Bucket

examplebucket

Object

exampleobject

Region

中国 (杭州)