本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 列出 Image Builder 映像资源的生命周期管理策略
<a name="list-lifecycle-policies"></a>

您可以获取图像生命周期管理策略列表，其中包括生命**周期策略**列表页面上的关键详细信息列 AWS 管理控制台，或者在 Image Builder API 中获取命令或操作 SDKs、或 AWS CLI。

您可以使用以下方法之一列出您 AWS 账户中的 Image Builder 映像生命周期策略资源。有关 API 操作，请参阅 *EC2 Image Builder API 参考[ListLifecyclePolicies](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListLifecyclePolicies.html)*中的。有关关联的 SDK 请求，请参阅同一页面上的[另请参阅](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListLifecyclePolicies.html#API_ListLifecyclePolicies_SeeAlso)链接。

------
#### [ AWS 管理控制台 ]

控制台中显示了现有策略的以下详细信息。您可以选择任何列来更改结果的排序顺序。策略列表最初按**策略名称**进行排序。当前排序顺序的列名以粗体显示。

如果结果不止一页，则面板右上角的分页箭头将变为活动状态。您可以通过搜索栏按策略名称、策略状态、输出映像类型和映像资源 ARN 筛选结果。
+ **策略名称** – 策略的名称。
+ **策略状态** – 策略处于活动状态还是非活动状态。
+ **类型** – 创建新映像版本（AMI 或容器映像）时 Image Builder 分配的输出映像类型。
+ **上次执行日期** – 生命周期策略上次运行的时间。
+ **创建日期** – 生命周期策略创建以来的时间戳。
+ **ARN** – 生命周期策略资源的 Amazon 资源名称（ARN）。

要在中列出生命周期策略 AWS 管理控制台，请执行以下步骤：

1. 打开 EC2 Image Builder 控制台，网址为[https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)。

1. 在导航窗格中，选择**生命周期策略**。这将显示您账户中的映像生命周期策略列表。

**可用操作**  
您也可以从**生命周期策略**列表页面对生命周期策略执行以下操作。

要创建新的映像生命周期策略，请选择**创建生命周期策略**。有关如何创建策略的更多信息，请参阅[创建生命周期策略](create-lifecycle-policies.md)。

要执行以下所有操作，必须首先选择策略。要选择策略，可以选中**策略名称**旁的复选框。
+ 要关闭或打开策略，请从**操作**菜单中选择**禁用策略**或**启用策略**。
+ 要更改策略，请从**操作**菜单中选择**编辑策略**。
+ 要删除策略，请从**操作**菜单中选择**删除策略**。
+ 要创建使用所选策略作为基准设置的新策略，请从**操作**菜单中选择**克隆策略**。

------
#### [ AWS CLI ]

以下命令示例说明如何使用列 AWS CLI 出特定镜像生命周期策略 AWS 区域。有关可用于此命令的参数和选项的更多信息，请参阅《[list-lifecycle-policies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-lifecycle-policies.html)命令参考》中的 AWS CLI 命令。

**示例**：

```
aws imagebuilder list-lifecycle-policies \
--region us-west-1
```

**输出**：

```
{
    "lifecyclePolicySummaryList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:111122223333:lifecycle-policy/sample-lifecycle-policy1",
            "name": "sample-lifecycle-policy1",
            "status": "DISABLED",
            "executionRole": "arn:aws:iam::111122223333:role/sample-lifecycle-role",
            "resourceType": "AMI_IMAGE",
            "dateCreated": "2023-11-07T14:57:01.603000-08:00",
            "tags": {}
        },
        {
            "arn": "arn:aws:imagebuilder:us-west-2:111122223333:lifecycle-policy/sample-lifecycle-policy2",
            "name": "sample-lifecycle-policy2",
            "status": "ENABLED",
            "executionRole": "arn:aws:iam::111122223333:role/sample-lifecycle-role",
            "resourceType": "AMI_IMAGE",
            "dateCreated": "2023-09-06T10:43:21.436000-07:00",
            "dateLastRun": "2023-11-13T04:43:46.106000-08:00",
            "tags": {}
        },
        {
            "arn": "arn:aws:imagebuilder:us-west-2:111122223333:lifecycle-policy/sample-lifecycle-policy3",
            "name": "sample-lifecycle-policy3",
            "status": "ENABLED",
            "executionRole": "arn:aws:iam::111122223333:role/sample-lifecycle-role",
            "resourceType": "AMI_IMAGE",
            "dateCreated": "2023-10-19T15:16:40.046000-07:00",
            "dateUpdated": "2023-10-21T20:07:15.958000-07:00",
            "dateLastRun": "2023-11-12T09:27:45.830000-08:00"
}]}
```

**注意**  
要使用默认值 AWS 区域，请在不带`--region`参数的情况下运行此命令。

------