ack

管理 ACK 集群

运行 ecctl ack <action> -h 查看用法，或 ecctl schema ack.ack.<action> --full 获取该命令完整的结构化规格——每个参数与行为，便于 Agent 读取和填参。

create

ecctl ack create [flags]

创建 ACK 集群

参数	类型	必填	说明
`--name`	string	✓	集群名称
`--region`	string	✓	Alibaba Cloud region
`--type`	string	✓	集群类型
`--api-server-public`	boolean		通过公网端点开放 API Server
`--edition`	string		集群版本规格；常见值包括 ack.standard、ack.pro.small、ack.pro.xlarge、ack.pro.2xlarge、ack.pro.4xlarge
`--pod-cidr`	cidr		Pod 网络 CIDR，作为 ACK CreateCluster 的 container_cidr 发送
`--profile`	string		ACK 集群场景类型。如需同时指定配置 profile 和 ACK profile，请将配置 profile 放在资源命令前，例如 ecctl --profile prod ack create --profile Serverless。
`--resource-group`	string		资源组 ID
`--service-cidr`	cidr		Service 网络 CIDR
`--snat-entry`	boolean		在 ACK 支持时创建用于集群出站访问的 SNAT 条目
`--tag`	key_value		标签赋值 key=value
`--version`	string		目标 Kubernetes 版本
`--vpc`	string		VPC ID
`--vswitch`	string_array		集群网络使用的交换机 ID
`--zone`	string_array		ACK CreateCluster zone_ids 使用的可用区 ID

ecctl ack update <id> [flags]

更新 ACK 集群

API	调用时机	用途
`ModifyCluster`	指定 `--name` 或指定 `--api-server-public` 或指定 `--api-server-eip-id` 或指定 `--resource-group` 或指定 `--maintenance-window` 时	执行资源操作。
`DescribeClusterDetail`	（指定 `--name` 或指定 `--api-server-public` 或指定 `--api-server-eip-id` 或指定 `--resource-group` 或指定 `--maintenance-window`）且未指定 `--no-wait` 时	轮询等待资源达到目标状态。（重复调用）
`MigrateCluster`	指定 `--to-edition` 时	执行资源操作。
`DescribeClusterDetail`	指定 `--to-edition` 且未指定 `--no-wait` 时	轮询等待资源达到目标状态。（重复调用）
`ModifyClusterTags`	指定 `--tag-replace` 时	执行资源操作。
`TagResources`	指定 `--tag` 时	执行资源操作。
`UntagResources`	指定 `--remove-tag` 时	执行资源操作。
`DescribeClusterDetail`	未指定 `--no-wait` 时	读取资源视图。
`ListTagResources`	未指定 `--no-wait` 时	读取资源视图。

ecctl ack delete <id> [flags]

删除 ACK 集群

API	调用时机	用途
`DeleteCluster`	每次执行命令时	执行资源操作。
`DescribeClustersV1`	未指定 `--no-wait` 时	轮询等待资源达到目标状态。（重复调用）

参数	类型	必填	说明
`--region`	string	✓	Alibaba Cloud region
`--delete-options`	object		ACK delete_options JSON 或 @file
`--force`	boolean		删除集群关联资源而不是保留它们（默认：`false`）
`--retain-all-resources`	boolean		删除集群时保留全部云资源
`--retain-resources`	string_array		删除时保留的云资源 ID

ecctl ack get <id> [flags]

获取 ACK 集群

API	调用时机	用途
`DescribeClusterDetail`	每次执行命令时	读取资源视图。
`DescribeClusterResources`	指定 `--with-resources` 时	读取资源视图。
`ListTagResources`	指定 `--with-tags` 时	读取资源视图。
`DescribePolicyGovernanceInCluster`	指定 `--with-policy-governance` 时	读取资源视图。

ecctl ack list [<ids>...] [flags]

列出 ACK 集群

API	调用时机	用途
`DescribeClustersForRegion`	指定 `--cross-account` 时	读取资源视图。
`DescribeClustersV1`	未指定 `--cross-account` 时	读取资源视图。

ecctl ack upgrade <id> [flags]

升级 ACK 集群