全部产品
Search
文档中心

Cloud Phone:BatchGetAcpConnectionTicket

更新时间:Jan 16, 2026

Mendapatkan tiket koneksi secara batch. Operasi ini bersifat asinkron. Dalam kebanyakan kasus, tiket dikembalikan langsung dalam respons. Namun, pada beberapa kasus, Anda perlu menggunakan TaskId dari respons untuk memanggil operasi ini kembali dan melakukan polling terhadap hasilnya.

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

Daftar ID instans ECP. Anda dapat menentukan 1 hingga 100 ID.

string

No

ID instans.

acp-bj9t2gmys****

EndUserId

string

No

ID pengguna yang ditetapkan. Jika Anda tidak meneruskan parameter ini, sistem akan menggunakan pengguna yang ditetapkan oleh Backend untuk mendapatkan tiket.

user

ConnectionMode

string

No

Mode koneksi.

custom

InstanceTasks

array<object>

No

Tugas koneksi instans. Gunakan parameter ini untuk menanyakan apakah tugas pemerolehan tiket telah selesai.

object

No

Tugas koneksi instans.

InstanceId

string

No

ID instans.

acp-fkuit0cmyfvzz****

TaskId

string

No

ID tugas.

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

Elemen respons

Element

Type

Description

Example

object

Skema 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.

acp-ajxvwo1u0hqvd****

TaskStatus

string

Status tugas. Status `FINISHED` menunjukkan bahwa Anda dapat mengambil tiket dari bidang `Ticket`. Jika tidak, Anda harus menggunakan `TaskId` untuk memanggil operasi ini lagi guna menanyakan hasil pembuatan tiket.

FINISHED

TaskId

string

ID tugas.

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

Ticket

string

Tiket yang digunakan untuk menghubungkan ke instans pengguna.

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

ErrorCode

string

Alasan kesalahan.

InvalidResourceId.NotFound

PersistentAppInstanceId

string

ID session persisten.

p-abdywvcksdb****

AppInstanceId

string

ID instans fisik.

ai-0caoetkqi8kj****

Port

integer

Port koneksi.

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.