All Products
Search
Document Center

Object Storage Service:cors (cross-origin resource sharing)

Last Updated:Mar 21, 2026

Gunakan perintah cors untuk membuat, memodifikasi, mengkueri, atau menghapus konfigurasi Berbagi Sumber Daya Lintas Asal (CORS) pada sebuah bucket. CORS adalah solusi lintas asal standar yang disediakan oleh HTML5, memungkinkan server aplikasi web mengontrol akses lintas asal dan menjamin keamanan transmisi data antar asal.

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

  • Bucket OSS

  • Izin yang diperlukan untuk operasi yang ingin Anda lakukan. Untuk menyambungkan izin ini ke RAM user, lihat Attach a custom policy to a RAM user.

    OperasiIzin yang diperlukan
    Membuat atau memodifikasi konfigurasi CORSoss:PutBucketCors
    Mengkueri konfigurasi CORSoss:GetBucketCors
    Menghapus konfigurasi CORSoss:DeleteBucketCors
  • ossutil terinstal. Untuk ossutil versi 1.6.16 dan yang lebih baru, gunakan ossutil langsung sebagai nama biner. Untuk versi sebelumnya, sesuaikan nama biner berdasarkan sistem operasi Anda. Untuk detailnya, lihat ossutil command reference.

Untuk informasi latar belakang tentang cara kerja CORS dengan OSS, lihat CORS.

Membuat atau memodifikasi konfigurasi CORS

Menjalankan cors --method put akan membuat konfigurasi CORS baru jika belum ada, atau menimpa konfigurasi yang sudah ada.

Sintaks

ossutil cors --method put oss://<bucketname> <local_xml_file>
ParameterWajibDeskripsi
bucketnameYaNama bucket.
local_xml_fileYaPath ke file XML lokal yang berisi konfigurasi CORS. Contoh: localfile.txt.

Contoh

  1. Buat file lokal bernama localfile.txt dengan konfigurasi CORS berikut. Contoh ini mengizinkan permintaan lintas asal PUT dari www.aliyun.com dan menginstruksikan browser untuk menyimpan cache tanggapan preflight (OPTIONS) selama 10.000 detik.

       <?xml version="1.0" encoding="UTF-8"?>
       <CORSConfiguration>
         <CORSRule>
           <AllowedOrigin>www.aliyun.com</AllowedOrigin>
           <AllowedMethod>PUT</AllowedMethod>
           <MaxAgeSeconds>10000</MaxAgeSeconds>
         </CORSRule>
       </CORSConfiguration>
  2. Terapkan konfigurasi tersebut ke examplebucket:

       ossutil cors --method put oss://examplebucket localfile.txt

    Output yang diharapkan:

       0.299514(s) berlalu

Mengkueri konfigurasi CORS

Sintaks

ossutil cors --method get oss://<bucketname> [<local_xml_file>]
ParameterWajibDeskripsi
bucketnameYaNama bucket.
local_xml_fileTidakPath ke file lokal tempat konfigurasi CORS disimpan. Jika dihilangkan, konfigurasi akan ditampilkan di layar.

Contoh

Jalankan perintah berikut untuk mengkueri konfigurasi CORS dari examplebucket dan menyimpannya ke localfile.txt:

ossutil cors --method get oss://examplebucket localfile.txt

Output yang diharapkan:

0.212407(s) berlalu

Konfigurasi CORS ditulis ke localfile.txt. Untuk menampilkan konfigurasi di layar, hilangkan path file:

ossutil cors --method get oss://examplebucket

Menghapus konfigurasi CORS

Sintaks

ossutil cors --method delete oss://<bucketname>

Contoh

ossutil cors --method delete oss://examplebucket

Output yang diharapkan:

0,530750(s) elapsed

Opsi umum

Untuk mengoperasikan bucket di wilayah berbeda atau yang dimiliki oleh Akun Alibaba Cloud berbeda, tambahkan opsi berikut:

OpsiDeskripsi
-e <endpoint>Titik akhir wilayah tempat bucket berada.
-i <AccessKey ID>ID AccessKey dari akun pemilik bucket.
-k <AccessKey secret>Rahasia AccessKey dari akun pemilik bucket.

Contoh: Buat konfigurasi CORS untuk testbucket, yang berlokasi di wilayah China (Hangzhou) dan dimiliki oleh akun berbeda:

ossutil cors --method put oss://testbucket localfile.txt -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Untuk daftar lengkap opsi umum, lihat Common options.