文档首页/ 云解析服务 DNS/ API参考/ API/ 记录集管理(v2.1)/ 查询系统线路 - ListSystemLines
更新时间:2025-11-14 GMT+08:00

查询系统线路 - ListSystemLines

功能介绍

查询系统预置解析线路。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v2.1/system-lines

表1 Query参数

参数

是否必选

参数类型

描述

locale

String

参数解释:

指定显示语言。

约束限制:

不涉及。

取值范围:

  • zh-cn:中文

  • en-us:英语

  • es-us:西班牙语

  • pt-br:葡萄牙语

默认取值:

zh-cn

limit

Integer

参数解释:

分页查询时配置每页返回的资源个数。

约束限制:

不涉及。

取值范围:

0~1000。

默认取值:

1000

offset

Integer

参数解释:

分页查询起始偏移量,表示从偏移量的下一个资源开始查询。

约束限制:

当设置marker不为空时,以marker为分页起始标识,offset不生效。

取值范围:

0~2147483647。

默认取值:

0

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

lines

Array of SystemLine objects

参数解释:

线路列表。

取值范围:

不涉及。

metadata

metadata object

参数解释:

返回满足过滤条件的资源总数。

取值范围:

不涉及。

表3 SystemLine

参数

参数类型

描述

id

String

参数解释:

线路ID。

取值范围:

不涉及。

father_id

String

参数解释:

父线路ID。

取值范围:

不涉及。

name

String

参数解释:

线路名称。

取值范围:

不涉及。

表4 metadata

参数

参数类型

描述

total_count

Integer

参数解释:

满足查询条件的资源总数,不受分页(即limit、offset参数)影响。

取值范围:

不涉及。

请求示例

查询系统线路。

GET https://{endpoint}/v2.1/system-lines

响应示例

状态码:200

查询系统线路响应。

{
  "lines" : [ {
    "id" : "default_view",
    "father_id" : "DEFAULT",
    "name" : "全网默认"
  }, {
    "id" : "AP",
    "father_id" : "REGION",
    "name" : "亚太地区"
  }, {
    "id" : "Dianxin",
    "father_id" : "ISP",
    "name" : "电信"
  }, {
    "id" : "Dianxin_Huabei",
    "father_id" : "Dianxin",
    "name" : "华北地区"
  }, {
    "id" : "Dianxin_Beijing",
    "father_id" : "Dianxin_Huabei",
    "name" : "北京"
  } ]
}

状态码

状态码

描述

200

查询系统线路响应。

错误码

请参见错误码