Condividi tramite

Gestire gli invii di prodotti

  • Articolo

Usare i metodi seguenti nelle API hardware Microsoft per gestire gli invii per i prodotti e per ottenere la firma da Microsoft. Per un'introduzione alle API hardware Microsoft, inclusi i prerequisiti per l'uso dell'API, vedere API del dashboard hardware.

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

Metodi per la gestione degli invii di prodotti

Method URI Descrizione
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} Ottenere lo stato/i dati per un prodotto specifico
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId} Ottenere lo stato/i dati per un invio specifico di un prodotto
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products Creare un nuovo prodotto
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/ Creare un nuovo invio per un prodotto
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/commit Confermare un invio di prodotto

Creare e inviare un prodotto per la firma

  1. Completare tutti i prerequisiti per le API hardware Microsoft.

  2. Ottenere un token di accesso microsoft Entra ID. Devi passare questo token di accesso ai metodi nell'API di invio di Microsoft Store. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.

  3. Creare un nuovo prodotto eseguendo il metodo seguente nell'API Hardware Microsoft. Questo metodo crea un nuovo prodotto in corso e consente di inviare pacchetti per questo prodotto.

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

    Il corpo della risposta contiene una risorsa Product che include l'ID di questo prodotto.

  4. Creare un invio per questo prodotto eseguendo il metodo seguente nell'API Hardware Microsoft. Usare l'ID prodotto creato nel passaggio precedente.

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

    Il corpo della risposta contiene una risorsa invio che include l'ID dell'invio, l'URI della firma di accesso condiviso (SAS) per caricare il pacchetto del prodotto (driver) per l'invio a Archiviazione BLOB di Azure. [! NOTA] > Un URI di firma di accesso condiviso fornisce l'accesso a una risorsa sicura nell'archiviazione di Azure senza richiedere chiavi dell'account. Per informazioni di base sugli URI di firma di accesso condiviso e sul relativo uso con Archiviazione BLOB di Azure, vedere Concedere l'accesso limitato alle risorse Archiviazione di Azure usando firme di accesso condiviso.For background information about SAS URIs and their use with Archiviazione BLOB di Azure, see Grant limited access to Archiviazione di Azure resources using shared access signatures (SAS).

  5. Caricare il pacchetto nel Archiviazione BLOB di Azure nel percorso specificato dall'URI di firma di accesso condiviso nel passaggio precedente. L'esempio di codice C# seguente illustra come caricare un pacchetto in Archiviazione BLOB di Azure usando la classe BlockBlobClient nella libreria BLOB di Archiviazione di Azure per .NET. In questo esempio si presuppone che il pacchetto sia già scritto in un oggetto flusso.

    string sasUrl = "<SAS URL from Hardware API>";
Azure.Storage.Blobs.Specialized.BlockBlobClient blockBlobClient =
    new Azure.Storage.Blobs.Specialized.BlockBlobClient(new System.Uri(sasUrl));
string filePath = "<Path to HLK package>";
using (FileStream fileStream = File.OpenRead(filePath))
{ 
    await blockBlobClient.UploadAsync(fileStream);
}

  6. Eseguire il commit dell'invio del prodotto eseguendo il metodo seguente. Questo metodo avvisa Hardware Dev Center che hai finito con l'invio e la convalida del prodotto inizia per l'invio.

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

  7. Controllare lo stato del commit eseguendo il metodo seguente per ottenere lo stato dell'invio del prodotto.

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

    Per confermare lo stato dell'invio, esaminare il valore commitStatus nel corpo della risposta. Questo valore deve passare da CommitReceived a CommitComplete se la richiesta ha esito positivo o a CommitFailed in caso di errori nella richiesta.

    Nota

    La pagina di ricerca principale viene aggiornata circa ogni 10 minuti. Per visualizzare tutti i risultati durante la creazione, fare clic su Pagina elenco driver (tutto) nella parte superiore della pagina Driver del Centro per i partner. Anche se la pagina richiede tempo per elaborare e caricare se si dispone di un sacco di invii, gli invii riusciti e non riusciti devono essere elencati quando viene caricato. Per altre info, vedi Trovare un invio hardware.

Esempio di codice

L'esempio di codice seguente illustra come usare l'API Hardware Microsoft:

Risorse dati

I metodi delle API Hardware Microsoft per la creazione e la gestione dei dati dei prodotti usano le risorse dati JSON seguenti:

Vedi anche