ait tag — 完整参考
创建、查看、列出并删除指向已记录状态的本地 AIT Tag 引用。
适用人群： 开发者与发布运维
作用边界#
用途： 创建、查看、列出并删除指向已记录状态的本地 AIT Tag 引用。
影响类别： 改动 Tag 引用，同时提供只读的 list 和 show 操作。
覆盖： ait tag 下共 5 个公开 help surface。
下面的代码块原样保留 1.1.1 二进制的输出，包含它给出的每一个参数、选项、 默认值、可选值、冲突关系和必填要求。
完整命令树#
ait tag
ait tag create
ait tag list
ait tag show
ait tag delete原样输出的 help#
ait tag#
二进制描述： Create, inspect, list, and delete local-only AIT Tags that name exact Snapshots. An existing Tag binding cannot be retargeted, and deleting a Tag never deletes its Snapshot.
Create, inspect, list, and delete local-only AIT Tags that name exact Snapshots. An existing Tag binding cannot be retargeted, and deleting a Tag never deletes its Snapshot.
Usage: ait tag <COMMAND>
Commands:
create Create a local Tag; existing names are rejected.
list List all local Tags without changing repository state.
show Show one exact local Tag without changing repository state.
delete Delete only one local Tag reference.
help Print this message or the help of the given subcommand(s)
Options:
-h, --help
Print help (see a summary with '-h')说明
创建、查看、列出和删除指向确切 Snapshot 的仅本地 AIT Tag。已存在的 Tag 绑定不能改指其他目标，删除 Tag 也绝不会删除其 Snapshot。
| 参数 / 选项 | 说明 |
|---|---|
create | 创建一个本地 Tag；已存在的名称会被拒绝。 |
list | 列出所有本地 Tag，不改变仓库状态。 |
show | 显示一个确切的本地 Tag，不改变仓库状态。 |
delete | 仅删除一个本地 Tag 引用。 |
help | 打印本消息或给定子命令的帮助 |
ait tag create#
二进制描述： Create one local AIT Tag for an exact existing Snapshot. When --snapshot is omitted, the current Line head is used. An existing Tag name is always rejected and cannot be replaced or moved.
Create one local AIT Tag for an exact existing Snapshot. When --snapshot is omitted, the current Line head is used. An existing Tag name is always rejected and cannot be replaced or moved.
Usage: ait tag create [OPTIONS] --message <MESSAGE> <NAME>
Arguments:
<NAME>
New local Tag name; an existing name is rejected.
Options:
--snapshot <SNAPSHOT_ID>
Exact existing local Snapshot ID; defaults to the current Line head.
--message <MESSAGE>
Required non-empty, single-line reason for creating the Tag.
--json
Emit the created Tag as stable JSON.
-h, --help
Print help (see a summary with '-h')说明
为一个确切的已有 Snapshot 创建一个本地 AIT Tag。省略 --snapshot 时使用当前 Line head。已存在的 Tag 名称始终会被拒绝，不能替换或移动。
ait tag list#
二进制描述： List all local Tags without changing repository state.
List all local Tags without changing repository state.
Usage: ait tag list [OPTIONS]
Options:
--json Emit the complete local Tag list as stable JSON.
-h, --help Print help说明
列出所有本地 Tag，不改变仓库状态。
| 参数 / 选项 | 说明 |
|---|---|
--json | 以稳定 JSON 输出完整的本地 Tag 列表。 |
-h, --help | 打印帮助 |
ait tag show#
二进制描述： Show one exact local Tag without changing repository state.
Show one exact local Tag without changing repository state.
Usage: ait tag show [OPTIONS] <NAME>
Arguments:
<NAME> Exact local Tag name to inspect.
Options:
--json Emit the Tag record as stable JSON.
-h, --help Print help说明
显示一个确切的本地 Tag，不改变仓库状态。
| 参数 / 选项 | 说明 |
|---|---|
<NAME> | 要查看的确切本地 Tag 名称。 |
--json | 以稳定 JSON 输出该 Tag 记录。 |
-h, --help | 打印帮助 |
ait tag delete#
二进制描述： Delete one exact local AIT Tag reference. The referenced Snapshot, Line heads, and workspace content remain unchanged.
Delete one exact local AIT Tag reference. The referenced Snapshot, Line heads, and workspace content remain unchanged.
Usage: ait tag delete [OPTIONS] <NAME>
Arguments:
<NAME>
Exact local Tag name to delete.
Options:
--json
Emit the deleted Tag record as stable JSON.
-h, --help
Print help (see a summary with '-h')说明
删除一个确切的本地 AIT Tag 引用。被引用的 Snapshot、各 Line head 和工作区内容保持不变。