Skip to main content

save_client_params_v2 保存NTP客户端参数V2

POST /api/v1/ntp/save_client_params_v2​

描述​

保存NTP客户端参数V2接口，用于保存NTP客户端的相关配置参数。第二个版本。

访问权限​

具备以下权限：

ntp:save_client_params_v2

JSON参数​

请求参数如下：

{
  "version": "string",
  "ntpClientEnabled": boolean,
  "servers": [
    {
      "address": "string",
      "enabled": boolean,
      "iburst": boolean,
      "minpoll": number,
      "maxpoll": number,
      "offset": number,
      "prefer": boolean,
      "key": number,
      "description": "string"
    },
    ...
  ]
}
tip
  • version: 版本号，当前版本为2.0。
  • ntpClientEnabled: NTP客户端使能，true表示启用，false表示禁用。必填字段
  • servers: NTP服务器列表，包含多个NTP服务器的配置参数。 必填字段，数组类型。
  • address: NTP服务器地址，可以是域名或IP地址。 必填字段
  • enabled: NTP服务器使能，true表示启用，false表示禁用。
  • iburst: NTP服务器iburst选项，true表示启用，false表示禁用。
  • minpoll: NTP服务器最小轮询间隔，单位为2的指数次幂，取值范围为4~17。
  • maxpoll: NTP服务器最大轮询间隔，单位为2的指数次幂，取值范围为4~17。
  • offset: NTP服务器偏移量，单位为毫秒。
  • prefer: NTP服务器优先级，true表示优先，false表示非优先。
  • key: NTP服务器密钥，取值范围为0~65535，0表示不使用密钥。
  • description: NTP服务器描述信息，可以为空字符串。

请求参数说明:

  • servers是数组列表，元素个数可以有多个，也可以为0；更新某个元素时可以只传递需要更新的选项。
  • 首选服务器（建议只有一个），就是如果配置多个NTP服务器，只有一个将"prefer"选项配置为"true"，不是强制要求，前端修改时最好可以检查，给与提示。
  • 非必须参数，比如 key、description都可以不传递

请求示例：

{
  "version": "2.0",
  "ntpClientEnabled": true,
  "servers": [
    {
      "address": "ntp.aliyun.com",
      "enabled": true,
      "iburst": true,
      "minpoll": 4,
      "maxpoll": 6,
      "offset": 0,
      "prefer": true,
      "key": 0,
      "description": "Aliyun NTP Server (Preferred)"
    },
    {
      "address": "pool.ntp.org",
      "enabled": false
    },
    {
      "address": "192.168.188.81",
      "enabled": true,
      "minpoll": 0,
      "maxpoll": 0,
      "offset": 0.000005,
      "prefer": false
    }
  ]
}