全部产品
Search
文档中心

Object Storage Service:cors

更新时间:Jul 02, 2025

Berbagi Sumber Daya Lintas Asal (CORS) adalah solusi standar lintas asal yang disediakan oleh HTML5 untuk memungkinkan server aplikasi web mengontrol akses lintas asal. Hal ini memastikan keamanan transmisi data lintas asal. Topik ini menjelaskan cara menjalankan perintah cors untuk menambah, memodifikasi, menanyakan, atau menghapus konfigurasi CORS untuk sebuah bucket.

Catatan penggunaan

  • Untuk membuat atau memodifikasi konfigurasi CORS, Anda harus memiliki izin oss:PutBucketCors. Untuk menanyakan konfigurasi CORS, Anda harus memiliki izin oss:GetBucketCors. Untuk menghapus konfigurasi CORS, Anda harus memiliki izin oss:DeleteBucketCors. Untuk informasi lebih lanjut, lihat Lampirkan Kebijakan Kustom ke Pengguna RAM.

  • Untuk ossutil versi 1.6.16 dan yang lebih baru, Anda dapat langsung menggunakan ossutil sebagai nama biner di baris perintah tanpa perlu memperbarui nama biner berdasarkan sistem operasi. Untuk ossutil sebelum versi 1.6.16, Anda perlu memperbarui nama biner sesuai dengan sistem operasi. Untuk informasi lebih lanjut, lihat Referensi Perintah ossutil.

  • Untuk informasi lebih lanjut tentang CORS, lihat CORS.

Buat atau modifikasi konfigurasi CORS untuk sebuah bucket

Jika bucket tidak memiliki konfigurasi CORS yang ada, perintah cors dengan opsi --method put akan membuat konfigurasi CORS untuk bucket tersebut. Jika bucket sudah memiliki konfigurasi CORS, perintah cors dengan opsi --method put akan menimpa konfigurasi CORS yang ada.

Untuk membuat atau memodifikasi konfigurasi CORS untuk sebuah bucket, ikuti langkah-langkah berikut:

  1. Buat file lokal dan tambahkan konfigurasi CORS ke dalamnya.

  2. Gunakan ossutil untuk membaca konfigurasi CORS dari file lokal dan asosiasikan konfigurasi tersebut dengan bucket yang ditentukan.

Gunakan sintaks perintah berikut untuk membuat atau memodifikasi konfigurasi CORS untuk sebuah bucket:

  • Sintaks Perintah

    ossutil cors --method put oss://bucketname local_xml_file

    Tabel berikut menjelaskan parameter-parameter di atas.

    Parameter

    Deskripsi

    bucketname

    Nama bucket untuk mana Anda ingin membuat atau memodifikasi konfigurasi CORS.

    local_xml_file

    Nama file lokal tempat konfigurasi CORS ditentukan. Contoh: localfile.txt.

  • Contoh

    1. Buat file bernama localfile.txt di komputer lokal dan tambahkan konfigurasi CORS ke dalam file tersebut.

      Contoh konfigurasi CORS berikut mengizinkan permintaan lintas asal PUT dari www.aliyun.com dan menentukan bahwa browser menyimpan respons terhadap permintaan 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. Buat konfigurasi CORS untuk bucket examplebucket.

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

      Contoh keluaran berikut menunjukkan bahwa konfigurasi CORS telah dibuat.

      0.299514(s) elapsed

Menanyakan konfigurasi CORS sebuah bucket

  • Sintaks Perintah

    ossutil cors --method get oss://bucketname [local_xml_file]

    Tabel berikut menjelaskan parameter-parameter di atas.

    Parameter

    Deskripsi

    bucketname

    Nama bucket yang konfigurasi CORS-nya ingin Anda tanyakan.

    local_xml_file

    Nama file lokal tempat Anda ingin menyimpan konfigurasi CORS. Contoh: localfile.txt. Jika parameter ini tidak ditentukan, konfigurasi CORS akan ditampilkan di layar.

  • Contoh

    Jalankan perintah berikut untuk menanyakan konfigurasi CORS sebuah bucket bernama examplebucket:

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

    Contoh keluaran berikut menunjukkan bahwa konfigurasi CORS diperoleh dan ditulis ke file localfile.txt.

    0.212407(s) elapsed

Hapus konfigurasi CORS sebuah bucket

  • Sintaks Perintah

    ossutil cors --method delete oss://bucketname
  • Contoh

    Jalankan perintah berikut untuk menghapus konfigurasi CORS bucket examplebucket:

    ossutil cors --method delete oss://examplebucket

    Contoh keluaran berikut menunjukkan bahwa konfigurasi CORS bucket examplebucket telah dihapus.

    0.530750(s) elapsed

Opsi umum

Jika Anda menggunakan ossutil untuk beralih ke bucket yang berada di wilayah lain, tambahkan opsi -e untuk menentukan titik akhir wilayah tempat bucket tersebut berada. Jika Anda menggunakan ossutil untuk beralih ke bucket yang dimiliki oleh akun Alibaba Cloud lain, tambahkan opsi -i untuk menentukan ID AccessKey dari akun tersebut, dan tambahkan opsi -k untuk menentukan Rahasia AccessKey dari akun tersebut.

Sebagai contoh, Anda dapat menjalankan perintah berikut untuk membuat konfigurasi CORS untuk bucket bernama testbucket, yang berada di wilayah China (Hangzhou) dan dimiliki oleh akun Alibaba Cloud lain:

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

Untuk informasi lebih lanjut tentang opsi umum, lihat Opsi Umum.