文档中心

容器服务

请输入

集群管理

DeleteKubeconfigs - 吊销 Kubeconfig

吊销集群的 Kubeconfig 凭证。

使用说明

此接口为异步接口，当此接口返回成功时，不代表 Kubeconfig 已成功吊销，需要您等待 5 秒后调用 ListKubeconfigs 接口查看该 Kubeconfig 是否存在，若未查询到，表示已删除成功。

请求说明

VKE 已在全球多个地域部署服务，旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅服务地址文档，根据业务所在地域，选择最合适的接入点。

请求地址：https://vke.cn-beijing.volcengineapi.com?Action=DeleteKubeconfigs&Version=2022-05-12

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

请求参数

调用该 API 时的请求参数如下，除此之外还需传入公共请求参数。公共请求参数说明，请参见公共参数。

参数	类型	是否必选	示例值	描述
Action	String	是	DeleteKubeconfigs	接口名称。当前 API 的名称为 DeleteKubeconfigs。
Version	String	是	2022-05-12	接口版本。当前 API 的版本为 2022-05-12。
ClusterId	String	是	cc5silum****	集群 ID。可以调用 ListClusters 接口，获取集群 ID。注意集群必须处于{Running,[Ok]}或{Updating,[Progressing]}状态。可调用 ListClusters 接口获取集群当前的状态。
Ids	Array of String	是	["kc5silumrsfeqxxxx"]	Kubeconfig ID。在容器服务控制台的集群页面，单击目标集群名称后，在集群的基本信息页面连接信息页签获取 Kubeconfig ID，也可以查看调用 CreateKubeconfig 接口后保存的 Kubeconfig ID 信息。

请求示例

返回参数

本接口无专有返回参数，公共返回参数请参见返回结果。

返回示例

错误码

本接口错误码如下表所示，公共错误码请参见公共错误码。

HTTP 状态码	错误码	错误信息	说明
400	OperationDenied.ClusterStatus	The action has been denied due to wrong cluster status {{statusPhase}} and [{{statusConditions}}].	指定集群的当前状态不支持该操作。请确认该接口依赖的集群状态后重试。
400	OperationDenied.KubeconfigStatus	The action has been denied due to wrong kubeconfig status {{statusPhase}}.	当前 Kubeconfig 状态下无法执行此操作。请您等待 5 秒后重试。

最近更新时间：2026.01.14 15:53:17

这个页面对您有帮助吗？

有用

无用