調用DescribeOnceTask查詢用戶端工作清單-Security Center-阿里雲 - Security Center

查詢用戶端任務列表。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-sas:DescribeOnceTask

get

*All Resource

*

無

請求參數

名稱	類型	必填	描述	樣本值
TaskType	string	否	任務類型。取值： VUL_CHECK_TASK：漏洞掃描任務 CLIENT_PROBLEM_CHECK：用戶端任務 CLIENT_DEV_OPS：雲端維運任務 ASSET_SECURITY_CHECK：資產採集任務 ASSET_REFRESH_HOST：主機資產同步任務說明 TaskType 和 RootTaskId 不能同時為空。	CLIENT_PROBLEM_CHECK
RootTaskId	string	否	根任務 ID。說明 TaskType 和 RootTaskId 不能同時為空。	bb5d657479bba5e1d308b6c9e85c9174
StartTimeQuery	integer	否	根任務開始的時間戳。單位為毫秒。	1651737301000
EndTimeQuery	integer	否	根任務結束的時間戳。單位為毫秒。	1651766520000
CurrentPage	integer	否	設定從返回結果的第幾頁開始顯示查詢結果。預設值為 1，表示從第 1 頁開始顯示。	1
PageSize	integer	否	設定分頁查詢時，每頁包含的用戶端任務的數量。預設值為 20，表示每頁包含 20 個用戶端任務。	20
Source	string	否	任務來源。取值包括但不限於： schedule：漏洞掃描自動調度 console：漏洞掃描控制台一鍵檢測。	console
TaskId	string	否	任務 ID。	d7b2acf8d362742123e4a84e1bf8****

返回參數

名稱	類型	描述	樣本值
	object	用戶端任務返回資料。
RequestId	string	本次呼叫請求的 ID，是由阿里雲為該請求生成的唯一標識符，可用於排查和定位問題。	7E0618A9-D5EF-4220-9471-C42B5E92719F
PageInfo	object	分頁資訊。
CurrentPage	integer	分頁查詢時，當前頁的頁碼。	1
PageSize	integer	分頁查詢時，每頁包含的用戶端任務的數量。預設值為 20，表示每頁包含 20 個用戶端任務。	20
TotalCount	integer	查詢到的用戶端任務的總條數。	100
Count	integer	分頁查詢時，當前頁面顯示的用戶端任務條數。	2
TaskManageResponseList	array<object>	用戶端任務查詢的返回資訊列表。
	object	用戶端任務查詢的返回資訊。
TaskType	string	任務類型。取值： CLIENT_PROBLEM_CHECK：用戶端任務 CLIENT_DEV_OPS：雲端維運任務 ASSET_SECURITY_CHECK：資產採集任務。	CLIENT_PROBLEM_CHECK
Progress	string	任務進度，單位為百分比。	10%
TaskStatus	integer	任務狀態。取值： 1：已啟動。 2：已完成。 3：已失敗。 4：已逾時。	1
DetailData	string	任務執行詳情。該參數為 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****" } ]
TaskStatusText	string	任務狀態的文字物件。取值： INIT：待啟動。 START：已啟動。 DISPATCH：自檢命令已下發。 SUCCESS：自檢完成。 FAIL：執行失敗。 TIMEOUT：已逾時。	INIT
TaskName	string	任務名稱。	CLIENT_PROBLEM_CHECK
TaskStartTime	integer	任務實際開始的時間戳。單位為毫秒。	1649732012000
TaskEndTime	integer	任務實際結束的時間戳。單位為毫秒。	1650267989000
TaskId	string	任務 ID。	e900f528f5a6229bb640ca27cb44c98e
SuccessCount	integer	執行成功的任務數。	7
FailCount	integer	執行失敗的任務數。	2
ResultInfo	string	任務執行結果。	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	錯誤碼	錯誤資訊	描述
500	ServerError	ServerError
403	NoPermission	caller has no permission

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。