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 izinoss:GetBucketCors. Untuk menghapus konfigurasi CORS, Anda harus memiliki izinoss: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:
Buat file lokal dan tambahkan konfigurasi CORS ke dalamnya.
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_fileTabel 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
Buat file bernama
localfile.txtdi komputer lokal dan tambahkan konfigurasi CORS ke dalam file tersebut.Contoh konfigurasi CORS berikut mengizinkan permintaan lintas asal
PUTdariwww.aliyun.comdan 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>Buat konfigurasi CORS untuk bucket examplebucket.
ossutil cors --method put oss://examplebucket localfile.txtContoh 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.txtContoh 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://bucketnameContoh
Jalankan perintah berikut untuk menghapus konfigurasi CORS bucket examplebucket:
ossutil cors --method delete oss://examplebucketContoh 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 yourAccessKeySecretUntuk informasi lebih lanjut tentang opsi umum, lihat Opsi Umum.