全部产品
Search

搜索本产品

    容器服务 Kubernetes 版 ACK：DescribeClusterAddonsVersion - 查询集群组件版本

    文档中心

    容器服务 Kubernetes 版 ACK：DescribeClusterAddonsVersion - 查询集群组件版本

    更新时间：Nov 07, 2024
    目前该API接口已标记为弃用，推荐使用替代API：CS(2015-12-15) - ListClusterAddonInstances、CS(2015-12-15) - GetClusterAddonInstance。

    根据集群ID，查询集群中已安装的所有组件的详情。

    调试

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

    授权信息

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

    • 操作：是指具体的权限点。
    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
      • 对于必选的资源类型，用背景高亮的方式表示。
      • 对于不支持资源级授权的操作，用全部资源表示。
    • 条件关键字：是指云产品自身定义的条件关键字。
    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    cs:Queryk8sComponentsUpdateVersionget
    • Cluster
      acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
      无
    		无

    请求语法

    GET /clusters/{ClusterId}/components/version HTTP/1.1

    请求参数

    名称类型必填描述示例值
    ClusterIdstring是

    集群 ID。

    		c82e6987e2961451182edacd74faf****

    返回参数

    名称类型描述示例值
    object

    返回体参数。

    object

    组件详情。

    component_namestring

    组件名称。

    		ack-node-problem-detector
    versionstring

    组件当前版本。

    说明 如果version值不为空，则表示该组件已经安装。
    		1.2.1
    next_versionstring

    下一个可升级版本。

    		1.2.1
    changedstring

    组件是否有更新。取值：

    • true：已更新。
    • false：未更新。
    		false
    can_upgradeboolean

    组件是否可升级。取值：

    • true：组件可升级。
    • false：组件不可升级。
    		false
    policystring

    组件升级策略。

    • overwrite：强制覆盖。

    默认值：overwrite。

    		overwrite
    ready_to_upgradestring

    组件是否满足升级条件。取值：

    • true：满足升级条件。
    • false：不满足升级条件。
    		false
    existboolean

    是否可以在集群中安装该组件。取值：

    • true：可安装。
    • false：不可安装。
    		true
    requiredboolean

    组件是否为集群必需组件。取值：

    • true：为必需组件。
    • false：非必需组件。
    		false
    messagestring

    组件是否可升级的额外说明。

    		节点故障检测以及上报至事件中心的插件
    valuestring

    组件安装时，用户自定义的参数值。

    		npd:\n # Custom monitor definitions to add to Node Problem Detector ****

    示例

    正常返回示例

    JSON格式

    {
  "key": {
    "component_name": "ack-node-problem-detector",
    "version": "1.2.1",
    "next_version": "1.2.1",
    "changed": "false",
    "can_upgrade": false,
    "policy": "overwrite",
    "ready_to_upgrade": "false",
    "exist": true,
    "required": false,
    "message": "节点故障检测以及上报至事件中心的插件",
    "value": "npd:\\n  # Custom monitor definitions to add to Node Problem Detector ****"
  }
}

    错误码

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

    变更历史

    变更时间变更内容概要操作
    2024-01-12OpenAPI 变更为 deprecated，即将下线查看变更详情