Zarządzanie przesyłaniem produktów

Użyj następujących metod w interfejsach API sprzętu firmy Microsoft , aby zarządzać przesyłaniem produktów i uzyskiwaniem ich podpisanych przez firmę Microsoft. Aby zapoznać się z wprowadzeniem do interfejsów API Microsoft Hardware, w tym z wymaganiami wstępnymi dotyczącymi korzystania z API, sprawdź Interfejs API pulpitu nawigacyjnego sprzętu.

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

Metody zarządzania przesyłaniem produktów

Tworzenie i przesyłanie produktu do podpisywania

1. Spełnij wszystkie wymagania wstępne dotyczące interfejsów API sprzętu firmy Microsoft.

2. Uzyskaj token dostępu Microsoft Entra ID. Aby korzystać z metod w interfejsie API przesyłania sklepu Microsoft Store, należy przekazać ten token dostępu. Po uzyskaniu tokenu dostępu należy 60 minut używać go przed jego wygaśnięciem. Po wygaśnięciu tokenu można uzyskać nowy.

3. Utwórz nowy produkt, wykonując następującą metodę w interfejsie API sprzętu firmy Microsoft. Ta metoda tworzy nowy produkt w toku i umożliwia przesyłanie pakietów dla tego produktu.

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

   Treść odpowiedzi zawiera zasób Produkt, który zawiera identyfikator tego produktu.

4. Złóż zgłoszenie dla tego produktu, wykonując następującą metodę w API sprzętu Microsoftu. Użyj identyfikatora ProductID utworzonego w poprzednim kroku.

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

   Treść odpowiedzi zawiera zasób przesyłania , który zawiera identyfikator przesyłania, identyfikator URI sygnatury dostępu współdzielonego (SAS) do przekazywania pakietu produktu (sterownika) na potrzeby przesyłania do usługi Azure Blob Storage.

   Uwaga / Notatka

   URI SAS zapewnia dostęp do bezpiecznego zasobu w usłudze Azure Storage bez konieczności używania kluczy kont. Aby uzyskać podstawowe informacje o identyfikatorach URI sygnatur dostępu współdzielonego i ich użyciu z usługą Azure Blob Storage, zobacz Udzielanie ograniczonego dostępu do zasobów usługi Azure Storage przy użyciu sygnatur dostępu współdzielonego (SAS).

5. Prześlij swój pakiet do usługi Azure Blob Storage w lokalizacji określonej przez SAS URI w poprzednim kroku. W poniższym przykładzie kodu w języku C# pokazano, jak przekazać pakiet do usługi Azure Blob Storage przy użyciu klasy BlockBlobClient w bibliotece obiektów blob usługi Azure Storage dla platformy .NET. W tym przykładzie przyjęto założenie, że pakiet jest już zapisywany w obiekcie strumienia.

   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. Zatwierdź przesyłanie produktu , wykonując następującą metodę. Ta metoda powiadamia Centrum deweloperów sprzętu, że zakończyłeś zgłoszenie produktu, i wtedy rozpoczyna się walidacja.

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

7. Sprawdź stan zatwierdzenia, wykonując następującą metodę, aby uzyskać stan przesyłania produktu.

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

   Aby potwierdzić stan przesyłania, przejrzyj wartość commitStatus w treści odpowiedzi. Ta wartość powinna ulec zmianie z CommitReceived na CommitComplete, jeśli żądanie zakończy się powodzeniem lub na CommitFailed, jeśli występują błędy w żądaniu.

   Uwaga / Notatka

   Strona główna Wyszukiwanie jest odświeżona co około 10 minut. Aby wyświetlić wszystkie wyniki podczas ich tworzenia, kliknij pozycję Strona listy sterowników (wszystkie), w górnej części strony Sterowniki Centrum partnerskiego. Chociaż przetwarzanie i ładowanie strony zajmuje trochę czasu, jeśli masz wiele zgłoszeń, zarówno pomyślne, jak i nieudane zgłoszenia powinny być wyświetlone po załadowaniu strony. Aby uzyskać więcej informacji, zobacz Znajdź przesłanie sprzętu.

Przykład kodu

W poniższym przykładzie kodu pokazano, jak używać interfejsu API sprzętu firmy Microsoft:

• Przykład w języku C#

Zasoby danych

Metody interfejsów API sprzętu firmy Microsoft do tworzenia danych produktów i zarządzania nimi korzystają z następujących zasobów danych JSON:

• Zasób produktu
• Zasób przesyłania

Zobacz także

• Przykładowe interfejsy API pulpitu nawigacyjnego sprzętu (GitHub)