Mengelola Pengiriman Praprod

Gunakan metode berikut di MICROSOFT Hardware API untuk mengelola pengiriman praprod dan untuk mendapatkan paket driver Anda yang ditandatangani oleh Microsoft untuk penggunaan pengujian praproduksi. Untuk pengenalan API Perangkat Keras Microsoft, termasuk prasyarat untuk menggunakan API, lihat API dasbor perangkat keras.

https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/

Metode untuk mengelola pengiriman produk

Metode	URI	Deskripsi
TARUH	https://manage.devcenter.microsoft.com/v2.0/my/hardware/preprod/packages/	Mengirimkan paket untuk penandatanganan praprod
GET	https://manage.devcenter.microsoft.com/v2.0/my/hardware/preprod/packages/{packageId}	Mendapatkan metadata paket untuk pengiriman praprod
GET	https://manage.devcenter.microsoft.com/v2.0/my/hardware/preprod/packages/{packageId}/assets	Mendapatkan aset yang tersedia untuk pengiriman praprod
GET	https://manage.devcenter.microsoft.com/v2.0/my/hardware/preprod/packages/{packageId}/assets/{assetId}	Mendapatkan metadata aset untuk satu aset
GET	https://manage.devcenter.microsoft.com/v2.0/my/hardware/preprod/packages/{packageId}/assets/{assetId}/download	Mengunduh aset untuk pengiriman praprod tertentu

Sumber Daya Metadata Paket

ID	Pengidentifikasi unik paket
signingStatus	Belum Dimulai Sedang diproses Berhasil Gagal
Kesalahan	Kesalahan yang ditemui selama pemrosesan paket

Sumber Daya Metadata Aset

ID	Pengidentifikasi unik aset
packageID	Pengidentifikasi paket tempat aset ini berada
assetType	Jenis aset yang tersedia untuk diunduh. Nilai yang mungkin adalah: "SignedFilesZip": paket yang ditandatangani oleh Microsoft.
contentHash	Hash SHA-256 konten

Membuat dan mengirimkan produk untuk penandatanganan

1. Jika Anda belum melakukannya, selesaikan semua prasyarat untuk API Perangkat Keras Microsoft.

2. Dapatkan token akses ID Microsoft Entra. Anda harus meneruskan token akses ini ke metode di API pengiriman Microsoft Store. Setelah mendapatkan token akses, Anda memiliki waktu 60 menit untuk menggunakan token akses sebelum masa berlakunya habis. Setelah token kedaluwarsa, Anda dapat memperoleh yang baru.

3. Buat pengiriman baru dengan menjalankan metode berikut di Microsoft Hardware API. Isi permintaan harus berisi aliran paket Anda sebagai "application/octet-stream". Ini akan membuat pengiriman praprod baru yang sedang berlangsung dengan HDC. Pastikan bahwa paket masuk dengan cara yang sama seperti Yang Anda lakukan untuk pengiriman pengesahan sebelum mengunggah.

   PUT https://manage.devcenter.microsoft.com/v2.0/my/hardware/preprod/packages/
   

   Isi respons berisi id paket yang akan menjadi packageId untuk langkah berikutnya.

   {
       "id": "string",
       "etag": "string",
       "lastModified": "2022-03-28T23:31:17.014Z",
       "signingStatus": "NotStarted",
       "error": 
       {
           "message": "string"
       }
   }
   

4. Periksa status dengan menjalankan metode berikut untuk mendapatkan metadata paket.

   GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/preprod/packages/{packageId}
   

   Untuk mengonfirmasi status paket, tinjau nilai signingStatus di isi respons. Nilai ini harus berubah dari Pemrosesan menjadi Berhasil jika pengiriman berhasil, atau gagal jika ada kesalahan dalam permintaan. Jika ada kesalahan, bidang kesalahan berisi detail lebih lanjut tentang kesalahan tersebut.

   Jika signingStatusberhasil, paket yang ditandatangani harus tersedia di bidang aset.

   {
   "id": "string",
   "etag": "string",
   "lastModified": "2022-03-28T23:45:25.501Z",
   "signingStatus": "NotStarted",
   "error": {
       "message": "string"
   },
   "assets": [
       {
       "id": "string",
       "packageId": "string",
       "assetType": "string",
       "createdDate": "2022-03-28T23:45:25.501Z",
       "contentHash": "string"
       }
   ],
   "assetsContinuationToken": "string"
   }
   

5. Unduh paket yang ditandatangani sebelumnya dengan menggunakan metode berikut untuk mengunduh aset setelah penandatangananStatus Berhasil. Gunakan id untuk aset yang ditandatangani dari metadata yang diambil di langkah 4 sebagai assetId Anda dalam permintaan. Paket yang diunduh akan menyertakan file driver yang ditandatangani sebagai zip.

   GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/preprod/packages/{packageId}/assets/{assetId}/download
   

Contoh Kirim Paket untuk Kode Penandatanganan Praprod

    var httpClient = new HttpClient();
    httpClient.BaseAddress = new Uri(https://manage.devcenter.microsoft.com/v2.0/my/hardware/);
    httpClient.DefaultRequestHeaders.Accept.Clear();
    httpClient.DefaultRequestHeaders.Accept.Add(
        new MediaTypeWithQualityHeaderValue("*/*"));

    httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("bearer", token);

    var driverPackage = File.ReadAllBytes(@"C:\cabfile.cab");
    Task<HttpResponseMessage> response = httpClient.PutAsync("preprod/packages", new ByteArrayContent(driverPackage));
    var jsonResponse = response.Result.Content.ReadFromJsonAsync<object>().Result as JsonElement?;
    var packageId = jsonResponse?.GetProperty("id").ToString();