本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# SetBucketLoggingStatus (SOAP API)
<a name="SOAPSetBucketLoggingStatus"></a>

**注意**  
 Amazon S3 的 SOAP API 不適用於新客戶，並且將於 2025 年 8 月 31 日接近生命週期結束 (EOL)。我們建議您使用 REST API 或 AWS SDKs。

 `SetBucketLoggingStatus` 操作會更新現有儲存貯體的記錄狀態。

 如需此功能的一般簡介，請參閱[伺服器日誌](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerLogs.html)。

**Example**  
此範例請求會啟用 'mybucket' 儲存貯體的伺服器存取記錄，並將日誌設定為在字首 'access\_log-' 下傳送到 'mylogs'  
`Sample Request`  

```
 1. <?xml version="1.0" encoding="utf-8"?>
 2.     <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
 3.     <soap:Body>
 4.     <SetBucketLoggingStatus xmlns="https://doc.s3.amazonaws.com/2006-03-01">
 5.       <Bucket>myBucket</Bucket>
 6.       <AWSAccessKeyId>{{YOUR_AWS_ACCESS_KEY_ID}}</AWSAccessKeyId>
 7.       <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
 8.       <Signature>{{YOUR_SIGNATURE_HERE}}</Signature>
 9.       <BucketLoggingStatus>
10.         <LoggingEnabled>
11.           <TargetBucket>mylogs</TargetBucket>
12.           <TargetPrefix>mybucket-access_log-</TargetPrefix>
13.         </LoggingEnabled>
14.       </BucketLoggingStatus>
15.     </SetBucketLoggingStatus>
16.     </soap:Body>
17.     :</soap:Envelope>
```
`Sample Response`  

```
1. <?xml version="1.0" encoding="utf-8"?>
2.     <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
3.       <soapenv:Header>
4.       </soapenv:Header>
5.       <soapenv:Body>
6.         <SetBucketLoggingStatusResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01"/>
7.       </soapenv:Body>
8.     </soapenv:Envelope>
```

## 存取控制
<a name="SOAPSetBucketLoggingStatusAccessControl"></a>

只有儲存貯體的擁有者才能叫用此操作。