Todos los productos
Search
Centro de documentos

Cloud Phone:DescribeTasks

Última actualización: Oct 12, 2026

Consulta la lista de tareas actual de las instancias de cloud phone. Muchas operaciones en los cloud phones, como la creación y el encendido o apagado, se realizan de forma asíncrona. El sistema genera un ID de tarea para consultar el progreso y los resultados de la operación. Puede llamar a esta operación para consultar la lista completa de tareas y el estado de ejecución.

Descripción de la operación

  • Puede llamar a la operación DescribeTasks para consultar el estado de operación de una o más instancias de cloud phone.

  • Actualmente, las consultas de tareas son compatibles con operaciones como encendido, apagado, reinicio, restablecimiento, copia de seguridad o restauración, instalación de aplicaciones y comandos remotos.

  • El campo Level distingue los niveles de tarea. Si Level se establece en 1, la tarea es una tarea por lotes. Si Level se establece en 2, la tarea es una tarea a nivel de instancia.

Ejemplos:

Suponga que reinicia dos instancias de cloud phone cuyos ID de instancia son acp-25nt4kk9whhok**** y acp-j2taq887orj8l****. El requestId devuelto para esta operación es B8ED2BA9-0C6A-5643-818F-B5D60A64****. Para comprobar el resultado de esta operación por lotes, puede llamar a DescribeTasks y establecer InvokeId en B8ED2BA9-0C6A-5643-818F-B5D60A64****. Para obtener el resultado del reinicio de la instancia cuyo ID es acp-25nt4kk9whhok****, puede llamar a DescribeTasks y establecer ParentTaskId en el ID de la tarea por lotes y AndroidInstanceId en acp-25nt4kk9whhok****.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

InvokeId

string

No

El ID de ejecución del comando. Puede ingresar el requestId devuelto por la operación anterior.

B8ED2BA9-0C6A-5643-818F-B5D60A64****

ResourceIds

array

No

La lista de ID de recursos.

string

No

El ID del recurso. Si consulta el estado de la tarea de las operaciones de encendido, apagado, reinicio y restablecimiento del cloud phone, establezca este parámetro en el ID de la instancia.

acp-25nt4kk9whhok****

TaskIds

array

No

La lista de ID de tareas.

string

No

El ID de la tarea.

t-bp67acfmxazb4p****

ParentTaskId

string

No

El ID de la tarea principal.

t-iaej5dkbnmivx****

TaskType

string

No

El tipo de tarea.

Valores válidos:

  • BackupFile :

    Copia de seguridad de datos.

  • StopInstance :

    Apagado de instancia.

  • RebootInstance :

    Reinicio de instancia.

  • StartApp :

    Inicio de aplicación.

  • SendFile :

    Carga de archivo.

  • RunCommand :

    Comando remoto.

  • RestartApp :

    Reinicio de aplicación.

  • ResetInstance :

    Restablecimiento de instancia.

  • RecoverFile :

    Restauración de datos.

  • UninstallApp :

    Desinstalación de aplicación.

  • StopApp :

    Detención de aplicación.

  • Screenshot :

    Captura de pantalla.

  • InstallApp :

    Instalación de aplicación.

  • FetchFile :

    Descarga de archivo.

  • UpdateGroupImage :

    Reemplazo de imagen.

  • StartInstance :

    Encendido de instancia.

StartInstance

TaskTypes

array

No

La lista de tipos de tarea.

string

No

El tipo de tarea.

StartInstance

TaskStatus

string

No

El estado de la tarea.

Valores válidos:

  • PartFinished :

    Parcialmente exitosa.

  • Finished :

    Completada.

  • Failed :

    Fallida.

  • Skipped :

    Omitida.

  • Processing :

    En ejecución.

  • Waiting :

    En espera.

Processing

TaskStatuses

array

No

La lista de estados de tarea.

string

No

El estado de la tarea.

Finished

Level

integer

No

El nivel de la tarea. Un valor de 1 indica una tarea por lotes. Un valor de 2 indica una tarea a nivel de instancia.

1

InstanceId

string

No

El ID de la instancia.

acp-2zecay9ponatdc4m****

InstanceName

string

No

El nombre de la instancia.

defaultInstanceName

Param

string

No

El campo extendido.

param

MaxResults

integer

No

El número máximo de entradas por página para una consulta paginada. Valores válidos: de 1 a 100. Valor predeterminado: 10.

10

NextToken

string

No

El token que especifica la posición inicial para la lectura. Si este parámetro se deja vacío, la lectura comienza desde el principio.

FFbc8N4E1iOlcSxC+8boa0HHH2LKWbggYUinyrZWvtS1oTrMYCg1HuMLGuftj0****

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Los parámetros de respuesta.

NextToken

string

El token que especifica la posición inicial para la lectura. Si este parámetro se deja vacío, la lectura comienza desde el principio.

AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****

Data

array<object>

La lista de objetos de resultado devueltos.

object

El objeto de resultado devuelto.

TaskId

string

El ID de la tarea.

t-bp67acfmxazb4p****

InvokeId

string

El ID de ejecución del comando.

B8ED2BA9-0C6A-5643-818F-B5D60A64****

RegionId

string

El ID de la región.

cn-hangzhou

ResourceId

string

El ID del recurso.

acp-25nt4kk9whhok****

TaskType

string

El tipo de tarea.

StartInstance

TaskStatus

string

El estado de la tarea.

Processing

StartTime

string

La hora de inicio de la tarea. La hora se muestra en UTC y sigue el estándar ISO 8601.

2022-10-11T08:53:32Z

FinishTime

string

La hora de finalización de la tarea. La hora se muestra en UTC y sigue el estándar ISO 8601.

2022-10-11T08:53:32Z

Param

string

Los parámetros de la tarea.

param

Result

string

El resultado de la ejecución de la tarea.

{'Success': True}

ErrorCode

string

El código de error.

SendFileFailed

ErrorMsg

string

El mensaje de error.

connect error.

Level

integer

El nivel de la tarea.

1

FailedChildCount

integer

El número total de tareas secundarias fallidas.

2

SuccessChildCount

integer

El número total de tareas secundarias exitosas.

98

RunningChildCount

integer

El número total de tareas secundarias en ejecución.

0

TotalChildCount

integer

El número total de tareas secundarias para la tarea por lotes actual.

100

InstanceId

string

El ID de la instancia.

acp-uto81vfd8t8z****

InstanceName

string

El nombre de la instancia.

defaultInstanceName

InstanceStatus

string

El estado de la instancia.

RUNNING

Operator

string

El operador.

test

ParentTaskId

string

El ID de la tarea principal.

t-41oan3tza16vs****

TotalCount

integer

El número total de entradas.

10

RequestId

string

El ID de la solicitud.

B8ED2BA9-0C6A-5643-818F-B5D60A64****

Ejemplos

Respuesta exitosa

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 error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.