Todos los productos
Search
Centro de documentos

Cloud Phone:BatchGetAcpConnectionTicket

Última actualización: Oct 23, 2026

Obtiene las credenciales de conexión en lotes. Esta operación genera tickets de forma asíncrona. En la mayoría de los casos, puede obtener el ticket directamente de la respuesta en la primera llamada. En algunos casos, debe usar el TaskId de la respuesta para volver a llamar a esta operación y sondear el resultado de la generación.

Descripción de la operación

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

InstanceGroupId

string

No

El ID del grupo de instancias.

ag-25nt4kk9whjh****

InstanceIds

array

No

La lista de ID de instancias de Cloud Phone. Puede especificar de 1 a 100 ID.

string

No

El ID de la instancia.

acp-bj9t2gmys****

EndUserId

string

No

El ID del usuario asignado. Si no especifica este parámetro, se utiliza el usuario del sistema asignado en segundo plano para obtener el ticket.

user

ConnectionMode

string

No

El modo de conexión.

custom

InstanceTasks

array<object>

No

Las tareas de conexión de la instancia. Este parámetro se utiliza para consultar si la tarea de obtención del ticket ha finalizado.

object

No

La tarea de conexión de la instancia.

InstanceId

string

No

El ID de la instancia.

acp-fkuit0cmyfvzz****

TaskId

string

No

El ID de la tarea.

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

Ports

array

No

La lista de puertos de conexión personalizados.

string

No

El puerto de conexión personalizado.

10000

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Esquema de la respuesta.

RequestId

string

El ID de la solicitud.

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

InstanceConnectionModels

array<object>

Los resultados de la tarea de conexión de la instancia.

object

Los resultados de la tarea de conexión de la instancia.

AppInstanceGroupId

string

El ID del grupo de entrega.

aig-1uzb6heg797z3****

InstanceId

string

El ID de la instancia.

acp-ajxvwo1u0hqvd****

TaskStatus

string

El estado de la tarea. Un valor FINISHED indica que puede obtener el ticket del campo Ticket. De lo contrario, debe usar el TaskId para llamar a esta operación y consultar el resultado de la generación del ticket.

FINISHED

TaskId

string

El ID de la tarea.

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

Ticket

string

El ticket utilizado para conectarse a la instancia del usuario.

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

ErrorCode

string

La causa del error.

InvalidResourceId.NotFound

PersistentAppInstanceId

string

El ID de la sesión persistente.

p-abdywvcksdb****

AppInstanceId

string

El ID de la instancia física.

ai-0caoetkqi8kj****

Port

integer

El puerto de conexión.

10000

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.