Mengambil aturan CORS sebuah bucket dengan memanggil GetBucketCors - Object Storage Service

Mengambil aturan berbagi sumber daya lintas domain (CORS) dari sebuah bucket.

Struktur permintaan

GET /? cors HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Header permintaan

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

Header respons

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

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
CORSRule	Container	N/A	Kontainer yang menyimpan aturan CORS. Hingga 10 aturan dapat dikonfigurasi untuk sebuah bucket. Node induk: CORSConfiguration
AllowedOrigin	String	*	Sumber-sumber dari mana permintaan lintas domain diizinkan. Jika AllowedOrigin disetel ke asterisk (*), permintaan lintas domain dari semua sumber diizinkan. Node induk: CORSRule
AllowedMethod	Enumerasi (GET, PUT, DELETE, POST, dan HEAD)	GET	Metode permintaan lintas domain yang diizinkan. Node induk: CORSRule
AllowedHeader	String	*	Menunjukkan apakah header yang ditentukan oleh Access-Control-Request-Headers dalam permintaan preflight OPTIONS diizinkan. Setiap header yang ditentukan oleh Access-Control-Request-Headers harus cocok dengan nilai elemen AllowedHeader. Node induk: CORSRule
ExposeHeader	String	x-oss-test	Header respons untuk permintaan akses yang diizinkan dari aplikasi, seperti objek XMLHttpRequest dalam JavaScript. Node induk: CORSRule
MaxAgeSeconds	Integer	100	Jangka waktu di mana browser dapat menyimpan cache respons untuk permintaan preflight OPTIONS ke sumber daya tertentu. Sebuah aturan CORS hanya dapat berisi satu parameter MaxAgeSeconds. Unit: detik Node induk: CORSRule
CORSConfiguration	Container	N/A	Kontainer yang menyimpan konfigurasi CORS bucket. Node induk: none
ResponseVary	Boolean	false	Menunjukkan apakah header Vary: Origin dikembalikan. Nilai default: false. true: Header Vary: Origin dikembalikan terlepas apakah permintaan tersebut merupakan permintaan lintas domain atau apakah permintaan lintas domain berhasil. false: Header Vary: Origin tidak dikembalikan. Node induk: CORSConfiguration

Contoh

Contoh Permintaan

Get /? cors HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com  
Date: Thu, 17 Apr 2025 07:51:28 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Contoh Respons

HTTP/1.1 200
x-oss-request-id: 50519080C4689A033D00****
Date: Thu, 13 Sep 2012 07:51:28 GMT
Connection: keep-alive
Content-Length: 218  
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration>
    <CORSRule>
      <AllowedOrigin>*</AllowedOrigin>
      <AllowedMethod>GET</AllowedMethod>
      <AllowedHeader>*</AllowedHeader>
      <ExposeHeader>x-oss-test</ExposeHeader>
      <MaxAgeSeconds>100</MaxAgeSeconds>
    </CORSRule>
    <ResponseVary>false</ResponseVary>
</CORSConfiguration>

OSS SDKs

Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut guna memanggil GetBucketCors:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi GetBucketCors, lihat get-bucket-cors.

Kode kesalahan

Kode kesalahan	Status HTTP	Deskripsi
NoSuchBucket	404	Pesan kesalahan yang dikembalikan karena bucket yang ditentukan tidak ada.
NoSuchCORSConfiguration	404	Pesan kesalahan yang dikembalikan karena aturan CORS yang ditentukan tidak ada.
AccessDenied	403	Pesan kesalahan yang dikembalikan karena Anda tidak memiliki otorisasi untuk melakukan operasi ini. Hanya pemilik bucket yang dapat mengambil aturan CORS yang dikonfigurasi untuk bucket tersebut.