ecs port-range-list

管理 ECS 端口列表

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

create

ecctl ecs port-range-list create [flags]

创建端口列表

• 类型：mutation · 风险：medium
• 同步：等待 matched（waiter entries_visible，超时 300s）；用 --no-wait 跳过等待。
• 通过 ClientToken 幂等。

API	调用时机	用途
CreatePortRangeList	每次执行命令时	执行资源操作。
DescribePortRangeListEntries	未指定 --no-wait 且指定 --entry 时	轮询等待资源达到目标状态。（重复调用）
DescribePortRangeLists	未指定 --no-wait 时	读取资源视图。
DescribePortRangeListEntries	未指定 --no-wait 时	读取资源视图。

参数	类型	必填	说明
--max-entries	integer	✓	端口列表允许的最大条目数
--name	string	✓	端口列表名称
--region	string	✓	Alibaba Cloud region
--description	string		端口列表描述
--entry	object		创建端口列表时包含的端口范围条目
--resource-group	string		资源组 ID
--tag	key_value		标签赋值 key=value

update

ecctl ecs port-range-list update <id> [flags]

更新端口列表

• 类型：mutation · 风险：medium
• 同步：等待 matched（waiter entries_visible，超时 300s）；用 --no-wait 跳过等待。
• 通过 ClientToken 幂等。

API	调用时机	用途
ModifyPortRangeList	每次执行命令时	执行资源操作。
DescribePortRangeListEntries	未指定 --no-wait 且 --entry 中包含以 + 为前缀的值时	轮询等待资源达到目标状态。（重复调用）
DescribePortRangeListEntries	未指定 --no-wait 且 --entry 中包含以 - 为前缀的值时	轮询等待资源达到目标状态。（重复调用）
DescribePortRangeLists	未指定 --no-wait 时	读取资源视图。
DescribePortRangeListEntries	未指定 --no-wait 时	读取资源视图。

参数	类型	必填	说明
--region	string	✓	Alibaba Cloud region
--description	string		端口列表描述
--entry	string		端口范围条目变更，使用 + 前缀新增或 - 前缀删除
--name	string		端口列表名称

delete

ecctl ecs port-range-list delete <id> [flags]

删除端口列表

• 类型：mutation · 风险：high

API	调用时机	用途
DeletePortRangeList	每次执行命令时	执行资源操作。

参数	类型	必填	说明
--region	string	✓	Alibaba Cloud region

get

ecctl ecs port-range-list get <id> [flags]

获取端口列表

• 类型：read · 风险：low

API	调用时机	用途
DescribePortRangeLists	每次执行命令时	读取资源视图。
DescribePortRangeListAssociations	指定 --with-associations 时	读取资源视图。
DescribePortRangeListEntries	指定 --with-entries 时	读取资源视图。

参数	类型	必填	说明
--region	string	✓	Alibaba Cloud region
--fields	string		要包含的资源字段，使用逗号分隔
--with-associations	boolean		附带关联资源
--with-entries	boolean		附带端口范围条目

list

ecctl ecs port-range-list list [<ids>...] [flags]

列出端口列表

• 类型：read · 风险：low

API	调用时机	用途
DescribePortRangeLists	每次执行命令时	读取资源视图。

参数	类型	必填	说明
--region	string	✓	Alibaba Cloud region
--fields	string		要包含的资源字段，使用逗号分隔
--filter	key_value		过滤表达式 key=value
--limit	integer		最多返回资源数量（默认：100）
--next-token	string		下一页查询 token