Udostępnij przez

Tworzenie nowego produktu

Użyj tej metody w interfejsie API sprzętu firmy Microsoft, aby utworzyć nowy produkt sprzętowy.

Wymagania wstępne

Jeśli jeszcze tego nie zrobiono, przed podjęciem próby użycia dowolnej z tych metod wykonaj wszystkie wymagania wstępne dla interfejsów API sprzętu firmy Microsoft.

Żądanie

Ta metoda ma następującą składnię. Zapoznaj się z poniższymi sekcjami, aby zapoznać się z przykładami użycia i opisami nagłówka i treści żądania.

Metoda Żądanie URI
Bez znajomości kontekstu, w którym "POST" jest używany, nie mogę zaproponować dokładnego tłumaczenia. Jeżeli dotyczy HTTP, pozostaw jako "POST". https://manage.devcenter.microsoft.com/v2.0/my/hardware/products

Nagłówek żądania

Nagłówek Typ Opis
Autoryzacja sznurek To jest wymagane. Token dostępu Microsoft Entra ID w postaci Bearer<token>.
akceptować sznurek Opcjonalny. Określa typ zawartości. Dozwolona wartość to "application/json"

Parametry żądania

Nie należy podawać parametrów żądania dla tej metody.

Ciało żądania

W poniższym przykładzie pokazano treść żądania JSON do utworzenia nowego produktu. Aby uzyskać więcej informacji na temat wartości w treści żądania, zobacz tabelę poniżej pliku 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": {}
}

Aby uzyskać szczegółowe informacje o polach w żądaniu, zobacz Zasób produktu.

Prośba o przykłady

W poniższym przykładzie pokazano, jak utworzyć nowy produkt.

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

Odpowiedź

W poniższym przykładzie pokazano odpowiedź JSON zwróconą na pomyślne żądanie utworzenia produktu. Aby uzyskać więcej informacji na temat wartości w treści odpowiedzi, zobacz następującą sekcję.

{
  "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"
}

Ciało odpowiedzi

Aby uzyskać więcej informacji, zobacz Zasób produktu

Kody błędów

Aby uzyskać więcej informacji, zobacz Kody błędów.

Zobacz też

przykłady API panelu sterowania sprzętem (GitHub)

  • Last updated on