Compartilhar via

Gerenciar envios de produtos

  • Artigo

Use os seguintes métodos nas APIs de Hardware da Microsoft para gerenciar envios dos seus produtos e assiná-los pela Microsoft. Para obter uma introdução às APIs de Hardware da Microsoft, incluindo pré-requisitos para usar a API, consulte API de painel de hardware.

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

Métodos para gerenciar envios de produto

Método URI Descrição
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} Obter status/dados de um produto específico
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId} Obter status/dados de um envio específico de um produto
POSTAR https://manage.devcenter.microsoft.com/v2.0/my/hardware/products Criar um novo produto
POSTAR https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/ Criar um novo envio para um produto
POSTAR https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/commit Confirmar um envio de produto

Criar e enviar um produto para assinatura

  1. Conclua todos os pré-requisitos para as APIs de Hardware da Microsoft.

  2. Obtenha um token de acesso do Microsoft Entra ID. Você deve passar esse token de acesso para os métodos na API de envio da Microsoft Store. Após obter um token de acesso, você tem 60 minutos para usá-lo antes dele expirar. Depois que o token expirar, você poderá obter um novo.

  3. Crie um novo produto executando o seguinte método na API de Hardware da Microsoft. Esse método gera um novo produto em desenvolvimento e possibilita o envio de pacotes para ele.

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

    O corpo da resposta contém um recurso de produto que inclui a ID desse produto.

  4. Crie um envio para esse produto executando o seguinte método na API de Hardware da Microsoft. Utilize o ProductID criado na etapa anterior.

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

    O corpo da resposta contém um recurso de envio que inclui a ID do envio, o URI de assinatura de acesso compartilhado (SAS) para carregar o pacote do produto (driver) para o envio ao Armazenamento de Blobs do Azure. [!OBSERVAÇÃO] > Um URI SAS fornece acesso a um recurso seguro no armazenamento do Azure sem exigir chaves de conta. Para obter informações básicas sobre URIs SAS e seu uso com o Armazenamento de Blobs do Azure, consulte Conceder acesso limitado aos recursos do Armazenamento do Azure usando SAS (assinaturas de acesso compartilhado).

  5. Carregue seu pacote no Armazenamento de Blobs do Azure no local especificado pelo URI da SAS na etapa anterior. O exemplo de código C# a seguir demonstra como carregar um pacote no Armazenamento de Blobs do Azure usando a classe BlockBlobClient na Biblioteca de Blobs de Armazenamento do Azure para .NET. Este exemplo pressupõe que o pacote já foi gravado em um objeto de fluxo.

    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. Confirme o envio do produto executando o método a seguir. Este método notifica o Centro de Desenvolvimento de Hardware de que você finalizou o envio do produto, iniciando a validação para o envio.

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

  7. Verifique o status de confirmação executando o método a seguir para obter o status do envio do produto.

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

    Para confirmar o status do envio, revise o valor de commitStatus no corpo da resposta. Esse valor deve mudar de CommitReceived para CommitComplete se a solicitação for bem-sucedida ou para CommitFailed se houver erros na solicitação.

    Observação

    A página de pesquisa principal é atualizada a cada 10 minutos. Para exibir todos os seus resultados à medida que você os cria, clique em Página da lista de drivers (todos), na parte superior da página Drivers do Partner Center. Embora a página leve algum tempo para ser processada e carregada se você tiver muitos envios, os envios bem-sucedidos e malsucedidos deverão ser listados quando ela for carregada. Para obter mais informações, consulte Localizar um envio de hardware.

Exemplo de código

O exemplo de código a seguir demonstra como usar a API de Hardware da Microsoft:

Recursos de dados

Os métodos de APIs de Hardware da Microsoft para criar e gerenciar dados de produtos usam os seguintes recursos de dados JSON:

Confira também