GetJobUnlockCode - AWS Snowball

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

GetJobUnlockCode

Renvoie leUnlockCodevaleur de code pour la tâche spécifiée. Un particulierUnlockCodeest accessible jusqu'à 360 jours après la création de la tâche associée.

LeUnlockCodevalue est un code à 29 caractères avec 25 caractères alphanumériques et 4 tirets. Ce code est utilisé pour déchiffre le fichier manifeste lorsqu'il est passé en même temps que le manifeste à la machine Snow via le client Snowball lorsque le client est démarré pour la première fois. Le seul statut valide pour appeler cette API estWithCustomercomme le manifeste etUnlockles valeurs de code sont utilisées pour sécuriser votre appareil et ne doivent être utilisées que lorsque vous possédez l'appareil.

En tant que bonne pratique, nous vous recommandons de ne pas enregistrer de copie de laUnlockCodeau même emplacement que le fichier manifeste de cette tâche. Les enregistrer séparément empêche des tiers non autorisés d'accéder à l'appareil Snow associé à cette tâche.

Syntaxe de la demande

{ "JobId": "string" }

Paramètres de demande

Pour plus d'informations sur les paramètres communs à toutes les actions, voirParamètres courants.

Cette demande accepte les données suivantes au format JSON.

JobId

Identifiant de la tâche à laquelle vous souhaitez obtenir laUnlockCodevaleur pour, par exempleJID123e4567-e89b-12d3-a456-426655440000.

Type : Chaîne

Contraintes de longueur : Longueur fixe de 39.

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

Regatoire : Oui

Syntaxe de la réponse

{ "UnlockCode": "string" }

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

UnlockCode

LeUnlockCodepour la tâche spécifiée. LeUnlockCodeLa valeur est accessible pendant 360 jours après la création de la tâche.

Type : Chaîne

Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 1024.

Modèle : .*

Erreurs

Pour plus d'informations sur les erreurs communes à toutes les actions, voirErreurs courantes.

InvalidJobStateException

L'action ne peut pas être effectuée car l'état actuel de la tâche ne permet pas l'exécution de cette action.

HTTP Status Code : 400

InvalidResourceException

La ressource spécifiée est introuvable. Vérifiez les informations que vous avez fournies dans votre dernière demande et réessayez.

HTTP Status Code : 400

Voir aussi

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :