すべてのプロダクト
Search

このプロダクト

    Object Storage Service:WriteGetObjectResponse

    ドキュメントセンター

    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