GetBucketLogging - Interroger la configuration des journaux d'accès du bucket - Object Storage Service

Notes d'utilisation

L'opération GetBucketLogging nécessite l'autorisation oss:GetBucketLogging. Accorder des politiques d'accès personnalisées aux utilisateurs RAM.

Syntaxe de la requête

GET /?logging HTTP/1.1
Host: Host
Date: GMT Date
Authorization: SignatureValue

En-têtes de requête

Cette opération utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez En-têtes de requête communs.

En-têtes de réponse

La réponse contient uniquement les en-têtes de réponse communs. Pour plus d'informations, consultez En-têtes de réponse communs.

Éléments de réponse

Nom	Type	Exemple	Description
BucketLoggingStatus	Container	Non applicable	Conteneur pour le statut des journaux d'accès. Élément enfant : LoggingEnabled Élément parent : Aucun Remarque Si aucune règle de journalisation n'est configurée pour le bucket, OSS renvoie un corps XML avec un élément BucketLoggingStatus vide.
LoggingEnabled	Container	Non applicable	Conteneur pour les informations de journalisation des accès. Renvoyé uniquement lorsque la journalisation est activée. Éléments enfants : TargetBucket, TargetPrefix et LoggingRole Élément parent : BucketLoggingStatus
TargetBucket	String	mybucketlogs	Le bucket qui stocke les journaux d'accès. Élément enfant : Aucun Élément parent : BucketLoggingStatus.LoggingEnabled
TargetPrefix	String	mybucket-access_log/	Le préfixe des fichiers de journaux d'accès stockés. Élément enfant : Aucun Élément parent : BucketLoggingStatus.LoggingEnabled
LoggingRole	String	AliyunOSSLoggingDefaultRole	Le rôle pour l'autorisation de stockage des journaux. Élément enfant : Aucun Élément parent : BucketLoggingStatus.LoggingEnabled

Exemples

Bucket à usage général

Requête

Get /?logging HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com  
Date: Thu, 17 Apr 2025 05:31:04 GMT  
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Réponse

Réponse lorsque la journalisation est activée

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 280  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
    <LoggingEnabled>
        <TargetBucket>mybucketlogs</TargetBucket>
        <TargetPrefix>mybucket-access_log/</TargetPrefix>
        <LoggingRole>AliyunOSSLoggingDefaultRole</LoggingRole>
    </LoggingEnabled>
</BucketLoggingStatus>

Réponse lorsque la journalisation est désactivée

HTTP/1.1 200 
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 110  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
</BucketLoggingStatus>

Vector bucket

Les Vector buckets utilisent les ID de région Alibaba Cloud standard (tels que cn-hangzhou) dans l'en-tête Host, et non les anciens ID de région OSS (tels que oss-cn-hangzhou).

Requête

Get /?logging HTTP/1.1
Host: exampebucket-123***456.cn-hangzhou-internal.oss-vectors.aliyuncs.com
Date: Thu, 17 Apr 2025 05:31:04 GMT  
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Réponse

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 280  
Server: AliyunOSS

{
  "BucketLoggingStatus": {
    "LoggingEnabled": {
      "TargetBucket": "mybucketlogs",
      "TargetPrefix": "mybucket-access_log/",
      "LoggingRole": "AliyunOSSLoggingDefaultRole"
    }
  }
}

SDK

SDK pris en charge :

Outil de ligne de commande ossutil

La commande ossutil correspondante est get-bucket-logging.

Codes d'erreur

Code d'erreur

Code d'état HTTP

Description

NoSuchBucket

404

Le bucket spécifié n'existe pas.

AccessDenied

403

Vous ne disposez pas de l'autorisation nécessaire pour afficher la configuration des journaux d'accès du bucket. Seul le propriétaire du bucket possède cette autorisation.