文档

DescribeOnceTask - 查询客户端任务列表

更新时间:

查询客户端问题排查任务的列表。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
yundun-sas:DescribeOnceTaskget
  • 全部资源
    *

请求参数

名称类型必填描述示例值
TaskTypestring

任务类型。取值:

  • CLIENT_PROBLEM_CHECK:客户端任务
  • CLIENT_DEV_OPS:云运维任务
  • ASSET_SECURITY_CHECK:资产采集任务
说明 TaskTypeRootTaskId 不能同时为空
CLIENT_PROBLEM_CHECK
RootTaskIdstring

根任务 ID。

说明 TaskTypeRootTaskId 不能同时为空
bb5d657479bba5e1d308b6c9e85c9174
StartTimeQuerylong

根任务开始的时间戳。单位为毫秒。

1651737301000
EndTimeQuerylong

根任务结束的时间戳。单位为毫秒。

1651766520000
CurrentPageinteger

设置从返回结果的第几页开始显示查询结果。默认值为 1,表示从第 1 页开始显示。

1
PageSizeinteger

设置分页查询时,每页包含的客户端任务的数量。默认值为 20,表示每页包含 20 个客户端任务。

20
TaskIdstring

任务 ID。

d7b2acf8d362742123e4a84e1bf8****

返回参数

名称类型描述示例值
object

客户端任务返回数据。

RequestIdstring

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

7E0618A9-D5EF-4220-9471-C42B5E92719F
PageInfoobject

分页信息。

CurrentPageinteger

分页查询时,当前页的页码。

1
PageSizeinteger

分页查询时,每页包含的客户端任务的数量。默认值为 20,表示每页包含 20 个客户端任务。

20
TotalCountinteger

查询到的客户端任务的总条数。

100
Countinteger

分页查询时,当前页面显示的客户端任务条数。

2
TaskManageResponseListarray<object>

客户端任务查询的返回信息列表。

TaskManageResponseobject

客户端任务查询的返回信息。

TaskTypestring

任务类型。取值:

  • CLIENT_PROBLEM_CHECK:客户端任务
  • CLIENT_DEV_OPS:云运维任务
  • ASSET_SECURITY_CHECK:资产采集任务
CLIENT_PROBLEM_CHECK
Progressstring

任务进度,单位为百分比。

10%
TaskStatusinteger

任务状态。取值:

  • 1:已启动。
  • 2:已完成。
  • 3:已失败。
  • 4:已超时。
1
DetailDatastring

任务执行详情。该参数为 JSON 格式。

  • causeCode:排查原因返回码。
  • causeMsg:排查原因返回信息。
  • resCode:排查返回码。
  • resMsg:排查返回信息。
  • problemType:问题类型。
  • dispatchType:任务下发方式。
  • uuid:服务器 UUID。
  • instanceId:服务器实例的 ID。
  • internetIp:服务器外网 IP。
  • intranetIp:服务器的私网 IP 地址。
  • instanceName:服务器实例的名称。
  • url:排查日志下载链接。
[ { "dispatchType": "manual", "causeMsg": [], "causeCode": [], "resCode": [ "1003" ], "resMsg": [ "powershell -executionpolicy bypass -c \"(New-Object Net.WebClient).DownloadFile('http://aegis.alicdn.com/download/aegis_client_self_check/win32/aegis_checker.exe', $ExecutionContext.SessionState.Path.GetUnresolvedProviderPathFromPSPath('.\\\\aegis_checker.exe'))\"; \"./aegis_checker.exe -b eyJtb2RlIjoxLCJqc3J2X2RvbWFpbiI6W10sImlzc3VlIjoib2ZmbGluZSIsInVwZGF0ZV9kb21haW4iOltdLCJ1dWlkIjoiaW5ldC1lYWUwNDg2Ny0wMDJmLTQyM2QtYWYwMC1jNzJjZDYyOWIyNDgiLCJjbWRfaWR4IjoiNDRjZThiZWI3ZGYyYTQxMjQ1NGM4ZDc5OTE1ODI1MzMifQ==\"" ], "problemType": "offline", "uuid": "inet-eae04867-002f-423d-af00-c72cd629****" } ]
TaskStatusTextstring

任务状态的文本对象。取值:

  • INIT:待启动。
  • START:已启动。
  • DISPATCH:自检命令已下发。
  • SUCCESS:自检完成。
  • FAIL:执行失败。
  • TIMEOUT:已超时。
INIT
TaskNamestring

任务名称。

CLIENT_PROBLEM_CHECK
TaskStartTimelong

任务实际开始的时间戳。单位为毫秒。

1649732012000
TaskEndTimelong

任务实际结束的时间戳。单位为毫秒。

1650267989000
TaskIdstring

任务 ID。

e900f528f5a6229bb640ca27cb44c98e
SuccessCountinteger

执行成功的任务数。

7
FailCountinteger

执行失败的任务数。

2
ResultInfostring

任务执行结果。

successful

示例

正常返回示例

JSON格式

{
  "RequestId": "7E0618A9-D5EF-4220-9471-C42B5E92719F",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 100,
    "Count": 2
  },
  "TaskManageResponseList": [
    {
      "TaskType": "CLIENT_PROBLEM_CHECK",
      "Progress": "10%",
      "TaskStatus": 1,
      "DetailData": "[\n      {\n            \"dispatchType\": \"manual\",\n            \"causeMsg\": [],\n            \"causeCode\": [],\n            \"resCode\": [\n                  \"1003\"\n            ],\n            \"resMsg\": [\n                  \"powershell -executionpolicy bypass -c \\\"(New-Object Net.WebClient).DownloadFile('http://aegis.alicdn.com/download/aegis_client_self_check/win32/aegis_checker.exe', $ExecutionContext.SessionState.Path.GetUnresolvedProviderPathFromPSPath('.\\\\\\\\aegis_checker.exe'))\\\"; \\\"./aegis_checker.exe -b eyJtb2RlIjoxLCJqc3J2X2RvbWFpbiI6W10sImlzc3VlIjoib2ZmbGluZSIsInVwZGF0ZV9kb21haW4iOltdLCJ1dWlkIjoiaW5ldC1lYWUwNDg2Ny0wMDJmLTQyM2QtYWYwMC1jNzJjZDYyOWIyNDgiLCJjbWRfaWR4IjoiNDRjZThiZWI3ZGYyYTQxMjQ1NGM4ZDc5OTE1ODI1MzMifQ==\\\"\"\n            ],\n            \"problemType\": \"offline\",\n            \"uuid\": \"inet-eae04867-002f-423d-af00-c72cd629****\"\n      }\n]",
      "TaskStatusText": "INIT",
      "TaskName": "CLIENT_PROBLEM_CHECK",
      "TaskStartTime": 1649732012000,
      "TaskEndTime": 1650267989000,
      "TaskId": "e900f528f5a6229bb640ca27cb44c98e",
      "SuccessCount": 7,
      "FailCount": 2,
      "ResultInfo": "successful"
    }
  ]
}

错误码

HTTP status code错误码错误信息描述
403NoPermissioncaller has no permission当前操作未被授权,请联系主账号在RAM控制台进行授权后再执行操作。
500ServerErrorServerError服务故障,请稍后重试!

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

变更历史

变更时间变更内容概要操作
暂无变更历史