全部产品
Search
文档中心

Object Storage Service:WriteGetObjectResponse

更新时间:Jul 02, 2025

Menentukan data pengembalian dan header respons untuk permintaan GetObject.

Prasyarat

Izin oss:WriteGetObjectResponse diberikan kepada peran default (AliyunFCDefaultRole) dari layanan yang Anda buat di konsol Function Compute. Contoh kebijakan izin:

{
  "Statement": [
    {
      "Action": "oss:WriteGetObjectResponse",
      "Effect": "Allow",
      "Resource": "*"
    }
  ],
  "Version": "1"
}

Untuk informasi lebih lanjut, lihat Memberikan izin kepada Peran RAM.

Header permintaan

POST /?x-oss-write-get-object-response HTTP/1.1
Host: RouteFromFcEvent
Date: GMT Date
Authorization: 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

Header permintaan

Header

Tipe

Diperlukan

Contoh

Deskripsi

Host

String

Ya

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

Alamat penerusan router yang diperoleh dari parameter event Function Compute.

Date

String

Ya

Tue, 31 Oct 2023 03:17:58 GMT

Waktu saat permintaan dimulai. Waktu dalam GMT sesuai dengan spesifikasi HTTP 1.1.

Authorization

String

Ya

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

Informasi otentikasi yang digunakan untuk memverifikasi validitas permintaan. Untuk informasi lebih lanjut tentang cara menghitung header Authorization, lihat Sertakan tanda tangan di header Authorization.

x-oss-request-route

String

Ya

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

Alamat penerusan router yang diperoleh dari parameter event Function Compute.

x-oss-request-token

String

Ya

OSSV1#ZvBDC3XPm3g****

Token penerusan unik yang diperoleh dari parameter event Function Compute.

x-oss-fwd-status

String

Ya

200

Kode status HTTP yang dikembalikan oleh server backend.

Nilai valid: 200, 206, 301, 302, 303, 304, 400, 401, 403, 404, 405, 409, 411, 412, 416, 500, dan 503.

x-oss-fwd-header-Accept-Ranges

String

Tidak

bytes

Header respons HTTP yang dikembalikan oleh server backend. Digunakan untuk menentukan ruang lingkup sumber daya yang ingin Anda periksa.

x-oss-fwd-header-Cache-Control

String

Tidak

no-cache

Header respons HTTP yang dikembalikan oleh server backend. Digunakan untuk menentukan metode caching sumber daya yang digunakan oleh klien. Nilai valid:

  • no-cache: Setiap kali Anda mengakses objek yang di-cache, server memeriksa apakah objek tersebut diperbarui. Jika objek diperbarui, cache kedaluwarsa. Objek harus diunduh lagi dari server. Jika objek tidak diperbarui, cache tidak kedaluwarsa, dan Anda dapat langsung menggunakan objek yang di-cache.

  • no-store: Semua konten objek tidak di-cache.

  • public: Semua konten objek di-cache.

  • private: Semua konten objek hanya di-cache di klien.

  • max-age=<seconds>: periode validitas konten yang di-cache. Unit: detik. Opsi ini hanya tersedia di HTTP 1.1.

x-oss-fwd-header-Content-Disposition

String

Tidak

attachment

Header respons HTTP yang dikembalikan oleh server backend. Digunakan untuk menentukan nama objek yang akan diunduh dan apakah serta bagaimana objek tersebut diunduh. Nilai valid:

  • Content-Disposition:inline: Objek ditampilkan sebagai pratinjau.

  • Content-Disposition:attachment: Objek diunduh ke jalur yang ditentukan di browser dengan nama objek asli.

  • Content-Disposition:attachment; filename="yourFileName": Objek diunduh ke jalur yang ditentukan di browser dengan nama kustom.

    yourFileName menentukan nama kustom dari objek yang diunduh, seperti example.jpg.

x-oss-fwd-header-Content-Encoding

String

Tidak

gzip

Header respons HTTP yang dikembalikan oleh server backend. Digunakan untuk menentukan metode kompresi dan penyandian objek yang diunduh. Nilai valid:

  • identity (default): OSS tidak mengompres atau menyandikan objek.

  • gzip: OSS menggunakan algoritma kompresi LZ77 yang dibuat oleh Lempel dan Ziv pada tahun 1977 dan cyclic redundancy check (CRC) 32-bit untuk menyandikan objek.

  • compress: OSS menggunakan algoritma kompresi Lempel–Ziv–Welch (LZW) untuk menyandikan objek.

  • deflate: OSS menggunakan pustaka zlib dan algoritma deflate untuk menyandikan objek.

  • br: OSS menggunakan algoritma Brotli untuk menyandikan objek.

x-oss-fwd-header-Content-Language

String

Tidak

en

Header respons HTTP yang dikembalikan oleh server backend. Digunakan untuk menentukan bahasa objek yang diunduh.

Content-Length

String

Ya

67.589

Header respons HTTP yang dikembalikan oleh server backend. Digunakan untuk menentukan ukuran tubuh pesan HTTP. Unit: byte.

x-oss-fwd-header-Content-Range

String

Tidak

bytes 0-9/67589

Header respons HTTP yang dikembalikan oleh server backend. Digunakan untuk menentukan rentang objek yang ingin Anda periksa. Misalnya, jika header Content-Range disetel ke bytes 0-9/67589, ukuran seluruh objek adalah 67589 dan isi 10 byte pertama (0 hingga 9) dikembalikan.

x-oss-fwd-header-Content-Type

String

Tidak

text/html; charset=utf-8

Header respons HTTP yang dikembalikan oleh server backend. Digunakan untuk menentukan jenis data yang diterima atau dikirim.

x-oss-fwd-header-ETag

String

Tidak

D41D8CD98F00B204E9800998ECF8****

Header respons HTTP yang dikembalikan oleh server backend. Ini secara unik mengidentifikasi objek.

x-oss-fwd-header-Expires

String

Tidak

Fri, 10 Nov 2023 03:17:58 GMT

Header respons HTTP yang dikembalikan oleh server backend. Menentukan waktu kedaluwarsa absolut cache.

x-oss-fwd-header-Last-Modified

String

Tidak

Tue, 10 Oct 2023 03:17:58 GMT

Header respons HTTP yang dikembalikan oleh server backend. Menentukan waktu terakhir sumber daya yang diminta dimodifikasi.

Header respons

Respons terhadap permintaan WriteGetObjectResponse hanya mencakup header respons umum. Untuk informasi lebih lanjut, lihat Header HTTP Umum.

Contoh

  • Contoh Permintaan

    POST /?x-oss-write-get-object-response HTTP/1.1
    Host: RouteFromFcEvent
    Date: Tue, 31 Oct 2023 03:17:58 GMT
    Authorization: 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
    Content-Length: 67589
    x-oss-fwd-header-Content-Range: bytes 0-9/67589
    x-oss-fwd-header-Content-Type: text/html; charset=utf-8
    x-oss-fwd-header-ETag: D41D8CD98F00B204E9800998ECF8****
    x-oss-fwd-header-Expires: Fri, 10 Nov 2023 03:17:58 GMT
    x-oss-fwd-header-Last-Modified: Tue, 10 Oct 2023 03:17:58 GMT
  • Contoh Respons

    HTTP/1.1 200 OK
    x-oss-request-id: 6540CF0DCB24453133A****
    Date: Tue, 31 Oct 2023 03:17:58 GMT
    Content-Length: 0