擷取雲手機執行個體當前工作清單。雲手機很多（建立、開關機等）的操作都是非同步進行，系統將產生一個任務ID供使用者查詢操作進度及結果。使用者可通過調用該介面查詢所有任務清單及執行情況。
介面說明
可以通過 DescribeTasks 介面查詢批量或者單台雲手機執行個體的操作狀態。
目前支援開機、關機、重啟、重設、備份/恢複、安裝應用、遠程命令等操作的任務查詢。
Level 欄位可區分任務等級。當 Level=1，任務屬於批量任務；Level=2，任務屬於執行個體級任務。
舉例說明：
假設您對執行個體 ID 為 acp-25nt4kk9whhok****、執行個體 ID 為 acp-j2taq887orj8l**** 的兩台雲手機執行個體執行了重啟操作，返回這次操作的 requestId 為 B8ED2BA9-0C6A-5643-818F-B5D60A64****。如果您希望知道這次大量操作的結果，可以調用 DescribeTasks 來查詢，其中的 InvokeId 填寫 B8ED2BA9-0C6A-5643-818F-B5D60A64****；如果您希望拿到執行個體 ID 為 acp-25nt4kk9whhok**** 的重啟結果，入參 ParentTaskId=批量任務 ID，AndroidInstanceId=acp-25nt4kk9whhok****，可調用 DescribeTasks 即可。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| InvokeId |
string |
否 |
命令執行 ID，可以填寫上一次操作返回的 requestId。 |
B8ED2BA9-0C6A-5643-818F-B5D60A64**** |
| ResourceIds |
array |
否 |
資源 ID 列表。 |
|
|
string |
否 |
資源 ID，如果是查詢雲手機開機、關機、重啟和重設的任務狀態，資源 ID 填執行個體 ID 即可。 |
acp-25nt4kk9whhok**** |
|
| TaskIds |
array |
否 |
任務 ID 列表。 |
|
|
string |
否 |
任務 ID。 |
t-bp67acfmxazb4p**** |
|
| ParentTaskId |
string |
否 |
父任務 ID。 |
t-iaej5dkbnmivx**** |
| TaskType |
string |
否 |
任務類型。 |
StartInstance |
| TaskTypes |
array |
否 |
任務類型列表。 |
|
|
string |
否 |
任務類型。 |
StartInstance |
|
| TaskStatus |
string |
否 |
任務狀態。 |
Processing |
| TaskStatuses |
array |
否 |
任務狀態列表。 |
|
|
string |
否 |
任務狀態。 |
Finished |
|
| Level |
integer |
否 |
任務層級，1 表示批量任務；2 表示執行個體級任務。 |
1 |
| InstanceId |
string |
否 |
執行個體 ID。 |
acp-2zecay9ponatdc4m**** |
| InstanceName |
string |
否 |
執行個體名稱。 |
defaultInstanceName |
| Param |
string |
否 |
擴充欄位。 |
param |
| MaxResults |
integer |
否 |
分頁查詢時每頁的最大條目數。取值範圍 1～100，預設值為 10。 |
10 |
| NextToken |
string |
否 |
用來表示當前開始讀取的位置。置空表示從頭開始。 |
FFbc8N4E1iOlcSxC+8boa0HHH2LKWbggYUinyrZWvtS1oTrMYCg1HuMLGuftj0**** |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回參數。 |
||
| NextToken |
string |
用來表示當前開始讀取的位置。置空表示從頭開始。 |
AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc**** |
| Data |
array<object> |
返回結果對象列表。 |
|
|
object |
返回結果對象。 |
||
| TaskId |
string |
任務 ID。 |
t-bp67acfmxazb4p**** |
| InvokeId |
string |
命令執行 ID。 |
B8ED2BA9-0C6A-5643-818F-B5D60A64**** |
| RegionId |
string |
地區 ID。 |
cn-hangzhou |
| ResourceId |
string |
資源 ID。 |
acp-25nt4kk9whhok**** |
| TaskType |
string |
任務類型。 |
StartInstance |
| TaskStatus |
string |
任務狀態。 |
Processing |
| StartTime |
string |
任務開始時間。 |
2022-10-11T08:53:32Z |
| FinishTime |
string |
任務結束時間。 |
2022-10-11T08:53:32Z |
| Param |
string |
任務參數。 |
param |
| Result |
string |
任務執行結果。 |
{'Success': True} |
| ErrorCode |
string |
錯誤碼。 |
SendFileFailed |
| ErrorMsg |
string |
錯誤資訊。 |
connect error. |
| Level |
integer |
任務層級。 |
1 |
| FailedChildCount |
integer |
執行失敗的子任務總數。 |
2 |
| SuccessChildCount |
integer |
執行成功的子任務總數。 |
98 |
| RunningChildCount |
integer |
運行中的子任務總數。 |
0 |
| TotalChildCount |
integer |
當前批量任務的子任務總數。 |
100 |
| InstanceId |
string |
執行個體 ID。 |
acp-uto81vfd8t8z**** |
| InstanceName |
string |
執行個體名稱 |
defaultInstanceName |
| InstanceStatus |
string |
執行個體狀態。 |
RUNNING |
| Operator |
string |
操作者。 |
test |
| ParentTaskId |
string |
父任務 ID。 |
t-41oan3tza16vs**** |
| TotalCount |
integer |
總條目數。 |
10 |
| RequestId |
string |
請求 ID。 |
B8ED2BA9-0C6A-5643-818F-B5D60A64**** |
樣本
正常返回樣本
JSON格式
{
"NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****",
"Data": [
{
"TaskId": "t-bp67acfmxazb4p****",
"InvokeId": "B8ED2BA9-0C6A-5643-818F-B5D60A64****",
"RegionId": "cn-hangzhou",
"ResourceId": "acp-25nt4kk9whhok****",
"TaskType": "StartInstance",
"TaskStatus": "Processing",
"StartTime": "2022-10-11T08:53:32Z",
"FinishTime": "2022-10-11T08:53:32Z",
"Param": "param",
"Result": "{'Success': True}",
"ErrorCode": "SendFileFailed",
"ErrorMsg": "connect error.",
"Level": 1,
"FailedChildCount": 2,
"SuccessChildCount": 98,
"RunningChildCount": 0,
"TotalChildCount": 100,
"InstanceId": "acp-uto81vfd8t8z****",
"InstanceName": "defaultInstanceName",
"InstanceStatus": "RUNNING",
"Operator": "test",
"ParentTaskId": "t-41oan3tza16vs****"
}
],
"TotalCount": 10,
"RequestId": "B8ED2BA9-0C6A-5643-818F-B5D60A64****"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。