全部产品
Search
文档中心

Cloud Phone:BatchGetAcpConnectionTicket

更新时间:Dec 21, 2025

Mengambil tiket koneksi secara batch. Operasi ini menghasilkan tiket koneksi secara asinkron. Dalam kebanyakan kasus, tiket dikembalikan langsung dalam respons panggilan pertama. Namun, dalam beberapa situasi, respons awal akan berisi TaskId. Anda kemudian harus melakukan polling terhadap titik akhir ini dengan TaskId hingga proses pembuatan selesai dan tiket dikembalikan.

Deskripsi operasi

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

InstanceGroupId

string

No

ID kelompok instans.

ag-25nt4kk9whjh****

InstanceIds

array

No

ID instans Cloud Phone. Anda dapat menentukan 1 hingga 100 ID instans Cloud Phone.

string

No

ID instans Cloud Phone.

acp-bj9t2gmys****

EndUserId

string

No

ID pengguna yang diberi instans Cloud Phone.

user

InstanceTasks

array<object>

No

Tugas koneksi instans, yang digunakan untuk memeriksa apakah tugas pengambilan tiket telah selesai.

object

No

Tugas koneksi instans.

InstanceId

string

No

ID instans Cloud Phone.

acp-fkuit0cmyfvzz****

TaskId

string

No

ID task.

cn-hangzhou@c9f5c2e8-f5c4-4b01-8602-000cae94****

Elemen respons

Element

Type

Description

Example

object

Parameter respons.

RequestId

string

ID permintaan.

7B9EFA4F-4305-5968-BAEE-BD8B8DE5****

InstanceConnectionModels

array<object>

Hasil tugas koneksi instans.

object

Hasil tugas koneksi instans.

AppInstanceGroupId

string

ID kelompok pengiriman.

aig-1uzb6heg797z3****

InstanceId

string

ID instans Cloud Phone.

acp-ajxvwo1u0hqvd****

TaskStatus

string

Status task. Jika nilai yang dikembalikan adalah FINISHED, artinya nilai dapat diambil dari bidang Ticket. Jika nilai yang dikembalikan bukan FINISHED, Anda tetap perlu menggunakan operasi ini untuk memeriksa hasil pembuatan Ticket dengan menggunakan TaskId.

FINISHED

TaskId

string

ID task.

cn-hangzhou@c9f5c2e8-f5c4-4b01-8602-000cae94****

Ticket

string

Tiket yang digunakan untuk menghubungkan ke instans Cloud Phone.

piVE58_AdmVSVW7SEW3*AE5*p8mmO5gvItsNOmv4S_f_cNpoU_BOTwChTBoNM1ZJeedfK9zxYnbN5hossqIZCr6t7SGxRigm2Cb4fGaCdBZWIzmgdHq6sXXZQg4KFWufyvpeV*0*Cm58slMT1tJw3****

ErrorCode

string

InvalidResourceId.NotFound

PersistentAppInstanceId

string

p-abdywvcksdb****

AppInstanceId

string

ai-0caoetkqi8kj****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "7B9EFA4F-4305-5968-BAEE-BD8B8DE5****",
  "InstanceConnectionModels": [
    {
      "AppInstanceGroupId": "aig-1uzb6heg797z3****",
      "InstanceId": "acp-ajxvwo1u0hqvd****",
      "TaskStatus": "FINISHED",
      "TaskId": "cn-hangzhou@c9f5c2e8-f5c4-4b01-8602-000cae94****",
      "Ticket": "piVE58_AdmVSVW7SEW3*AE5*p8mmO5gvItsNOmv4S_f_cNpoU_BOTwChTBoNM1ZJeedfK9zxYnbN5hossqIZCr6t7SGxRigm2Cb4fGaCdBZWIzmgdHq6sXXZQg4KFWufyvpeV*0*Cm58slMT1tJw3****",
      "ErrorCode": "InvalidResourceId.NotFound",
      "PersistentAppInstanceId": "p-abdywvcksdb****",
      "AppInstanceId": "ai-0caoetkqi8kj****"
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.