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. Se non è già stato fatto, 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. In questo modo si crea un nuovo prodotto in corso e si 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 SAS e sul relativo utilizzo con Archiviazione BLOB di Azure, vedere Firme di accesso condiviso, parte 1: comprensione del modello SAS e Firme di accesso condiviso, parte 2: creare e usare una firma di accesso condiviso con l'archiviazione BLOB.

  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 CloudBlockBlob nella libreria client Archiviazione di Azure per .NET. In questo esempio si presuppone che il pacchetto sia già stato scritto in un oggetto flusso.

    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. Eseguire il commit dell'invio del prodotto eseguendo il metodo seguente. In questo modo, Hardware Dev Center segnala che l'invio e la convalida del prodotto verranno avviati 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.

Esempi di codice

Gli esempi di codice seguenti illustrano 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