すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:WriteGetObjectResponse

最終更新日:Feb 22, 2024

GetObjectリクエストの戻りデータと応答ヘッダーを指定します。

前提条件

oss:WriteGetObjectResponse権限は、Function Computeコンソールで作成したサービスのデフォルトロール (AliyunFCDefaultRole) に付与されます。 サンプル権限ポリシー:

{
  "Statement": [
    {
      "Action": "oss:WriteGetObjectResponse" 、
      "Effect": "Allow",
      "Resource": "*"
    }
  ],
  "バージョン": "1"
} 

詳細については、「RAMロールへの権限の付与」をご参照ください。

リクエストヘッダー

POST /?x-oss-write-get-object-response HTTP/1.1
ホスト: RouteFromFcEvent
日付: GMT日付
権限付与: SignatureValue
x-oss-request-route: RouteFromFcEvent
x-oss-request-token: TokenFromFcEvent
x-oss-fwd-status: StatusCode
x-oss-fwd-header-Accept-Ranges: AcceptRanges
x-oss-fwd-header-Cache-Control: CacheControl
x-oss-fwd-header-Content-Disposition: ContentDisposition
x-oss-fwd-header-Content-Encoding: ContentEncoding
x-oss-fwd-header-Content-Language: ContentLanguage
Content-Length: ContentLength
x-oss-fwd-header-Content-Range: ContentRange
x-oss-fwd-header-Content-Type: ContentType
x-oss-fwd-header-ETag: ETag
x-oss-fwd-header-Expires: Expires
x-oss-fwd-header-Last-Modified: LastModified 

リクエストヘッダー

ヘッダー

データ型

必須

説明

ホスト

String

必須

**** -opap.oss-cn-qingdao-internal.oss-object-process.aliyuncs.com

Function Computeのeventパラメーターから取得したルーター転送アドレス。

日付

String

必須

火曜日、10月31日2023 03:17:58 GMT

リクエストが開始された時刻。 時刻はHTTP 1.1で指定されたGMTです。

承認

String

必須

OSS lkojgn8y1exic6e:6 **** + BuuEqzI1tAMW0wgIyl ****

リクエストの有効性を検証するために使用される認証情報。 承認ヘッダーの計算方法の詳細については、「承認ヘッダーに署名を含める」をご参照ください。

x-oss-request-route

String

必須

**** -opap.oss-cn-qingdao-internal.oss-object-process.aliyuncs.com

Function Computeのeventパラメーターから取得したルーター転送アドレス。

x-oss-request-token

String

必須

OSSV1#ZvBDC3XPm3g ****

Function Computeのイベントパラメーターから取得した一意の転送トークン。

x-oss-fwd-status

String

必須

200

バックエンドサーバーから返されるHTTPステータスコード。

有効な値: 200、206、301、302、303、304、400、401、403、404、405、409、411、412、416、500、503

x-oss-fwd-header-Accept-Ranges

String

任意

バイト

バックエンドサーバーによって返されるHTTP応答ヘッダー。 クエリするリソースのスコープを指定するために使用されます。

x-oss-fwd-header-Cache-Control

String

任意

no-cache

バックエンドサーバーによって返されるHTTP応答ヘッダー。 クライアントが使用するリソースキャッシュ方法を指定するために使用されます。 有効な値:

  • no-cache: キャッシュされたオブジェクトにアクセスするたびに、サーバーはオブジェクトが更新されているかどうかを確認します。 オブジェクトが更新されると、キャッシュは期限切れになります。 オブジェクトはサーバーから再度ダウンロードする必要があります。 オブジェクトが更新されていない場合、キャッシュは期限切れにならず、キャッシュされたオブジェクトを直接使用できます。

  • no-store: オブジェクトのすべてのコンテンツはキャッシュされません。

  • public: オブジェクトのすべてのコンテンツがキャッシュされます。

  • private: オブジェクトのすべてのコンテンツはクライアントにのみキャッシュされます。

  • max-age=<seconds>: キャッシュされたコンテンツの有効期間。 単位は秒です。 このオプションは、HTTP 1.1でのみ使用できます。

x-oss-fwd-header-Content-Disposition

String

任意

添付ファイル

バックエンドサーバーによって返されるHTTP応答ヘッダー。 これは、ダウンロードするオブジェクトの名前と、オブジェクトをダウンロードするかどうかとダウンロード方法を指定するために使用されます。 有効な値:

  • Content-Disposition:inline: オブジェクトがプレビューされます。

  • Content-Disposition:attachment: オブジェクトは、元のオブジェクト名でブラウザの指定されたパスにダウンロードされます。

  • Content-Disposition:attachment; filename="yourFileName": オブジェクトは、カスタム名でブラウザの指定されたパスにダウンロードされます。

    yourFileNameは、ダウンロードしたオブジェクトのカスタム名 (example.jpgなど) を指定します。

x-oss-fwd-header-Content-Encoding

String

任意

gzip

バックエンドサーバーによって返されるHTTP応答ヘッダー。 ダウンロードされたオブジェクトの圧縮およびエンコード方法を指定するために使用されます。 有効な値:

  • identity (デフォルト): OSSはオブジェクトを圧縮またはエンコードしません。

  • gzip: OSSは、LempelとZivが1977で作成したLZ77圧縮アルゴリズムと32ビットの巡回冗長検査 (CRC) を使用してオブジェクトをエンコードします。

  • compress: OSSはLempel-Ziv-Welch (LZW) 圧縮アルゴリズムを使用してオブジェクトをエンコードします。

  • deflate: OSSは、zlibライブラリとdeflateアルゴリズムを使用してオブジェクトをエンコードします。

  • br: OSSはBrotliアルゴリズムを使用してオブジェクトをエンコードします。

x-oss-fwd-header-Content-Language

String

任意

en

バックエンドサーバーによって返されるHTTP応答ヘッダー。 ダウンロードしたオブジェクトの言語を指定するために使用されます。

Content-Length

String

必須

67589

バックエンドサーバーによって返されるHTTP応答ヘッダー。 HTTPメッセージ本文のサイズを指定するために使用されます。 単位:バイト

x-oss-fwd-header-Content-Range

String

任意

バイト0-9/67589

バックエンドサーバーによって返されるHTTP応答ヘッダー。 クエリするオブジェクトの範囲を指定するために使用されます。 たとえば、Content-Rangeヘッダーが0〜9/67589バイトに設定されている場合、オブジェクト全体のサイズが67589され、最初の10バイト (0〜9) のコンテンツが返されます。

x-oss-fwd-header-Content-Type

String

任意

text/html; charset=utf-8

バックエンドサーバーによって返されるHTTP応答ヘッダー。 受信または送信されたデータのタイプを指定するために使用されます。

x-oss-fwd-header-ETag

String

任意

D41D8CD98F00B204E9800998ECF8 ****

バックエンドサーバーによって返されるHTTP応答ヘッダー。 オブジェクトを一意に識別します。

x-oss-fwd-header-Expires

String

任意

11月10日金曜日2023 03:17:58 GMT

バックエンドサーバーによって返されるHTTP応答ヘッダー。 キャッシュの絶対有効期限を指定します。

x-oss-fwd-header-Last-Modified

String

任意

火曜日、10月10日2023 03:17:58 GMT

バックエンドサーバーによって返されるHTTP応答ヘッダー。 要求されたリソースが最後に変更された時刻を指定します。

レスポンスヘッダー

WriteGetObjectResponse要求に対する応答は、共通の応答ヘッダのみを含む。 詳細については、「共通HTTPヘッダー」をご参照ください。

  • リクエストの例

    POST /?x-oss-write-get-object-response HTTP/1.1
    ホスト: RouteFromFcEvent
    日付: 火、10月31日2023 03:17:58 GMT
    権限付与: SignatureValue
    x-oss-request-route: RouteFromFcEvent
    x-oss-request-token: TokenFromFcEvent
    x-oss-fwd-status: 200
    x-oss-fwd-header-Accept-Ranges: bytes
    x-oss-fwd-header-Cache-Control: no-cache
    x-oss-fwd-header-Content-Disposition: attachment
    x-oss-fwd-header-Content-Encoding: gzip
    x-oss-fwd-header-Content-Language: en
    コンテンツ-長さ: 67589
    x-oss-fwd-header-Content-Range: バイト0-9/67589
    x-oss-fwd-header-Content-Type: text/html; charset=utf-8
    x-oss-fwd-header-ETag: D41D8CD98F00B204E9800998ECF8 ****
    x-oss-fwd-header-期限切れ: 金曜日、11月10日2023 03:17:58 GMT
    x-oss-fwd-header-Last-Modified: 火曜日、10月10日2023 03:17:58 GMT 
  • レスポンスの例

    HTTP/1.1 200 OK
    x-oss-request-id: 6540CF0DCB24453133A ****
    日付: 火、10月31日2023 03:17:58 GMT
    コンテンツ長: 0