ListArtifactLifecycleRule API用于列举制品生命周期管理规则-容器镜像服务-阿里云-容器镜像服务(ACR)-阿里云帮助中心

列举制品生命周期管理规则。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

cr:ListArtifactLifecycleRule

get

*Instance

acs:cr:{#regionId}:{#accountId}:instance/{#InstanceId}

无

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	企业版实例 id	cri-eztul9ucz76q****
PageNo	integer	否	页号	1
PageSize	integer	否	每页展示的列表数。上限为 100。如果传入的值超过 100，系统将报参数错误或以 100 作为实际返回的列表数上限。	10
EnableDeleteTag	boolean	否	是否开启生命周期管理	true

返回参数

名称	类型	描述	示例值
	object
Code	string	返回码	success
IsSuccess	boolean	调用是否成功，取值： `true`：调用成功 `false`：调用失败	true
PageNo	integer	页号	1
PageSize	integer	页大小	10
RequestId	string	请求 ID	F92D82F9-A4C4-5A4A-97B9-E495BF1B****
Rules	array<object>	规则列表
	array<object>
Auto	boolean	是否自动执行	false
CreateTime	integer	创建时间，使用 UNIX 时间戳，单位为毫秒。	1638187989000
DryRun	boolean	是否开启 DryRun 模式。开启 DryRun 模式后仅执行生命周期任务扫描，不执行真实数据清理。默认关闭。	false
EnableDeleteTag	boolean	是否开启生命周期管理。该参数与 EnableDeleteUntaggedManifest 只有一个能设置为 true。	true
EnableDeleteUntaggedManifest	boolean	是否开启制品清理。该参数与 EnableDeleteTag 只有一个能设置为 true。	false
InstanceId	string	实例 ID	cri-brlg4cbj2yl****
ModifiedTime	integer	修改时间，使用 UNIX 时间戳，单位为毫秒。	1678341923385
NamespaceName	string	命名空间名称	test-ns
NextTime	integer	下一次执行时间，使用 UNIX 时间戳，单位为毫秒。	1638187989000
Policies	array<object>	生命周期策略列表。
	array<object>
Condition	object	生命周期策略触发条件。
LastPullOlderThanDays	integer	最近拉取时间距今超过的天数。	0
LastPushOlderThanDays	integer	最近推送时间距今超过的天数。	0
LatestTagCount	integer	保留的最新镜像版本数量。	0
Filter	object	镜像版本过滤条件。
TagWildcard	string	用于匹配镜像版本的通配符。
Type	string	生命周期策略类型。
RepoName	string	仓库名称	test_1
RetentionTagCount	integer	保留镜像个数	30
RuleId	string	规则 ID	cralr-yqx1q5sir6d****
ScheduleTime	string	执行周期	WEEK
Scope	string	清理范围	INSTANCE
TagRegexp	string	保留镜像版本的正则表达式	.*-alpine
TotalCount	integer	总数量	39

示例

正常返回示例

JSON格式

{
  "Code": "success",
  "IsSuccess": true,
  "PageNo": 1,
  "PageSize": 10,
  "RequestId": "F92D82F9-A4C4-5A4A-97B9-E495BF1B****",
  "Rules": [
    {
      "Auto": false,
      "CreateTime": 1638187989000,
      "DryRun": false,
      "EnableDeleteTag": true,
      "EnableDeleteUntaggedManifest": false,
      "InstanceId": "cri-brlg4cbj2yl****",
      "ModifiedTime": 1678341923385,
      "NamespaceName": "test-ns",
      "NextTime": 1638187989000,
      "Policies": [
        {
          "Condition": {
            "LastPullOlderThanDays": 0,
            "LastPushOlderThanDays": 0,
            "LatestTagCount": 0
          },
          "Filter": {
            "TagWildcard": ""
          },
          "Type": ""
        }
      ],
      "RepoName": "test_1",
      "RetentionTagCount": 30,
      "RuleId": "cralr-yqx1q5sir6d****",
      "ScheduleTime": "WEEK",
      "Scope": "INSTANCE",
      "TagRegexp": ".*-alpine\n"
    }
  ],
  "TotalCount": 39
}

错误码

HTTP status code	错误码	错误信息	描述
500	SystemError	A system error occurred.	未知错误。
403	NoPrivilege	Access is denied for the user.	用户无访问权限。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。