Erhalten von Prüfsummen bei Daten-Download

Beim Abrufen eines Archivs mit der „Initiate Job“-API (Informationen unter Job initiieren (POSTJobs)) können Sie optional einen abzurufenden Bereich des Archivs angeben. Beim Abrufen eines Archivs mit der „Get Job Output“-API (Informationen unter Get Job Output (GET output)) können Sie optional einen abzurufenden Bereich des Archivs angeben. Es ist wichtig, dass Sie zwei Merkmale dieser Bereiche verstehen, wenn Sie Ihre Archivdaten abrufen und herunterladen. Der abzurufende Bereich muss durch Megabytewerte auf das Archiv beziehen. Sowohl der abzurufende als auch der herunterzuladende Bereich muss sich durch Struktur-Hash-Werte zuordnen lassen, um die Werte der Prüfsumme zu erhalten, wenn Sie Ihre Daten herunterladen. Die beiden Typen der Bereichszuordnung werden wie folgt definiert:

• Auf Megabyte ausgerichtet — Ein Bereich [StartByte, EndBytes] ist auf Megabyte (1024*1024) ausgerichtet, wenn er durch 1 MB teilbar StartBytesist und EndBytesplus 1 durch 1 MB teilbar ist oder dem Ende des angegebenen Archivs entspricht (Archivbytegröße minus 1). Ein in der „Initiate Job“-API verwendeter Bereich, sofern angegeben, muss durch Megabytewerte zugeordnet sein.

• Tree-Hash Aligned — Ein Bereich [StartBytes, EndBytes] ist ein Baumhash, der in Bezug auf ein Archiv ausgerichtet ist, genau dann, wenn die Wurzel des über den Bereich erstellten Baum-Hashes einem Knoten im Baumhash des gesamten Archivs entspricht. Sowohl der abzurufende als auch der herunterzuladende Bereich muss durch Struktur-Hash-Werte zugeordnet sein, um die Werte der Prüfsumme für Ihre heruntergeladenen Daten zu erhalten. Ein Beispiel für Bereiche und deren Beziehungen zum Archiv-Struktur-Hash finden Sie unter Struktur-Hash-Beispiel: Abrufen eines durch Struktur-Hash-Werte zugeordneten Archivbereichs.

  Beachten Sie, dass ein durch Struktur-Hash-Werte zugeordneter Bereich zudem durch Megabyte-Werte zugeordnet ist. Ein durch Megabyte-Werte zugeordneter Bereich ist allerdings nicht notwendigerweise durch Struktur-Hash-Werte zugeordnet.

Mit den folgenden Fällen wird beschreiben, wann Sie beim Download Ihrer Archivdaten einen Prüfsummenwert erhalten:

• Wenn Sie in der „Initiate Job“-Anfrage keinen abzurufenden Bereich angeben und das gesamte Archiv in der „Get Job“-Anfrage herunterladen.

• Wenn Sie in der „Initiate Job“-Anfrage keinen abzurufenden Bereich angeben und einen durch Struktur-Hash-Werte zugeordneten Bereich zum Download in der „Get Job“-Anfrage angeben.

• Wenn Sie in der „Initiate Job“-Anfrage keinen durch Struktur-Hash-Werte zugeordneten Bereich angeben und den gesamten Bereich in der „Get Job“-Anfrage herunterladen.

• Wenn Sie in der „Initiate Job“-Anfrage einen durch Struktur-Hash-Werte zugeordneten Bereich angeben und einen durch Struktur-Hash-Werte zugeordneten Bereich zum Download in der „Get Job“-Anfrage angeben.

Wenn Sie einen abzurufenden Bereich in der „Initiate Job“-Anfrage angeben, der nicht auf ein Struktur-Hash bezogen ist, dann können Sie Ihre Archivdaten dennoch abrufen, aber es werden keine Prüfsummenwerte zurückgegeben, wenn Sie die Daten in der „Get Job“-Anfrage herunterladen.

Struktur-Hash-Beispiel: Abrufen eines durch Struktur-Hash-Werte zugeordneten Archivbereichs

Angenommen, es ist ein 6,5 MB großes Archiv in Ihrem Tresor vorhanden und Sie möchten 2 MB des Archivs abrufen. Wie Sie den 2-MB-Bereich in der „Initiate Job“-Anfrage angeben, bestimmt, ob Sie beim Download der Daten Prüfsummenwerte für die Daten erhalten. Im folgenden Diagramm werden zwei 2 MB große Bereiche für 6,5 MB große Archive dargestellt, die heruntergeladen werden können. Beide Bereiche sind durch Megabyte-Werte zugeordnet, aber nur eins ist durch Struktur-Hash-Werte zugeordnet.

Durch Struktur-Hash-Werte zugeordnet Bereichsangabe

In diesem Abschnitt wird genau angegeben, was einen durch Struktur-Hash-Werte zugeordneten Bereich ausmacht. Durch Struktur-Hash-Werte zugeordnete Bereiche sind wichtig, wenn Sie einen Teil eines Archivs herunterladen und Sie den abzurufenden Datenbereich und den herunterzuladenden Bereich aus den abgerufenen Daten angeben. Wenn diese beiden Bereiche durch Struktur-Hash-Werte zugeordnet sind, erhalten Sie beim Download der Daten Prüfsummendaten.

Ein Bereich [A, B] gilt nur dann hinsichtlich eines Archiv als durch Struktur-Hash-Werte zugeordnet, wenn ein neuer Struktur-Hash über [A, B] des Stamm des für den Bereich erstellten Struktur-Hashs einem Knoten in dem Struktur-Hash des gesamten Archivs entspricht. Dies wird im Diagramm in Struktur-Hash-Beispiel: Abrufen eines durch Struktur-Hash-Werte zugeordneten Archivbereichs verdeutlicht. In diesem Abschnitt werden die Angaben für Struktur-Hash-Zuordnung bereitgestellt.

Beachten Sie [P, Q] als die Bereichsabfrage für ein Archiv von N Megabyte (MB). Wobei P sowie Q Mehrfache eines MB sind. Beachten Sie, dass der tatsächliche eingeschlossene Bereich [P MB, Q MB - 1 Byte] ist. Zur Vereinfachung zeigen wir dies allerdings als [P, Q]. Demnach ergibt sich Folgendes:

• Wenn P eine ungerade Zahl ist, gibt es nur einen möglichen Bereich, der dem Struktur-Hash zugeordnet ist, nämlich [P, P + 1 MB).

• Wenn P eine gerade Zahl und k die der Maximalwert ist, wobei P als 2k * X geschrieben werden kann, dann sind höchstens k dem Struktur-Hash-Werte zugeordnete Bereiche möglich, die mit P beginnen. X ist eine Ganzzahl größer 0. Die durch Struktur-Hash-Werte zugeordneten Bereiche fallen in folgende Kategorien:

  • Für jedes i, wobei (0 <= i <= k) ist und P + 2ⁱ < N ist, dann ist [P, Q + 2ⁱ] ein durch Struktur-Hash-Werte zugeordneter Bereich.

  • P = 0 ist ein besonderer Fall, bei dem A = 2[lgN]*0 ist.