查询预置位列表

最近更新时间:2025-02-21 02:50:54

1. 接口描述

接口请求域名: vssapi.ctyun.cn
默认接口请求频率限制:500次/秒。

查询预置位列表。

2. 请求参数

参数类型是否必选示例值描述
ActionStringDescribeDevicePresets操作接口名,系统规定参数。
DeviceIdString29942028422873997设备ID。

3. 返回参数

参数类型描述
DeviceIdString设备ID。
DevicePresetsDevicePreset[]预置位列表。
RequestIdString唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

DevicePreset

参数类型描述
PresetIdString预置位编码。
PresetNameString预置位名称。

4. 示例

4.1 请求示例

https://vssapi.ctyun.cn/
?Action=DescribeDevicePresets
&DeviceId=29942028422873997
&Version=2020-06-12
&AccessKeyId= O0G0BPBI2T9YUD3U****
&Signature=cMKjvNwq%2FXGhGK6a%2FcwZwzue7c4%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=1016288166
&SignatureVersion=1.0
&Timestamp=1598952660

4.2 返回示例

{
  "DeviceId": "208383238668288",
  "DevicePresets": [
    {
      "PresetId": "1",
      "PresetName": "Preset 1"
    }
  ],
  "RequestId": "xaStNsngy6AWNGunPSDUUZ"
}

5. 错误码

ErrorCodeErrorMessage