標籤、欄位和選項在整個生命週期中會經歷特定狀態。 此外,標籤可能會有不同修訂版本。下圖顯示標籤生命週期,包括修訂:
- 建立標籤 (
create()
):系統會建立標籤,並以revision_id=1
形式儲存在資料庫中。標籤的狀態為UNPUBLISHED_DRAFT
。 在此狀態下:- 使用者無法查看標籤
- 使用者無法將標籤套用至雲端硬碟項目。
- (選用) 更新標籤、欄位或選項 (
delta()
):所有更新 (包括發布前的更新) 都會儲存在資料庫中,且標籤修訂版本會遞增。 - 發布標籤 (
publish()
):標籤狀態為PUBLISHED
,使用者可以套用標籤。發布標籤會增加修訂版本。 - (選用) 更新標籤、欄位或選項 (
delta()
):系統會更新標籤、欄位或選項,並以草稿標籤的形式儲存在資料庫中。標籤的狀態為PUBLISHED
,其中hasUnpublishedChanges=true
表示有草稿變更,但使用者無法存取。每次更新都會遞增標籤的修訂版本。 - (選用) 發布標籤 (
publish()
):如果可以,系統會發布最新草稿。標籤的狀態為PUBLISHED
,使用者可以套用標籤。發布標籤會增加版本。 - 停用標籤 (
disable()
):標籤的狀態為DISABLED
,但使用者仍可透過 API 套用標籤。不過,除非設定為顯示,否則 UI 不會顯示已停用的標籤。淘汰標籤會遞增修訂版本。 - 啟用標籤 (
enable()
):標籤會返回PUBLISHED
狀態,使用者可以套用標籤。發布標籤會增加修訂版本。 - 刪除標籤 (
delete()
):標籤的狀態為DELETED
,無法套用。系統最終會清除已刪除的標籤。
請務必強調,每次更新標籤都會增加標籤的修訂版本。此外,如果標籤已發布,在 n 次更新後再次發布,表示發布的修訂版本號碼為修訂版本 + n + 1 次連續更新。