제품 제출 관리

Microsoft 하드웨어 API에서 다음 방법을 사용하여 제품에 대한 제출을 관리하고 Microsoft에서 서명하도록 합니다. API를 사용하기 위한 필수 구성 요소를 포함하여 Microsoft 하드웨어 API에 대한 소개는 하드웨어 대시보드 API를 참조하세요.

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

제품 제출을 관리하는 방법

서명할 제품 만들기 및 제출

1. Microsoft 하드웨어 API 에 대한 모든 필수 구성 요소를 완료합니다.

2. Microsoft Entra ID 액세스 토큰을 가져옵니다. Microsoft Store 제출 API의 메서드에 이 액세스 토큰을 전달해야 합니다. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.

3. Microsoft 하드웨어 API에서 다음 메서드를 실행하여 새 제품을 만듭니다. 이 메서드는 진행 중인 새 제품을 만들고 이 제품에 대한 패키지를 제출할 수 있도록 합니다.

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

   응답 본문에는 이 제품의 ID를 포함하는 제품 리소스 가 포함되어 있습니다.

4. Microsoft 하드웨어 API에서 다음 메서드를 실행하여 이 제품에 대한 제출 을 만듭니다. 이전 단계에서 만든 ProductID를 사용합니다.

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

   응답 본문에는 제출 ID, Azure Blob Storage에 제출하기 위한 제품(드라이버) 패키지를 업로드하기 위한 SAS(공유 액세스 서명) URI가 포함된 제출 리소스가 포함됩니다. [! 참고] > SAS URI는 계정 키를 요구하지 않고 Azure Storage의 보안 리소스에 대한 액세스를 제공합니다. SAS URI 및 Azure Blob Storage에서의 사용에 대한 배경 정보는 SAS(공유 액세스 서명)를 사용하여 Azure Storage 리소스에 대한 제한된 액세스 권한 부여를 참조하세요.

5. 이전 단계의 SAS URI에서 지정한 위치에서 Azure Blob Storage에 패키지를 업로드합니다. 다음 C# 코드 예제에서는 .NET용 Azure Storage Blob 라이브러리의 BlockBlobClient 클래스를 사용하여 Azure Blob Storage에 패키지를 업로드하는 방법을 보여 줍니다. 이 예제에서는 패키지가 스트림 개체에 이미 작성되어 있다고 가정합니다.

   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분마다 새로 고쳐집니다. 결과를 만들 때 모든 결과를 보려면 파트너 센터의 드라이버 페이지 맨 위에 있는 드라이버 목록 페이지(모두)를 클릭합니다. 제출이 많은 경우 페이지를 처리하고 로드하는 데 다소 시간이 걸리지만 로드할 때 성공 및 실패한 제출이 모두 나열되어야 합니다. 자세한 내용은 하드웨어 제출 찾기를 참조하세요.

코드 예

다음 코드 예제에서는 Microsoft 하드웨어 API를 사용하는 방법을 보여 줍니다.

• C# 샘플

데이터 리소스

제품 데이터를 만들고 관리하기 위한 Microsoft 하드웨어 API 메서드는 다음 JSON 데이터 리소스를 사용합니다.

• 제품 리소스
• 제출 리소스

참고 항목

• 하드웨어 대시보드 API 샘플(GitHub)