GetJobUnlockCode - AWS Snowball
AnforderungssyntaxAnfrageparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

GetJobUnlockCode

Gibt den neuen zurückUnlockCodeCode-Wert für den angegebenen Auftrag Ein bestimmtesUnlockCode-Wert kann bis zu 360 Tage lang zugegriffen werden, nachdem der zugehörige Job erstellt wurde.

DieUnlockCodeWert ist 29 Zeichen lang; er besteht aus 25 alphanumerischen Zeichen und 4 Bindestrichen. Das Manifest wird beim ersten Start des Clients mit diesem Code verwendet, um die Manifestdatei zu entschlüsseln, wenn Manifest und Code über den Snowball-Cliance an die Snow-Appliance übergeben werden. Der einzig gültige Status für den Aufruf dieser API istWithCustomerwie Manifest undUnlockCodewerte werden zum Sichern Ihres Geräts verwendet und sollten nur verwendet werden, wenn Sie das Gerät haben.

Als bewährte Methode empfehlen wir, dass Sie keine Kopie desUnlockCodeam selben Speicherort wie die Manifestdatei für diesen Job. Wenn beides getrennt voneinander gespeichert wird, lässt sich besser verhindern, dass nicht autorisierte Parteien Zugriff auf das Snow-Gerät erlangen, das mit diesem Auftrag verknüpft ist.

Anforderungssyntax

{
   "JobId": "string"
}

Anfrageparameter

Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unterGeläufige Parameteraus.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

JobId

Die ID für den Auftrag, den Sie den Auftrag abrufen wollenUnlockCodevalue für zum BeispielJID123e4567-e89b-12d3-a456-426655440000aus.

Type: String (Zeichenfolge)

Längenbeschränkungen: Feste Länge von 39.

Pattern: (M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Erforderlich: Ja

Antwortsyntax

{
   "UnlockCode": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

UnlockCode

DieUnlockCodeWert für den angegebenen Auftrag DieUnlockCodeDer Wert kann bis zu 360 Tage lang zugegriffen werden, nachdem der Auftrag erstellt wurde.

Type: String (Zeichenfolge)

Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 1024 Zeichen.

Pattern: .*

Fehler

Informationen zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehleraus.

InvalidJobStateException

Die Aktion kann nicht ausgeführt werden, da der aktuelle Status des Jobs die Ausführung dieser Aktion nicht zulässt.

HTTP-Statuscode: 400

InvalidResourceException

Die angegebene Ressource kann nicht gefunden werden. Überprüfen Sie die Informationen, die Sie in Ihrer letzten Anfrage angegeben haben, und versuchen Sie es erneut.

HTTP-Statuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: