90.log

Event

文件上传进度通知

Topic: thing/product/{gateway_sn}/events

Direction: up

Method: fileupload_progress

Data:

Column
Name
Type
constraint
Description

result

返回码

int

非 0 代表错误

output

输出

struct

»ext

扩展信息

struct

»»files

文件列表

array

{"size": -, "item_type": struct}

»»»module

所属设备类型

enum_int

{"0":"飞行器","3":"机场"}

»»»size

文件大小

int

byte

»»»device_sn

设备序列号(SN)

text

»»»key

对象存储桶 Key

text

»»»fingerprint

文件指纹

text

»»»progress

进度信息

struct

»»»»progress

进度值

int

»»»»finish_time

上传完成时间

int

»»»»upload_rate

上传速率

int

Example:

{
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"data": {
		"output": {
			"ext": {
				"files": [
					{
						"device_sn": "drone_sn",
						"fingerprint": "4f65b891f3bc09bdb6d4c36a996b532d",
						"key": "4bf0039f-6434-44a8-b891-8d7b6b7ff138/drone_sn/video_20220621_110830.log",
						"module": "0",
						"progress": {
							"current_step": 19,
							"finish_time": 1655781395926,
							"progress": 100,
							"result": 0,
							"status": "ok",
							"upload_rate": 0
						},
						"size": 155232
					},
					{
						"device_sn": "dock_sn",
						"fingerprint": "4f65b891f3bc09bdb6d4c36a996b532d",
						"key": "4bf0039f-6434-44a8-b891-8d7b6b7ff138/dock_sn/video_20220621_110830.log",
						"module": "3",
						"progress": {
							"current_step": 19,
							"finish_time": 1655781395926,
							"progress": 100,
							"result": 0,
							"status": "ok",
							"total_step": 30,
							"upload_rate": 0
						},
						"size": 155232
					}
				]
			},
			"status": "ok"
		}
	},
	"gateway": "dock_sn",
	"need_reply": 0,
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"timestamp": 1655781395926,
	"method": "fileupload_progress"
}

Service

获取设备可上传的文件列表

Topic: thing/product/{gateway_sn}/services

Direction: down

Method: fileupload_list

Data:

Column
Name
Type
constraint
Description

module_list

文件所属过滤列表

array

{"size": -, "item_type": enum_int}

Example:

{
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"data": {
		"module_list": [
			"0",
			"3"
		]
	},
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"timestamp": 1654070968655,
	"method": "fileupload_list"
}

Topic: thing/product/{gateway_sn}/services_reply

Direction: up

Method: fileupload_list

Data:

Column
Name
Type
constraint
Description

files

array

{"size": 2, "item_type": struct}

»device_sn

设备序列号(SN)

text

»result

返回码

int

非 0 代表错误

»module

所属设备类型

enum_int

{"0":"飞行器","3":"机场"}

»list

文件索引列表

array

{"size": -, "item_type": struct}

»»boot_index

文件索引

int

»»start_time

日志开始时间

int

{"unit_name":"毫秒 / ms"}

»»end_time

日志结束时间

int

{"unit_name":"毫秒 / ms"}

»»size

日志文件大小

int

byte

Example:

{
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"data": {
		"files": [
			{
				"device_sn": "xxxxxxxxx",
				"list": [
					{
						"boot_index": 1111,
						"end_time": 1659427398806,
						"size": 33789,
						"start_time": 1654070968655
					},
					{
						"boot_index": 22222,
						"end_ime": 1659427398806,
						"size": 33789,
						"start_time": 1659427398806
					}
				],
				"module": "0",
				"result": 0
			},
			{
				"device_sn": "device_sn",
				"list": [
					{
						"boot_index": 11111,
						"end_time": 1659427398806,
						"size": 36772,
						"start_time": 1659427398806
					},
					{
						"boot_index": 22222,
						"end_ime": 1659427398806,
						"size": 33789,
						"start_time": 1659427398806
					}
				],
				"module": "3",
				"result": 0
			}
		],
		"result": 0
	},
	"gateway": "",
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"timestamp": 1654070968655,
	"method": "fileupload_list"
}

发起日志文件上传

设备端收到服务端下发的命令后,会直接返回执行结果状态

Topic: thing/product/{gateway_sn}/services

Direction: down

Method: fileupload_start

Data:

Column
Name
Type
constraint
Description

bucket

对象存储桶名称

text

region

数据中心所在的地域

text

credentials

凭证信息

struct

»access_key_id

访问密钥 ID

text

»access_key_secret

秘密访问密钥

text

»expire

访问密钥过期时间

int

{"step":"1","unit_name":"秒 / s"}

»security_token

会话凭证

text

endpoint

对外服务的访问域名

text

provider

云厂商枚举值

enum_string

{"ali":"阿里云","aws":"亚马逊云","minio":"minio"}

params

struct

»files

array

{"size": -, "item_type": struct}

»»object_key

文件在对象存储桶的 Key

text

»»module

日志所属模块

text

»»list

日志列表

array

{"size": -, "item_type": struct}

»»»boot_index

日志索引

int

Example:

{
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"data": {
		"bucket": "stg-dji-service-hz-ksd7",
		"credentials": {
			"access_key_id": "STS.access_key_id",
			"access_key_secret": "access_key_secret",
			"expire": 1659432522000,
			"security_token": "security_token"
		},
		"endpoint": "https://oss-cn-hangzhou.aliyuncs.com",
		"params": {
			"files": [
				{
					"list": [
						{
							"boot_index": 321
						},
						{
							"boot_index": 322
						}
					],
					"module": "3",
					"object_key": "object_key"
				}
			]
		},
		"provider": "ali",
		"region": "hz"
	},
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"timestamp": 1659429523120,
	"method": "fileupload_start"
}

Topic: thing/product/{gateway_sn}/services_reply

Direction: up

Method: fileupload_start

Data:

Column
Name
Type
constraint
Description

result

返回码

int

非 0 代表错误

Example:

{
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"data": {
		"result": 0
	},
	"gateway": "",
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"timestamp": 1655781392412,
	"method": "fileupload_start"
}

上传状态更新

设备端收到服务端下发的命令后,会直接返回执行结果状态

Topic: thing/product/{gateway_sn}/services

Direction: down

Method: fileupload_update

Data:

Column
Name
Type
constraint
Description

status

上传状态

enum_string

{"cancel":"取消"}

module_list

日志所属模块列表

array

{"size": -, "item_type": }

Example:

{
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"data": {
		"module_list": [
			"0",
			"3"
		],
		"status": "cancel"
	},
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"method": "fileupload_update"
}

Topic: thing/product/{gateway_sn}/services_reply

Direction: up

Method: fileupload_update

Data:

Column
Name
Type
constraint
Description

result

返回码

int

非 0 代表错误

Example:

{
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"data": {
		"result": 0
	},
	"gateway": "",
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"timestamp": 1655781392412,
	"method": "fileupload_update"
}

Last updated