使用put-bucket-logging 为存储空间开启日志转存功能 - Object Storage Service

La commande put-bucket-logging active le transfert des journaux pour un compartiment (Bucket). Elle génère des fichiers journaux à partir des logs d'accès OSS, selon une convention de nommage fixe et par intervalle horaire, puis les écrit dans le Bucket spécifié.

Prérequis

Avant d'activer le transfert des journaux, assurez-vous de bien comprendre son fonctionnement. Pour plus de détails, consultez la rubrique Transfert des journaux.

Permissions

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 propriétaire du 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`	Si vous activez la journalisation pour un compartiment et que les journaux sont écrits dans un autre compartiment, cette autorisation est requise pour le compartiment de destination.

Format de la commande

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

Paramètre

Type

Description

--bucket

string

Nom du Bucket.

--bucket-logging-status

string

Conteneur contenant les informations d'état de la journalisation des accès.

Remarque

La commande put-bucket-logging correspond à l'interface API PutBucketLogging. Pour connaître la signification des paramètres spécifiques à l'API, consultez la rubrique PutBucketLogging.

--bucket-logging-status

L'option de configuration --bucket-logging-status prend en charge les syntaxes XML et JSON. Lorsque la valeur de l'option contient le préfixe file://, la configuration est lue à partir d'un fichier.

Syntaxe XML :

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

Syntaxe JSON :

{
  "LoggingEnabled": {
    "TargetBucket": "string",
    "TargetPrefix": "string"
  }
}

Remarque

Pour obtenir la liste des options de ligne de commande globales prises en charge, consultez la rubrique Options de ligne de commande globales.

Exemples d'utilisation

Les exemples suivants montrent comment activer le transfert des journaux pour le compartiment nommé examplebucket. Le préfixe des fichiers journaux est défini sur MyLog- et les journaux d'accès sont stockés dans le Bucket dest-bucket.

Utilisez un fichier de configuration XML. Le contenu de bucket-logging-status.xml est le suivant :

<?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. Le contenu de bucket-logging-status.json est le suivant :

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

Exemple de commande :

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

Utilisez directement les paramètres de configuration JSON. Exemple de commande :

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