本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon ECR 中的生命週期政策屬性
<a name="lifecycle_policy_parameters"></a>

生命週期政策具有下列屬性。

若要查看生命週期政策的範例，請參閱 [Amazon ECR 中的生命週期政策範例](lifecycle_policy_examples.md)。如需使用 建立生命週期政策的說明 AWS CLI，請參閱 [建立生命週期政策 (AWS CLI)](lp_creation.md#lp-creation-cli)。

## 規則優先順序
<a name="lp_rule_priority"></a>

`rulePriority`  
類型：整數  
必要：是  
設定套用的規則之順序，從最低值到最高值。首先`1`套用優先順序為 的生命週期政策規則，接著套用優先順序`2`為 的規則，以此類推。當您新增規則到生命週期政策時，必須指定唯一的 `rulePriority` 值。政策中的值不需要跨規則循序。擁有 `any` 的 `tagStatus` 值必須有 `rulePriority` 的最高值與最後評估的值。

## Description
<a name="lp_description"></a>

`description`  
類型：字串  
必要：否  
(選用) 說明生命週期政策中的規則用途。

## 標籤狀態
<a name="lp_tag_status"></a>

`tagStatus`  
類型：字串  
必要：是  
決定您新增的生命週期政策規則是否為映像指定標籤。可接受選項為 `tagged`、`untagged`、或 `any`。若您指定 `any`，所有映像都對規則進行評估。如果您指定 `tagged`，則還必須指定 `tagPrefixList`值或 `tagPatternList`值。如果您指定 `untagged`，則必須同時省略 `tagPrefixList`和 `tagPatternList`。

## 標籤模式清單
<a name="lp_tag_pattern_list"></a>

`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"]` 則為無效。

## 標籤字首清單
<a name="lp_tag_prefix_list"></a>

`tagPrefixList`  
類型：list[string]  
必填：是，如果 `tagStatus` 設為已標記且未指定 `tagPatternList`  
僅在您指定 `"tagStatus": "tagged"` 且未指定 `tagPatternList` 時使用。您必須指定以逗號分隔的映像標籤前綴清單，用以使用生命週期政策來採取動作。例如，若您的映像被標記為 `prod`、`prod1`、`prod2` 以此類推，您可能需要使用標籤前綴 `prod` 來指定所有映像。若您指定多個標籤，只會選擇含有所有指定標籤的映像。

## 儲存類別
<a name="lp_storage_class"></a>

`storageClass`  
類型：字串  
必要：是，如果 `countType` 為 `sinceImageTransitioned`  
規則只會選取此儲存類別的影像。使用 `imageCountMoreThan`、 `sinceImagePushed`或 `countType`的 時`sinceImagePulled`，唯一支援的值為 `standard`。使用計數類型 時`sinceImageTransitioned`，這是必要的，唯一支援的值是 `archive`。如果您省略此選項，`standard`則會使用 的值。

## 計數類型
<a name="lp_count_type"></a>

`countType`  
類型：字串  
必要：是  
指定計數類型以套用到映像。  
若 `countType` 設為 `imageCountMoreThan`，您也指定 `countNumber` 來建立設定存在於您的儲存庫中的映像數量限制之規則。如果 `countType` 設定為 `sinceImagePushed`、 `sinceImagePulled`或 `sinceImageTransitioned`，您也可以指定 `countUnit`和 `countNumber`，以指定存在於儲存庫中映像的時間限制。

## 計數單位
<a name="lp_count_unit"></a>

`countUnit`  
類型：字串  
必要：是，只有在 `countType` 設定為 `sinceImagePushed`、 `sinceImagePulled`或 時 `sinceImageTransitioned`  
除了代表天數的 `days` 外，請指定 `countNumber` 的技術單位來作為時間單位。  
這只能在 `countType`為 `sinceImagePushed`、 `sinceImagePulled`或 時指定`sinceImageTransitioned`；如果您在 `countType`為任何其他值時指定計數單位，則會發生錯誤。

## Count (計數)
<a name="lp_count_number"></a>

`countNumber`  
類型：整數  
必要：是  
指定計數號碼。可接受的值為正整數 (`0` 不是接受值)。  
如果使用的 `countType` 為 `imageCountMoreThan`，那麼值便是您想要保留於儲存庫中的最大映像數量。如果使用的 `countType` 為 `sinceImagePushed`，那麼值便是您想要保留於儲存庫中的映像存在時間上限。如果`countType`使用的 是 `sinceImagePulled`，則值為自上次提取映像以來的天數上限。如果`countType`使用的 是 `sinceImageTransitioned`，則值為自封存映像以來的天數上限。

## Action
<a name="lp_action"></a>

`type`  
類型：字串  
必要：是  
指定一種動作類型。支援的值為 `expire`（刪除映像） 和 `transition`（將映像移至封存儲存）。

`targetStorageClass`  
類型：字串  
必要：是，如果 `type` 為 `transition`  
您希望生命週期政策轉換映像的儲存類別。 `archive` 是唯一支援的值。