DescribeTasks - Cloud Phone

Menanyakan task yang dibuat untuk instans cloud phone. Banyak operasi pada cloud phone—seperti membuat, menjalankan, atau menghentikannya—bersifat asinkron. Saat Anda memulai suatu operasi, sistem akan mengembalikan Task ID yang dapat digunakan untuk melacak progres dan hasil akhirnya. Anda dapat memanggil API ini untuk mengambil daftar semua task beserta status eksekusinya.

Deskripsi operasi

Anda dapat memanggil operasi DescribeTasks untuk menanyakan task yang dibuat untuk satu atau beberapa instans cloud phone.
Sistem saat ini mendukung berbagai jenis task, termasuk menjalankan, menghentikan, merestart, dan mereset instans cloud phone; mencadangkan dan memulihkan data; menginstal aplikasi; serta mengeksekusi perintah remote.
Anda dapat menggunakan bidang Level untuk menentukan jenis task. Jika Level diatur ke 1, artinya merupakan task batch. Jika Level diatur ke 2, artinya merupakan task tingkat instans.

Contoh

Misalnya, Anda merestart dua instans cloud phone dengan ID instans acp-25nt4kk9whhok**** dan acp-j2taq887orj8l****, dan ID permintaan yang dikembalikan adalah B8ED2BA9-0C6A-5643-818F-B5D60A64****. Untuk memeriksa hasil operasi kedua instans tersebut, Anda dapat memanggil operasi DescribeTasks dengan mengatur parameter permintaan InvokeId ke B8ED2BA9-0C6A-5643-818F-B5D60A64****. Jika hanya ingin memeriksa instans cloud phone dengan ID acp-25nt4kk9whhok****, Anda harus mengatur parameter permintaan ParentTaskId ke ID task batch dan parameter permintaan AndroidInstanceId ke acp-25nt4kk9whhok**** saat memanggil operasi DescribeTasks.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
InvokeId	string	No	ID eksekusi perintah. Anda dapat mengatur nilainya ke ID permintaan yang terakhir dikembalikan.	B8ED2BA9-0C6A-5643-818F-B5D60A64****
ResourceIds	array	No	ID resource.
	string	No	ID resource. Untuk memeriksa status task start, stop, restart, atau reset pada instans cloud phone, atur nilai ke ID instans cloud phone tersebut.	acp-25nt4kk9whhok****
TaskIds	array	No	ID task.
	string	No	ID task.	t-bp67acfmxazb4p****
ParentTaskId	string	No	ID task induk.	t-iaej5dkbnmivx****
TaskType	string	No	Jenis task. Valid values: BackupFile : StopInstance : RebootInstance : StartApp : SendFile : RunCommand : RestartApp : ResetInstance : RecoverFile : UninstallApp : StopApp : Screenshot : InstallApp : FetchFile : UpdateGroupImage : StartInstance :	StartInstance
TaskTypes	array	No	Jenis task.
	string	No	Jenis task.	StartInstance
TaskStatus	string	No	Status task. Valid values: PartFinished : Finished : Failed : Skipped : Processing : Waiting :	Processing
TaskStatuses	array	No	Status task.
	string	No	Status task.	Finished
Level	integer	No	Tingkat task. Nilai 1 menunjukkan task batch. Nilai 2 menunjukkan task tingkat instans.	1
InstanceId	string	No	ID instans cloud phone.	acp-2zecay9ponatdc4m****
InstanceName	string	No	Nama instans cloud phone.	defaultInstanceName
Param	string	No	Bidang ekstensi.	param
MaxResults	integer	No	Jumlah maksimum entri per halaman. Nilai yang valid: 1 hingga 100. Nilai default: 10.	10
NextToken	string	No	Token paginasi yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Jika parameter ini dibiarkan kosong, data akan diambil dari entri pertama.	FFbc8N4E1iOlcSxC+8boa0HHH2LKWbggYUinyrZWvtS1oTrMYCg1HuMLGuftj0****

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
NextToken	string	Token paginasi. Dapat digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Jika NextToken kosong, berarti tidak ada halaman berikutnya.	AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****
Data	array<object>	Objek yang dikembalikan.
	object	Objek yang dikembalikan.
TaskId	string	ID task.	t-bp67acfmxazb4p****
InvokeId	string	ID eksekusi perintah.	B8ED2BA9-0C6A-5643-818F-B5D60A64****
RegionId	string	ID wilayah.	cn-hangzhou
ResourceId	string	ID resource.	acp-25nt4kk9whhok****
TaskType	string	Jenis task.	StartInstance
TaskStatus	string	Status task.	Processing
StartTime	string	Waktu mulai task.	2022-10-11T08:53:32Z
FinishTime	string	Waktu selesai task.	2022-10-11T08:53:32Z
Param	string	Parameter task.	param
Result	string	Hasil eksekusi task.	{'Success': True}
ErrorCode	string	Kode kesalahan.	SendFileFailed
ErrorMsg	string	Pesan kesalahan.	connect error.
Level	integer	Tingkat task.	1
FailedChildCount	integer	Jumlah total subtask yang gagal.	2
SuccessChildCount	integer	Jumlah total subtask yang berhasil dieksekusi.	98
RunningChildCount	integer	Jumlah total subtask yang sedang berjalan.	0
TotalChildCount	integer	Jumlah total subtask dari task batch saat ini.	100
InstanceId	string	ID instans cloud phone.	acp-uto81vfd8t8z****
InstanceName	string	Nama instans cloud phone.	defaultInstanceName
InstanceStatus	string	Status instans cloud phone.	RUNNING
Operator	string	Operator.	test
ParentTaskId	string	ID task induk.	t-41oan3tza16vs****
TotalCount	integer	Jumlah total entri yang dikembalikan.	10
RequestId	string	ID permintaan.	B8ED2BA9-0C6A-5643-818F-B5D60A64****

Contoh

Respons sukses

JSONformat

{
  "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****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.