GET Bucket Logging
更新時間 2024-11-07 18:15:44
最近更新時間: 2024-11-07 18:15:44
分享文章
本節主要介紹GET Bucket Logging。
此操作用來獲得指定Bucket的logging。只有根用戶和擁有GET Bucket Logging權限的子用戶才能執行此操作，否則會返回403 AccessDenied錯誤。
請求語法
GET /?logging HTTP/1.1
Host: BucketName.oos-cn.ctyunapi.cn
Date: date
Authorization: SignatureValue
請求參數
| 名稱 | 描述 | 是否必須 |
|---|---|---|
| BucketName | 存儲桶名稱。 | 是 |
響應結果
| 名稱 | 描述 |
|---|---|
| BucketLoggingStatus | 響應的容器。 類型：容器。 子節點：LoggingEnabled。 |
| LoggingEnabled | 日志信息的容器，當啟動日志時，包含這個元素；否則此元素及其子元素都不顯示。 類型：容器。 父節點：BucketLoggingStatus。 子節點：TargetBucket、TargetPrefix。 |
| TargetBucket | 保存log的bucket，OOS會向此Bucket存儲日志。 類型：字符串。 父節點：LoggingEnabled。 |
| TargetPrefix | 生成的log文件將以此為前綴命名。 類型：字符串。 父節點：LoggingEnabled。 |
請求示例
GET?/?logging?HTTP/1.1
Host:?docs.oos-cn.ctyunapi.cn
Date:?Mon,?03 Sep?2012?12:00:00?GMT
Authorization: SignatureValue
響應示例
以下是設置了日志的響應示例。
HTTP/1.1?200?OK
x-amz-request-id:?7b6bfbc182504e46f26558675c696b7130323c26282a2c2e30
Date:?Mon,?03 Sep?2012?12:00:00?GMT
Server:?CTYUN
?
<?xml?version="1.0"?encoding="UTF-8"?>
<BucketLoggingStatus?xmlns="//doc.s3.amazonaws.com/2006-03-01">
<LoggingEnabled>
<TargetBucket>example-bucket</TargetBucket>
<TargetPrefix>mybucket-access_log-/</TargetPrefix>
</LoggingEnabled>
</BucketLoggingStatus>
以下是沒有設置日志時的響應示例。
HTTP/1.1?200?OK
x-amz-request-id:?ef00a70d4f2b43416ee1d4e3d8e5e7edacaeb7a2a4a6a8aaac
Date:?Mon,?03 Sep?2012?12:00:00?GMT
Server:?CTYUN
?
<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="//s3.amazonaws.com/doc/2006-03-01/"></BucketLoggingStatus>
