Chat Thread - Remove Chat Participant

Riferimento

Servizio:: Communication

Versione API:: 2024-03-07

Rimuovere un partecipante da un thread.

POST {endpoint}/chat/threads/{chatThreadId}/participants/:remove?api-version=2024-03-07

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
chatThreadId	path	True	string	ID thread da cui rimuovere il partecipante.
endpoint	path	True	string	Endpoint della risorsa di comunicazione di Azure.
api-version	query	True	string	Versione dell'API da richiamare.

Intestazione della richiesta

Media Types: "application/json", "application/merge-patch+json"

Nome	Necessario	Tipo	Descrizione
Authorization	True	string	Un token di accesso utente ACS (Servizi di comunicazione di Azure).

Corpo della richiesta

Media Types: "application/json", "application/merge-patch+json"

Nome	Tipo	Descrizione
participantCommunicationIdentifier	CommunicationIdentifierModel	ID del partecipante del thread da rimuovere dal thread.

Risposte

Nome	Tipo	Descrizione
204 No Content		Richiesta riuscita.
401 Unauthorized	CommunicationErrorResponse	Non autorizzato.
403 Forbidden	CommunicationErrorResponse	Vietato.
429 Too Many Requests	CommunicationErrorResponse	Troppe richieste.
Other Status Codes	CommunicationErrorResponse	Servizio non disponibile.

Sicurezza

Authorization

Un token di accesso utente ACS (Servizi di comunicazione di Azure).

Tipo: apiKey
In: header

Esempio

Remove participant

Esempio di richiesta

HTTP

POST https://contoso.westus.communications.azure.com/chat/threads/19:f2167429acf6482880c6b7790a9086c1@thread.v2/participants/:remove?api-version=2024-03-07

{
  "rawId": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10b",
  "communicationUser": {
    "id": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10b"
  }
}

Risposta di esempio

Codice di stato:: 204

Codice di stato:: 401

{
  "error": {
    "code": "Unauthorized",
    "message": "Request is not authorized."
  }
}

Codice di stato:: 403

{
  "error": {
    "code": "Forbidden",
    "message": "User is not allowed to perform specified action."
  }
}

Codice di stato:: 429

{
  "error": {
    "code": "TooManyRequests",
    "message": "Rate limit exceeded."
  }
}

Codice di stato:: 503

{
  "error": {
    "code": "ServiceUnavailable",
    "message": "The server is currently unable to handle the request."
  }
}

Condividi tramite