教學課程：透過分段上傳來上傳物件並驗證其資料完整性

上傳組件時，除了上傳 ID 之外，還必須使用 --part-number 引數來指定組件編號。您可選擇 1 到 10,000 之間的任何組件編號。組件編號可找出獨特的某個組件，以及其在上傳中物件內的位置。您選擇的組件編號必須是連續的號碼 (例如，其可為 1、2 或 3)。若使用和前一個上傳組件相同的組件編號上傳新的組件，將會覆寫前一個已上傳的組件。

使用 upload-part 命令上傳分段上傳的每個組件。--upload-id 與步驟 3 中 create-multipart-upload 命令所建立輸出中的 ID 相同。若要上傳資料的第一個組件，請使用下列命令：

aws s3api upload-part --bucket amzn-s3-demo-bucket1 --key 'census_data_file' --part-number 1 --body census-part00 --upload-id "cNV6KCSNANFZapz1LUGPC5XwUVi1n6yUoIeSP138sNOKPeMhpKQRrbT9k0ePmgoOTCj9K83T4e2Gb5hQvNoNpCKqyb8m3.oyYgQNZD6FNJLBZluOIUyRE.qM5yhDTdhz" --checksum-algorithm SHA256

完成每個 upload-part 命令之後，您應該會看到如下列範例所示的輸出：

{
    "ServerSideEncryption": "AES256",
    "ETag": "\"e611693805e812ef37f96c9937605e69\"",
    "ChecksumSHA256": "QLl8R4i4+SaJlrl8ZIcutc5TbZtwt2NwB8lTXkd3GH0="
}
            

對於後續組件，請相應地遞增組件編號：

aws s3api upload-part --bucket amzn-s3-demo-bucket1 --key 'census_data_file' --part-number <part-number> --body <file-path> --upload-id "<your-upload-id>" --checksum-algorithm SHA256

例如，使用下列命令來上傳第二個組件：

aws s3api upload-part --bucket amzn-s3-demo-bucket1 --key 'census_data_file' --part-number 2 --body census-part01 --upload-id "cNV6KCSNANFZapz1LUGPC5XwUVi1n6yUoIeSP138sNOKPeMhpKQRrbT9k0ePmgoOTCj9K83T4e2Gb5hQvNoNpCKqyb8m3.oyYgQNZD6FNJLBZluOIUyRE.qM5yhDTdhz" --checksum-algorithm SHA256

Amazon S3 會傳回每個上傳組件的實體標籤 (ETag) 和額外檢查總和作為回應中的標頭。

繼續使用 upload-part 命令，直到您已上傳物件的所有組件為止。

若要產生具有所有上傳組件詳細資訊的 JSON 檔案，請使用下列 list-parts 命令。將 amzn-s3-demo-bucket1 取代為您實際的儲存貯體名稱，並將 <your-upload-id> 取代為您在步驟 3 中收到的上傳 ID。如需 list-parts 命令的詳細資訊，請參閱《AWS Command Line Interface 使用者指南》中的list-parts。

aws s3api list-parts --bucket amzn-s3-demo-bucket1 --key 'census_data_file' --upload-id <your-upload-id> --query '{Parts: Parts[*].{PartNumber: PartNumber, ETag: ETag, ChecksumSHA256: ChecksumSHA256}}' --output json > parts.json

這會產生名為 parts.json 的新檔案。該檔案包含所有上傳組件的 JSON 格式資訊。parts.json 檔案包含分段上傳之每個組件的基本資訊 (例如組件編號及其對應的 ETag 值)，完成分段上傳程序需要這些資訊。

使用任何文字編輯器或透過終端機開啟 parts.json。以下是範例輸出：

{
    "Parts": [
        {
            "PartNumber": 1,
            "ETag": "\"3c3097f89e2a2fece47ac54b243c9d97\"",
            "ChecksumSHA256": "fTPVHfyNHdv5VkR4S3EewdyioXECv7JBxN+d4FXYYTw="
        },
        {
            "PartNumber": 2,
            "ETag": "\"03c71cc160261b20ab74f6d2c476b450\"",
            "ChecksumSHA256": "VDWTa8enjOvULBAO3W2a6C+5/7ZnNjrnLApa1QVc3FE="
        },
        {
            "PartNumber": 3,
            "ETag": "\"81ae0937404429a97967dffa7eb4affb\"",
            "ChecksumSHA256": "cVVkXehUlzcwrBrXgPIM+EKQXPUvWist8mlUTCs4bg8="
        }
    ]
}
            

若要擷取上傳物件的 ETag，請執行 head-object 請求：

aws s3api head-object --bucket amzn-s3-demo-bucket1 --key census_data_file

以下是範例輸出：

{
    "AcceptRanges": "bytes",
    "LastModified": "2024-07-26T19:04:13+00:00",
    "ContentLength": 16106127360,
    "ETag": "\"f453c6dccca969c457efdf9b1361e291-3\"",
    "ContentType": "binary/octet-stream",
    "ServerSideEncryption": "AES256",
    "Metadata": {}
}
            

此 ETag 已將 "-3" 附加至結尾。這表示使用分段上傳，將物件分三個組件上傳。

接下來，使用 md5sum 命令計算每個組件的 MD5 檢查總和。請務必提供正確的組件檔案路徑：

md5sum census-part*

以下是範例輸出：

e611693805e812ef37f96c9937605e69 census-part00
63d2d5da159178785bfd6b6a5c635854 census-part01
95b87c7db852451bb38b3b44a4e6d310 census-part02
            

在此步驟中，手動將 MD5 雜湊合併為一個字串。然後，執行下列命令，將字串轉換為二進位，並計算二進位值的 MD5 檢查總和：

echo "e611693805e812ef37f96c9937605e6963d2d5da159178785bfd6b6a5c63585495b87c7db852451bb38b3b44a4e6d310" | xxd -r -p | md5sum

以下是範例輸出：

f453c6dccca969c457efdf9b1361e291 -

此雜湊值應符合步驟 1 中原始 ETag 值的雜湊值，才能驗證 census_data_file 物件的完整性。

在您的終端機中執行下列命令 (包括 --checksum-mode enabled 引數)，以顯示您物件的 ChecksumSHA256 值：

aws s3api head-object --bucket amzn-s3-demo-bucket1 --key census_data_file --checksum-mode enabled

以下是範例輸出：

{
    "AcceptRanges": "bytes",
    "LastModified": "2024-07-26T19:04:13+00:00",
    "ContentLength": 16106127360,
    "ChecksumSHA256": "aI8EoktCdotjU8Bq46DrPCxQCGuGcPIhJ51noWs6hvk=-3",
    "ETag": "\"f453c6dccca969c457efdf9b1361e291-3\"",
    "ContentType": "binary/octet-stream",
    "ServerSideEncryption": "AES256",
    "Metadata": {}
}
            

使用下列命令，將個別組件的 ChecksumSHA256 值解碼為 base64，並將其儲存在名為 outfile 的二進位檔案中。您可以在 parts.json 檔案中找到這些值。將範例 base64 字串取代為您實際的 ChecksumSHA256 值。

echo "QLl8R4i4+SaJlrl8ZIcutc5TbZtwt2NwB8lTXkd3GH0=" | base64 --decode >> outfile
echo "xCdgs1K5Bm4jWETYw/CmGYr+m6O2DcGfpckx5NVokvE=" | base64 --decode >> outfile
echo "f5wsfsa5bB+yXuwzqG1Bst91uYneqGD3CCidpb54mAo=" | base64 --decode >> outfile
            

執行下列命令來計算 outfile 的 SHA256 檢查總和：

sha256sum outfile

以下是範例輸出：

688f04a24b42768b6353c06ae3a0eb3c2c50086b8670f221279d67a16b3a86f9 outfile

在下一個步驟中，取得雜湊值並將其轉換為二進位值。此二進位值應符合步驟 1 中的 ChecksumSHA256 值。

將步驟 3 中的 SHA256 檢查總和轉換為二進位，然後將其編碼為 base64，以確認其是否符合步驟 1 中的 ChecksumSHA256 值：

echo "688f04a24b42768b6353c06ae3a0eb3c2c50086b8670f221279d67a16b3a86f9" | xxd -r -p | base64

以下是範例輸出：

aI8EoktCdotjU8Bq46DrPCxQCGuGcPIhJ51noWs6hvk=

此輸出應確認 base64 輸出符合 head-object 命令輸出中的 ChecksumSHA256 值。如果輸出符合檢查總和值，則物件有效。