调用DescribeImageInfoList接口查询镜像列表及详细信息-云安全中心-阿里云-云安全中心(Security Center)-阿里云帮助中心

查询镜像列表。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

yundun-sas:DescribeImageInfoList

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
Uuids	string	是	指定服务器的 UUID。存在多个 UUID 时使用英文逗号（,）分隔。说明调用 DescribeCloudCenterInstances 接口获取该参数。	391abd09184cbd3743d7f5ec125d**, e6aeb2a5b6004479398b0bcd1160**

返回参数

名称	类型	描述	示例值
	object	返回对象。
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	BC3B0DAE-CC0E-59E9-9383-6F060F22****
ImageInfos	array<object>	镜像信息 images 组成的集合。
	object	镜像对象。
Status	string	镜像状态。	NORMAL
Endpoints	string	镜像服务的 endpoint 列表。	cn-hangzhou-x7
RiskStatus	string	镜像是否存在安全风险。取值： YES：存在风险 NO：不存在风险	YES
VulStatus	string	实例是否存在漏洞。取值： YES：存在漏洞。 NO：不存在漏洞。	YES
ImageCreate	integer	镜像创建时间。	1636962328000
AlarmStatus	string	资产是否存在安全告警。取值： YES：存在安全告警 NO：不存在安全告警	YES
Digest	string	镜像 digest 值。	a3521b04dfdd1361a24be6263f2983cf12ba910989f4d9f7324da7e1e89f****
RegistryType	string	注册类型。	harbor
ImageUpdate	integer	镜像更新时间。	1636974116000
Tag	string	镜像标签。	v1
InstanceId	string	镜像实例的 ID。	i-wz95abw6pa7y79ve****
RepoType	string	仓库类型，取值： `PUBLIC`：公开 `PRIVATE`：私有	PUBLIC
RegionId	string	镜像实例所在的地域 ID。	cn-hangzhou
Uuid	string	服务器的 uuid。	ff9ca084-7faa-4ab2-8728-69024755****
ImageSize	integer	镜像大小。	157408623
RepoId	string	镜像仓的 ID。	crr-5qk9v2rdt0s****
TagImmutable	integer	标签不可变性。枚举值： 0 : 可变/覆盖 1 : 不可变/新增	0
VulCount	integer	您资产中的漏洞总数量。	1
AlarmCount	integer	在当前容器组、应用、命名空间或集群中检测出的告警数量。	10
ImageId	string	镜像的 ID。	bb0175afea16138815a8900adeeb0315d88a83a2376eeffa14db1d693a15****
RepoName	string	镜像仓库的名称。	opa-test
RepoNamespace	string	镜像仓库的命名空间。	libssh2
SourceBizTag	string	镜像业务用途标签。	PAI

示例

正常返回示例

JSON格式

{
  "RequestId": "BC3B0DAE-CC0E-59E9-9383-6F060F22****",
  "ImageInfos": [
    {
      "Status": "NORMAL",
      "Endpoints": "cn-hangzhou-x7",
      "RiskStatus": "YES",
      "VulStatus": "YES",
      "ImageCreate": 1636962328000,
      "AlarmStatus": "YES",
      "Digest": "a3521b04dfdd1361a24be6263f2983cf12ba910989f4d9f7324da7e1e89f****",
      "RegistryType": "harbor",
      "ImageUpdate": 1636974116000,
      "Tag": "v1",
      "InstanceId": "i-wz95abw6pa7y79ve****",
      "RepoType": "PUBLIC",
      "RegionId": "cn-hangzhou",
      "Uuid": "ff9ca084-7faa-4ab2-8728-69024755****",
      "ImageSize": 157408623,
      "RepoId": "crr-5qk9v2rdt0s****",
      "TagImmutable": 0,
      "VulCount": 1,
      "AlarmCount": 10,
      "ImageId": "bb0175afea16138815a8900adeeb0315d88a83a2376eeffa14db1d693a15****",
      "RepoName": "opa-test",
      "RepoNamespace": "libssh2",
      "SourceBizTag": "PAI"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
500	ServerError	ServerError
403	NoPermission	caller has no permission

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

变更历史

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