仮想デバイス の大量作成
- 印刷する
- PDF
仮想デバイス の大量作成
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
概要
仮想デバイスを一度に大量作成します。
リクエスト
リクエストURL
POST {CLOUD_IOT_CORE_API_URL}/devices/bulk
Content-Type: application/json; charset=utf-8
x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}
リクエストボディー
{
"devices":[
{
"device":{
"name":"string",
"description":"string"
},
"deviceProperties":{
"createUpdateList":[
{
"key":"string",
"value":"string"
}
]
}
}
]
}
| 項目 | 必須の有無 | タイプ | 制約事項 | 説明 |
|---|---|---|---|---|
| devices[].device.name | Yes | string | 128字以内のアルファベットの大文字小文字、数字、-、_のみ許可 | 仮想デバイス名 |
| devices[].device.description | Yes | string | 128文字以内のみ許可 &、<、>、"、' は非許可 | 仮想デバイスの説明 |
| devices[].deviceProperties.createUpdateList[].key | Yes | string | 128字以内のアルファベットの大文字小文字、数字、-、_のみ許可 | 仮想デバイス属性 Key。 同一のキーを探して情報を修正します。 既存の保存されているキーが要求ボディにない場合は削除されます。 |
| devices[].deviceProperties.createUpdateList[].value | No | string | 512字以内のアルファベットの大文字小文字、数字、-、_のみ許可 | 仮想デバイス属性 Value |
レスポンス
レスポンスボディ
{
"status": "string",
"body": {
"devices":[
{
"device":{
"name":"string",
"description":"string",
"modifyTime": "localDateTime",
"registerTime": "localDateTime"
},
"deviceProperties":{
"createUpdateList":[
{
"key":"string",
"value":"string",
"modifyTime": "localDateTime",
"registerTime": "localDateTime"
}
]
}
}
]
}
}
| 項目 | タイプ | 説明 |
|---|---|---|
| status | string | レスポンスの成否 |
| body.devices[].device.name | string | 仮想デバイス名 |
| body.devices[].device.description | string | 仮想デバイス説明 |
| body.devices[].device.modifyTime | localDateTime | 仮想デバイスの最終修正日 |
| body.devices[].device.registerTime | localDateTime | 仮想デバイスの作成日 |
| body.devices[].deviceProperties.createUpdateList[].key | string | 仮想デバイス属性 Key |
| body.devices[].deviceProperties.createUpdateList[].value | string | 仮想デバイス属性 Value |
| body.devices[].deviceProperties.createUpdateList[].modifyTime | localDateTime | 仮想デバイス属性の最終修正日 |
| body.devices[].deviceProperties.createUpdateList[].registerTime | localDateTime | 仮想デバイス属性の作成日 |
例
{
"status": "SUCCESS",
"body": {
"devices": [
{
"device": {
"name": "bulb",
"description": "bulb in living room",
"modifyTime": "2022-04-18 14:15:50",
"registerTime": "2022-04-18 14:15:50"
},
"deviceProperties": {
"createUpdateList": [
{
"key": "lux",
"value": "2000",
"modifyTime": "2022-04-18 14:15:51",
"registerTime": "2022-04-18 14:15:51"
},
{
"key": "ampere",
"value": "5",
"modifyTime": "2022-04-18 14:15:51",
"registerTime": "2022-04-18 14:15:51"
}
]
}
}
]
}
}
この記事は役に立ちましたか?