Compartilhar via


Criar um novo produto

Use esse método na API de Hardware da Microsoft para criar um novo produto de hardware.

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

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.
accept string 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 produto. Para obter mais detalhes sobre os valores no corpo da solicitação, consulte a tabela abaixo do json.

{
  "productName": "Test_Network_Product2-R",
  "testHarness": "Attestation",
  "announcementDate": "2018-01-01T00:00:00",
  "deviceMetadataIds": [],
  "firmwareVersion": "980",
  "deviceType": "external",
  "isTestSign": false,
  "isFlightSign": false,  
  "marketingNames": [],
  "selectedProductTypes": {
    "windows_v100_RS3": "Unclassified"
  },
  "requestedSignatures": [
    "WINDOWS_v100_RS3_FULL",
    "WINDOWS_v100_X64_RS3_FULL",
    "WINDOWS_VISTA"
  ],
  "additionalAttributes": {}
}

Para obter detalhes sobre os campos na solicitação, consulte Recurso do produto.

Exemplos de solicitação

O exemplo a seguir demonstra como criar um novo produto.

POST https://manage.devcenter.microsoft.com/v2.0/my/hardware/products 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 produto. Para obter mais detalhes sobre os valores no corpo da resposta, veja a seção a seguir.

{
  "id": 14631253285588838,
  "sharedProductId": 1152921504607010608,
  "links": [
    {
      "href": "https:// manage.devcenter.microsoft.com/api/v1/hardware/products/14631253285588838",
      "rel": "self",
      "method": "GET"
    },
    {
      "href": "https:// manage.devcenter.microsoft.com/api/v1/hardware/products/14631253285588838/submissions",
      "rel": "get_submissions",
      "method": "GET"
    }
  ],
  "isCommitted": false,
  "isExtensionInf": false,
  "announcementDate": "2018-01-01T00:00:00",
  "deviceMetadataIds": [],
  "firmwareVersion": "980",
  "deviceType": "external",
  "isTestSign": false,
  "isFlightSign": false,  
  "marketingNames": [],
  "productName": "VST_apdevtest1",
  "selectedProductTypes": {
    "windows_v100_RS3": "Unclassified"
  },
  "requestedSignatures": [
    "WINDOWS_v100_RS3_FULL",
    "WINDOWS_v100_X64_RS3_FULL",
    "WINDOWS_VISTA"
  ],
  "additionalAttributes": {},
  "testHarness": "attestation"
}

Corpo da resposta

Consulte o Recurso do produto para obter mais detalhes

Códigos do Erro

Para obter mais informações, consulte Códigos de erro.

Confira também

exemplos de API de hardware dashboard (GitHub)