Tous les produits
Search

Ce produit

    Object Storage Service:put-bucket-encryption

    Centre de documentation

    Object Storage Service:put-bucket-encryption

    Dernière mise à jour :Aug 18, 2026

    Configure les règles de chiffrement d'un bucket.

    Notes d'utilisation

    Par défaut, un compte Alibaba Cloud est autorisé à configurer les règles de chiffrement d'un bucket. Pour ajouter ou modifier des règles en tant qu'utilisateur Resource Access Management (RAM) ou via Security Token Service (STS), vous devez disposer de l'autorisation oss:PutBucketEncryption. Pour plus d'informations, consultez la rubrique Exemples courants de politiques RAM.

    Syntaxe de la commande

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

    Paramètre

    Type

    Description

    --bucket

    string

    Nom du bucket.

    --server-side-encryption-rule

    string

    Conteneur des règles de chiffrement côté serveur.
    Remarque

    La commande put-bucket-encryption correspond à l'opération PutBucketEncryption. Pour plus d'informations sur les paramètres de l'opération PutBucketEncryption, consultez la rubrique PutBucketEncryption.

    --server-side-encryption-rule

    L'option de configuration --server-side-encryption-rule prend en charge les formats XML et JSON. Si la valeur de l'option contient le préfixe file://, la configuration est lue depuis un fichier.

    • Format XML :

      <ServerSideEncryptionRule> <ApplyServerSideEncryptionByDefault> <SSEAlgorithm>string</SSEAlgorithm> <KMSMasterKeyID>string</KMSMasterKeyID> <KMSDataEncryption>string</KMSDataEncryption> </ApplyServerSideEncryptionByDefault></ServerSideEncryptionRule>

    • Format JSON :

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

    Pour plus d'informations sur les options de ligne de commande globales prises en charge, consultez la rubrique Options de ligne de commande globales.

    Exemples

    Les exemples suivants montrent comment définir la méthode de chiffrement côté serveur du bucket examplebucket sur AES256.

    • Ajoutez le script suivant à un fichier de configuration XML nommé server-side-encryption-rule.xml :

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

    Exemple de commande :

    ossutil api put-bucket-encryption --bucket examplebucket --server-side-encryption-rule file://server-side-encryption-rule.xml

    • Ajoutez le script suivant à un fichier de configuration JSON nommé server-side-encryption-rule.json :

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

      Exemple de commande :

      ossutil api put-bucket-encryption --bucket examplebucket --server-side-encryption-rule file://server-side-encryption-rule.json

    • Configurez les paramètres de la commande suivante au format JSON :

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