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.