ait-native
浏览 1.0.0 文档
1.0.0 文档修订 2

ait tag — 完整参考

创建、查看、列出并删除指向已记录状态的本地 AIT Tag 引用。

适用人群： 开发者与发布运维

Open Command Manual

作用边界#

用途： 创建、查看、列出并删除指向已记录状态的本地 AIT Tag 引用。

影响类别： 改动 Tag 引用，同时提供只读的 list 和 show 操作。

覆盖： ait tag 下共 5 个公开 help surface。

下面的代码块原样保留 1.0.0 二进制的输出，包含它给出的每一个参数、选项、 默认值、可选值、冲突关系和必填要求。

完整命令树#

Code · text
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.

Code · text
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')

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.

Code · text
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')

ait tag list#

二进制描述： List all local Tags without changing repository state.

Code · text
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

ait tag show#

二进制描述： Show one exact local Tag without changing repository state.

Code · text
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

ait tag delete#

二进制描述： Delete one exact local AIT Tag reference. The referenced Snapshot, Line heads, and workspace content remain unchanged.

Code · text
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')

Version authority

Checked against the exact 1.0.0 source

This page is public documentation, not a second product contract. Use the exact source and distribution contract for release authority.

Open 1.0.0 Release ↗Distribution Contract ↗CLI Source ↗
Owning component Snapshots
  • ait-coreSNP-B06A48DA0245
  • ait-serverSNP-E90456E6425E
  • ait-runnerSNP-6B0A1BB3AFAD
  • ait-pythonSNP-973E3BFAF3DE
  • ait-nodeSNP-F962CC66AA62