All Products
Search
Document Center

Cloud Phone:BatchGetAcpConnectionTicket

Last Updated:Jun 10, 2026

Mengambil tiket koneksi secara batch. Operasi ini menghasilkan tiket koneksi secara asinkron. Dalam sebagian besar kasus, tiket dikembalikan langsung di tanggapan panggilan pertama. Namun, dalam beberapa situasi, tanggapan awal akan berisi `TaskId`. Anda kemudian harus melakukan polling pada titik akhir ini dengan `TaskId` hingga 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

The ID of the cloud phone instance.

acp-bj9t2gmys****

EndUserId

string

No

ID pengguna yang ditugaskan pada instans cloud phone.

user

ConnectionMode

string

No

Mode koneksi.

custom

InstanceTasks

array<object>

No

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

object

No

The instance connection task.

InstanceId

string

No

The ID of the cloud phone instance.

acp-fkuit0cmyfvzz****

TaskId

string

No

The ID of the task.

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

Ports

array

No

string

No

Elemen respons

Element

Type

Description

Example

object

The response parameters.

RequestId

string

The ID of the request.

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

InstanceConnectionModels

array<object>

The results of the instance connection tasks.

object

The result of the instance connection task.

AppInstanceGroupId

string

The ID of the delivery group.

aig-1uzb6heg797z3****

InstanceId

string

The ID of the cloud phone instance.

acp-ajxvwo1u0hqvd****

TaskStatus

string

The state of the task. If FINISHED is returned, it indicates that a value can be retrieved from the Ticket field. If the returned value is not FINISHED, you still need to use this operation to query the Ticket generation result by using TaskId.

FINISHED

TaskId

string

The ID of the task.

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

Ticket

string

The ticket used to connect to the cloud phone instance.

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

ErrorCode

string

InvalidResourceId.NotFound

PersistentAppInstanceId

string

p-abdywvcksdb****

AppInstanceId

string

ai-0caoetkqi8kj****

Port

integer

The port used for establishing a connection.

10000

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****",
      "Port": 10000
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.