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
Test
Autorización de RAM
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.