全部产品
Search

搜索本产品

    容器服务 Kubernetes 版 ACK：DescribeClusterAttachScripts - 查询添加已有节点到集群节点池的脚本

    文档中心

    容器服务 Kubernetes 版 ACK：DescribeClusterAttachScripts - 查询添加已有节点到集群节点池的脚本

    更新时间：Aug 27, 2026

    如果需要将已有ECS实例添加到ACK集群中作为Worker节点，或移除Worker节点后需将节点实例重新加入节点池，ACK支持手动将已有节点到节点池。您可以调用DescribeClusterAttachScripts接口获取添加已有节点的脚本。

    调试

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

    调试

    授权信息

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

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    cs:DescribeClusterAttachScripts

    update

    *Cluster

    acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

    		 无 无

    请求语法

    POST /clusters/{ClusterId}/attachscript HTTP/1.1

    路径参数

    名称

    类型

    必填

    描述

    示例值
    ClusterId

    string

    是

    集群 ID。

    ca375a93a30474552ad2a0ebe183e****

    请求参数

    名称

    类型

    必填

    描述

    示例值
    body

    object

    否

    请求体参数。

    amd64
    nodepool_id

    string

    否

    节点池 ID，添加节点时可以将该节点添加到指定的节点池中。

    说明

    如果不指定节点池 ID，默认将节点添加至默认节点池。

    np1c9229d9be2d432c93f77a88fca0****
    format_disk

    boolean

    否

    手动添加已有实例到集群时，是否对该实例进行数据盘挂载，将容器和镜像存储在数据盘上。取值：

    • true：对实例进行数据盘挂载，数据盘内原有数据将丢失，请注意备份数据。

    • false：不对实例进行数据盘挂载。

    默认值：false。

    数据挂载规则：

    • 如果 ECS 已挂载数据盘，且最后一块数据盘的文件系统未初始化，系统会自动将该数据盘格式化为 ext4，用来存放内容/var/lib/docker、/var/lib/kubelet 。

    • 如果 ECS 未挂载数据盘，则不会挂载新的数据盘。

    false
    keep_instance_name

    boolean

    否

    添加已有实例到集群时，是否保留实例名称。如果不保留，则实例名称格式为worker-k8s-for-cs-<clusterid>。取值：

    • true：保留实例名称。

    • false：不保留实例名称，会用系统规则进行替换。

    默认值：true。

    true
    rds_instances

    array

    否

    如果指定了 RDS 实例列表，集群节点 ECS 会自动加入 RDS 访问白名单。

    string

    否

    RDS 实例名称。

    rm-xxx
    arch

    string

    否

    节点 CPU 架构。支持的 CPU 架构包括amd64、arm、arm64。

    默认值：amd64。

    说明

    当集群类型为边缘托管版时必填。

    amd64
    options

    string

    否

    节点的接入配置参数。

    说明

    当集群类型为边缘托管版时必填。

    {"enableIptables": true,"manageRuntime": true,"quiet": true,"allowedClusterAddons": ["kube-proxy","flannel","coredns"]}
    expired

    integer

    否

    描述生成的 token 的过期时间，格式为 Unix 时间戳，如示例的 1739980800 表示 2025-02-20 00:00:00。

    1740037333
    one_time_token

    boolean

    否

    返回参数

    名称

    类型

    描述

    示例值

    string

    节点接入脚本。

    "wget http://***.oss-cn-hangzhou.aliyuncs.com/***"

    示例

    正常返回示例

    JSON格式

    "\"wget http://***.oss-cn-hangzhou.aliyuncs.com/***\""

    错误码

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

    变更历史

    更多信息，参考变更详情。