Consulta as tarefas criadas para uma instância de cloud phone. Muitas operações em cloud phones — como criá-los, iniciá-los ou pará-los — são assíncronas. Quando você inicia uma operação, o sistema retorna um Task ID que pode ser usado para acompanhar seu progresso e resultado final. Você pode chamar esta API para recuperar uma lista de todas as tarefas e seus status de execução.
Descrição da operação
-
Você pode chamar a operação DescribeTasks para consultar as tarefas criadas para uma ou mais instâncias de cloud phone.
-
O sistema atualmente oferece suporte a várias tarefas, incluindo iniciar, parar, reiniciar e redefinir instâncias de cloud phone; fazer backup e restaurar dados; instalar aplicativos; e executar comandos remotos.
-
Você pode usar o campo Level para especificar o tipo de tarefa. Se Level estiver definido como 1, representa uma tarefa em lote. Se Level estiver definido como 2, representa uma tarefa no nível da instância.
Exemplo
Suponha que você reinicie duas instâncias de cloud phone com os IDs de instância acp-25nt4kk9whhok**** e acp-j2taq887orj8l****, e o ID de solicitação retornado seja B8ED2BA9-0C6A-5643-818F-B5D60A64****. Se você quiser verificar os resultados da operação das duas instâncias de cloud phone, poderá chamar a operação DescribeTasks. Você precisa definir o parâmetro de solicitação InvokeId como B8ED2BA9-0C6A-5643-818F-B5D60A64****. Se você quiser verificar apenas a instância de cloud phone com o ID acp-25nt4kk9whhok****, deverá definir o parâmetro de solicitação ParentTaskId como o ID da tarefa em lote e o parâmetro de solicitação AndroidInstanceId como acp-25nt4kk9whhok**** ao chamar a operação DescribeTasks.
Experimente agora
Testar
Autorização RAM
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| InvokeId |
string |
Não |
O ID da execução do comando. Você pode definir o valor como o último ID de solicitação retornado. |
B8ED2BA9-0C6A-5643-818F-B5D60A64**** |
| ResourceIds |
array |
Não |
Os IDs dos recursos. |
|
|
string |
Não |
O ID do recurso. Para verificar o status de uma tarefa de início, parada, reinicialização ou redefinição em uma instância de cloud phone, defina o valor como o ID da instância de cloud phone. |
acp-25nt4kk9whhok**** |
|
| TaskIds |
array |
Não |
Os IDs das tarefas. |
|
|
string |
Não |
O ID da tarefa. |
t-bp67acfmxazb4p**** |
|
| ParentTaskId |
string |
Não |
O ID da tarefa pai. |
t-iaej5dkbnmivx**** |
| TaskType |
string |
Não |
O tipo da tarefa. Valores válidos:
|
StartInstance |
| TaskTypes |
array |
Não |
Os tipos das tarefas. |
|
|
string |
Não |
O tipo da tarefa. |
StartInstance |
|
| TaskStatus |
string |
Não |
O estado da tarefa. Valores válidos:
|
Processing |
| TaskStatuses |
array |
Não |
Os status das tarefas. |
|
|
string |
Não |
O estado da tarefa. |
Finished |
|
| Level |
integer |
Não |
O nível da tarefa. Um valor de 1 especifica uma tarefa em lote. Um valor de 2 especifica uma tarefa no nível da instância. |
1 |
| InstanceId |
string |
Não |
O ID da instância de cloud phone. |
acp-2zecay9ponatdc4m**** |
| InstanceName |
string |
Não |
O nome da instância de cloud phone. |
defaultInstanceName |
| Param |
string |
Não |
O campo de extensão. |
param |
| MaxResults |
integer |
Não |
O número máximo de entradas por página. Valores válidos: 1 a 100. Valor padrão: 10. |
10 |
| NextToken |
string |
Não |
O token de paginação que é usado na próxima solicitação para recuperar uma nova página de resultados. Se o parâmetro for deixado vazio, os dados serão consultados a partir da primeira entrada. |
FFbc8N4E1iOlcSxC+8boa0HHH2LKWbggYUinyrZWvtS1oTrMYCg1HuMLGuftj0**** |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
Os parâmetros de resposta. |
||
| NextToken |
string |
Um token de paginação. Pode ser usado na próxima solicitação para recuperar uma nova página de resultados. Se NextToken estiver vazio, não existirá próxima página. |
AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc**** |
| Data |
array<object> |
Os objetos que são retornados. |
|
|
object |
O objeto que é retornado. |
||
| TaskId |
string |
O ID da tarefa. |
t-bp67acfmxazb4p**** |
| InvokeId |
string |
O ID da execução do comando. |
B8ED2BA9-0C6A-5643-818F-B5D60A64**** |
| RegionId |
string |
O ID da região. |
cn-hangzhou |
| ResourceId |
string |
O ID do recurso. |
acp-25nt4kk9whhok**** |
| TaskType |
string |
O tipo da tarefa. |
StartInstance |
| TaskStatus |
string |
O estado da tarefa. |
Processing |
| StartTime |
string |
A hora de início da tarefa. |
2022-10-11T08:53:32Z |
| FinishTime |
string |
A hora de término da tarefa. |
2022-10-11T08:53:32Z |
| Param |
string |
Os parâmetros da tarefa. |
param |
| Result |
string |
O resultado da execução da tarefa. |
{'Success': True} |
| ErrorCode |
string |
O código de erro. |
SendFileFailed |
| ErrorMsg |
string |
A mensagem de erro. |
connect error. |
| Level |
integer |
O nível da tarefa. |
1 |
| FailedChildCount |
integer |
O número total de subtarefas com falha. |
2 |
| SuccessChildCount |
integer |
O número total de subtarefas executadas com sucesso. |
98 |
| RunningChildCount |
integer |
O número total de subtarefas que estão em execução. |
0 |
| TotalChildCount |
integer |
O número total de subtarefas da tarefa em lote atual. |
100 |
| InstanceId |
string |
O ID da instância de cloud phone. |
acp-uto81vfd8t8z**** |
| InstanceName |
string |
O nome da instância de cloud phone. |
defaultInstanceName |
| InstanceStatus |
string |
O status da instância de cloud phone. |
RUNNING |
| Operator |
string |
O operador. |
test |
| ParentTaskId |
string |
O ID da tarefa pai. |
t-41oan3tza16vs**** |
| TotalCount |
integer |
O número total de entradas retornadas. |
10 |
| RequestId |
string |
O ID da solicitação. |
B8ED2BA9-0C6A-5643-818F-B5D60A64**** |
Exemplos
Resposta de sucesso
JSON formato
{
"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****"
}Códigos de erro
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.