장치 만들기

POST

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

관리할 장치를 추가합니다.

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

요청 매개 변수

이름	필수/옵션	유형	설명
division_id		string	부서 ID
device_identifier		string	장치 식별자입니다. 비워둘 수 없으며 최대 255자입니다. 부서 내에서 고유해야 합니다.
device_profile_id	필수	string	장치 만들기에 대해 템플릿으로 사용할 장치 프로필의 ID
fields		array	필드의 배열
.. id		string	필드의 ID(장치 프로필 필드 ID에 상응)
.. value		string	필드의 값입니다. 필수는 장치 프로필로 정의됩니다. 최대 1024개 심볼

응답 매개 변수

이름	유형	설명
id	string	장치 고유 ID
account_id	string	계정 ID
division	object	부서 컨테이너
.. id	string	부서 ID
.. name	string	부서 이름
device_identifier	string	장치 식별자
device_profile	object	장치 프로필 컨테이너
.. id	string	장치 프로필 ID
.. name	string	장치 프로필 이름
created	string	만들 날짜 및 시간(UTC)
updated	string	마지막 업데이트 날짜 및 시간(UTC)
status	string	상태(새로 만든 장치에서는 항상 ‘활성’)
fields	array	필드의 배열
.. id	string	필드 ID
.. name	string	필드 이름(장치 프로필에서)
.. value	string	필드 값
.. mandatory	boolean	필드가 필수입니까? (장치 프로필에 따라서 참 또는 거짓)

요청 매개 변수

응답 매개 변수

정보