标签生命周期

标签、字段和选项在其整个生命周期内会经历特定状态。 此外，标签可能还有不同的修订版本。下图显示了标签生命周期，包括版本控制：

标签生命周期图。
图 3. 标签的生命周期
  1. 创建标签 (create()) - 系统会创建标签并将其作为 revision_id=1 存储在数据库中。相应标签的状态为 UNPUBLISHED_DRAFT。 在此状态下：
    • 用户无法查看标签
    • 用户无法将标签应用于云端硬盘内容。
  2. （可选）更新标签、字段或选项 (delta()) - 每次更新（即使在发布之前）都会存储在数据库中，并且标签的修订版本会递增。
  3. 发布标签 (publish()) - 标签的状态为 PUBLISHED，用户可以应用该标签。发布标签会增加其修订版本。
  4. （可选）更新标签、字段或选项 (delta()) - 系统会更新标签、字段或选项，并将其作为草稿标签存储在数据库中。标签的状态为 PUBLISHED，其中 hasUnpublishedChanges=true 表示存在草稿更改，但用户无法使用这些更改。每次更新都会使标签的修订版本递增。
  5. （可选）发布标签 (publish()) - 如果有，则发布最新的草稿。标签的状态为 PUBLISHED，用户可以应用该标签。发布标签会递增其版本。
  6. 停用标签 (disable()) - 标签的状态为 DISABLED，但用户可以通过 API 应用该标签。不过，除非配置为显示，否则界面中不会显示“已停用”标签。弃用标签会递增其修订版本。
  7. 启用标签 (enable()) - 标签会恢复为 PUBLISHED 状态，用户可以应用该标签。发布标签会增加其修订版本。
  8. 删除标签 (delete()) - 标签的状态为 DELETED，无法应用。已删除的标签最终会被清除。

请务必注意，每次更新标签都会使标签的修订版本递增。如果标签已发布，在 n 次更新后再次发布，则其已发布的修订版本号为修订版本号 + n + 1 次连续更新。