Compartilhar via


Obter todos os envios

Use esse método na API de Hardware da Microsoft para recuperar dados para todos os envios de um 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
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productID}/submissions

Cabeçalho da solicitação

parâmetro Tipo Descrição
Autorização string Obrigatórios. O token de acesso de ID de Microsoft Entra no token> de portador<do 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

Não forneça um corpo da solicitação para esse método.

Exemplos de solicitação

O exemplo a seguir demonstra como recuperar informações sobre todos os envios de um produto.

GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/13635057453741329/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 todos os envios de um produto. Para resumir, este exemplo mostra apenas os dados dos dois primeiros envios retornados pela solicitação. Para obter mais detalhes sobre os valores no corpo da resposta, veja a seção a seguir.

{
  "value": [
    {
      "id": 1152921504621442000,
      "productId": 13635057453741328,
      "links": [
        {
          "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/13635057453741329/submissions/1152921504621441944",
          "rel": "self",
          "method": "GET"
        },
        {
          "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/13635057453741329/submissions/1152921504621441944",
          "rel": "update_submission",
          "method": "PATCH"
        }
      ],
      "isExtensionInf": true,
      "isUniversal": true,
      "isDeclarativeInf": true,
      "name": "HARRY-Duatest2",
      "type": "derived"
    },
    {
      "id": 1152921504621442000,
      "productId": 13635057453741328,
      "workflowStatus": {
        "currentStep": "finalizeIngestion",
        "state": "completed",
        "messages": []
      },
      "links": [
        {
          "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/13635057453741329/submissions/1152921504621441946",
          "rel": "self",
          "method": "GET"
        },
        {
          "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/13635057453741329/submissions/1152921504621441946",
          "rel": "update_submission",
          "method": "PATCH"
        }
      ],
      "isExtensionInf": true,
      "isUniversal": true,
      "isDeclarativeInf": true,
      "name": "updated-1",
      "type": "derived"
    },
    {
      "id": 1152921504621442000,
      "productId": 13635057453741328,
      "workflowStatus": {
        "currentStep": "finalizeIngestion",
        "state": "completed",
        "messages": []
      },
      "links": [
        {
          "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/13635057453741329/submissions/1152921504621441930",
          "rel": "self",
          "method": "GET"
        },
        {
          "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/13635057453741329/submissions/1152921504621441930",
          "rel": "update_submission",
          "method": "PATCH"
        }
      ],
      "isExtensionInf": true,
      "isUniversal": true,
      "isDeclarativeInf": true,
      "name": "HARRY-Duatest2",
      "type": "initial"
    }
  ],
  "links": [
    {
      "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/13635057453741329/submissions",
      "rel": "self",
      "method": "GET"
    }
  ]
}

Corpo da resposta

Valor Tipo Descrição
value array Uma matriz de objetos que contêm informações sobre cada envio de um produto. Para obter mais informações sobre os dados em cada objeto, consulte Recurso de envio.
links array Uma matriz de objetos com links úteis sobre a entidade que contém. Consulte o objeto de link para obter mais detalhes

Códigos do Erro

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

Confira também