云端互联文档
架构设计
1. 在司空 2 配置阿里云 OSS 配置信息以及司空 2 回调地址。
2. 机场在执行完航线任务后,会将媒体文件上传到指定的阿里云 OSS 中。
3. 司空 2 收到机场媒体文件上传成功的回调后,会通过配置的回调地址回调用户指定的云平台。
对接流程
操作主体:三方伙伴
流程说明
准备阶段
多媒体直传参数配置。
存储地址
使用 STS 临时访问凭证访问 OSS,配置信息可参照阿里云官方文档。
{
"access_key_id":"xxxxxxx", // 必传
"access_key_secret":"xxxxxxxx", // 必传
"region":"cn-hangzhou", // 必传
"bucket":"hz-xxx-bucket", // 必传
"arn":"xxxxxx", // 必传
"policy": "xxxxxxx", // 非必传
"role_session_name":"xxxxx", // 必传
"provider":"ali" // 必传,ali 或aws
}
API 地址(接收通知接口)
地址可自定义,必须为 https 接口,如 https://x.com/xxx
请求入参:
{
"notify_type":"drc_file_upload_complete",
"org_id":"组织ID",
"org_name":"组织名称",
"prj_id":"项目ID",
"prj_name":"项目名称",
"sn":"设备SN",
"task_info":{
"task_type":"任务类型",
"tags":["标签1","标签2"],
"task_id": "xxxx-xxxx-xxxx"
},
"files":[
{
"name":"名称",
"key":"阿里云key"
}
],
"folder_info":{
"expected_file_count":0,
"uploaded_file_count":0,
"folder_id":0
}
}
返回值:
{
"code":0,
"message":"code 非 0,返回错误信息"
}
配置阶段
1. 进入我的组织,选择组织设置,注意需要有管理员权限
2. 配置存储桶信息
3. 参数请参考准备阶段,存储地址格式为 json.
4. 在项目设置中开启云云对接
5. 计划任务开启云云对接&设置标签
测试阶段
1. 飞行完成后,查看媒体库是否传输完成,并有弹窗显示媒体上传至三方平台 + 任务标签。
2. 飞行完成后,查看三方平台是否能接收到通知消息,确认以下几点;
- 格式是否正确
- 信息是否完整(组织 + 项目 + 设备 + 任务 + 文件 + 标签)
- 时间是否及时
{
"notify_type":"drc_file_upload_complete",
"org_id":"组织ID",
"org_name":"组织名称",
"prj_id":"项目ID",
"prj_name":"项目名称",
"sn":"设备SN",
"task_info":{
"task_type":"任务类型",
"tags":["标签1","标签2"]
},
"files":[
{
"name":"名称",
"key":"阿里云key"
}
],
"folder_info":{
"expected_file_count":0,
"uploaded_file_count":0,
"folder_id":0
}
}
FAQ
- STS 临时凭证信息上传错误,司空 2 会有什么表现?在保存 STS 配置信息时,司空 2 会报错。如果设置成功,证明 STS 配置是准确的。
- 客户平台没有正确处理司空 2 的回调,司空 2 会重试吗?司空 2 在 2 小时内,会每 30 分钟回调一次云端。在 2 小时后,司空 2 会每 2 小时回调一次。
- 支持的对象存储?阿里云、AWS
评论
2 条评论
第三方云平台仅支持阿里云和AWS?支持私有云么?
能以项目为抓手,从第三方云平台丝滑跳转到司空2同一个项目里面进行控制操作吗?
请登录写评论。