跳到主要内容

ntp_port_list_x NTP端口参数列表

POST /api/v1/network/ntp_port_list_x​

描述​

获取NTP端口参数列表接口，用于获取NTP端口参数列表信息。x86平台配置项目。

访问权限​

需要登录，具备以下权限：

network:ntp_port_list

JSON参数​

请求参数如下：

{
  "id"?: 0 ~ n
}

参数id: 0 - n，表示获取指定id的NTP端口参数数据。如果不传递id参数，表示获取全部的NTP端口参数数据。

请求示例：

{
  "id": 0
}

响应结果​

请求返回的HTTP状态码为200

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

{
  "success": true|false,
  "data"?: [
    {
      "id": 0,
      "mac": "00:00:00:00:00:00",
      "ipv4Address": "ip",
      "ipv4NetMask": "ip",
      "ipv4Gateway": "ip",
      "ipv6Address": "ip",
      "ipv6PrefixLength": 0-128,
      "linkLocalAddress": "ip",
    },
    {
      "id": 1,
      "mac": "00:00:00:00:00:00",
      "ipv4Address": "ip",
      "ipv4NetMask": "ip",
      "ipv4Gateway": "ip",
      "ipv6Address": "ip",
      "ipv6PrefixLength": 0-128,
      "linkLocalAddress": "ip",
    },
    ...
  ],
  "errorCode"?: "option string",
  "errorMessage"?: "option string",
  "showType"?: 0|1|2|4|9,
  "traceId"?: "option string"
}
提示
  • id: NTP端口ID，取值范围为0-4
  • mac: MAC地址，格式为xx:xx:xx:xx:xx:xx，x为09、af的十六进制数字。
  • ipv4Address: IPv4地址，格式为x.x.x.x，x为0~255的数字。
  • ipv4NetMask: IPv4子网掩码，格式为x.x.x.x，x为0~255的数字。
  • ipv4Gateway: IPv4网关地址，格式为x.x.x.x，x为0~255的数字。
  • ipv6Address: IPv6地址，格式为x❌x❌x❌x:x，x为0~ffff的十六进制数字。
  • ipv6PrefixLength: IPv6前缀长度，取值范围为0-128。
  • linkLocalAddress: 链路本地地址，格式为x❌x❌x❌x:x，x为0~ffff的十六进制数字。

正确结果示例：

{
  "success": true,
  "data": [
    {
      "id": 0,
      "mac": "00:00:00:00:00:00",
      "ipv4Address": "192.168.188.87",
      "ipv4NetMask": "255.255.255.0",
      "ipv4Gateway": "192.168.188.1",
      "ipv6Address": "fe80::1",
      "ipv6PrefixLength": 64,
      "linkLocalAddress": "fe80::1"
    },
    {
      "id": 1,
      "mac": "00:00:00:00:00:00",
      "ipv4Address": "10.10.0.87",
      "ipv4NetMask": "255.255.0.0",
      "ipv4Gateway": "10.10.0.1",
      "ipv6Address": "fe80::1",
      "ipv6PrefixLength": 64,
      "linkLocalAddress": "fe80::1"
    },
    ...
}

错误结果示例, 返回false时候需要带上错误码和错误信息：

{
  "success": false,
  "errorCode": "40004",
  "errorMessage": "no.permission",
  "showType": 4
}

错误码​

错误码说明错误信息显示类型
40000没有空白参数no.blank.params4
提示

4 表示弹框提示错误信息。