Panggil PutBucketAccessMonitor untuk mengaktifkan atau menonaktifkan pelacakan akses untuk bucket - Object Storage Service

Mengaktifkan atau menonaktifkan pelacakan akses untuk sebuah bucket. Jika pelacakan akses diaktifkan untuk sebuah bucket, OSS mencatat waktu akses terakhir objek dalam bucket tersebut. Dalam hal ini, Anda dapat mengonfigurasi aturan siklus hidup berdasarkan waktu akses terakhir untuk mengidentifikasi data panas dan dingin sesuai pola akses data, serta memindahkan data dingin ke kelas penyimpanan yang lebih hemat biaya.

Catatan penggunaan

Untuk mengaktifkan atau menonaktifkan pelacakan akses untuk sebuah bucket, Anda harus memiliki izin oss:PutBucketAccessMonitor. Untuk informasi lebih lanjut, lihat Menambahkan Kebijakan Kustom ke Pengguna RAM.

Sintaks permintaan

PUT /?accessmonitor HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<AccessMonitorConfiguration>
  <Status>Enabled</Status>
</AccessMonitorConfiguration>

Header permintaan

Semua header dalam permintaan DescribeRegions adalah header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Elemen permintaan

Elemen

Tipe

Diperlukan

Contoh

Deskripsi

AccessMonitorConfiguration

Container

N/A

Konfigurasi pelacakan akses bucket.

Node anak: Status

Status

String

Enabled

Menentukan apakah akan mengaktifkan pelacakan akses untuk bucket. Nilai valid:

Enabled: mengaktifkan pelacakan akses.
OSS awalnya menggunakan waktu saat pelacakan akses diaktifkan sebagai waktu akses terakhir objek dalam bucket dan memperbarui waktu akses terakhir objek jika objek diakses.
Waktu akses terakhir objek diperbarui secara asinkron. Jika sebuah objek diakses beberapa kali dalam periode 24 jam, hanya operasi akses pertama pada objek dalam periode tersebut yang memperbarui waktu akses terakhir. Anda dapat menentukan aturan siklus hidup berdasarkan waktu akses terakhir untuk bucket.
Disabled: menonaktifkan pelacakan akses.
Pelacakan akses hanya dapat dinonaktifkan jika bucket tidak memiliki aturan siklus hidup yang didasarkan pada waktu akses terakhir.

Node induk: AccessMonitorConfiguration

Header respons

Semua header dalam respons terhadap permintaan DescribeRegions adalah header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Contoh

Permintaan Contoh

PUT /?accessmonitor HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Date: Thu, 17 Apr 2025 13:08:38 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<?xml version="1.0" encoding="UTF-8"?>
<AccessMonitorConfiguration>
  <Status>Enabled</Status>
</AccessMonitorConfiguration>

Respons Contoh

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

Referensi

Untuk informasi lebih lanjut tentang aturan siklus hidup berdasarkan waktu akses terakhir, lihat Aturan Siklus Hidup Berdasarkan Waktu Akses Terakhir.
Setelah pelacakan akses diaktifkan, Anda dapat memanggil operasi PutBucketLifecycle untuk mengonfigurasi aturan siklus hidup berdasarkan waktu akses terakhir. Untuk informasi lebih lanjut, lihat PutBucketLifecycle.

SDK OSS

Anda dapat menggunakan SDK OSS untuk bahasa pemrograman berikut untuk memanggil PutBucketAccessMonitor:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi PutBucketAccessMonitor, lihat put-bucket-access-monitor.

Kode kesalahan

Kode kesalahan	Kode status HTTP	Deskripsi
MalformedXML	400	Konfigurasi pelacakan akses tidak valid.
AccessMonitorDisableNotAllowed	400	Status pelacakan akses tidak dapat disetel ke Disabled karena bucket memiliki aturan siklus hidup berdasarkan waktu akses terakhir.
AccessDenied	403	Anda tidak memiliki otorisasi untuk mengakses bucket.
NoSuchBucket	404	Bucket tidak ada.