PutBucketHttpsConfig - Object Storage Service

Anda dapat memanggil operasi PutBucketHttpsConfig untuk mengonfigurasi versi TLS dan suite algoritma enkripsi pada sebuah bucket.

Catatan penggunaan

Untuk mengonfigurasi versi TLS dan suite algoritma enkripsi pada sebuah bucket, Anda harus memiliki izin oss:PutBucketHttpsConfig. Untuk informasi lebih lanjut, lihat Memberikan Izin Kustom kepada Pengguna RAM.
Setiap Wilayah memiliki titik akhir yang dapat digunakan untuk mengakses OSS di wilayah tersebut. Untuk informasi lebih lanjut tentang pemetaan antara wilayah dan titik akhir, lihat Titik Akhir dan Pusat Data.

Sintaks permintaan

PUT /?httpsConfig HTTP/1.1
Date: Tanggal GMT
Authorization: NilaiTandaTangan
Host: NamaBucket.oss-cn-hangzhou.aliyuncs.com

<?xml version="1.0" encoding="UTF-8"?>
<HttpsConfiguration>  
  <TLS>
    <Enable>true</Enable>   
    <TLSVersion>TLSv1.2</TLSVersion>
    <TLSVersion>TLSv1.3</TLSVersion>
  </TLS>
  <CipherSuite>
    <Enable>true</Enable>
    <StrongCipherSuite>false</StrongCipherSuite>
    <CustomCipherSuite>ECDHE-ECDSA-AES128-SHA256</CustomCipherSuite>
    <TLS13CustomCipherSuite>ECDHE-ECDSA-AES256-CCM8</CustomCipherSuite>
  </CipherSuite>
</HttpsConfiguration>

Header permintaan

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

Elemen permintaan

Nama	Tipe	Diperlukan	Contoh	Deskripsi
HttpsConfiguration	Kontainer	Ya	Tidak ada	Kontainer yang menyimpan konfigurasi HTTPS. Node induk: tidak ada
TLS	Kontainer	Ya	Tidak ada	Kontainer yang menyimpan konfigurasi Versi TLS. Node induk: HttpsConfiguration
Enable	Boolean	Ya	true	Menentukan apakah akan mengaktifkan kontrol versi TLS untuk bucket. Nilai valid: true false Node induk: TLS
TLSVersion	string	Opsional	TLSv1.2	Versi TLS. Elemen ini hanya diperlukan jika Anda menyetel elemen Enable ke true. Nilai valid: TLSv1.0 TLSv1.1 TLSv1.2 TLSv1.3 Untuk informasi lebih lanjut tentang skenario dan deskripsi versi TLS, lihat Deskripsi versi TLS. Node induk: TLS
CipherSuite	Kontainer	Opsional	Tidak ada	Kontainer yang menyimpan suite algoritma enkripsi. Node induk: HttpsConfiguration
Enable	Boolean	Opsional	true	Mengonfigurasi suite algoritma enkripsi TLS. Nilai valid: true: suite algoritma enkripsi kuat atau suite algoritma enkripsi kustom. false: semua suite algoritma enkripsi (default). Node induk: CipherSuite
StrongCipherSuite	Boolean	Opsional	false	Menentukan apakah akan menggunakan suite algoritma enkripsi kuat. Nilai valid: true: menggunakan suite algoritma enkripsi kuat. false: menggunakan suite algoritma enkripsi kustom. Node induk: CipherSuite
CustomCipherSuite	string	Opsional	ECDHE-ECDSA-AES128-SHA256	Menentukan suite algoritma enkripsi kustom. Anda dapat menentukan beberapa suite. Bidang ini digunakan untuk mengonfigurasi suite algoritma enkripsi kustom untuk TLS 1.2. Node induk: CipherSuite
TLS13CustomCipherSuite	string	Opsional	ECDHE-ECDSA-AES256-CCM8	Menentukan suite algoritma enkripsi kustom. Anda dapat menentukan beberapa suite. Bidang ini digunakan untuk mengonfigurasi suite algoritma enkripsi kustom untuk TLS 1.3. Node induk: CipherSuite

Header tanggapan

Semua header dalam tanggapan terhadap permintaan PutBucketHttpsConfig merupakan header tanggapan umum. Untuk informasi lebih lanjut, lihat Header Tanggapan Umum.

Contoh

Contoh Permintaan

PUT /?httpsConfig HTTP/1.1
Date: Thu, 17 Apr 2025 08:40:17 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
Host: oss-example.oss-cn-hangzhou.aliyuncs.com

<?xml version="1.0" encoding="UTF-8"?>
<HttpsConfiguration>  
  <TLS>
    <Enable>true</Enable>   
    <TLSVersion>TLSv1.2</TLSVersion>
    <TLSVersion>TLSv1.3</TLSVersion>
  </TLS>
  <CipherSuite>
    <Enable>true</Enable>
    <StrongCipherSuite>false</StrongCipherSuite>
    <CustomCipherSuite>ECDHE-ECDSA-AES128-SHA256</CustomCipherSuite>
    <CustomCipherSuite>ECDHE-RSA-AES128-GCM-SHA256</CustomCipherSuite>
    <CustomCipherSuite>ECDHE-ECDSA-AES256-CCM8</CustomCipherSuite>
    <TLS13CustomCipherSuite>ECDHE-ECDSA-AES256-CCM8</CustomCipherSuite>
    <TLS13CustomCipherSuite>ECDHE-ECDSA-AES256-CCM8</CustomCipherSuite>
    <TLS13CustomCipherSuite>ECDHE-ECDSA-AES256-CCM8</CustomCipherSuite>
  </CipherSuite>
</HttpsConfiguration>

Contoh Keluaran Perintah:

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Wed, 16 Aug 2023 15:56:37 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

Alat baris perintah ossutil

Untuk informasi lebih lanjut tentang perintah ossutil yang sesuai dengan operasi PutBucketHttpsConfig, lihat put-bucket-https-config.