查询额外K8s命名空间列表

最近更新时间: 2026-10-11 00:12:05

1. 接口描述

接口请求域名： tsf.api3.fincloud.tencent.com。

获取k8s命名空间列表

默认接口请求频率限制：20次/秒。

接口更新时间：2026-02-04 23:30:32。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeExtraKubeNamespaces
Version	是	否	String	公共参数，本接口取值：2018-03-26
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
K8sNamespaceList	否	否	Array of String	k8s命名空间列表，不传入时查询全量示例值：
Limit	否	否	Int64	限制数目示例值：
Offset	否	否	Int64	偏移量示例值：
SearchWord	否	是	String	模糊查询，通过id和name进行过滤示例值：

3. 输出参数

参数名称	类型	描述
Result	KubeNamespacePage	k8s命名空间信息示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InvalidParameter.ParamError	参数错误。
UnauthorizedOperation.NoPrivilege	用户无权限访问该接口。。
FailedOperation.ApplicationQueryFailed	应用查询失败。
FailedOperation.TsfPrivilegeError	TSF权限模块异常，请联系系统管理员。。
InternalError.UnhandledException	[%s]模块未处理异常。。
MissingParameter.ApplicationIdNull	应用ID不能为空。
ResourceNotFound.MicroserviceOffline	目标微服务已离线[%s]。。
UnauthorizedOperation.NoLicense	缺少License。。
FailedOperation.DispatchCommonError	TSF暂时不能响应请求。

5. 示例

示例1 获取k8s命名空间列表

输入示例

POST / HTTP/1.1
Host: tsf.api3.fincloud.tencent.com
Content-Type: application/json
X-TC-Action: DescribeExtraKubeNamespaces
<Common Parameters>

{"Limit":20,"Offset":0,"SearchWord":"dev"}

输出示例

{
  "Response": {
    "RequestId": "786574b3-c7f9-4794-b57c-67247e34c162",
    "Result": {
      "Content": [
        {
          "ClusterId": "cls-23iwxsfg",
          "ClusterInfo": "dev-cluster(cls-23iwxsfg)",
          "K8sNamespace": "dev-1"
        }
      ],
      "TotalCount": 1
    }
  }
}