使用ListOperationProcess查询检查操作任务列表-云安全中心-阿里云-云安全中心(Security Center)-阿里云帮助中心

查询操作任务列表。

接口说明

当前仅支持检查操作任务查询。

调试

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

调试

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
yundun-sas:ListOperationProcess	list	*OperationProcess `acs:yundun-sas:{#regionId}:{#accountId}:operationprocess/{#TaskId}`	无	无

请求参数

名称	类型	必填	描述	示例值
TaskTypes	array	否	任务类型，取值： CHECK_ALL：全量检查。 CHECK_POLICY：按照配置策略的检查项执行的检查。 CHECK_SCHEDULE：定时检查。 CHECK_ITEM：按照指定检查项检查。 CHECK_INSTANCE：按照指定检查项加实例的检查。
	string	否	任务类型。	CHECK_POLICY
CurrentPage	integer	否	分页查询时，显示的当前页的页码。	1
PageSize	integer	否	查询页面大小	20
StatusCodes	array	否	任务状态码列表。
	integer	否	检查任务状态码列表，取值： 0：未启动 1：检查中 2：检查完成 3：超时	0
StartTime	long	否	以任务创建时间为准的查询开始时间，单位为毫秒。	1680919232000
EndTime	long	否	以任务完成时间为准的查询结束时间，单位为毫秒。	1635575219000
TaskIds	array	否	任务 ID 列表。
	string	否	任务 ID。	3d7a1b68-599f-4e16-9b45-e920a183b***
TaskSources	array	否	任务来源列表。
	string	否	任务来源。取值： YAO_CHI：瑶池控制台。	YAO_CHI

返回参数

名称	类型	描述	示例值
	object	ListOperationProcessResponse
Processes	array<object>	操作任务信息列表。
Processes	object	操作任务信息。
TotalCount	integer	查询到的数据总条数。	337
FinishCount	integer	完成数量。	197
TaskId	string	操作任务的 ID。	3d7a1b68-599f-4e16-9b45-e920a183b***
StatusCode	integer	检查任务状态码列表，取值： 0：未启动 1：检查中 2：检查完成 3：超时	1
TaskType	string	任务类型，取值： CHECK_ALL：全量检查。 CHECK_POLICY：按照配置策略的检查项执行的检查。 CHECK_SCHEDULE：定时检查。 CHECK_ITEM：按照指定检查项检查。 CHECK_INSTANCE：按照指定检查项加实例的检查。	CHECK_POLICY
StartTime	long	任务开始时间，单位为毫秒。	1705457102000
EndTime	long	任务结束时间，单位为毫秒。	1705467559000
CreateTime	long	任务创建时间，单位为毫秒。	1674388824000
TaskSource	string	任务来源。取值： YAO_CHI：瑶池。	YAO_CHI
DetailTaskTotalCount	integer	子任务总数量。	10
DetailTaskReadyCount	integer	子任务完成数量。	5
PageInfo	object	分页信息。
CurrentPage	integer	分页查询时，显示的当前页的页码。	1
PageSize	integer	分页，每页数量	20
TotalCount	integer	总条数。	263
Count	integer	当前页显示的数据条数。	4
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	F8B6F758-BCD4-597A-8A2C-DA5A552C****

示例

正常返回示例

JSON格式

{
  "Processes": [
    {
      "TotalCount": 337,
      "FinishCount": 197,
      "TaskId": "3d7a1b68-599f-4e16-9b45-e920a183b***\n",
      "StatusCode": 1,
      "TaskType": "CHECK_POLICY",
      "StartTime": 1705457102000,
      "EndTime": 1705467559000,
      "CreateTime": 1674388824000,
      "TaskSource": "YAO_CHI",
      "DetailTaskTotalCount": 10,
      "DetailTaskReadyCount": 5
    }
  ],
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 263,
    "Count": 4
  },
  "RequestId": "F8B6F758-BCD4-597A-8A2C-DA5A552C****"
}

错误码

HTTP status code	错误码	错误信息	描述
400	CspmParamIllegal	The parameter is not legal. %s.	参数不合法。%s.
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
500	ServerError	ServerError	服务故障，请稍后重试！

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

变更历史

变更时间	变更内容概要	操作
2024-12-12	OpenAPI 描述信息更新、OpenAPI 错误码发生变更	查看变更详情