Object Storage Service:PutBucketLogging

Kullanım notları

• PutBucketLogging işlemini çağırarak bir paket için günlük kaydını etkinleştirmek için oss:PutBucketLogging izni gerekir. Daha fazla bilgi için bkz. Özel bir ilke atama.

• Günlüklerin oluşturulduğu kaynak paket ile günlüklerin depolandığı hedef paket aynı veya farklı olabilir. Ancak, hedef paket kaynak paketle aynı bölgede ve aynı Alibaba Cloud hesabına ait olmalıdır.

• OSS, paket erişim günlüklerini saatlik olarak oluşturur. Bununla birlikte, bir saate ait istekler önceki veya sonraki saatte oluşturulan günlüğe kaydedilebilir.

  Günlük nesnelerinin adlandırma kuralları ve günlük biçimi hakkında daha fazla bilgi için bkz. Günlük Kaydı.

• Günlük kaydını devre dışı bıraksanız bile OSS günlük nesneleri oluşturmaya devam eder. Depolama maliyetlerinizi azaltmak için artık ihtiyaç duymadığınız günlük nesnelerini silin.

  Günlük nesnelerini düzenli olarak silmek için yaşam döngüsü kuralları yapılandırabilirsiniz. Daha fazla bilgi için bkz. Son değiştirilme zamanına dayalı yaşam döngüsü kuralları.

• OSS günlüklerine yeni alanlar eklenebilir. Günlük işleme araçları geliştirirken olası uyumluluk sorunlarını dikkate almanızı öneririz.

İstek sözdizimi

PUT /?logging HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Authorization: SignatureValue 
Host: Host
<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus>
    <LoggingEnabled>
        <TargetBucket>TargetBucket</TargetBucket>
        <TargetPrefix>TargetPrefix</TargetPrefix>
    </LoggingEnabled>
</BucketLoggingStatus>

İstek üstbilgileri

Bir PutBucketLogging isteği yalnızca ortak istek üstbilgileri içerir. Daha fazla bilgi için bkz. Ortak istek üstbilgileri.

İstek öğeleri

Yanıt üstbilgileri

Bir PutBucketLogging isteğine verilen yanıttaki tüm üstbilgiler ortak yanıt üstbilgileridir. Daha fazla bilgi için bkz. Ortak yanıt üstbilgileri.

Örnekler

Paketler için örnekler

• Günlük kaydını etkinleştirmek için örnek istek

  PUT /?logging HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Content-Length: 186
  Date: Thu, 17 Apr 2025 03:21:12 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  
  <?xml version="1.0" encoding="UTF-8"?>
  <BucketLoggingStatus>
      <LoggingEnabled>
          <TargetBucket>examplebucket</TargetBucket>
          <TargetPrefix>MyLog-</TargetPrefix>
          <LoggingRole>AliyunOSSLoggingDefaultRole</LoggingRole>
      </LoggingEnabled>
  </BucketLoggingStatus>

  Örnek yanıt

  HTTP/1.1 200 OK
  x-oss-request-id: 534B371674E888648906008B
  Date: Fri, 04 May 2012 03:21:12 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

• Günlük kaydını devre dışı bırakmak için örnek istek

  Bir paket için günlük kaydını devre dışı bırakmak üzere yalnızca boş bir BucketLoggingStatus gönderin. Örnek:

  PUT /?logging HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Content-Type: application/xml
  Content-Length: 86
  Date: Thu, 17 Apr 2025 04:21:12 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  <?xml version="1.0" encoding="UTF-8"?>
  <BucketLoggingStatus>
  </BucketLoggingStatus>

  Örnek yanıt

  HTTP/1.1 200 OK
  x-oss-request-id: 534B371674125A4D8906008B
  Date: Fri, 04 May 2012 04:21:12 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

  Vektör paketleri için örnekler

  Bir vektör paketi için Host belirtirken standart Alibaba Cloud bölge kimliğini kullanın (örnek: cn-hangzhou ). Genel amaçlı paketler için kullanılan eski OSS bölge kimliğini (örnek: oss-cn-hangzhou ) kullanmayın.

  Günlük kaydını etkinleştirmek için örnek istek

  PUT /?logging HTTP/1.1
  Host: examplebucket-123***456.cn-hangzhou-internal.oss-vectors.aliyuncs.com
  Content-Length: 186
  Content-Type: application/json
  Date: Thu, 17 Apr 2025 03:21:12 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  
  {
    "BucketLoggingStatus": {
      "LoggingEnabled": {
        "TargetBucket": "examplebucket",
        "TargetPrefix": "MyLog-",
        "LoggingRole": "AliyunOSSLoggingDefaultRole"
      }
    }
  }

  Örnek yanıt

  HTTP/1.1 200 OK
  x-oss-request-id: 534B371674E888648906008B
  Date: Fri, 04 May 2012 03:21:12 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

OSS SDK'ları

PutBucketLogging işlemini çağırmak için aşağıdaki programlama dillerine yönelik OSS SDK'larını kullanın:

• Java

• Python V2

• PHP V2

• Go V2

• C

• .NET

• Node.js

• Ruby

ossutil

PutBucketLogging işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. put-bucket-logging.

Hata kodları