Skip to main content

save_unicast_master_list_x 保存单播主时钟列表

POST /api/v1/ptp/save_unicast_master_list_x​

描述​

保存单播主时钟列表接口，用于保存单播主时钟列表信息。

访问权限​

具备以下权限：

ptp:save_global_params

JSON参数​

请求参数如下：

{
  "tables": [
    {
      "table_id": 1|2|3,
      "description"?: "option string",
      "logQueryInterval": -3~7,
      "addresses": [
        "option string"
      ]
    }
  ]
}
  • 参数tables: 单播主时钟列表数组，可以包含多个主时钟列表配置对象， 保存时，tables不能为空，但元素可以少于3个，比如希望只修改二层的MAC列表，只传一个参数即可，不传入的table不做修改
  • 参数table_id: 可选主时钟列表的ID，约定固定对应L2 层的通信，单播列表中的地址都是MAC地址；2对应UDPv4层PTP通信，单播列表中的地址都是IPv4地址；3对应UDPv 6层PTP通信，单播列表中的地址都是IPv6地址
  • 参数description: 主时钟列表的描述信息，可选参数
  • 参数logQueryInterval: 单播协商尝试的时间间隔，2的幂次方（秒），值为2对应4秒（常用），API限制范围 -3~7
  • 参数addresses: 地址列表，table_id=1时只能是MAC地址，table_id=2时只能是IPv4地址，table_id=3时只能是IPv6地址

请求示例：

{
  "tables": [
    {
      "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"
      ]
    }
  ]
}

响应结果​

请求返回的HTTP状态码为200

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

{
  "success": true|false,
  "errorCode"?: "option string",
  "errorMessage"?: "option string",
  "showType"?: 0|1|2|4|9,
  "traceId"?: "option string"
}

正确响应结果示例：

{
  "success": true
}