使用 EBS Direct 寫入 Amazon EBS快照 APIs

下列步驟說明如何使用 EBS 直接APIs寫入增量快照：

使用 StartSnapshot 動作並指定父項快照 ID 以啟動快照作為現有快照的增量快照，或省略父項快照 ID 以啟動新的快照。此動作會傳回新的快照 ID，此 ID 處於待定狀態。
使用 PutSnapshotBlock 動作並指定待處理快照的 ID，以個別區塊的形式將資料新增至該快照。您必須為傳輸的資料區塊指定 Base64-encodedSHA256檢查總和。服務會運算所接收資料的檢查總和，並使用您指定的檢查總和進行驗證。如果檢查總和不相符，該動作就會失敗。
當您完成將資料新增至待定快照時，請使用 CompleteSnapshot動作啟動非同步工作流程，以密封快照並將其移至已完成狀態。

重複這些步驟，以使用先前建立的快照做為父系快照來建立新的增量快照。

例如，在下圖中，快照 A 是第一個啟動的新快照。系統將快照 A 作為啟動快照 B 的父系快照。將快照 B 作為啟動和建立快照的父系快照 C。快照 A、B 和 C 是增量快照。快照 A 用於建立EBS磁碟區 1。快照 D 是從EBS磁碟區 1 建立。快照 D 是 A 的增量快照；它不是 B 或 C 的增量快照。

下列範例示範如何使用 EBS Direct 撰寫快照APIs。

啟動快照

AWS CLI

下列 start-snapshot 範例命令會啟動 8 GiB 快照，並使用快照 snap-123EXAMPLE1234567 做為父系快照。新快照將是父系快照的增量快照。如果在指定的 60 分鐘逾時期間內沒有對快照提出放置或完成請求，則快照會移至錯誤狀態。550e8400-e29b-41d4-a716-446655440000 用戶端字符會確保請求的冪等性。如果省略用戶端權杖， AWS SDK會自動為您產生一個權杖。如需取得冪等性的詳細資訊，請參閱確保請求中的 StartSnapshot API意識模糊。


aws ebs start-snapshot --volume-size 8 --parent-snapshot snap-123EXAMPLE1234567 --timeout 60 --client-token 550e8400-e29b-41d4-a716-446655440000

下列針對先前命令的回應範例顯示快照 ID、 AWS 帳戶 ID、狀態、以 GiB 為單位的磁碟區大小，以及快照中區塊的大小。快照會以 pending 狀態啟動。在後續 put-snapshot-block 命令中指定快照 ID，將資料寫入快照，然後使用 complete-snapshot 命令完成快照並將其狀態變更為 completed。


{
    "SnapshotId": "snap-0aaEXAMPLEe306d62",
    "OwnerId": "111122223333",
    "Status": "pending",
    "VolumeSize": 8,
    "BlockSize": 524288
}

AWS API

下列StartSnapshot範例請求會啟動 8 GiB 快照，使用快照snap-123EXAMPLE1234567作為父快照。新快照將是父系快照的增量快照。如果在指定的 60 分鐘逾時期間內沒有對快照提出放置或完成請求，則快照會移至錯誤狀態。550e8400-e29b-41d4-a716-446655440000 用戶端字符會確保請求的冪等性。如果省略用戶端權杖， AWS SDK會自動為您產生一個權杖。如需取得冪等性的詳細資訊，請參閱確保請求中的 StartSnapshot API意識模糊。


POST /snapshots HTTP/1.1
Host: ebs.us-east-2.amazonaws.com
Accept-Encoding: identity
User-Agent: <User agent parameter>
X-Amz-Date: 20200618T040724Z
Authorization: <Authentication parameter>

{
    "VolumeSize": 8,
    "ParentSnapshot": snap-123EXAMPLE1234567,
    "ClientToken": "550e8400-e29b-41d4-a716-446655440000",
    "Timeout": 60
}

以下針對先前請求的範例回應顯示快照 ID、 AWS 帳戶 ID、狀態、以 GiB 為單位的磁碟區大小，以及快照中的區塊大小。快照會以待定狀態啟動。在後續 PutSnapshotBlocks 請求中指定快照 ID，以便將資料寫入快照。


HTTP/1.1 201 Created
x-amzn-RequestId: 929e6eb9-7183-405a-9502-5b7da37c1b18
Content-Type: application/json
Content-Length: 181
Date: Thu, 18 Jun 2020 04:07:29 GMT
Connection: keep-alive

{
    "BlockSize": 524288,
    "Description": null,
    "OwnerId": "138695307491",
    "Progress": null,
    "SnapshotId": "snap-052EXAMPLEc85d8dd",
    "StartTime": null,
    "Status": "pending",
    "Tags": null,
    "VolumeSize": 8
}

將資料放入快照中

AWS CLI

下列 put-snapshot 範例命令會寫入資料 524288 位元組來封鎖 1000 快照上的索引 snap-0aaEXAMPLEe306d62。Base64 編碼的 QOD3gmEQOXATfJx2Aa34W4FU2nZGyXfqtsUuktOw8DM= 檢查總和是使用 SHA256 演算法產生的。傳輸的資料位於 /tmp/data 檔案中。


aws ebs put-snapshot-block --snapshot-id snap-0aaEXAMPLEe306d62 --block-index 1000 --data-length 524288 --block-data /tmp/data --checksum QOD3gmEQOXATfJx2Aa34W4FU2nZGyXfqtsUuktOw8DM= --checksum-algorithm SHA256

前一個命令的下列範例回應會針對服務接收的資料，確認資料長度、檢查總和演算法。


{
    "DataLength": "524288",
    "Checksum": "QOD3gmEQOXATfJx2Aa34W4FU2nZGyXfqtsUuktOw8DM=",
    "ChecksumAlgorithm": "SHA256"
}

AWS API

下列PutSnapshot範例請求會寫入資料524288位元組，以封鎖快照 1000上的索引snap-052EXAMPLEc85d8dd。Base64 編碼的 QOD3gmEQOXATfJx2Aa34W4FU2nZGyXfqtsUuktOw8DM= 檢查總和是使用 SHA256 演算法產生的。資料會在請求的內文中傳輸，並表示為 BlockData 在以下範例中。


PUT /snapshots/snap-052EXAMPLEc85d8dd/blocks/1000 HTTP/1.1
Host: ebs.us-east-2.amazonaws.com
Accept-Encoding: identity
x-amz-Data-Length: 524288
x-amz-Checksum: QOD3gmEQOXATfJx2Aa34W4FU2nZGyXfqtsUuktOw8DM=
x-amz-Checksum-Algorithm: SHA256
User-Agent: <User agent parameter>
X-Amz-Date: 20200618T042215Z
X-Amz-Content-SHA256: UNSIGNED-PAYLOAD
Authorization: <Authentication parameter>
          
          BlockData

以下是先前請求的範例回應，可確認服務所接收之資料的資料長度、檢查總和以及檢查總和演算法。


HTTP/1.1 201 Created
x-amzn-RequestId: 643ac797-7e0c-4ad0-8417-97b77b43c57b
x-amz-Checksum: QOD3gmEQOXATfJx2Aa34W4FU2nZGyXfqtsUuktOw8DM=
x-amz-Checksum-Algorithm: SHA256
Content-Type: application/json
Content-Length: 2
Date: Thu, 18 Jun 2020 04:22:12 GMT
Connection: keep-alive

{}

完成快照

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

讀取快照

加密結果