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

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

使用 upload-part命令來上傳分段上傳的每個部分。與步驟 3 中create-multipart-upload命令建立的輸出中的--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 命令的詳細資訊，請參閱 list-parts (在 AWS Command Line Interface 使用者指南中)

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
            

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

sha256sum outfile

以下是輸出範例：

688f04a24b42768b6353c06ae3a0eb3c2c50086b8670f221279d67a16b3a86f9 outfile

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

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

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

以下是輸出範例：

aI8EoktCdotjU8Bq46DrPCxQCGuGcPIhJ51noWs6hvk=

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