Condividi tramite


Call Media - Unhold

Rimuovere i partecipanti dalla chiamata usando l'identificatore.

POST {endpoint}/calling/callConnections/{callConnectionId}:unhold?api-version=2025-05-15

Parametri dell'URI

Nome In Necessario Tipo Descrizione
callConnectionId
path True

string

ID connessione di chiamata.

endpoint
path True

string (url)

Endpoint della risorsa di comunicazione di Azure.

api-version
query True

string

Versione dell'API da richiamare.

Intestazione della richiesta

Nome Necessario Tipo Descrizione
Authorization True

string

Token di accesso utente di Servizi di comunicazione di Azure.

Corpo della richiesta

Nome Necessario Tipo Descrizione
targetParticipant True

CommunicationIdentifierModel

operationCallbackUri

string

Impostare un URI di callback che esegue l'override dell'URI di callback predefinito impostato da CreateCall/AnswerCall per questa operazione. Questa configurazione è per azione. Se non è impostato, verrà usato l'URI di callback predefinito impostato da CreateCall/AnswerCall.

operationContext

string

Usato dai clienti quando si chiamano azioni di chiamata mid-call per correlare la richiesta all'evento di risposta.

Risposte

Nome Tipo Descrizione
200 OK

Restituisce la risposta del partecipante non trattenuta

Other Status Codes

CommunicationErrorResponse

Errore

Sicurezza

Authorization

Token di accesso utente di Servizi di comunicazione di Azure.

Tipo: apiKey
In: header

Esempio

CallMedia_Unhold

Esempio di richiesta

POST https://contoso.communications.azure.com/calling/callConnections/18dea47f-b081-4107-9a5c-4300819d2c6c:unhold?api-version=2025-05-15

{
  "targetParticipant": {
    "kind": "communicationUser",
    "communicationUser": {
      "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_0f50d091-5bd3-448b-884d-44be7037d9b9"
    }
  }
}

Risposta di esempio

Definizioni

UnholdRequest

Payload della richiesta per mantenere il partecipante dalla chiamata.

Nome Tipo Descrizione
operationCallbackUri

string

Impostare un URI di callback che esegue l'override dell'URI di callback predefinito impostato da CreateCall/AnswerCall per questa operazione. Questa configurazione è per azione. Se non è impostato, verrà usato l'URI di callback predefinito impostato da CreateCall/AnswerCall.

operationContext

string

Usato dai clienti quando si chiamano azioni di chiamata mid-call per correlare la richiesta all'evento di risposta.

targetParticipant

CommunicationIdentifierModel