

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

# 到期的日誌資料表記錄
<a name="metadata-tables-expire-journal-table-records"></a>

根據預設，日誌資料表中的記錄不會過期。為協助將日誌資料表的儲存成本降到最低，您可以啟用日誌資料表記錄到期條件。

**注意**  
如果您在 2025 年 7 月 15 日之前建立 S3 Metadata 組態，則無法在該組態上使日誌資料表記錄過期。建議您刪除並重新建立組態，以便使日誌資料表記錄過期，並建立庫存資料表。如需詳細資訊，請參閱[在 2025 年 7 月 15 日之前建立的中繼資料組態上啟用庫存資料表](metadata-tables-create-configuration.md#metadata-tables-migration)。

如果啟用日誌資料表記錄到期條件，則可以設定保留日誌資料表記錄的天數。若要設定此值，請指定介於 `7` 和 `2147483647` 之間的任何整數。例如，若要將日誌資料表記錄保留一年，請將此值設定為 `365`。

**重要**  
日誌資料表記錄到期後，便無法復原。

記錄將在符合到期條件後的 24 至 48 小時內到期。日誌記錄會從最新的快照中移除。已刪除記錄的資料和儲存體，可藉由資料表維護操作進行移除。

如果您已啟用日誌資料表記錄到期條件，您可以隨時停用此功能，以停止日誌資料表記錄到期條件。

您可以使用 Amazon S3 主控台、 AWS Command Line Interface (AWS CLI) AWS 、 SDKs 或 Amazon S3 REST API 來使日誌資料表記錄過期。

## 如何使日誌資料表記錄過期
<a name="metadata-tables-expire-journal-table-records-procedure"></a>

### 使用 S3 主控台
<a name="metadata-tables-expire-journal-table-records-console"></a>

**使日誌資料表記錄過期**

1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 的 Amazon S3 主控台。

1. 在左側導覽窗格中，選擇**一般用途儲存貯體**。

1. 選擇包含中繼資料表組態的一般用途儲存貯體，其中包含您要使記錄過期的日誌資料表。

1. 在儲存貯體的詳細資訊頁面上，選擇**中繼資料**索引標籤。

1. 在**中繼資料**索引標籤上，選擇**編輯**，然後選擇**編輯日誌資料表記錄過期**。

1. 在**編輯日誌資料表記錄過期**頁面上，選擇**記錄過期**下的**已啟用**。

1. 設定要保留日誌資料表記錄的天數。若要設定**記錄變成過期的天數**值，請指定介於 `7` 和 `2147483647` 之間的任何整數。例如，若要將日誌資料表記錄保留一年，請將此值設定為 `365`。
**重要**  
日誌資料表記錄到期後，便無法復原。

1. 在**日誌資料表記錄將在指定天數後到期**下，選取此核取方塊。

1. 選擇**儲存變更**。

如果您想要停用日誌資料表記錄過期功能，請重複上述步驟，但針對步驟 6 選擇**已停用**，而非**已啟用**。

### 使用 AWS CLI
<a name="metadata-tables-expire-journal-table-records-cli"></a>

若要執行下列命令，您必須 AWS CLI 安裝並設定 。如果您尚未 AWS CLI 安裝 ，請參閱*AWS Command Line Interface 《 使用者指南*》中的[安裝或更新至最新版本的 AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/getting-started-install.html)。

您也可以使用 ，從主控台執行 AWS CLI 命令 AWS CloudShell。 AWS CloudShell 是一種以瀏覽器為基礎的預先驗證 Shell，您可以直接從 啟動 AWS 管理主控台。如需詳細資訊，請參閱《AWS CloudShell 使用者指南》**中的[什麼是 CloudShell](https://docs.aws.amazon.com//cloudshell/latest/userguide/welcome.html) 和[開始使用 AWS CloudShell](https://docs.aws.amazon.com//cloudshell/latest/userguide/getting-started.html)。

**使用 使日誌資料表記錄過期 AWS CLI**

若要使用下列範例命令，請以您自己的資訊取代 `{{user input placeholders}}`。

1. 建立包含日誌資料表組態的 JSON 檔案，然後儲存檔案 (例如 `journal-config.json`)。以下是範例組態。

   若要設定 `Days` 值，請指定介於 `7` 和 `2147483647` 之間的任何整數。例如，若要將日誌資料表記錄保留一年，請將此值設定為 `365`。

   ```
   {
     "RecordExpiration": {
       "Expiration": "ENABLED",
       "Days": {{10}}
     }
   }
   ```

   若要停用日誌資料表記錄過期功能，請改為建立下列範例組態。如果 `Expiration` 設定為 `DISABLED`，則不得在組態中指定 `Days` 值。

   ```
   {
     "RecordExpiration": {
       "Expiration": "DISABLED"
     }
   }
   ```

1. 使用下列命令來使一般用途儲存貯體中日誌資料表的記錄過期 (例如，`{{amzn-s3-demo-bucket}}`)：

   ```
   aws s3api update-bucket-metadata-journal-table-configuration \
   --bucket {{amzn-s3-demo-bucket}} \
   --journal-table-configuration file://./{{journal-config}}.json \
   --region {{us-east-2}}
   ```

### 使用 REST API
<a name="metadata-tables-expire-journal-table-records-rest-api"></a>

您可以傳送 REST 請求來使日誌資料表記錄過期。如需詳細資訊，請參閱[https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataJournalTableConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataJournalTableConfiguration.html)。

### 使用 AWS SDKs
<a name="metadata-tables-expire-journal-table-records-sdk"></a>

您可以使用 AWS SDKs 使 Amazon S3 中的日誌資料表記錄過期。如需詳細資訊，請參閱[支援的 SDK 清單](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataJournalTableConfiguration.html#API_UpdateBucketMetadataJournalTableConfiguration_SeeAlso)。