跳到主要内容

get_client_params_v2 获取ntp客户端配置参数

POST /api/v1/ntp/get_client_params_v2

描述

获取ntp客户端配置参数接口,用于获取ntp客户端的相关配置参数。第二个版本。

访问权限

具备以下权限:

ntp:get_client_params_v2

JSON参数

请求参数如下:

{}

无参数, 传递空对象即可 请求示例:

{}

响应结果

请求返回的HTTP状态码为200

返回结果为JSON格式的数据,您可以通过解析JSON数据来获取API调用的结果信息。结构如下:

{
"success": true|false,
"data"?: {
"version": "string",
"ntpClientEnabled": boolean,
"servers": [
{
"address": "string",
"enabled": boolean,
"iburst": boolean,
"minpoll": number,
"maxpoll": number,
"offset": number,
"prefer": boolean,
"key": number,
"description": "string"
}
]
},
"errorCode"?: "option string",
"errorMessage"?: "option string",
"showType"?: 0|1|2|4|9,
"traceId"?: "option string"
}
提示
  • version: 版本号,当前版本为2.0。
  • ntpClientEnabled: NTP客户端使能状态,true表示启用,false表示禁用。
  • servers: NTP服务器列表,包含多个NTP服务器的配置参数。 servers是数组列表,元素个数可以有多个,也可以为0;更新某个元素时可以只传递需要更新的选项。 每个NTP服务器包含以下参数:
    • address: NTP服务器地址,可以是域名或IP地址。
    • enabled: NTP服务器使能状态,true表示启用,false表示禁用。
    • iburst: 是否启用iburst模式,true表示启用,false表示禁用。
    • minpoll: 最小轮询间隔,单位为2的次幂秒。
    • maxpoll: 最大轮询间隔,单位为2的次幂秒。
    • offset: NTP服务器偏移量,单位为毫秒。
    • prefer: 是否为首选服务器,true表示是,false表示否。
    • key: NTP服务器密钥,默认为0表示不使用密钥。
    • description: NTP服务器描述信息,用于标识服务器的用途或位置。

注:offset使用jansson库实数类型,前端显示做一个格式化处理,最多保留9位小数。