All Products
Search
Document Center

Cloud Phone:BatchGetAcpConnectionTicket

Last Updated:Oct 23, 2026

Mengambil kredensial koneksi secara batch. Operasi ini menghasilkan tiket secara asinkron. Dalam sebagian besar kasus, Anda dapat memperoleh tiket langsung dari tanggapan pada panggilan pertama. Dalam beberapa kasus, Anda harus menggunakan TaskId dari tanggapan untuk memanggil operasi ini lagi dan melakukan polling untuk hasil pembuatan.

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 Cloud Phone. Anda dapat menentukan 1 hingga 100 ID.

string

No

ID instans.

acp-bj9t2gmys****

EndUserId

string

No

ID pengguna yang ditetapkan. Jika Anda tidak menentukan parameter ini, pengguna sistem yang ditetapkan di latar belakang akan digunakan untuk memperoleh tiket.

user

ConnectionMode

string

No

Mode koneksi.

custom

InstanceTasks

array<object>

No

Tugas koneksi instans. Parameter ini digunakan untuk mengkueri apakah tugas pengambilan 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****

Ports

array

No

Daftar Port koneksi kustom.

string

No

Port koneksi kustom.

10000

Elemen respons

Element

Type

Description

Example

object

Skema tanggapan.

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. Nilai FINISHED menunjukkan bahwa Anda dapat memperoleh tiket dari bidang Ticket. Jika tidak, Anda harus menggunakan TaskId untuk memanggil operasi ini dan mengkueri hasil pembuatan tiket.

FINISHED

TaskId

string

ID tugas.

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

Ticket

string

Tiket yang digunakan untuk terhubung ke instans pengguna.

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

ErrorCode

string

Penyebab error.

InvalidResourceId.NotFound

PersistentAppInstanceId

string

ID sesi 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.