调用ListClusterKubeconfigStates获取指定集群的KubeConfig列表及状态-容器服务 Kubernetes 版 ACK-阿里云

如果您需要查看当前集群的访问控制情况，您可以调用ListClusterKubeconfigStates接口来获取当前集群已下发用户KubeConfig的列表以及状态。

接口说明

说明

使用该接口需要拥有 ram:ListUsers 和 ram:ListRoles 权限

使用该接口需要拥有管理容器服务（CS）的权限（AliyunCSFullAccess）

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
cs:ListClusterKubeconfigStates	none	*Cluster `acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}`	无	无

请求语法

GET /clusters/{ClusterId}/kubeconfig/states HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
ClusterId	string	否	集群 ID。	c82e6987e2961451182edacd74faf****
pageNumber	integer	否	页码。取值范围：大于等于 1 默认值：1	1
pageSize	integer	否	每页记录数。取值范围：1-50 默认值：10	10

返回参数

名称	类型	描述	示例值
	object	响应体参数。
states	array<object>	集群关联的 KubeConfig 状态列表。
state	object
account_id	string	阿里云账号、RAM 用户或角色 ID。	22855*****************
account_name	string	RAM 用户登录名称或角色名称。	tom
account_display_name	string	RAM 用户显示名称或角色名称。	tom
account_type	string	账号类型。 RootAccount: 阿里云账号 RamUser: RAM 用户 RamRole:RAM 角色	RamUser
account_state	string	账号状态。 Active: 当前账号状态为活跃 InActive: 当前账号状态为冻结 Deleted：当前账号状态为已删除	Active
cert_expire_time	string	KubeConfig 客户端证书过期时间。	2027-07-15T01:32:20Z
cert_state	string	KubeConfig 客户端证书状态。 Unexpired: 未过期 Expired：已过期 Unknown: 未知（异常状态）	Expired
revokable	boolean	KubeConfig 客户端证书是否可吊销。	true
page	object	分页信息。
page_number	integer	页码。	1
page_size	integer	每页包含的最大记录数量。	10
total_count	integer	结果总数。	5

示例

正常返回示例

JSON格式

{
  "states": [
    {
      "account_id": "22855*****************",
      "account_name": "tom",
      "account_display_name": "tom",
      "account_type": "RamUser",
      "account_state": "Active",
      "cert_expire_time": "2027-07-15T01:32:20Z",
      "cert_state": "Expired",
      "revokable": true
    }
  ],
  "page": {
    "page_number": 1,
    "page_size": 10,
    "total_count": 5
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作

暂无变更历史