Share via

Mengelola Pengiriman Produk

  • Artikel

Gunakan metode berikut di API Perangkat Keras Microsoft untuk mengelola pengiriman produk Anda dan untuk menandatanganinya oleh Microsoft. 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
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} Mendapatkan status/data untuk produk tertentu
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId} Mendapatkan status/data untuk pengiriman produk tertentu
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products Membuat produk baru
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/ Membuat pengiriman baru untuk produk
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/commit Menerapkan pengiriman produk

Membuat dan mengirimkan produk untuk ditandatangani

  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 menggunakannya sebelum masa berlakunya habis. Setelah token kedaluwarsa, Anda dapat memperoleh yang baru.

  3. Buat produk baru dengan menjalankan metode berikut di MICROSOFT Hardware API. Ini membuat produk baru yang sedang berlangsung dan memungkinkan Anda mengirimkan paket untuk produk ini.

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

    Isi respons berisi sumber daya Produk yang menyertakan ID produk ini.

  4. Buat pengiriman untuk produk ini dengan menjalankan metode berikut di API Perangkat Keras Microsoft. Gunakan ProductID yang dibuat pada langkah di atas.

    https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/

    Isi respons berisi sumber daya Pengiriman yang mencakup ID pengiriman, URI tanda tangan akses bersama (SAS) untuk mengunggah paket produk (driver) untuk pengiriman ke Azure Blob Storage. [! CATATAN] > SAS URI menyediakan akses ke sumber daya aman di penyimpanan Azure tanpa memerlukan kunci akun. Untuk informasi latar belakang tentang URI SAS dan penggunaannya dengan Azure Blob Storage, lihat Tanda Tangan Akses Bersama, Bagian 1: Memahami model SAS dan Tanda Tangan Akses Bersama, Bagian 2: Membuat dan menggunakan SAS dengan penyimpanan Blob .

  5. Unggah paket Anda ke Azure Blob Storage di lokasi yang ditentukan oleh SAS URI di langkah sebelumnya. Contoh kode C# berikut menunjukkan cara mengunggah paket ke Azure Blob Storage menggunakan kelas CloudBlockBlob di Pustaka Klien Azure Storage untuk .NET. Contoh ini mengasumsikan bahwa paket telah ditulis ke objek stream.

    string sasUrl = "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl";
Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob blockBob =
    new Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob(new System.Uri(sasUrl));
await blockBob.UploadFromStreamAsync(stream);

  6. Terapkan pengiriman produk dengan menjalankan metode berikut. Ini akan memperingatkan Hardware Dev Center bahwa Anda selesai dengan pengiriman produk anda dan validasi akan dimulai untuk pengiriman.

    https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/commit

  7. Periksa status penerapan dengan menjalankan metode berikut untuk mendapatkan status pengiriman produk.

    https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}

    Untuk mengonfirmasi status pengiriman, tinjau nilai commitStatus di isi respons. Nilai ini harus berubah dari CommitReceived menjadi CommitComplete jika permintaan berhasil atau ke CommitFailed jika ada kesalahan dalam permintaan.

    Catatan

    Halaman Pencarian utama di-refresh setiap 10 menit. Untuk menampilkan semua hasil saat Anda membuatnya, klik Halaman Daftar Driver (semua), di bagian atas halaman Driver Pusat Mitra. Meskipun halaman membutuhkan waktu untuk memproses dan memuat jika Anda memiliki banyak pengiriman, pengiriman yang berhasil dan tidak berhasil harus dicantumkan ketika dimuat. Untuk informasi selengkapnya, lihat Menemukan pengiriman perangkat keras.

Contoh kode

Contoh kode berikut menunjukkan cara menggunakan API Perangkat Keras Microsoft:

Sumber daya data

Metode API Perangkat Keras Microsoft untuk membuat dan mengelola data produk menggunakan sumber daya data JSON berikut:

Lihat juga