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.
Operasi Izin yang diperlukan Membuat atau memodifikasi konfigurasi CORS oss:PutBucketCorsMengkueri konfigurasi CORS oss:GetBucketCorsMenghapus konfigurasi CORS oss:DeleteBucketCorsossutil terinstal. Untuk ossutil versi 1.6.16 dan yang lebih baru, gunakan
ossutillangsung 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>| Parameter | Wajib | Deskripsi |
|---|---|---|
bucketname | Ya | Nama bucket. |
local_xml_file | Ya | Path ke file XML lokal yang berisi konfigurasi CORS. Contoh: localfile.txt. |
Contoh
Buat file lokal bernama
localfile.txtdengan konfigurasi CORS berikut. Contoh ini mengizinkan permintaan lintas asalPUTdariwww.aliyun.comdan 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>Terapkan konfigurasi tersebut ke
examplebucket:ossutil cors --method put oss://examplebucket localfile.txtOutput yang diharapkan:
0.299514(s) berlalu
Mengkueri konfigurasi CORS
Sintaks
ossutil cors --method get oss://<bucketname> [<local_xml_file>]| Parameter | Wajib | Deskripsi |
|---|---|---|
bucketname | Ya | Nama bucket. |
local_xml_file | Tidak | Path 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.txtOutput yang diharapkan:
0.212407(s) berlaluKonfigurasi CORS ditulis ke localfile.txt. Untuk menampilkan konfigurasi di layar, hilangkan path file:
ossutil cors --method get oss://examplebucketMenghapus konfigurasi CORS
Sintaks
ossutil cors --method delete oss://<bucketname>Contoh
ossutil cors --method delete oss://examplebucketOutput yang diharapkan:
0,530750(s) elapsedOpsi umum
Untuk mengoperasikan bucket di wilayah berbeda atau yang dimiliki oleh Akun Alibaba Cloud berbeda, tambahkan opsi berikut:
| Opsi | Deskripsi |
|---|---|
-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 yourAccessKeySecretUntuk daftar lengkap opsi umum, lihat Common options.