S3 中繼資料表結構描述 - Amazon Simple Storage Service

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

S3 中繼資料表結構描述

Amazon S3 中繼資料表包含列和欄。每一列代表一個您在一般用途儲存貯體中已建立、更新或刪除物件的變動事件。這些事件大部分是各種使用者動作的結果，但其中一些事件是 Amazon S3 代表您採取動作的結果，例如 S3 生命週期過期或儲存類別轉換。

S3 Metadata 是一種事件處理管道，旨在使中繼資料表最終與一般用途儲存貯體中發生的變更保持一致。請注意，在通知 S3 Metadata 物件已建立或更新之前，該物件可能已在儲存貯體中遭到覆寫或刪除。根據預設，會為每個 S3 儲存貯體操作建立資料表資料列。不過，如果刪除或覆寫任何物件中繼資料，或無法再擷取物件，有些資料欄可能會顯示NULL值，指出任何遺失的中繼資料結構描述。

以下是名為 amzn-s3-demo-bucket: 之一般用途儲存貯體的中繼資料表範例 

bucket                key                        sequence_number                                                                                          record_type   record_timestamp           version_id   is_delete_marker   size   last_modified_date   e_tag	                           storage_class  is_multipart   encryption_status   is_bucket_key_enabled   kms_key_arn                                                                   checksum_algorithm   object_tags   user_metadata	                                                                                                                 requester      source_ip_address   request_id
amzn-s3-demo-bucket Finance/statement1.pdf     80e737d8b4d82f776affffffffffffffff006737d8b4d82f776a00000000000000000000000000000000000000000000000072   CREATE        2024-11-15 23:26:44.899                 FALSE              6223   11/15/2024 23:26     e131b86632dda753aac4018f72192b83    STANDARD	  FALSE          SSE-KMS             FALSE                   arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890df   SSECRC32             {}            {count -> Asia, customs -> false, family -> true, location -> Mary, name -> football, user -> United States}                       111122223333   192.0.2.1           CVK8FWYRW0M9JW65
amzn-s3-demo-bucket s3-dg.pdf                  80e737d8b4e39f1dbdffffffffffffffff006737d8b4e39f1dbd00000000000000000000000000000000000000000000000072   CREATE        2024-11-15 23:26:44.942                 FALSE              3554   11/15/2024 23:26     9bb49efc2d92c05558ddffbbde8636d5    STANDARD	  FALSE          DSSE-KMS            FALSE                   arn:aws:kms:us-east-1:936810216292:key/0dcebce6-49fd-4cae-b2e2-5512ad281afd   SSESHA1              {}            {}                                                                                                                                 111122223333   192.0.2.1           CVKAQDRAZEG7KXAY
amzn-s3-demo-bucket Development/Projects.xls   80e737d8b4ed9ac5c6ffffffffffffffff006737d8b4ed9ac5c600000000000000000000000000000000000000000000000072   CREATE        2024-11-15 23:26:44.966                 FALSE              7746   11/15/2024 23:26     729a6863e47fb9955b31bfabce984908    STANDARD	  FALSE          SSE-S3              FALSE                   NULL                                                                          SSECRC32             {}            {count -> Asia, customs -> Canada, family -> Billiards, filter -> true, location -> Europe, name -> Asia, user -> United States}   111122223333   192.0.2.1           CVK7Z6XQTQ90BSRV

中繼資料表具有下列結構描述：

欄名稱 是否為必要？ 資料類型

bucket

 是 字串 一般用途儲存貯體名稱。如需詳細資訊，請參閱一般用途儲存貯體命名規則。

key

 是 字串 物件金鑰名稱 (或金鑰)，可唯一識別儲存貯體中的物件。如需詳細資訊，請參閱命名 Amazon S3 物件。

sequence_number

 是 字串

序號，這是包含在指定物件記錄中的序數。若要排序相同儲存貯體和金鑰的記錄，您可以依 sequence_number 進行排序。對於指定的儲存貯體和金鑰，字母順序較大的 sequence_number 值表示記錄引進儲存貯體的時間較近。

record_type

 是 字串

此記錄的類型，下列其中一項：CREATE、UPDATE_METADATA 或 DELETE。

CREATE 記錄指出新物件 (或新版本的物件) 已寫入儲存貯體。

UPDATE_METADATA 記錄會擷取現有物件的可變中繼資料變更，例如儲存類別或標籤。

DELETE 記錄指出已刪除此物件 (或此版本的物件)。啟用版本控制時，DELETE 記錄代表刪除標記或永久刪除。刪除標記的 record_type 值為 DELETE，is_delete_marker 值為 True。永久刪除記錄在除 bucket、key、sequence_number、record_type、record_timestamp 和 version_id 以外的所有其他欄中都有 null 值。如需詳細資訊，請參閱刪除啟用版本控制功能之儲存貯體中的物件。

record_timestamp

 是 時間戳記 NTZ (無時區)

與此記錄相關聯的時間戳記。

version_id

 否 字串

物件的版本 ID。當您對儲存貯體啟用版本控制時，Amazon S3 會將版本號碼指派給已新增至儲存貯體的物件。如需詳細資訊，請參閱使用 S3 版本控制保留多個版本的物件。

在您設定版本控制狀態之前，儲存在儲存貯體中的物件版本 ID 為 null。

is_delete_marker

 否 Boolean

物件的刪除標記狀態。如果物件為刪除標記，則此值為 True。否則為 False。如需詳細資訊，請參閱使用刪除標記。

注意

刪除標記的 record_type 值為 DELETE (而不是 UPDATE_METADATA) 時為其新增的列。如果因為 S3 生命週期過期而建立刪除標記，則 requester 值為 s3.amazonaws.com。

size

 否 Long

物件大小 (位元組)，不包括未完成的分段上傳或物件中繼資料大小。如果 is_delete_marker 為 True，則大小為 0。如需詳細資訊，請參閱系統定義的物件中繼資料。

last_modified_date

 否 時間戳記 NTZ (無時區)

物件建立日期或上次修改日期，以最近者為準。對於分段上傳，物件建立日期是指啟動分段上傳的日期。如需詳細資訊，請參閱系統定義的物件中繼資料。

e_tag

 否 字串

實體標籤 (ETag)，這是物件的雜湊值。ETag 只會反映物件內容的變更，而非其中繼資料的變更。ETag 可以是物件資料的 MD5 Digest。ETag 是否為 MD5 摘要取決於物件的建立方式和加密方式。如需詳細資訊，請參閱 Amazon S3 API 參考中的 Object。

storage_class

 否 字串

用於儲存物件的儲存類別。下列其中一項：STANDARD、REDUCED_REDUNDANCY、STANDARD_IA、ONEZONE_IA、INTELLIGENT_TIERING、GLACIER、DEEP_ARCHIVE 或 GLACIER_IR。如需詳細資訊，請參閱了解和管理 Amazon S3 儲存類別。

is_multipart

 否 Boolean

物件的上傳類型。如果物件是以分段上傳的方式上傳，則此值為 True。否則為 False。如需詳細資訊，請參閱在 Amazon S3 中使用分段上傳來上傳和複製物件。

encryption_status

 否 字串

物件的伺服器端加密狀態，視使用的加密金鑰類型而定：使用 Amazon S3 受管金鑰的伺服器端加密 (SSE-S3)、使用 AWS Key Management Service (AWS KMS) 金鑰的伺服器端加密 (SSE-KMS)、使用 AWS KMS keys 的雙層伺服器端加密 (DSSE-KMS)，或使用客戶提供金鑰的伺服器端加密 (SSE-C)。如果物件未加密，則此值為 null。可能的值包括 SSE-S3、SSE-KMS、DSSE-KMS、SSE-C 或 null。如需詳細資訊，請參閱使用加密來保護資料。

is_bucket_key_enabled

 否 Boolean

物件的 S3 儲存貯體金鑰啟用狀態。如果物件針對 SSE-KMS 使用 S3 儲存貯體金鑰，則此值為 True。否則為 False。如需詳細資訊，請參閱在物件層級設定 S3 儲存貯體金鑰。

kms_key_arn

 否 字串

用來加密物件之 KMS 金鑰的 Amazon Resource Name (ARN)，適用於 encryption_status 為 SSE-KMS 或 DSSE-KMS 的列。如果物件未使用 SSE-KMS 或 DSSE-KMS 加密，則值為 null。如需詳細資訊，請參閱搭配 AWS KMS 金鑰使用伺服器端加密 (SSE-KMS)及使用雙層伺服器端加密搭配 AWS KMS 金鑰 (DSSE-KMS)。

注意

如果列代表處理刪除或覆寫事件時不再存在的物件版本，kms_key_arn 會包含 null 值，即使 encryption_status 欄值為 SSE-KMS 或 DSSE-KMS 也一樣。

checksum_algorithm

 否 字串

用來建立物件檢查總和的演算法，下列其中一項：CRC64-NVME、CRC32、CRC32C、SHA1 或 SHA256。如果不存在檢查總和，則此值為 null。如需詳細資訊，請參閱使用支持的檢查總和演算法。

object_tags

 否 Map <String, String>

與物件相關聯的物件標籤。物件標籤會儲存為金鑰/值對的映射。如果物件沒有物件標籤，則會儲存空的映射 ({})。如需詳細資訊，請參閱使用標籤分類儲存空間

注意

如果 record_type 值為 DELETE，則 object_tags 欄會包含 null 值。如果 record_type 值為 CREATE 或 UPDATE_METADATA，代表處理刪除或覆寫事件時不再存在之物件版本的列會在 object_tags 欄中包含 null 值。

user_metadata

 否 Map <String, String>

與物件相關聯的使用者中繼資料。使用者中繼資料會儲存為金鑰/值對的映射。如果物件沒有使用者中繼資料，則會儲存空的映射 ({})。如需詳細資訊，請參閱使用者定義的物件中繼資料。

注意

如果 record_type 值為 DELETE，則 user_metadata 欄會包含 null 值。如果 record_type 值為 CREATE 或 UPDATE_METADATA，代表處理刪除或覆寫事件時不再存在之物件版本的列會在 user_metadata 欄中包含 null 值。

requester

 否 字串

提出請求的請求者或 AWS 服務 委託人的 AWS 帳戶 ID。

source_ip_address

 否 字串

請求的來源 IP 位址。對於使用者請求產生的記錄，此欄包含請求的來源 IP 位址。對於 Amazon S3 或代表 AWS 服務 使用者執行的動作，此欄包含 null 值。

request_id

 否 字串

與請求相關聯的請求 ID。