장치 만들기

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 필드가 필수입니까? (장치 프로필에 따라서 참 또는 거짓)