跳到主要内容

get_unicast_master_list_x 获取单播主时钟列表

POST /api/v1/ptp/get_unicast_master_list_x​

描述​

获取单播主时钟列表接口，用于获取单播主时钟列表信息。

访问权限​

具备以下权限：

ptp:get_global_params

JSON参数​

请求参数如下：

{}

响应结果​

请求返回的HTTP状态码为200

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

{
  "success": true|false,
  "data"?: [
    {
      "table_id": 1|2|3,
      "description"?: "option string",
      "logQueryInterval": -3~7,
      "addresses": [
        "option string"
      ]
    }
  ],
  "errorCode"?: "option string",
  "errorMessage"?: "option string",
  "showType"?: 0|1|2|4|9,
  "traceId"?: "option string"
}
提示
  • table_id: 可选主时钟列表的ID，约定固定对应L2 层的通信，单播列表中的地址都是MAC地址；2对应UDPv4层PTP通信，单播列表中的地址都是IPv4地址；3对应UDPv6层PTP通信，单播列表中的地址都是IPv6地址
  • logQueryInterval: 单播协商尝试的时间间隔，2的幂次方（秒），值为2对应4秒（常用），API限制范围 -3~7
  • addresses: 地址列表，table_id=1时只能是MAC地址，table_id=2时只能是IPv4地址，table_id=3时只能是IPv6地址

正确响应结果示例：

{
  "success": true,
  "data": [
    {
      "table_id": 1,
      "description": "[L2]Layer-2 Ethernet Unicast Masters",
      "logQueryInterval": 2,
      "addresses": [
        "00:1A:2B:3C:4D:5E",
        "00:1A:2B:3C:4D:5F"
      ]
    },
    {
      "table_id": 2,
      "description": "[UDPv4] IPv4 UDP Unicast Masters",
      "logQueryInterval": 2,
      "addresses": [
        "192.168.10.100",
        "192.168.10.101",
        "192.168.10.102"
      ]
    },
    {
      "table_id": 3,
      "description": "[UDPv6] IPv6 UDP Unicast Masters",
      "logQueryInterval": 2,
      "addresses": [
        "2001:db8::100",
        "2001:db8::101"
      ]
    }
  ]
}