查询集群服务网段
更新时间 2026-08-17 12:01:37
最近更新时间: 2026-08-17 12:01:37
接口功能介绍
查询集群服务网段（ServiceCidr资源）列表
接口约束
仅使用Calico的IPv4单栈1.31.6版本集群支持
URI
GET /v2/cce/clusters//apis/networking.k8s.io//servicecidrs
路径参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| clusterId | 是 | String | 集群ID，获取方式请参见如何获取接口URI中参数 | ||
| apiVersion | 是 | String | 资源api的版本，请选择当前所操作集群支持的资源api版本，可参见Kubernetes版本与资源API版本对应表。 | v1beta1 |
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池ID，您可以查看云容器引擎资源池 | ||
| b342b77ef26b11ecb0ac0242ac110002 |
请求体body参数 无
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 响应状态码 | 800 | |
| message | String | 响应信息 | success | |
| returnObj | String | 字符串类型的多个ServiceCidr资源yaml定义 | apiVersion: networking.k8s.io/v1beta1kind: ServiceCIDRmetadata: creationTimestamp: '2025-07-14T08:53:38Z' managedFields: - apiVersion: networking.k8s.io/v1beta1 fieldsType: FieldsV1 fieldsV1: f:spec: f:cidrs: {} manager: fabric8-kubernetes-client operation: Update time: '2025-07-14T08:53:38Z' name: test resourceVersion: '2062354' uid: 53f1450b-eed5-4d78-9c8e-b43b65ed2724spec: cidrs: [172.26.1.0/24]status: {} | |
| error | String | 错误码，参见错误码说明 | CCSE_500 |
枚举参数
无
请求示例
请求url
GET https://ccse-global.ctapi.ctyun.cn/v2/cce/clusters/{clusterId}/apis/networking.k8s.io/v1beta1/servicecidrs
请求头header
{
regionId:bb9fdb42056f11eda1610242ac110002
}
请求体body
无
响应示例
{
"code": 0,
"requestId": "6df4cca3-24cb-4427-aa99-1a88ff0bc27b",
"statusCode": 800,
"message": "Successfully queried the list of cluster-level resources.",
"returnObj": "apiVersion: networking.k8s.io/v1beta1\nitems:\n- apiVersion: networking.k8s.io/v1beta1\n metadata:\n creationTimestamp: '2025-07-15T02:01:50Z'\n finalizers: [networking.k8s.io/service-cidr-finalizer]\n managedFields:\n - apiVersion: networking.k8s.io/v1beta1\n fieldsType: FieldsV1\n fieldsV1:\n f:status:\n f:conditions:\n k:{\"type\":\"Ready\"}:\n .: {}\n f:status: {}\n f:type: {}\n manager: kubernetes-service-cidr-controller\n operation: Apply\n subresource: status\n time: '2025-07-15T02:01:50Z'\n - apiVersion: networking.k8s.io/v1beta1\n fieldsType: FieldsV1\n fieldsV1:\n f:status:\n f:conditions:\n k:{\"type\":\"Ready\"}:\n .: {}\n f:lastTransitionTime: {}\n f:message: {}\n f:status: {}\n f:type: {}\n manager: service-cidr-controller\n operation: Apply\n subresource: status\n time: '2025-07-16T01:34:17Z'\n - apiVersion: networking.k8s.io/v1beta1\n fieldsType: FieldsV1\n fieldsV1:\n f:spec:\n f:cidrs: {}\n manager: kube-apiserver\n operation: Update\n time: '2025-07-15T02:01:50Z'\n - apiVersion: networking.k8s.io/v1beta1\n fieldsType: FieldsV1\n fieldsV1:\n f:metadata:\n f:finalizers:\n .: {}\n v:\"networking.k8s.io/service-cidr-finalizer\": {}\n manager: kube-controller-manager\n operation: Update\n time: '2025-07-15T02:01:59Z'\n name: kubernetes\n resourceVersion: '161916'\n uid: 3cb3a433-2804-452a-bc13-e56670c0ab1b\n spec:\n cidrs: [10.96.0.0/16]\n status:\n conditions:\n - {type: Ready, status: 'True', lastTransitionTime: '2025-07-16T01:34:17Z', reason: '',\n message: Kubernetes Service CIDR is ready}\nkind: ServiceCIDRList\nmetadata: {resourceVersion: '169507'}\n"
}
状态码
请参考 状态码
错误码
请参考 错误码
