本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon ECR 中的生命週期政策屬性
生命週期政策具有下列屬性。
若要查看生命週期政策的範例,請參閱 Amazon ECR 中的生命週期政策範例。如需使用 建立生命週期政策的說明 AWS CLI,請參閱 建立生命週期政策 (AWS CLI)。
規則優先順序
rulePriority-
類型:整數
必要:是
設定套用的規則之順序,從最低值到最高值。首先
1套用優先順序為 的生命週期政策規則,接著套用優先順序2為 的規則,以此類推。當您新增規則到生命週期政策時,必須指定唯一的rulePriority值。政策中的值不需要跨規則循序。擁有any的tagStatus值必須有rulePriority的最高值與最後評估的值。
說明
description-
類型:字串
必要:否
(選用) 說明生命週期政策中的規則用途。
標籤狀態
tagStatus-
類型:字串
必要:是
決定您新增的生命週期政策規則是否為映像指定標籤。可接受選項為
tagged、untagged、或any。若您指定any,所有映像都對規則進行評估。如果您指定tagged,則還必須指定tagPrefixList值或tagPatternList值。如果您指定untagged,則必須同時省略tagPrefixList和tagPatternList。
標籤模式清單
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來指定所有映像。若您指定多個標籤,只會選擇含有所有指定標籤的映像。
儲存方案
storageClass-
類型:字串
必要:是,如果
countType為sinceImageTransitioned規則只會選取此儲存類別的影像。使用
imageCountMoreThan、sinceImagePushed或countType的 時sinceImagePulled,唯一支援的值為standard。使用計數類型 時sinceImageTransitioned,這是必要的,唯一支援的值是archive。如果您省略此選項,standard則會使用 的值。
計數類型
countType-
類型:字串
必要:是
指定計數類型以套用到映像。
若
countType設為imageCountMoreThan,您也指定countNumber來建立設定存在於您的儲存庫中的映像數量限制之規則。如果countType設定為sinceImagePushed、sinceImagePulled或sinceImageTransitioned,您也可以指定countUnit和countNumber,以指定存在於儲存庫中映像的時間限制。
計數單位
countUnit-
類型:字串
必要:是,只有在
countType設定為sinceImagePushed、sinceImagePulled或 時sinceImageTransitioned除了代表天數的
days外,請指定countNumber的技術單位來作為時間單位。這只能在
countType為sinceImagePushed、sinceImagePulled或 時指定sinceImageTransitioned;如果您在countType為任何其他值時指定計數單位,則會發生錯誤。
Count (計數)
countNumber-
類型:整數
必要:是
指定計數號碼。可接受的值為正整數 (
0不是接受值)。如果使用的
countType為imageCountMoreThan,那麼值便是您想要保留於儲存庫中的最大映像數量。如果使用的countType為sinceImagePushed,那麼值便是您想要保留於儲存庫中的映像存在時間上限。如果countType使用的 是sinceImagePulled,則值為自上次提取映像以來的天數上限。如果countType使用的 是sinceImageTransitioned,則值為自封存映像以來的天數上限。
Action
type-
類型:字串
必要:是
指定一種動作類型。支援的值為
expire(刪除映像) 和transition(將映像移至封存儲存)。 targetStorageClass-
類型:字串
必要:是,如果
type為transition您希望生命週期政策轉換映像的儲存類別。
archive是唯一支援的值。