调用ModifyDeviceAutoUpgradePolicy修改智能接入网关设备软件的升级策略。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyDeviceAutoUpgradePolicy

系统规定参数。取值:ModifyDeviceAutoUpgradePolicy

RegionId String cn-shanghai

智能接入网关实例的地域ID。

SmartAGId String sag-1um5x5nwhilymw****

智能接入网关实例ID。

SerialNumber String sage62x022502****

智能接入网关设备序列号。

CronExpression String 0 0 4 1/1 * ?

升级开始时间。升级开始时间使用cron表达式。

例如:0 0 4 1/1 * ?表示从每月第一天上午4时开始,每天的上午4时执行升级操作。

UpgradeType String scheduled

升级类型。取值:

  • scheduled:定时升级。
  • boot:开机自动升级。
  • manual:手动升级。
Duration Integer 30

升级时间段。取值范围:30~120

单位:分钟。

TimeZone String Asia/Shanghai

时区。取值:

Asia/Shanghai :中国标准时间(北京)

Asia/Hong_Kong :中国香港时间

Asia/Tokyo :日本时间(东京)

Australia/Sydney :澳洲时间(悉尼)

Asia/Kuala_Lumpur :马来西亚时间(吉隆坡)

Europe/Berlin :德国时间(柏林)

Asia/Singapore :新加坡时间

Asia/Jakarta :印度尼西亚时间(雅加达)

VersionType String Device

指定要修改升级策略的软件类型。取值:

  • Device:表示智能接入网关设备运行的操作系统软件。
  • Dpi:表示智能接入网关设备运行的应用特征库软件。

返回数据

名称 类型 示例值 描述
RequestId String F03C6897-2284-4BC8-94B4-1467BD992A2D

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyDeviceAutoUpgradePolicy
&CronExpression=0 0 4 1/1 * ?
&Duration=30
&RegionId=cn-shanghai
&SerialNumber=sage62x022502****
&SmartAGId=sag-1um5x5nwhilymw****
&TimeZone=Asia/Shanghai
&UpgradeType=scheduled
&<公共请求参数>

正常返回示例

XML格式

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

<ModifyDeviceAutoUpgradePolicyResponse>
<RequestId>F03C6897-2284-4BC8-94B4-1467BD992A2D</RequestId>
</ModifyDeviceAutoUpgradePolicyResponse>

JSON格式

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

{
  "RequestId" : "F03C6897-2284-4BC8-94B4-1467BD992A2D"
}

错误码

HttpCode 错误码 错误信息 描述
400 SAG.InstanceIdEmpty You must specify the SAG instance ID. 智能接入网关实例ID为空。
400 SAG.InvalidSerialNumber The specified SerialNumber is invalid. 非法的序列号。

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