GetJobUnlockCode - AWS Snowball
Sintaks PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

GetJobUnlockCode

Mengembalikan nilai kode UnlockCode untuk Tugas yang ditentukan. Sebuah nilai UnlockCode tertentu dapat diakses hingga 360 hari setelah Tugas terkait telah dibuat.

Nilai UnlockCode adalah kode 29-karakter dengan 25 karakter alfanumerik dan 4 tanda hubung. Kode ini digunakan untuk mendekripsi file manifes ketika dilewatkan bersama dengan manifes ke perangkat Snow melalui klien Snowball ketika klien dimulai untuk pertama kalinya. Satu-satunya status valid untuk memanggil API ini adalah WithCustomer karena manifes dan nilai Unlock kode digunakan untuk mengamankan perangkat Anda dan hanya boleh digunakan saat Anda memiliki perangkat.

Sebagai praktik terbaik, kami rekomendasikan Anda tidak menyimpan salinan UnlockCode di lokasi yang sama dengan file manifes untuk Tugas itu. Menyimpan ini secara terpisah membantu mencegah pihak yang tidak berwenang mendapatkan akses ke perangkat Snow yang terkait dengan Tugas tersebut.

Sintaks Permintaan

{
   "JobId": "string"
}

Parameter Permintaan

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.

Permintaan menerima data berikut dalam format JSON.

JobId

ID untuk Tugas yang ingin Anda beri nilai UnlockCode, misalnya JID123e4567-e89b-12d3-a456-426655440000.

Tipe: String

Batas Panjang: Panjang tetap 39.

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

Diperlukan: Ya

Sintaksis Respons

{
   "UnlockCode": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

UnlockCode

Nilai UnlockCode untuk Tugas yang ditentukan. Nilai UnlockCode dapat diakses hingga 360 hari setelah Tugas telah dibuat.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024.

Pola: .*

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

InvalidJobStateException

Tindakan tidak dapat dilakukan karena status Tugas saat ini tidak memungkinkan tindakan untuk dilakukan.

Kode Status HTTP: 400

InvalidResourceException

Sumber daya yang ditentukan tidak dapat ditemukan. Periksa informasi yang Anda berikan dalam permintaan terakhir Anda, dan coba lagi.

Kode Status HTTP: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: