分页查询Ingress路由列表
更新时间 2026-06-22 10:42:49
最近更新时间: 2026-06-22 10:42:49
接口功能介绍
调用listIngressPage接口分页查询Ingress路由列表
接口约束
无
URI
GET /v2/ingress/listIngressPage
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| pageNum | 否 | Integer | 分页pageNum，默认值为1 | 1 | |
| pageSize | 否 | Integer | 分页pageSize，默认值为10 | 10 |
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池ID，请参考调用前必知-概述 | bb9fdb42056f11eda1610242ac110002 |
请求体body参数 无
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 响应编码 2000 success | ||
| message | String | 消息内容 | ||
| returnObj | Object | 返回数据 | returnObj | |
| error | String | 调用错误时返回的错误编码 |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| total | Integer | 总行数 | ||
| list | Array of Objects | 当前页记录列表 | list | |
| pageNum | Integer | 当前页 | ||
| pageSize | Integer | 每页行数 | ||
| size | Integer | 从startRow到endRow的记录数 | ||
| startRow | Integer | 当前页第一个元素在所有元素的序号 | ||
| endRow | Integer | 当前页最后一个元素在所有元素的序号 | ||
| pages | Integer | 总页数 | ||
| prePage | Integer | 前一页 | ||
| nextPage | Integer | 下一页 | ||
| isFirstPage | Boolean | 是否为第一页 | ||
| isLastPage | Boolean | 是否为最后一页 | ||
| hasPreviousPage | Boolean | 是否有前一页 | ||
| hasNextPage | Boolean | 是否有下一页 | ||
| navigatePages | Integer | 导航页码数 | ||
| navigatepageNums | Array of Integers | 所有导航页页号，Integer数组 | ||
| navigateFirstPage | Integer | 导航条上的第一页 | ||
| navigateLastPage | String | 导航条上的最后一页 |
表 list
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| ingressUuid | String | ingress路由uuid | ||
| ingressName | String | ingress路由名称 | ||
| ingressType | String | ingress类型 | ||
| clusterName | String | K8s集群名称 | ||
| namespace | String | K8s集群命名空间 | ||
| labels | Map of String | 标签 | ||
| annotations | Map of String | 注解 | ||
| rules | Array of Objects | ingress路由规则列表 | rules | |
| createTime | String | 创建时间 | ||
| updateTime | String | 更新时间 | ||
| endpoint | String | endpoint |
表 rules
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| ingressRuleUuid | String | ingress路由规则uuid | ||
| host | String | 主机域名 | ||
| enableTls | Integer | 是否开启TLS | ||
| secretName | String | K8s保密字典名称 | ||
| paths | Array of Objects | ingress路由服务列表 | paths |
表 paths
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| ingressPathUuid | String | ingress路由路径uuid | ||
| path | String | ingress路由路径 | ||
| pathType | String | ingress路由路径路径类型 | ||
| appDeployName | String | 应用实例名称 | ||
| appDeployUuid | String | 应用实例uuid | ||
| serviceName | String | 应用实例添加的K8s service名称 | ||
| servicePort | Integer | 应用实例添加的K8s service端口 |
枚举参数
无
请求示例
请求url
GET https://msap-global.ctapi.ctyun.cn/v2/ingress/listIngressPage
请求头header
{
"regionId": "bb9fdb42056f11eda1610242ac110002"
}
请求体body
无
响应示例
{
"statusCode": 2000,
"message": "成功",
"returnObj": {
"total": 3,
"list": [
{
"ingressUuid": "bdd1e52dc7724ef19b09adb17f3eb572",
"ingressName": "ffffffcxxccx",
"ingressType": "nginx",
"clusterName": "cce-6ox1df",
"namespace": "default",
"labels": null,
"annotations": null,
"rules": [
{
"ingressRuleUuid": "fd426641a11848efa283cf37ffcca37d",
"host": "www.baidu.com",
"enableTls": 0,
"secretName": null,
"paths": [
{
"ingressPathUuid": "8508b5c9bbe04343a452a84f1c48aae3",
"path": "/index",
"pathType": "ImplementationSpecific",
"appDeployName": "consumer666",
"appDeployUuid": "4daa0cfbf1de4c90bee65c16cdbdc16c",
"serviceName": "test-666",
"servicePort": 28081
}
]
}
],
"createTime": "2024-12-25T09:34:49.000+08:00",
"updateTime": "2024-12-25T09:34:49.000+08:00",
"endpoint": null
},
{
"ingressUuid": "dc1dc9a6ec5547ea89169a42cd1f9b94",
"ingressName": "666",
"ingressType": "nginx",
"clusterName": "cce-uq10qb",
"namespace": "you",
"labels": {
"edas_ingress": "true"
},
"annotations": {
"kubernetes.io/ingress.class": "nginx-ingress-controller"
},
"rules": [
{
"ingressRuleUuid": "64d8ccdcf36d4b9bbcb134631afcd65e",
"host": "aaaa",
"enableTls": 0,
"secretName": null,
"paths": [
{
"ingressPathUuid": "df7604fcc800492a86255ba309d78a15",
"path": "/abc",
"pathType": "ImplementationSpecific",
"appDeployName": "consumer666",
"appDeployUuid": "4daa0cfbf1de4c90bee65c16cdbdc16c",
"serviceName": "test-666",
"servicePort": 28081
}
]
}
],
"createTime": "2024-12-24T17:41:35.000+08:00",
"updateTime": "2024-12-24T18:10:13.000+08:00",
"endpoint": null
},
{
"ingressUuid": "7d2338062dc94efeb45b6304cb426682",
"ingressName": "nginx-ttl2",
"ingressType": "nginx",
"clusterName": "cce-6ox1df",
"namespace": "default",
"labels": null,
"annotations": null,
"rules": [
{
"ingressRuleUuid": "6e7698ce1d944bdda3550f056a0be1a4",
"host": "www.bg.com",
"enableTls": 0,
"secretName": null,
"paths": [
{
"ingressPathUuid": "b192d124ca174801bbac2bc9512e224c",
"path": "/bbq",
"pathType": "ImplementationSpecific",
"appDeployName": "nginx-test",
"appDeployUuid": "b9874937b86d4399b8e8e4f0e24b5c73",
"serviceName": "nginx888",
"servicePort": 8081
}
]
}
],
"createTime": "2024-12-12T14:40:18.000+08:00",
"updateTime": "2024-12-12T14:40:18.000+08:00",
"endpoint": null
}
],
"pageNum": 1,
"pageSize": 10,
"size": 3,
"startRow": 1,
"endRow": 3,
"pages": 1,
"prePage": 0,
"nextPage": 0,
"isFirstPage": true,
"isLastPage": true,
"hasPreviousPage": false,
"hasNextPage": false,
"navigatePages": 8,
"navigatepageNums": [
1
],
"navigateFirstPage": 1,
"navigateLastPage": 1
}
}
状态码
请参考 状态码
错误码
请参考 错误码
