调用DescribeDeviceAutoUpgradePolicy查看智能接入网关设备运行软件的升级策略

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeDeviceAutoUpgradePolicy	系统规定参数。取值：DescribeDeviceAutoUpgradePolicy。
RegionId	String	是	cn-shanghai	智能接入网关实例所属的地域ID。
SmartAGId	String	是	sag-kxe2cv7hot7qrv****	智能接入网关实例ID。
SerialNumber	String	是	sage62x022502****	智能接入网关设备序列号。
VersionType	String	否	Device	要查看的软件类型： Device：表示智能接入网关设备运行的操作系统软件。 Dpi：表示智能接入网关设备运行的应用特征库软件。

返回数据


名称	类型	示例值	描述
UpgradeType	String	scheduled	升级类型。 scheduled：定时升级。 boot：开机自动升级。 manual：手动升级。
TimeZone	String	Asia/Shanghai	时区。
SerialNumber	String	sage62x022502****	智能接入网关设备序列号。
RequestId	String	0E20FBB8-BCFC-4F5E-BD94-77FF6A2133D0	请求ID。
Jitter	String	5	升级时间的上下偏差。单位：分钟。
Duration	String	60	升级时间段。取值范围：30~120。单位：分钟。
CronExpression	String	0 0 4 1/1 * ?	升级开始时间。升级开始时间使用cron表达式。例如：`0 0 4 1/1 * ?`表示从每月第一天上午4时开始，每天执行升级操作。
SmartAGId	String	sag-kxe2cv7hot7qrv****	智能接入网关实例ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeDeviceAutoUpgradePolicy
&RegionId=cn-shanghai
&SerialNumber=sage62x022502****
&SmartAGId=sag-1um5x5nwhilymw****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDeviceAutoUpgradePolicyResponse>
<SerialNumber>sage62x022502****</SerialNumber>
<SmartAGId>sag-kxe2cv7hot7qrv****</SmartAGId>
<UpgradeType>scheduled</UpgradeType>
<Duration>60</Duration>
<RequestId>0E20FBB8-BCFC-4F5E-BD94-77FF6A2133D0</RequestId>
<CronExpression>0 0 4 1/1 * ?</CronExpression>
<TimeZone>Asia/Shanghai</TimeZone>
</DescribeDeviceAutoUpgradePolicyResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "SerialNumber" : "sage62x022502****",
  "SmartAGId" : "sag-kxe2cv7hot7qrv****",
  "UpgradeType" : "scheduled",
  "Duration" : 60,
  "RequestId" : "0E20FBB8-BCFC-4F5E-BD94-77FF6A2133D0",
  "CronExpression" : "0 0 4 1/1 * ?",
  "TimeZone" : "Asia/Shanghai"
}

错误码

访问错误中心查看更多错误码。