Partager via

Gérer les soumissions préprodées

  • Article

Utilisez les méthodes suivantes dans APIs Microsoft Hardware pour gérer les soumissions preprod et pour obtenir la signature de vos packages de pilotes par Microsoft pour les tests de préproduction. Pour une introduction aux Microsoft Hardware APIs, y compris les conditions préalables à l’utilisation de l’API, veuillez consulter API de tableau de bord matériel.

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

Méthodes pour gérer les soumissions de produits.

Method URI Description
PUT https://manage.devcenter.microsoft.com/v2.0/my/hardware/preprod/packages/ Soumettre un package pour la signature preprod.
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/preprod/packages/{packageId} Obtenez les métadonnées du package pour une soumission preprod.
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/preprod/packages/{packageId}/assets Obtenez les actifs disponibles pour une soumission preprod.
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/preprod/packages/{packageId}/assets/{assetId} Obtenez les métadonnées d’un actif unique.
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/preprod/packages/{packageId}/assets/{assetId}/download Téléchargez un actif pour une soumission preprod donnée.

Ressource des métadonnées de package.

id Identifiant unique du package.
signingStatus
  • NotStarted
  • Processing
  • Opération réussie
  • Échec
Erreur Erreurs rencontrées lors du traitement du package.

Ressource des métadonnées d’actif.

id Identifiant unique de l’actif.
packageID Identifiant du package auquel cet actif appartient.
assetType Le type d’actif disponible au téléchargement. Les valeurs possibles sont les suivantes :
  • « SignedFilesZip » : package signé par Microsoft.
contentHash SHA-256 hash du contenu.

Créez et soumettez un produit pour signature.

  1. Si vous ne l’avez pas encore fait, complétez tous les prérequis pour les APIS Microsoft Hardware.

  2. Obtenez un token d’accès Microsoft Entra ID. Vous devez transmettre ce jeton d’accès aux méthodes dans l’API de soumission au Microsoft Store. Une fois que vous avez récupéré le jeton d’accès, vous avez 60 minutes pour l’utiliser avant qu’il n’expire. Une fois le jeton expiré, vous pouvez en obtenir un nouveau.

  3. Créez une nouvelle soumission en exécutant la méthode suivante dans l’API Microsoft Hardware. Le corps de la demande doit contenir votre flux de package comme « application/octet-stream ». Cela créera une nouvelle soumission preprod en cours avec HDC. Assurez-vous que le package est signé de la même manière que pour les soumissions d’attestation avant de le télécharger.

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

    Le corps de la réponse contient l’id du package qui sera le packageId pour les étapes suivantes.

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

  4. Vérifiez l’état en exécutant la méthode suivante pour obtenir les métadonnées du package.

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

    Pour confirmer l’état du package, consultez la valeur signingStatus dans le corps de la réponse. Cette valeur devrait passer de Processing à Succeeded si la soumission réussit, ou à Failed s’il y a des erreurs dans la demande. S’il y a des erreurs, le champ error contient plus de détails sur l’erreur.

    Si le signingStatus est Succeeded, un package signé devrait être disponible dans le champ assets.

    {
"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. Téléchargez votre package signé preprod en utilisant la méthode suivante pour télécharger un actif une fois que le signingStatus est Succeeded. Utilisez l’id de l’actif signé provenant des métadonnées récupérées à l’étape 4 comme assetId dans la demande. Le package téléchargé comprendra les fichiers de pilotes signés sous forme de zip.

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

Exemple de code pour soumettre un package pour la signature Preprod

    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();