All Products
Search

This Product

    Object Storage Service:GetObjectRetention

    Document Center

    Object Storage Service:GetObjectRetention

    Last Updated:Apr 01, 2026

    Panggil GetObjectRetention untuk mengambil kebijakan retensi objek pada versi tertentu, termasuk mode retensinya dan tanggal berakhirnya periode retensi.

    Catatan penggunaan

    • Sebelum memanggil operasi ini, Anda harus mengaktifkan kebijakan retensi tingkat objek (ObjectWorm) untuk bucket dengan memanggil PutBucketObjectWormConfiguration.

    • Untuk memanggil operasi ini, Anda harus memiliki izin oss:GetObjectRetention.

    • Jika tidak ada kebijakan retensi objek yang dikonfigurasi untuk objek tersebut dan tidak ada kebijakan retensi tingkat objek default yang dikonfigurasi untuk bucket, elemen Mode dan RetainUntilDate dalam elemen Retention yang dikembalikan akan kosong.

    Sintaks permintaan

    GET /ObjectName?retention HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

    Parameter permintaan

    Parameter

    Tipe

    Wajib

    Contoh

    Deskripsi

    retention

    N/A

    Ya

    N/A

    Menentukan operasi untuk mengambil kebijakan retensi objek.

    versionId

    string

    Tidak

    CAEQNhiBgMDJgZCA0BYiIDc4MGZj****

    ID versi objek. Jika dihilangkan, operasi akan mengambil kebijakan retensi untuk versi terbaru objek tersebut.

    Elemen respons

    Parameter

    Tipe

    Contoh

    Deskripsi

    Retention

    Kontainer

    N/A

    Kontainer untuk informasi kebijakan retensi objek.

    Node anak: Mode dan RetainUntilDate

    Mode

    string

    COMPLIANCE

    Mode retensi objek. COMPLIANCE menunjukkan mode kepatuhan. Node ini kosong jika tidak ada kebijakan retensi yang dikonfigurasi.

    Node induk: Retention

    RetainUntilDate

    string

    2026-10-11T00:00:00.000Z

    Tanggal hingga retensi berlaku untuk versi objek tersebut. Tanggal menggunakan format ISO 8601. Versi objek tidak dapat dihapus atau ditimpa sebelum tanggal ini. Node ini kosong jika tidak ada kebijakan retensi yang dikonfigurasi.

    Node induk: Retention

    Contoh

    • Contoh permintaan

      GET /exampleobject?retention&versionId=CAEQNhiBgMDJgZCA0BYiIDc4MGZj**** HTTP/1.1
Date: Thu, 17 Mar 2026 11:18:32 GMT
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20260317/cn-hangzhou/oss/aliyun_v4_request,Signature=****

    • Contoh respons

      HTTP/1.1 200 OK
x-oss-request-id: 5374A2880232A65C2300****
Date: Thu, 17 Mar 2026 11:18:32 GMT
Content-Type: application/xml
Transfer-Encoding: chunked
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<Retention>
  <Mode>COMPLIANCE</Mode>
  <RetainUntilDate>2026-10-11T00:00:00.000Z</RetainUntilDate>
</Retention>