获取云手机实例当前任务列表。
接口说明
- 可以通过 DescribeTasks 接口查询云手机实例的操作状态。
- 目前只支持开机、关机、重启、重置等 4 种操作的任务查询。
举例说明：
假设您对实例 ID 为 acp-25nt4kk9whhok**** 的云手机实例执行了重启操作，返回这次操作的 requestId 为 B8ED2BA9-0C6A-5643-818F-B5D60A64****；如果您希望知道这次操作的结果，可以调用 DescribeTasks 来查询，其中的 InvokeId 填写 B8ED2BA9-0C6A-5643-818F-B5D60A64**** 即可。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| 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**** | |
| TaskType | string | 否 | 任务类型。 枚举值：
| StartInstance |
| TaskStatus | string | 否 | 任务状态。 枚举值：
| Processing |
| MaxResults | integer | 否 | 分页查询时每页的最大条目数。取值范围 1～100，默认值为 10。 | 10 |
| NextToken | string | 否 | 用来表示当前开始读取的位置。置空表示从头开始。 | FFbc8N4E1iOlcSxC+8boa0HHH2LKWbggYUinyrZWvtS1oTrMYCg1HuMLGuftj0**** |
返回参数
示例
正常返回示例
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",
"Result": "",
"ErrorCode": "",
"ErrorMsg": ""
}
],
"TotalCount": 10,
"RequestId": "B8ED2BA9-0C6A-5643-818F-B5D60A64****"
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2024-08-21 | OpenAPI 返回结构发生变更 | 查看变更详情 |