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 和工作區內容保持不變。