本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon ECR 中的生命週期政策屬性
生命週期政策具有下列屬性。
若要查看生命週期政策的範例,請參閱 Amazon ECR 中的生命週期政策範例。如需使用 建立生命週期政策的說明 AWS CLI,請參閱 建立生命週期政策 (AWS CLI)。
規則優先順序
rulePriority
-
類型:整數
必要:是
設定套用的規則之順序,從最低值到最高值。首先
1
套用優先順序為 的生命週期政策規則,接著套用優先順序2
為 的規則,以此類推。當您新增規則到生命週期政策時,必須指定唯一的rulePriority
值。政策中的值不需要跨規則循序。擁有any
的tagStatus
值必須有rulePriority
的最高值與最後評估的值。
描述
description
-
類型:字串
必要:否
(選用) 說明生命週期政策中的規則用途。
標籤狀態
tagStatus
-
類型:字串
必要:是
決定您新增的生命週期政策規則是否為映像指定標籤。可接受選項為
tagged
、untagged
、或any
。若您指定any
,所有映像都對規則進行評估。如果您指定tagged
,那麼您也必須指定tagPrefixList
值。如果您指定untagged
,那麼您必須省略tagPrefixList
。
標籤模式清單
tagPatternList
-
類型:list[string]
必填:是,如果
tagStatus
設為已標記且未指定tagPrefixList
為已標記的映像建立生命週期政策時,最佳做法是使用
tagPatternList
來指定預計會過期的標籤。您必須指定以逗號分隔的映像標籤模式清單,其中可能包含萬用字元 (*
),以便您透過生命週期政策執行動作。例如,若您的映像標記為prod
、prod1
、prod2
等等,您可能需使用標籤模式清單prod*
來指定所有標籤。若您指定多個標籤,只會選擇含有所有指定標籤的映像。重要
每個字串最多可有 4 個萬用字元 (
*
),例如["*test*1*2*3", "test*1*2*3*"]
是有效字串,但["test*1*2*3*4*5*6"]
則為無效。
標籤字首清單
tagPrefixList
-
類型:list[string]
必填:是,如果
tagStatus
設為已標記且未指定tagPatternList
僅在您指定
"tagStatus": "tagged"
且未指定tagPatternList
時使用。您必須指定以逗號分隔的映像標籤前綴清單,用以使用生命週期政策來採取動作。例如,若您的映像被標記為prod
、prod1
、prod2
以此類推,您可能需要使用標籤前綴prod
來指定所有映像。若您指定多個標籤,只會選擇含有所有指定標籤的映像。
計數類型
countType
-
類型:字串
必要:是
指定計數類型以套用到映像。
若
countType
設為imageCountMoreThan
,您也指定countNumber
來建立設定存在於您的儲存庫中的映像數量限制之規則。若countType
設為sinceImagePushed
,您也指定countUnit
與countNumber
來指定存在於您的儲存庫中的映像時間限制。
計數單位
countUnit
-
類型:字串
必要:是,僅限
countType
設定為sinceImagePushed
的情況除了代表天數的
days
外,請指定countNumber
的技術單位來作為時間單位。只可在
countType
為sinceImagePushed
時進行指定;若您在countType
為其他值時指定計數單位,會發生錯誤。
Count (計數)
countNumber
-
類型:整數
必要:是
指定計數號碼。可接受的值為正整數 (
0
不是接受值)。如果使用的
countType
為imageCountMoreThan
,那麼值便是您想要保留於儲存庫中的最大映像數量。如果使用的countType
為sinceImagePushed
,那麼值便是您想要保留於儲存庫中的映像存在時間上限。
動作
type
-
類型:字串
必要:是
指定一種動作類型。支援的值為
expire
。