Compartir a través de

Administración de envíos de productos

  • Artículo

Use los métodos siguientes de las API de hardware de Microsoft para administrar los envíos de los productos y obtenerlos firmados de Microsoft. Para obtener una introducción a las API de hardware de Microsoft, incluidos los requisitos previos para usar la API, consulte API de panel de hardware.

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

Métodos para administrar envíos de productos

Método URI Descripción
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID} Obtener el estado o los datos de un producto específico
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId} Obtener el estado o los datos de un envío específico de un producto
PUBLICAR https://manage.devcenter.microsoft.com/v2.0/my/hardware/products Crear un nuevo producto
PUBLICAR https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/ Creación de un nuevo envío para un producto
PUBLICAR https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions/{submissionId}/commit Confirmación de un envío de producto

Creación y envío de un producto para la firma

  1. Complete todos los requisitos previos para usar las API de hardware de Microsoft.

  2. Obtenga un token de acceso de Microsoft Entra ID. Debe pasar este token de acceso a los métodos de la API de envío de Microsoft Store. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.

  3. Cree un nuevo producto ejecutando el método siguiente en la API de hardware de Microsoft. Este método crea un nuevo producto en curso y le permite enviar paquetes para este producto.

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

    El cuerpo de la respuesta contiene un recurso de producto que incluye el identificador de este producto.

  4. Cree un envío para este producto ejecutando el siguiente método en la API de hardware de Microsoft. Use el ProductID creado en el paso anterior.

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

    El cuerpo de la respuesta contiene un recurso de envío que incluye el identificador del envío, el URI de firma de acceso compartido (SAS) para cargar el paquete del producto (controlador) para el envío a Azure Blob Storage. [NOTA] > Un URI de SAS proporciona acceso a un recurso seguro en el almacenamiento de Azure sin necesidad de claves de cuenta. Para obtener información general sobre los URI de SAS y su uso con Azure Blob Storage, consulte Concesión de acceso limitado a los recursos de Azure Storage mediante firmas de acceso compartido (SAS).

  5. Cargue el paquete en Azure Blob Storage en la ubicación especificada por el URI de SAS en el paso anterior. El siguiente ejemplo de código C# muestra cómo cargar un paquete en Azure Blob Storage mediante la clase BlockBlobClient en la biblioteca de blobs de Azure Storage para .NET. En este ejemplo se supone que el paquete ya se ha escrito en un objeto de secuencia.

    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 el envío del producto ejecutando el siguiente método. Este método avisa Centro de desarrollo de hardware que ha terminado con el envío del producto y se inicia la validación para el envío.

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

  7. Compruebe el estado de confirmación ejecutando el método siguiente para obtener el estado del envío del producto.

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

    Para confirmar el estado del envío, revise el valor commitStatus en el cuerpo de respuesta. Este valor debe cambiar de CommitReceived a CommitComplete si la solicitud se realiza correctamente, o bien a CommitFailed si hay errores en la solictud.

    Nota:

    La página de búsqueda principal se actualiza cada 10 minutos. Para ver todos los resultados a medida que los crea, haga clic en la Página Lista de controladores (todos) en la parte superior de la página Controladores del Centro de partners. Aunque la página tarda algún tiempo en procesarse y cargarse si tiene una gran cantidad de envíos, los envíos correctos e incorrectos deben aparecer cuando se carga. Para obtener más información, consulte Búsqueda de un envío de hardware.

Ejemplo de código

En el ejemplo de código siguiente se muestra cómo usar la API de hardware de Microsoft:

Recursos de datos

Los métodos de las API de hardware de Microsoft para crear y administrar datos del producto usan los siguientes recursos de datos JSON:

Consulte también