调用DescribeGroupedContainerInstances分组查询容器实例列表-云安全中心-阿里云-云安全中心(Security Center)-阿里云帮助中心

根据分组类型查询对应的容器列表信息。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

yundun-sas:DescribeGroupedContainerInstances

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
Criteria	string	否	设置搜索资产的条件。该参数为 JSON 格式，多个条件之间使用半角逗号（,）分隔。例如：`[{"name":"riskStatus","value":"YES"},{"name":"riskLevel","value":"2"}]`。说明支持使用实例 ID、实例名称、所属 VPC ID、地域、公网 IP 地址等条件搜索资产。您可以调用 DescribeCriteria 查询支持的搜索条件。	[{"name":"riskStatus","value":"YES"},{"name":"riskLevel","value":"2"}]
LogicalExp	string	否	设置多个搜索条件间生效的逻辑关系。取值： OR：表示多个条件间为或的关系。 AND：表示多个条件间为与的关系。	OR
GroupField	string	是	要查询的分组类型。取值： pod：容器组。 appName：应用名称。 namespace：命名空间。 clusterId：集群 ID。 image：镜像。	pod
FieldValue	string	否	设置不同分组类型的搜索条件。根据 GroupField 选择的类型您需要设置以下搜索条件： GroupField 选择为 pod：指定要查询的容器组名称。 GroupField 选择为 appName：指定要查询的应用名称。 GroupField 选择为 namespace：指定要查询的命名空间。 GroupField 选择为 clusterId：指定要查询的集群 ID。 GroupField 选择为 image：指定要查询的镜像名称。说明以上搜索条件均支持模糊搜索。	cas-adad-qeqwe
PageSize	integer	否	设置分页查询时，每页显示的容器资产的数量。默认值为 20，表示每页显示 20 条容器资产信息。说明建议 PageSize 取值不要为空。	20
CurrentPage	integer	否	设置从返回结果的第几页开始显示查询结果。默认值为 1，表示从第 1 页开始显示。	1

返回参数

名称	类型	描述	示例值
	object
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	4E5BFDCF-B9DD-430D-9DA4-151BCB581C9D
PageInfo	object	数据分页信息。
CurrentPage	integer	分页查询时，当前页的页码。	1
PageSize	integer	分页查询时，每页显示的容器资产的数量。默认值为 20，表示每页显示 20 条容器资产信息。	20
TotalCount	integer	查询到的容器资产的总数量。	25
Count	integer	分页查询时，当前页显示的容器资产信息的条数。	20
GroupedContainerInstanceList	array<object>	查询到的容器资产信息的列表。
	object	容器资产信息。
RiskLevel	string	风险的等级。取值： high：高危 medium：中危 low：低危	low
HostIp	string	容器集群的主机 IP。	172.114.XX.XX
Pod	string	容器组名称。	csi-plugin-2n****
RiskStatus	string	风险状态。取值： NO：无风险。 YES：有风险。	NO
CreateTime	integer	创建集群时间戳，单位为毫秒。	1600076893000
Namespace	string	集群的命名空间。	kube-system
CusterState	string	集群的运行状态。取值： running：集群正在运行。 stopped：集群已经停止运行。 deleted：集群已经被删除。 delete_failed：删除集群失败。 failed：创建集群失败。	running
InstanceId	string	服务器实例的 ID。	i-8vb9ul5xec4tua4q****
RegionId	string	实例所在的地域的 ID。	cn-hangzhou
AppName	string	应用名称。	oss-liveness-probe
InstanceCount	integer	查询到的容器组数量、应用数量、集群数量或命名空间数量。	9
ClusterType	string	集群的类型。取值： Kubernetes：Kubernetes 专有版。 ManagedKubernetes：标准托管集群（边缘集群）。 Ask：标准 Serverless 集群。	ManagedKubernetes
ClusterName	string	集群名称。	test
PodIp	string	容器组 IP。	172.114.XX.XX
VulCount	integer	在当前容器组、应用、命名空间或集群中检测出的漏洞数量。	1
AlarmCount	integer	在当前容器组、应用、命名空间或集群中检测出的告警数量。	1
RiskInstanceCount	integer	存在风险的实例数量。	1
ClusterId	string	集群 ID。	cf3824769c85441b4bf3****
Image	string	容器镜像。	registry-vpc.ap-southeast-5.aliyuncs.com/log-service-release/sls-connector:1.1.77
ImageRepoNamespace	string	镜像仓库命名空间。	name001
ImageRepoName	string	镜像仓库名称。	test-003
ImageRepoTag	string	镜像仓库标签。	dev-20220512-2
ImageDigest	string	镜像 digest 值。	58e58c013f70bbfde140c8a55c1078074b3483479428d4069aa946827fd566cf
ImageUuid	string	镜像 UUID。	e4bdec1d9ba7e0967111a7ea467c****
HcCount	integer	在当前容器组、应用、命名空间或集群中检测出的基线总数。	20
SyncOpen	integer	集群日志审计同步开关。取值： 0：关闭。 1：开启。	1
SyncStatus	integer	集群日志审计同步状态。取值： 0：同步失败。 1：同步成功。	1

示例

正常返回示例

JSON格式

{
  "RequestId": "4E5BFDCF-B9DD-430D-9DA4-151BCB581C9D",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 25,
    "Count": 20
  },
  "GroupedContainerInstanceList": [
    {
      "RiskLevel": "low",
      "HostIp": "172.114.XX.XX",
      "Pod": "csi-plugin-2n****",
      "RiskStatus": "NO",
      "CreateTime": 1600076893000,
      "Namespace": "kube-system",
      "CusterState": "running",
      "InstanceId": "i-8vb9ul5xec4tua4q****",
      "RegionId": "cn-hangzhou",
      "AppName": "oss-liveness-probe",
      "InstanceCount": 9,
      "ClusterType": "ManagedKubernetes",
      "ClusterName": "test",
      "PodIp": "172.114.XX.XX",
      "VulCount": 1,
      "AlarmCount": 1,
      "RiskInstanceCount": 1,
      "ClusterId": "cf3824769c85441b4bf3****",
      "Image": "registry-vpc.ap-southeast-5.aliyuncs.com/log-service-release/sls-connector:1.1.77",
      "ImageRepoNamespace": "name001",
      "ImageRepoName": "test-003",
      "ImageRepoTag": "dev-20220512-2",
      "ImageDigest": "58e58c013f70bbfde140c8a55c1078074b3483479428d4069aa946827fd566cf",
      "ImageUuid": "e4bdec1d9ba7e0967111a7ea467c****",
      "HcCount": 20,
      "SyncOpen": 1,
      "SyncStatus": 1
    }
  ]
}

错误码

HTTP status code	错误码	错误信息
400	IllegalParam	Illegal param
500	ServerError	ServerError
403	NoPermission	caller has no permission

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

变更历史

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