Gerät erstellen

POST
https://one.digicert.com/iot/api/v1/device

Fügen Sie ein Gerät zur Verwaltung hinzu

bash
{
  "division_id": "fd5faa1e-623a-47a9-831b-b9397c33395f",
  "device_identifier": "New Device",
  "device_profile_id": "a81a431a-be7b-4f2e-8afd-b2778491511f",
  "fields": [
    {
      "id": "417c328e-604c-4e94-9112-ee58f12277fb",
      "value": "mandatory value"
    },
    {
      "id": "90eb4de2-ae8a-48a0-a904-d30c5ab6e1de",
      "value": "optional value"
    }
  ]
}
201 Created
{
  "id": "64c02969-3890-4da8-a5ef-b574fd72887e",
  "account_id": "1d1ec1ec-6502-11e9-a923-1681be663d3e",
  "division": {
    "id": "fd5faa1e-623a-47a9-831b-b9397c33395f",
    "name": "Mock Division 1"
  },
  "device_identifier": "New Device",
  "device_profile": {
    "id": "a81a431a-be7b-4f2e-8afd-b2778491511f",
    "name": "Device Profile"
  },
  "created": "2020-04-22T07:13:20Z",
  "updated": "2020-04-22T07:13:20Z",
  "status": "ACTIVE",
  "fields": [
    {
      "id": "417c328e-604c-4e94-9112-ee58f12277fb",
      "name": "Mandatory Field",
      "value": "mandatory value",
      "mandatory": true
    },
    {
      "id": "90eb4de2-ae8a-48a0-a904-d30c5ab6e1de",
      "name": "Optional Field",
      "value": "optional value",
      "mandatory": false
    }
  ]
}
400 Bad Request
{
  "errors": [
    {
      "code": "invalid_input",
      "message": "Device with division fd5faa1e-623a-47a9-831b-b9397c33395f and identifier New Device already exist"
    }
  ]
}

Antragsparameter

Name Antr./Opt. Typ Beschreibung
division_id string Abteilungs-ID
device_identifier string Geräte-ID Darf nicht leer sein, max. 255 Zeichen Muss in der Abteilung eindeutig sein
device_profile_id erforderlich string ID des Geräteprofils, das als Vorlage für Geräterstellung verwendet wird
fields array Felder-Array
.. id string Feld-ID (entspricht der Geräteprofilfeld-ID)
.. value string Feldwert Pflichtfeld, definiert vom Geräteprofil Max 1024 Zeichen

Reaktionsparameter

Name Typ Beschreibung
id string Eindeutige Geräte-ID
account_id string Konto-ID
division object Abteilungscontainer
.. id string Abteilungs-ID
.. name string Abteilungsname
device_identifier string Geräte-ID
device_profile object Geräteprofilcontainer
.. id string Geräteprofil-ID
.. name string Geräteprofilname
created string Datum und Uhrzeit der Erstellung (UTC)
updated string Datum und Uhrzeit der letzten Aktualisierung (UTC)
status string Status (für neu erstelltes Gerät immer AKTIV)
fields array Felder-Array
.. id string Feld-ID
.. name string Feldname (vom Geräteprofil)
.. value string Feldwert
.. mandatory boolean Ist dies ein Pflichtfeld? (wahr oder falsch gemäß dem Geräteprofil)