Criar um novo envio para um produto
Use esse método na API de Hardware da Microsoft para criar um novo envio para um produto. Antes de usar esse método, verifique se você criou um novo produto. Para obter detalhes, consulte criar um novo produto.
Pré-requisitos
Se você ainda não fez isso, conclua todos os pré-requisitos para as APIs de Hardware da Microsoft antes de tentar usar qualquer um desses métodos.
Solicitação
Esse método tem a seguinte sintaxe. Veja as seções a seguir para obter exemplos de uso e descrições do corpo da solicitação e do cabeçalho.
| Método | URI da solicitação |
|---|---|
| POST | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions |
A productId no método é o produto para o qual o envio é destinado.
Cabeçalho da solicitação
| parâmetro | Tipo | Descrição |
|---|---|---|
| Autorização | String | Obrigatórios. O token de acesso Microsoft Entra ID no token> de portador<de formulário. |
| Aceitar | Cadeia de caracteres | Opcional. Especifica o tipo de conteúdo. O valor permitido é "application/json" |
Parâmetros da solicitação
Não forneça parâmetros de solicitação para esse método.
Corpo da solicitação
O exemplo a seguir demonstra o corpo da solicitação JSON para criar um novo envio.
{
"name": "VST_apdevtest1_init",
"type": "initial"
}
Para obter detalhes sobre os campos na solicitação, consulte Recurso de envio.
Exemplos de solicitação
O exemplo a seguir demonstra como criar um novo envio.
POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14631253285588838/submissions HTTP/1.1
Authorization: Bearer <your access token>
Resposta
O exemplo a seguir demonstra o corpo da resposta JSON retornado por uma solicitação bem-sucedida para criar um novo envio para um produto. Para obter mais detalhes sobre os valores no corpo da resposta, veja a seção a seguir.
{
"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"
}
Corpo da resposta
Consulte Recurso de envio para obter mais detalhes.
Códigos do Erro
Para obter mais informações, consulte Códigos de erro.