Help Center/ IoT Device Access/ API Reference/ MQTT or MQTTS API Reference on the Device Side/ Device Security Situational Awareness/ Device Monitoring Security Situation Awareness Configuration Change
Updated on 2025-04-22 GMT+08:00
View PDF
Share

Device Monitoring Security Situation Awareness Configuration Change

Topic

Downstream: $oc/devices/{device_id}/sys/properties/set/request_id={request_id}

Downstream Response Parameters

Parameter

Mandatory

Type

Description

object_device_id

No

String

Explanation:

  • For directly connected device: This parameter is not carried.
  • For gateway child device: The value is the child device ID in the topic.

service

Yes

List<ServiceProperty>

Explanation:

List of device services.

ServiceProperty structure

Parameter

Mandatory

Type

Description

service_id

No

String

Explanation:

The value is fixed at $security_detection_config for security situational awareness.

properties

Yes

SecurityProperties

Explanation:

Security situational awareness configuration details.

Example Downstream Response

Topic: $oc/devices/{device_id}/sys/properties/set/request_id={request_id}
Data format:
{
	"services": [{
		"properties": {
			"loginBruteForceCheck": 1,
			"cpuUsageCheck": 1,
			"cpuUsageThreshold": 80,
			"cpuUsageCheckPeriod": 2,
			"memoryCheck": 1,
			"memoryThreshold": 80,
			"memoryCheckReportPeriod": 24,
			"batteryPercentageCheck": 1,
			"batteryPercentageReportPeriod": 24,
			"batteryPercentageThreshold": 20
		},
		"service_id": "$security_detection_config"
	}]
}