Gerät erstellen

POST

https://one.digicert.com/iot/api/v2/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)

Antragsparameter

Reaktionsparameter

Über