全部产品
Search
文档中心

Object Storage Service:put-bucket-https-config

更新时间:Nov 09, 2025

Mengaktifkan atau menonaktifkan manajemen Versi TLS (Transport Layer Security) untuk sebuah bucket.

Catatan penggunaan

Secara default, Akun Alibaba Cloud memiliki izin untuk mengaktifkan atau menonaktifkan manajemen Versi TLS untuk sebuah bucket. Jika Anda ingin menggunakan Pengguna RAM atau Layanan Token Keamanan (STS), Anda memerlukan izin oss:PutBucketHttpsConfig. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke Pengguna RAM.

Sintaks perintah

ossutil api put-bucket-https-config --bucket nilai --https-configuration nilai [flags]

Parameter

Tipe

Deskripsi

--bucket

string

Nama bucket.

--https-configuration

string

Kontainer yang menyimpan konfigurasi Versi TLS.

Catatan

Perintah put-bucket-https-config sesuai dengan operasi PutBucketHttpsConfig. Untuk detail parameter dalam operasi PutBucketHttpsConfig, lihat PutBucketHttpsConfig.

--https-configuration

Opsi --https-configuration mendukung format XML dan JSON. Jika nilai opsi berisi awalan file://, ossutil membaca konfigurasi dari file konfigurasi.

  • Format XML:

    <HttpsConfiguration>
      <TLS>
        <Enable>boolean</Enable>
        <TLSVersion>string</TLSVersion>
        ...
      </TLS>
    </HttpsConfiguration>
  • Format JSON:

    {
      "TLS": {
        "Enable": boolean,
        "TLSVersion": ["string", ...]
      }
    }
Catatan

Untuk informasi lebih lanjut tentang opsi baris perintah global yang didukung, lihat Opsi Baris Perintah Global.

Contoh

Aktifkan manajemen Versi TLS untuk bucket bernama examplebucket dan atur Versi TLS ke TLS 1.2 dan TLS 1.3.

  • Buat file konfigurasi XML bernama https-configuration.xml dan tambahkan kode berikut ke file konfigurasi:

    <?xml version="1.0" encoding="UTF-8"?>
    <HttpsConfiguration>  
        <TLS>
            <Enable>true</Enable>   
            <TLSVersion>TLSv1.2</TLSVersion>
            <TLSVersion>TLSv1.3</TLSVersion>
        </TLS>
    </HttpsConfiguration>

    Contoh perintah:

    ossutil api put-bucket-https-config --bucket examplebucket --https-configuration file://https-configuration.xml
  • Buat file konfigurasi JSON bernama https-configuration.json dan tambahkan kode berikut ke file konfigurasi:

    {
      "TLS": {
        "Enable": "true",
        "TLSVersion": [
          "TLSv1.2",
          "TLSv1.3"
        ]
      }
    }

    Contoh perintah:

    ossutil api put-bucket-https-config --bucket examplebucket --https-configuration file://https-configuration.json
  • Konfigurasikan parameter dalam perintah berikut dalam format JSON:

    ossutil api put-bucket-https-config --bucket examplebucket --https-configuration "{\"TLS\":{\"Enable\":\"true\",\"TLSVersion\":[\"TLSv1.2\",\"TLSv1.3\"]}}"