调用DescribeSmartAccessGatewayVersions查询智能接入网关设备的软件版本信息。

调试

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

请求参数

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

系统规定参数。取值:DescribeSmartAccessGatewayVersions

RegionId String cn-hangzhou

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

SmartAGId String sag-d3m51apgw4po5*****

智能接入网关实例ID。

SmartAGSn String sage62x022502****

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

VersionType String Device

智能接入网关设备软件类型。取值:

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

返回数据

名称 类型 示例值 描述
RequestId String 765AB188-69BF-47C6-BEDD-B9FC72BFBB0

请求ID。

SmartAGVersions Array of SmartAGVersion

智能接入网关设备软件版本信息列表。

SmartAGVersion
Type String release

软件版本类型。取值:

  • beta:测试版本。
  • release:发布版本。
CreateTime Long 1522744623000

软件版本发布时间戳。

VersionName String testpackage1

软件版本名称。

VersionCode String 1.0

软件版本号。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeSmartAccessGatewayVersions
&RegionId=cn-hangzhou
&SmartAGId=sag-d3m51apgw4po5*****
&SmartAGSn=sage62x022502****
&VersionType=Device
&公共请求参数

正常返回示例

XML格式

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

<?xml version="1.0" encoding="UTF-8"?>
<DescribeSmartAccessGatewayVersionsResponse>
  <SmartAGVersions>
      <SmartAGVersion>
          <Type>release</Type>
          <CreateTime>1522744623000</CreateTime>
          <VersionCode>1.0</VersionCode>
          <VersionName>testpackage1</VersionName>
      </SmartAGVersion>
  </SmartAGVersions>
  <RequestId>765AB188-69BF-47C6-BEDD-B9FC72BFBB00</RequestId>
</DescribeSmartAccessGatewayVersionsResponse>

JSON格式

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

{
  "SmartAGVersions" : {
    "SmartAGVersion" : [ {
      "Type" : "release",
      "CreateTime" : 1522744623000,
      "VersionCode" : "1.0",
      "VersionName" : "testpackage1"
    } ]
  },
  "RequestId" : "765AB188-69BF-47C6-BEDD-B9FC72BFBB00"
}

错误码

HttpCode 错误码 错误信息 描述
400 VersionNotExist The specified version does not exist. 当前指定的版本不存在。
403 Forbidden User not authorized to operate on the specified resource. 用户没有操作此资源的权限。

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