全部产品
Search
文档中心

Object Storage Service:put-bucket-encryption

更新时间:Dec 06, 2025

Mengonfigurasi aturan enkripsi untuk sebuah bucket.

Catatan penggunaan

Secara default, akun Alibaba Cloud memiliki izin untuk mengonfigurasi aturan enkripsi bucket. Jika Anda ingin menambahkan atau mengubah aturan sebagai pengguna Resource Access Management (RAM) atau menggunakan Security Token Service (STS), Anda harus memiliki izin oss:PutBucketEncryption. Untuk informasi selengkapnya, lihat Lampirkan kebijakan kustom ke pengguna RAM.

Sintaks perintah

ossutil api put-bucket-encryption --bucket value --server-side-encryption-rule value [flags]

Parameter

Tipe

Deskripsi

--bucket

string

Nama bucket.

--server-side-encryption-rule

string

Kontainer untuk aturan enkripsi sisi server.

Catatan

Perintah put-bucket-encryption sesuai dengan operasi PutBucketEncryption. Untuk detail lebih lanjut tentang parameter dalam operasi PutBucketEncryption, lihat PutBucketEncryption.

--server-side-encryption-rule

Opsi konfigurasi --server-side-encryption-rule mendukung format XML dan JSON. Jika nilai opsi tersebut berisi awalan file://, konfigurasinya dibaca dari sebuah file.

  • Format XML:

    <ServerSideEncryptionRule>
      <ApplyServerSideEncryptionByDefault>
        <SSEAlgorithm>string</SSEAlgorithm>
        <KMSMasterKeyID>string</KMSMasterKeyID>
        <KMSDataEncryption>string</KMSDataEncryption>
      </ApplyServerSideEncryptionByDefault>
    </ServerSideEncryptionRule>
  • Format JSON:

    {
      "ApplyServerSideEncryptionByDefault": {
        "SSEAlgorithm": "string",
        "KMSMasterKeyID": "string",
        "KMSDataEncryption": "string"
      }
    }
Catatan

Untuk informasi selengkapnya mengenai opsi baris perintah global yang didukung, lihat Opsi baris perintah global.

Contoh

Contoh berikut menunjukkan cara mengatur metode enkripsi sisi server bucket examplebucket ke AES256.

  • Tambahkan skrip berikut ke file konfigurasi XML bernama server-side-encryption-rule.xml:

    <?xml version="1.0" encoding="UTF-8"?>
    <ServerSideEncryptionRule>
      <ApplyServerSideEncryptionByDefault>
        <SSEAlgorithm>AES256</SSEAlgorithm>
        <KMSMasterKeyID></KMSMasterKeyID>
      </ApplyServerSideEncryptionByDefault>
    </ServerSideEncryptionRule>

Contoh perintah:

ossutil api put-bucket-encryption --bucket examplebucket --server-side-encryption-rule file://server-side-encryption-rule.xml
  • Tambahkan skrip berikut ke file konfigurasi JSON bernama server-side-encryption-rule.json:

    {
      "ApplyServerSideEncryptionByDefault": {
        "SSEAlgorithm": "AES256"
      }
    }

    Contoh perintah:

    ossutil api put-bucket-encryption --bucket examplebucket --server-side-encryption-rule file://server-side-encryption-rule.json
  • Konfigurasikan parameter dalam perintah berikut dalam format JSON:

    ossutil api put-bucket-encryption --bucket examplebucket --server-side-encryption-rule "{\"ApplyServerSideEncryptionByDefault\":{\"SSEAlgorithm\":\"AES256\"}}"