Compartir a través de


Crear un nuevo envío para un producto

Use este método en la API de hardware de Microsoft para crear un nuevo envío para un producto. Antes de usar este método, asegúrese de que ha creado un nuevo producto. Para obtener más información, consulte Creación de un nuevo producto.

Requisitos previos

Si aún no lo ha hecho, complete todos los requisitos previos para las API de hardware de Microsoft antes de intentar usar cualquiera de estos métodos.

Solicitud

Este método tiene la siguiente sintaxis. Consulta las siguientes secciones para ver ejemplos de uso y descripciones tanto del encabezado como del cuerpo de la solicitud.

Método URI de solicitud
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions

El productId en el método es el producto para el que está previsto el envío.

Encabezado de solicitud

Encabezado Tipo Descripción
Authorization String Necesario. Token de acceso de identificador de Microsoft Entra en el formulario Token de portador<>.
Aceptar String Opcional. Especifica el tipo de contenido. El valor permitido es "application/json"

Parámetros de solicitud

No proporcione parámetros de solicitud para este método.

Cuerpo de la solicitud

En el ejemplo siguiente se muestra el cuerpo de la solicitud JSON para crear un nuevo envío.

{
  "name": "VST_apdevtest1_init",
  "type": "initial"
}

Para obtener más información sobre los campos de la solicitud, consulte Recurso de envío.

Ejemplos de solicitud

En el ejemplo siguiente se muestra cómo crear un nuevo envío.

POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14631253285588838/submissions HTTP/1.1
Authorization: Bearer <your access token>

Response

En el ejemplo siguiente se muestra el cuerpo de respuesta JSON devuelto por una solicitud correcta para crear un nuevo envío para un producto. Para obtener más información acerca de los valores del cuerpo de respuesta, consulta la siguiente sección.

{
  "id": 1152921504621465124,
  "productId": 14631253285588838,
  "downloads": {
    "items": [
      {
        "type": "initialPackage",
        "url": "<SAS URL from Hardware API>"
      }
    ],
    "messages": []
  },
  "links": [
    {
      "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14631253285588838/submissions/1152921504621465124",
      "rel": "self",
      "method": "GET"
    },
    {
      "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14631253285588838/submissions/1152921504621465124",
      "rel": "update_submission",
      "method": "PATCH"
    }
  ],
  "commitStatus": "commitPending",
  "isExtensionInf": true,
  "isUniversal": true,
  "isDeclarativeInf": true,
  "name": "VST_apdevtest1_init",
  "type": "initial"
}

Response body

Consulte El recurso de envío para obtener más detalles.

Códigos de error

Para obtener más información, consulta Códigos de error.

Consulte también

ejemplos de API de panel de hardware (GitHub)