Chat Thread - Remove Chat Participant

Usuń uczestnika z wątku.

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

Parametry identyfikatora URI

Name In Required Type Description
chatThreadId
path True
  • string

Identyfikator wątku, z którego ma zostać usunięty uczestnik.

endpoint
path True
  • string

Punkt końcowy zasobu komunikacyjnego platformy Azure.

api-version
query True
  • string

Wersja interfejsu API do wywołania.

Nagłówek żądania

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

Name Required Type Description
Authorization True
  • string

Token dostępu użytkownika usługi ACS (Azure Communications Services).

Treść żądania

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

Name Type Description
participantCommunicationIdentifier
  • CommunicationIdentifierModel

Identyfikator uczestnika wątku, który ma zostać usunięty z wątku.

Odpowiedzi

Name Type Description
204 No Content

Żądanie powiodło się.

401 Unauthorized
  • CommunicationErrorResponse

Próby.

403 Forbidden
  • CommunicationErrorResponse

Zabrania.

Other Status Codes
  • CommunicationErrorResponse

Zbyt wiele żądań.

Other Status Codes
  • CommunicationErrorResponse

Usługa niedostępna.

Zabezpieczenia

Authorization

Token dostępu użytkownika usługi ACS (Azure Communications Services).

Type: apiKey
In: header

Przykłady

Remove participant

Sample Request

POST https://contoso.westus.communications.azure.com/chat/threads/19:f2167429acf6482880c6b7790a9086c1@thread.v2/participants/:remove?api-version=2021-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"
  }
}

Sample Response

{
  "error": {
    "code": "Unauthorized",
    "message": "Request is not authorized."
  }
}
{
  "error": {
    "code": "Forbidden",
    "message": "User is not allowed to perform specified action."
  }
}
{
  "error": {
    "code": "TooManyRequests",
    "message": "Rate limit exceeded."
  }
}
{
  "error": {
    "code": "ServiceUnavailable",
    "message": "The server is currently unable to handle the request."
  }
}