跳到主要内容

ecs snapshot-group

管理快照一致性组

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

create

ecctl ecs snapshot-group create [flags]

创建快照一致性组

  • 类型:mutation · 风险:medium
  • 同步:等待 accomplished(waiter accomplished_after_create,超时 600s);用 --no-wait 跳过等待。
  • 通过 ClientToken 幂等。
API调用时机用途
CreateSnapshotGroup每次执行命令时执行资源操作。
DescribeSnapshotGroups未指定 --no-wait轮询等待资源达到目标状态。(重复调用)
DescribeSnapshotGroups未指定 --no-wait返回最终资源视图。(复用等待结果,不额外请求)
参数类型必填说明
--instancestring源实例 ID
--regionstringAlibaba Cloud region
--descriptionstring快照一致性组描述
--disk-idsarray纳入一致性组的云盘 ID 列表
--exclude-disk-idsarray排除在一致性组之外的云盘 ID 列表
--instant-accessboolean为组内快照启用快速可用
--instant-access-retention-daysinteger快速可用保留天数
--namestring快照一致性组名称
--resource-groupstring资源组 ID
--tagkey_value标签赋值 key=value

update

ecctl ecs snapshot-group update <id> [flags]

更新快照一致性组

  • 类型:mutation · 风险:medium
API调用时机用途
ModifySnapshotGroup每次执行命令时执行资源操作。
DescribeSnapshotGroups未指定 --no-wait读取资源视图。
参数类型必填说明
--regionstringAlibaba Cloud region
--descriptionstring快照一致性组描述
--namestring快照一致性组名称

delete

ecctl ecs snapshot-group delete <id> [flags]

删除快照一致性组

  • 类型:mutation · 风险:high
  • 同步:等待 absent(waiter deleted_after_delete,超时 300s);用 --no-wait 跳过等待。
API调用时机用途
DeleteSnapshotGroup每次执行命令时执行资源操作。
DescribeSnapshotGroups未指定 --no-wait轮询等待资源达到目标状态。(重复调用)
参数类型必填说明
--regionstringAlibaba Cloud region

get

ecctl ecs snapshot-group get <id> [flags]

获取快照一致性组

  • 类型:read · 风险:low
API调用时机用途
DescribeSnapshotGroups每次执行命令时读取资源视图。
参数类型必填说明
--regionstringAlibaba Cloud region
--fieldsstring要包含的资源字段,使用逗号分隔

list

ecctl ecs snapshot-group list [<ids>...] [flags]

列出快照一致性组

  • 类型:read · 风险:low
API调用时机用途
DescribeSnapshotGroups每次执行命令时读取资源视图。
参数类型必填说明
--regionstringAlibaba Cloud region
--fieldsstring要包含的资源字段,使用逗号分隔
--filterkey_value过滤表达式 key=value
--limitinteger最多返回资源数量(默认:100
--next-tokenstring下一页查询 token