Use the put-bucket-logging command to enable logging for a bucket - Object Storage Service

Active la journalisation pour un compartiment Object Storage Service (OSS). Une fois la journalisation activée, OSS génère des objets de journal d'accès toutes les heures selon des règles de nommage prédéfinies, puis stocke ces objets dans le compartiment spécifié.

Remarques d'utilisation

Avant d'activer la journalisation, assurez-vous de bien comprendre cette fonctionnalité. Pour plus d'informations, consultez la rubrique Expédition des journaux.

Autorisations

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud ne disposent d'aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'opération via des stratégies RAM ou une stratégie de compartiment.

API	Action	Description
PutBucketLogging	`oss:PutBucketLogging`	Active la journalisation pour un compartiment.
PutBucketLogging	`oss:PutObject`	Lors de l'activation de la journalisation pour un compartiment, si les journaux sont écrits dans un autre compartiment, cette autorisation est requise pour le compartiment de destination.

Syntaxe de la commande

ossutil api put-bucket-logging --bucket value --bucket-logging-status value [flags]

Paramètre

Type

Description

--bucket

string

Nom du compartiment.

--bucket-logging-status

string

Conteneur qui stocke les informations sur l'état de la journalisation.

Remarque

La commande put-bucket-logging équivaut à l'opération PutBucketLogging. Pour plus d'informations sur cette opération API, consultez la rubrique PutBucketLogging.

--bucket-logging-status

Le paramètre --bucket-logging-status prend en charge les formats XML et JSON. Si la valeur du paramètre commence par « file:// », les configurations sont chargées à partir du fichier spécifié.

Format XML :

<BucketLoggingStatus>
  <LoggingEnabled>
    <TargetBucket>string</TargetBucket>
    <TargetPrefix>string</TargetPrefix>
  </LoggingEnabled>
</BucketLoggingStatus>

Format JSON :

{
  "LoggingEnabled": {
    "TargetBucket": "string",
    "TargetPrefix": "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.

Exemples

Activez la journalisation pour le compartiment examplebucket avec les journaux d'accès préfixés par MyLog- et stockés dans le compartiment dest-bucket.

Utilisez un fichier de configuration XML (bucket-logging-status.xml dans cet exemple)

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus>
  <LoggingEnabled>
    <TargetBucket>dest-bucket</TargetBucket>
    <TargetPrefix>MyLog-</TargetPrefix>
  </LoggingEnabled>
</BucketLoggingStatus>

Exemple de commande :

ossutil api put-bucket-logging --bucket examplebucket --bucket-logging-status file://bucket-logging-status.xml

Utilisez un fichier de configuration JSON (bucket-logging-status.json dans cet exemple)

{
  "LoggingEnabled": {
    "TargetBucket": "destBucket",
    "TargetPrefix": "MyLog-"
  }
}

Exemple de commande :

ossutil api put-bucket-logging --bucket examplebucket --bucket-logging-status file://bucket-logging-status.json

Utilisez des paramètres JSON directement dans la ligne de commande

ossutil api put-bucket-logging --bucket examplebucket --bucket-logging-status "{\"LoggingEnabled\":{\"TargetBucket\":\"destBucket\",\"TargetPrefix\":\"MyLog-\"}}"