Поделиться через

Управление отправками продуктов

  • Статья

Используйте следующие методы в API оборудования Майкрософт, чтобы управлять отправками продуктов и получать их подписанными корпорацией Майкрософт. Общие сведения об API оборудования Майкрософт, включая предварительные требования для использования API, см. в разделе API панели мониторинга оборудования.

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

Методы управления отправкой продуктов

Method URI Description
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} Получение состояния или данных для конкретного продукта
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId} Получение состояния или данных для определенной отправки продукта
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products Создание нового продукта
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/ Создание новой отправки для продукта
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/commit Фиксация отправки продукта

Создание и отправка продукта для подписывания

  1. Выполните все необходимые условия для API оборудования Майкрософт.

  2. Получите маркер доступа к идентификатору Microsoft Entra. Этот маркер доступа необходимо передать методам в API отправки Microsoft Store. После получения маркера доступа у вас будет 60 минут, чтобы использовать его до истечения срока действия. После истечения срока действия маркера можно получить новый.

  3. Создайте продукт , выполнив следующий метод в API оборудования Майкрософт. Этот метод создает новый продукт, который выполняется, и позволяет отправлять пакеты для этого продукта.

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

    Текст ответа содержит ресурс Product, содержащий идентификатор этого продукта.

  4. Создайте отправку для этого продукта, выполнив следующий метод в API оборудования Майкрософт. Используйте ProductID, созданный на предыдущем шаге.

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

    Текст ответа содержит ресурс отправки, содержащий идентификатор отправки, универсальный код ресурса (URI) подписанного URL-адреса (SAS) для отправки пакета продукта (драйвера) для отправки в Хранилище BLOB-объектов Azure. [! ПРИМЕЧАНИЕ. > URI SAS предоставляет доступ к защищенному ресурсу в службе хранилища Azure без необходимости использовать ключи учетной записи. Дополнительные сведения о URI SAS и их использовании с Хранилище BLOB-объектов Azure см. в статье Предоставление ограниченного доступа к ресурсам служба хранилища Azure с помощью подписанных URL-адресов (SAS).

  5. Отправьте пакет в Хранилище BLOB-объектов Azure в расположении, указанном URI SAS на предыдущем шаге. В следующем примере кода C# показано, как отправить пакет в Хранилище BLOB-объектов Azure с помощью класса BlockBlobClient в библиотеке больших двоичных объектов служба хранилища Azure для .NET. В этом примере предполагается, что пакет уже записан в объект потока.

    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. Зафиксируйте отправку продукта, выполнив следующий метод. Этот метод оповещает Центр разработки оборудования, что вы сделали с отправкой и проверкой продукта, начинается для отправки.

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

  7. Проверьте состояние фиксации, выполнив следующий метод, чтобы получить состояние отправки продукта.

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

    Чтобы подтвердить состояние отправки, просмотрите значение commitStatus в тексте ответа. Это значение должно измениться с CommitReceived на CommitComplete , если запрос выполнен успешно или на CommitFailed , если в запросе возникают ошибки.

    Примечание.

    Основная страница поиска обновляется примерно каждые 10 минут. Чтобы просмотреть все результаты при их создании, щелкните страницу списка драйверов (все) в верхней части страницы "Драйверы " Центра партнеров. Хотя страница занимает некоторое время для обработки и загрузки, если у вас много отправки, при загрузке следует указать как успешные, так и неудачные отправки. Дополнительные сведения см. в разделе "Поиск аппаратной отправки".

Пример кода

В следующем примере кода показано, как использовать API оборудования Майкрософт:

Ресурсы данных

Методы API оборудования Майкрософт для создания и управления данными продукта используют следующие ресурсы данных JSON:

См. также