华为云用户手册

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 普通租户的token。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息。

请求示例 PUT /v1/3266392d188c47d09948b1**********/devices/9339084235*****000001/channels/ 933908423****0000001/access-strategy { "start_time" : "10:00", "end_time" : "18:00", "total_length" : 240, "random_strategy" : "RANDOM", "periodicity" : "DAY", "state" : "STOPPED" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 普通租户的token。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息。 表3 请求Body参数 参数 是否必选 参数类型 描述 random_strategy 否 String 视频采集类型，可选值如下。 RANDOM：表示使用随机采集方法。在开始时间和结束时间内，随机采集总时长为total_length参数值的视频。 随机策略说明： 一天内从start_time到end_time的时间，会随机分成若干个时间分片（总分片个数不超过6个），每个时间分片最短为10min，最长不超过total_length时间，每两个时间分片之间的间隔至少为20min。时间分片之间的间隔即视频起始时间的间隔，例如中间断开10min，也就是间隔至少20min。 如果设置为每天执行采集（即“periodicity”为“DAY”），每天的时间分片会重新随机生成，以保证每天接入的时间分片不同。 如果更新了接入策略（例如修改了start_time、total_length等参数），并且当前接入策略运行状态为ACTIVE，则会重新生成分片，其中分片开始时间早于当前时间的不会在当天执行，分片开始时间晚于当前时间的会在当天执行。 CONSECUTIVE：表示从开始时间连续采集时长为total_length参数值的视频。 默认值为RANDOM，不区分大小写。 start_time 否 String 一天中 视频接入 的开始时间，时间格式为HH:MM，取值范围是00:10～23:40。分钟数值须为10的倍数，例如10:10、10:20、10:30等。第一次设置接入策略时，该参数必填。后续更新接入策略时，该参数可选。 end_time 否 String 一天中视频接入的结束时间，时间格式为HH:MM，取值范围是00:10～23:50。分钟数值须为10的倍数，如23:10、23:20等。end_time必须晚于start_time。第一次设置视频采集类型为RANDOM时，该参数必填。后续更新接入策略时，该参数可选采集类型为CONSECUTIVE时，该参数被忽略。 total_length 否 Integer 视频接入总采集时长，单位：分钟。参数值须为10的倍数，最小值为10分钟，最大值根据用户的配额决定。不同的视频采集类型，total_length有不同的配额设置：采集类型为RANDOM时，start_time加上total_length后的时间不能超过end_time。采集类型为CONSECUTIVE时，start_time加上total_length后的时间不能超过24:00，即采集时长不允许跨天。第一次设置接入策略时，该参数必填。后续更新接入策略时，该参数可选。 periodicity 否 String 采集周期，可选值如下。 ONCE：表示采集一次。 DAY：表示每天执行。 默认值为DAY，不区分大小写。 state 否 String 视频接入状态，可选值如下。 ACTIVE：表示激活当前视频接入策略。 STOPPED：表示停止当前视频接入策略。 默认值为STOPPED，不区分大小写。

约束与限制 RTMP接入功能已下线，若有RTMP视频流接入需求建议您使用 视频直播 服务。 目前"华北-北京一"和"华东-上海二"区域不支持新用户开通。 VIS支持以下接入类型： 视频流：支持HTTP-FLV类型的视频流接入。 设备：支持GB/T28181摄像设备接入。 VIS最多支持接入50个设备，最多支持激活10个视频流。若您需要扩大配额，请提交工单与华为云技术客服联系。 HTTP-FLV 类型的视频流，支持编码格式为H264。 GB/T28181摄像设备接入的视频流，支持编码格式为H264和H265。 RTMP推流地址：RTMP接入类型重新激活后需要再次重新获取最新推流地址。 播放地址：HTTP-FLV与RTMP接入类型视频流，每次激活需要重新获取播放地址，同时播放地址存在有效期需要定期获取最新的。 视频流的取流地址，最多支持5路同时取流。 VIS支持以下类型视频流输出： HTTP-FLV视频流：当接入到VIS的视频流以H265或H264编码时，输出流支持HTTP-FLV协议。 HLS视频流：当接入到VIS的视频流以H265或H264编码时，输出流支持HLS协议。 父主题： 使用前必读

概述 欢迎使用部署服务（CodeArts Deploy）。部署服务提供可视化、一键式部署服务，支持部署到虚拟机或者容器，提供Tomcat、SpringBoot等模板或者自由组装编排原子步骤进行部署，支持并行部署和流水线无缝集成，实现部署环境标准化和部署过程自动化。 您可以使用本文档提供的API对部署服务进行相关操作，如新建主机、新建主机集群、部署应用等。支持的全部操作请参见API概览。 在调用部署服务的API之前，请确保已经充分了解部署服务的相关概念，详细信息请参见产品介绍。 父主题： 使用前必读

Step5 在开发环境中调试代码 由于已经连接至云端开发环境，此时可以方便的在本地PyCharm中编码、调测并运行。运行实际环境为云上开发环境，资源为云上昇腾AI处理器资源。可以做到本地编写修改代码，直接在云上环境运行。 像本地运行代码一样，直接单击运行按钮运行代码即可，此时虽然是在本地IDE单击的运行按钮，实际上运行的是云端开发环境里的代码，日志可以回显在本地的日志窗口。 图5 调试代码 也可以单击右上角的Run/Debug Configuration来设置运行的参数。 图6 设置运行参数 当需要调试代码时，可以直接打断点，然后使用debug方式运行程序。 图7 代码打断点 图8 Debug方式调试 此时可以进入debug模式，代码运行暂停在该行，且可以查看变量的值。 图9 Debug模式 使用debug方式调试代码的前提是本地的代码和云端的代码是完全一致的，如果不一致可能会导致在本地打断点的行和实际运行时该行的代码并不一样，会出现意想不到的错误。 因此在配置云上Python Interpreter时，推荐选择Automatically upload选项，以保证本地的文件修改能自动上传到云端。如果没有选择自动上传，则本地代码修改完后，也可以参考Step6 同步上传本地文件至Notebook手动上传目录或代码。

前提条件 本地已安装2019.2及以上版本的PyCharm专业版。SSH远程调试功能只限PyCharm专业版。 创建一个Notebook实例，并开启远程SSH开发。该实例状态必须处于“运行中”，具体参见创建Notebook实例章节。 在Notebook实例详情页面获取开发环境IP地址（例如：dev-modelarts-cnnorth4.huaweicloud.com）和端口号。 图1 Notebook实例详情页面 准备好密钥对。 密钥对在用户第一次创建时，自动下载，之后使用相同的密钥时不会再有下载界面（用户一定要保存好），或者每次都使用新的密钥对。

相关操作 关闭TensorBoard方式如下： 方式1：单击下图所示的，进入TensorBoard实例管理界面，该界面记录了所有启动的TensorBoard实例，单击对应实例后面的SHUT DOWN即可停止该实例。 图8 单击SHUT DOWN停该实例 方式2：在开发环境JupyterLab中的“.ipynb”文件窗口中输入命令，关闭TensorBoard。PID在启动界面有提示或者通过ps -ef | grep tensorboard查看。 !kill PID 方式3：单击下方红框中的按钮可以关闭所有启动的TensorBoard实例。 图9 关闭所有启动的TensorBoard实例 方式4（不推荐）：直接在JupyterLab中上关闭TensorBoard窗口，此方式仅关闭可视化窗口，并未关闭后台。

Step2 上传Summary数据 在开发环境中使用TensorBoard可视化功能，需要用到Summary数据。 Summary数据可以直接传到开发环境的这个路径下/home/ma-user/work/，也可以放到OBS并行文件系统中。 Summary数据上传到Notebook路径/home/ma-user/work/下的方式，请参见上传数据至Notebook。 Summary数据如果是通过OBS并行文件系统挂载到Notebook中，请将模型训练时产生的Summary文件先上传到OBS并行文件系统，并确保OBS并行文件系统与ModelArts在同一区域。在Notebook中启动TensorBoard时，Notebook会自动从挂载的OBS并行文件系统目录中读取Summary数据。

Step3 启动TensorBoard 在开发环境的JupyterLab中打开TensorBoard有多种方法。可根据使用习惯选择。 图1 JupyterLab中打开TensorBoard的方法 方式1（推荐）： 在JupyterLab左侧导航创建名为“summary”的文件夹，将数据上传到“/home/ma-user/work/summary”路径。注：文件夹命名只能为summary否则无法使用。 进入“summary”文件夹，单击方式1，直接进入TensorBoard可视化界面。如图2所示。 图2 TensorBoard界面（1） 方式2： 用户可以自行升级除2.4.0之外的TensorBoard，但需注意升级后只有方式2使用新的TensorBoard，其余方式保持TensorBoard2.1.1不变。

示例 在ModelArts Notebook里进行镜像构建。 ma-cli image build .ma/customize_from_ubuntu_18.04_to_modelarts/Dockerfile -swr notebook_test/my_image:0.0.1 其中“.ma/customize_from_ubuntu_18.04_to_modelarts/Dockerfile”为Dockerfile文件所在路径，“notebook_test/my_image:0.0.1”为构建的新镜像的SWR路径。

相关操作 关闭MindInsight方式如下： 方式1：在开发环境JupyterLab中的“.ipynb”文件窗口中输入命令，关闭MindInsight。端口号在启动MindInsight中设置，默认使用8080，需要替换为实际开启MindInsight时的端口。 !mindinsight stop --port 8080 方式2：单击下方按钮进入MindInsight实例管理界面，该界面记录了所有启动的MindInsight实例，单击对应实例后面的SHUT DOWN即可停止该实例。 图8 单击SHUT DOWN停止实例 方式3：单击下方红框中的按钮可以关闭所有启动的MindInsight实例。 图9 关闭所有启动的MindInsight实例 方式4（不推荐）：直接在JupyterLab中上关闭MindInsight窗口，此方式仅是关闭MindInsight可视化窗口，并未关闭后台。

Step2 上传Summary数据 在开发环境中使用MindInsight可视化功能，需要用到Summary数据。 Summary数据可以直接传到开发环境的这个路径下/home/ma-user/work/，也可以放到OBS并行文件系统中。 Summary数据上传到Notebook路径/home/ma-user/work/下的方式，请参见上传数据至Notebook。 Summary数据如果是通过OBS并行文件系统挂载到Notebook中，请将模型训练时产生的Summary文件先上传到OBS并行文件系统，并确保OBS并行文件系统与ModelArts在同一区域。在Notebook中启动MindInsight时，Notebook会自动从挂载的OBS并行文件系统目录中读取Summary数据。

操作步骤 执行如下的sql作业。 select c.id as `企业id`, 0.5 * a.tax_bal + 0.8 * b.supp_bal + (0.05 * c.electric_bal + 0.05 * c.water_bal) * 0.1 as `企业评分` from Partner1.TAX a, Partner1.SUPPORT b, Partner2.POWER_DATA c where b.id = c.id and a.id = b.id 审批时可以看到如下的信息，涉及关联字段较多，其使用方式都能够在审批界面中展示出来。 图1 基础信息 执行结果如下。 图2 执行结果 结果显示， TICS 支持大量基础的SQL语法。 图3 SQL编写提醒

设备查询 地图上可查看已接入的设备。 通过筛选设备类型，在地图上高亮同类型的所有设备。 通过输入设备Id或esn，在地图上高亮显示相应的设备。 在线率统计：各个设备类型的统计原理详见表1。 表1 设备在线率统计 统计对象 统计原理 边缘Edge 在线率=设备在线数 / 边缘Edge设备总数 在线：该边缘Edge和 路网数字化服务 连接正常 运行中：该边缘Edge节点在IEF（华为云智能边缘平台）状态为运行中，即Atlas设备和IEF当前连接正常 待部署：该边缘Edge节点在IEF状态为待部署，即Atlas设备还未部署 部署中：该边缘Edge节点在IEF状态为部署中，即Atlas设备正在部署 离线：该边缘Edge和路网数字化服务连接断开 升级中：该边缘Edge节点在IEF状态为升级中，即Atlas设备正在升级 删除中：该边缘Edge节点在IEF状态为删除中，即Atlas设备正在删除 未接入：该边缘Edge设备信息导入后，和路网数字化服务从未建立过连接 路侧RSU 在线率=设备在线数 / RSU设备总数 在线：该RSU和路网数字化服务连接正常 离线：该RSU和路网数字化服务连接断开 未接入：该RSU设备信息导入后，RSU设备和路网数字化服务从未建立过连接 摄像头 在线率=设备在线数 / 摄像头设备总数 在线：该摄像头和路网数字化服务连接正常 离线：该摄像头和路网数字化服务连接断开 未接入：该摄像头设备信息导入后，和路网数字化服务从未建立过连接 雷达 在线率=设备在线数 / 雷达设备总数 在线：该雷达和路网数字化服务连接正常 离线：该雷达和路网数字化服务连接断开 未接入：该雷达设备信息导入后，和路网数字化服务从未建立过连接 设备删除：单击“删除”按钮，可以删除该设备信息。 设备详情：单击“详情”按钮，可以查看该设备的详细信息。 设备修改：单击“编辑”按钮，可以修改该设备信息。 父主题： 设备管理

计费示例 假设您在2023/03/08 15:50:04购买了一个包年/包月的AstroZero实例（用户数为35人，实例版本为专业版）。购买时长为1个月，并在到期前手动续费1个月，则： 第一个计费周期为：2023/03/08 15:50:04 ~ 2023/04/08 23:59:59 第二个计费周期为：2023/04/08 23:59:59 ~ 2023/05/08 23:59:59 图1中价格仅供参考，实际计算请以Astro轻应用价格详情中的价格为准。 图1 包年/包月AstroZero费用计算示例

计费说明 AstroZero根据您选择的实例版本、用户数和购买时长进行计费。AstroZero提供了四种不同的规格套餐供您选择。除了免费版实例外，其他三种规格套餐均为包年/包月购买方式。如您需要快速了解AstroZero服务的具体价格，请参见AstroZero价格详情。 表1标“*”的计费项为必选计费项。 表1 AstroZero计费项 计费项 计费项说明 适用的计费模式 计费公式 * 实例版本 AstroZero服务提供了标准版、专业版和专享版三种包年/包月的实例版本，请根据自身需求，购买相应的实例版本。 标准版：适用于零代码应用开发场景，开发者不需要有代码开发经验，企业自用首选。 专业版：专业版在标准版基础上提供了低代码应用运行环境（多租户共享运行环境），且提供了更多功能和资源，适用于专业开发者。 专享版：专享版提供了物理隔离的运行环境，运行环境实例发放到租户虚拟私有云中。使用专享版前，请确认已提交工单申请开通专享版，否则，您将无法购买专享版。 包年/包月 标准版270元/月，最多可添加30个用户（包括业务用户），超过的用户数将额外收取费用（9元/用户/月），即（¥270.00/月/基础30人 + ¥9.00/月/新增1人）*订购月份数 专业版1170元/月，最多可添加30个用户（包括业务用户），超过的用户数将额外收取费用（39元/用户/月），即（¥1170.00/月/基础30人 + ¥39.00/月/新增1人）*订购月份数 专享版提供了如下三种规格，供您选择。 500人：48000元/月，最多可添加500用户（包括业务用户）。 2000人：82000元/月，最多可添加2000用户（包括业务用户）。 5000人：128000元/月，最多可添加5000用户（包括业务用户）。 其中，1年按10个月计算。 * 用户数 购买用户的个数，即用户（应用开发者）和业务用户（应用使用者）之和。

2022-09-30 镜像版本 内核版本 更新内容 Huawei Cloud EulerOS 2.0等保2.0三级版 64位 5.10.0-60.18.0.50.h322_1.hce2.x86_64 第一次正式发布 该镜像是根据《GB/T22239-2019信息安全技术网络安全等级保护基本要求》进行等保加固的镜像，您使用本镜像无需额外配置即可满足以下等保合规要求： 身份鉴别 访问控制 安全审计 入侵防范 恶意代码防范 更多信息，请参见Huawei Cloud EulerOS 2.0等保2.0三级版镜像概述。 发布区域：所有区域 Huawei Cloud EulerOS 2.0 标准版 64位 ARM版 5.10.0-60.18.0.50.r509_2.hce2.x86_64 第一次正式发布。 发布区域：所有区域 Huawei Cloud EulerOS 2.0等保2.0三级版 64位 ARM版 5.10.0-60.18.0.50.h322_1.hce2.x86_64 第一次正式发布 发布区域：所有区域

2022-07-15 镜像名称 内核版本 更新内容 Huawei Cloud EulerOS 2.0 标准版 64位 ARM版 5.10.0-60.18.0.50.h322_1.hce2.x86_64 第一次正式发布 发布区域：所有区域 Huawei Cloud EulerOS 2.0 标准版 64位 5.10.0-60.18.0.50.h322_1.hce2.x86_64 第一次正式发布 发布区域：所有区域 Huawei Cloud EulerOS 1.1 CentOS兼容版 64位 3.10.0-1160.66.1.hce1c.x86_64 5.10.0-60.18.0.50.h322_1.hce2.x86_64（默认内核） 第一次正式发布 发布区域：新加坡

参数说明 参数 必选/可选 类型 位置 描述 taskId 必选 String path 批量任务ID，创建批量任务后获得。 select 必选 String query 指定可选的返回值，可取值：tag。不指定时可填写null。 appId 必选 String query 如果是本应用的任务，此参数值可以填写null，否则填写授权应用的appId。 accessToken 必选 String header 如果调用了定时刷新token接口，此参数值可以填写null，否则要填写鉴权接口获取的accessToken。

错误码 Http状态码 错误码 错误描述 说明 400 100019 Illegal request. 非法请求。 处理建议：请检查接口请求中的必须参数是否为空。 400 100022 The input is invalid 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 403 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 403 100217 The application hasn't been authorized 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系 物联网平台 维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 404 105005 The batchTask is not existed. 批量任务不存在。 处理建议：请检查接口请求中的taskId是否有误。 500 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。

返回结果 广播名称 广播参数 成员 描述 IOTA_TOPIC_HUB_RMVDEV_RSP HW_MSG对象 EN_IOTA_HUB_IE_TYPE 删除结果。 EN_IOTA_HUB_IE_TYPE： 枚举项 枚举值 类型 描述 EN_IOTA_HUB_IE_RESULT 0 EN_IOTA_HUB_RESULT_TYPE 添加/删除执行结果。 EN_IOTA_HUB_IE_DEVICEID 1 String 添加成功后分配的设备ID。 EN_IOTA_HUB_RESULT_TYPE： 枚举项 枚举值 描述 EN_IOTA_HUB_RESULT_SUC CES S 0 添加/删除执行成功。 EN_IOTA_HUB_RESULT_DEVICE_EXIST 1 设备已存在。 EN_IOTA_HUB_RESULT_DEVICE_NOTEXIST 2 设备不存在。 EN_IOTA_HUB_RESULT_DEVICE_FAILED 255 执行失败。

示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 // 开发者调用该接口进行设备删除 HW_cHAR *pcDeviceId = stDevice.pcDeviceId; IOTA_HubDeviceRemove(HW_NULL, pcDeviceId); 结果处理： HW_iNT Device_RemoveResultHandler(HW_UiNT uiCookie, HW_MSG pstMsg) { uiResult = HW_MsgGetUint (pstMsg, EN_IOTA_HUB_IE_RESULT); if (EN_IOTA_HUB_RESULT_SUCCESS != uiResult) { // retry with uiCookie return 0; } return 0; } HW_BroadCastReg(“IOTA_TOPIC_HUB_RMVDEV_RSP”, Device_RemovResultHandler);

参数说明 参数 必选/可选 类型 位置 描述 clientInfo 必选 ClientInfo - 见下表ClientInfo的描述。 ClientInfo 参数 必选/可选 类型 位置 描述 platformIp 必选 String(256) path 设置平台的IP。 platformPort 必选 String(256) path 设置平台的端口，如“8743”。 appId 必选 String(256) body 访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。 secret 必选 String(256) body 访问物联网平台的应用密钥，与appId对应，在物联网平台创建应用时由平台分配获得。

错误码 Http状态码 错误码 错误描述 说明 400 100247 Operation not allowed. The application has been frozen. 应用冻结。 处理建议：请检查应用是否因为欠费冻结。 400 102202 Required Parameter is null or empty. 必选参数为空。 处理建议：请检查请求参数中的必选参数是否已填写。 401 100208 AppId or secret is not right. appId或secret错误。 处理建议： 请检查appId和secret是否有误，是否新增字符或缺少字符。 请检查请求路径中的IP地址是否有误。 500 50252 Internal server error. 服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

返回值 AuthOutDTO 参数 类型 描述 scope String(256) 申请权限范围，即accessToken所能访问物联网平台资源的范围，参数值固定为default。 tokenType String(256) accessToken的类型，参数值固定为bearer。 expiresIn Number(256) 平台生成并返回accessToken的有效时间，单位为秒。 accessToken String(256) 鉴权参数，访问物联网平台API接口的凭证。 refreshToken String(256) 鉴权参数，用来刷新accessToken，refreshToken的有效时间为“1”个月。

错误码 Http状态码 错误码 错误描述 说明 200 100203 The application is not existed. 应用不存在。 处理建议： 请检查HTTP请求头域中携带的appId是否有误。 请检查请求路径（url）中传入的appId是否有误。 200 100217 The application hasn't been authorized. 应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 200 100418 The deviceData is not existed. 设备信息不存在。 处理建议： 请求参数中携带的deviceId错误。请确认该deviceId是否属于该appId或者deviceId是否写错。 Header中携带的appId有误，请确认该appId下是否有该deviceId。 如果URL中携带了可选参数appId，请检查该appId是否有误。 200 100428 The device is not online. 设备不在线。 处理建议：请检查设备与网关的连接是否正常。 200 100432 The device command is muted. 设备命令已被禁用。 处理建议：请检查接口请求参数method中的命令是否有误。 400 100022 The input is invalid. 输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 400 102203 CommandName is invalid. 命令名称无效。 处理建议：请检查接口请求参数method中携带的命令是否有误。 403 100450 The gateway is not online. 网关不在线。 处理建议：请检查网关与物联网平台的连接是否正常。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 Invalid access token or appId. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 404 100444 The serviceType is not exist. 服务类型不存在。 处理建议：请检查接口请求参数toType中的服务类型是否有误。 500 100001 Internal server error. 服务内部处理错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 500 100023 The data in dataBase is abnomal. 数据库异常。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 500 50252 Internal server error. 服务内部处理错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 503 100501 Congestion occurs, and the current network has been flow-controlled 发生拥塞，当前的网络已经被流控。

响应参数 InvokeDeviceServiceOutDTO 参数 类型 描述 status String(128) 命令状态。 “sent”：已发送 “deliveried”：已投递，toType为“CLOUD”的请求才有该返回值 “failed”：失败，toType为“CLOUD”的请求才有该返回值 timestamp String(128) 发送命令的时间戳，时间格式：yyyyMMdd'T'HHmmss'Z'， 如“20151212T121212Z”。 requestId String(128) 设备命令ID。 toType为“GATEWAY”时，如果请求有requestId则同请求的requestId一致，如果请求无requestId则平台分配一个序列号。 toType为“CLOUD”时，则为空。

参数说明 参数 必选/可选 类型 位置 描述 commandDTO 必选 CommandDTO body 见下表CommandDTO的描述。 deviceId 必选 String(1-64) path 设备ID，用于唯一标识一个设备。 serviceId 必选 String(1-64) path 服务ID，唯一标识一个服务。 appId 可选 String query 如果是本应用的设备，此参数值可以填写None，否则填写授权应用的appId。 accessToken 必选 String header 填写鉴权接口获取的accessToken。 CommandDTO 参数 必选/可选 类型 位置 描述 header 必选 CommandNA2CloudHeader body 具体参见CommandNA2CloudHeader结构体。 body 可选 Object body 消息的消息体。JsonObject里面是一个个健值对。每个健都是profile中命令的参数名（paraName）。 CommandNA2CloudHeader结构体说明： 参数 必选/可选 类型 位置 描述 requestId 可选 String(0-128) body 用于标识一个命令，不能重复。 mode 必选 Enum body 是否要确认消息。 “NOACK”：不需要确认消息 “ACK”：需要确认消息 其它值无效 from 可选 String(128) body 表示消息发布者的地址。 App发起的请求：“/users/{userId}” 第三方应用发起的请求：“/{serviceName}” 物联网平台发起的请求：“/cloud/{serviceName}” toType 可选 Enum body 消息接受者的类型，“CLOUD/GATEWAY”。 to 可选 String(128) body 消息接收者的地址。 method 必选 String(1-32) body 命令名称，如：“DISCOVERY”为发现非直连设备，“REMOVE”为删除非直连设备。 callbackURL 可选 String(1024) body 命令的回调路径。

典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令，设备不在线时命令下发失败。下发命令的具体格式需要第三方应用与设备自定义，物联网平台在接口中直接进行封装，透传。 此接口适用于使用MQTT协议接入的设备，例如集成了AgentLite SDK的设备。