Chat Thread - Update Chat Thread Properties

Referenz

Dienst:: Communication

API-Version:: 2024-03-07

Aktualisiert die Eigenschaften eines Threads.

PATCH {endpoint}/chat/threads/{chatThreadId}?api-version=2024-03-07

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
chatThreadId	path	True	string	Die ID des zu aktualisierenden Threads.
endpoint	path	True	string	Der Endpunkt der Azure Communication-Ressource.
api-version	query	True	string	Version der API, die aufgerufen werden soll.

Anforderungsheader

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

Name	Erforderlich	Typ	Beschreibung
Authorization	True	string	Ein ACS(Azure Communication Services)-Benutzerzugriffstoken.

Anforderungstext

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

Name	Typ	Beschreibung
topic	string	Thema "Chatthread".

Antworten

Name	Typ	Beschreibung
204 No Content		Thread wurde erfolgreich aktualisiert.
401 Unauthorized	CommunicationErrorResponse	Unbefugt.
403 Forbidden	CommunicationErrorResponse	Verboten.
429 Too Many Requests	CommunicationErrorResponse	Zu viele Anforderungen.
Other Status Codes	CommunicationErrorResponse	Der Dienst ist nicht verfügbar.

Sicherheit

Authorization

Ein ACS(Azure Communication Services)-Benutzerzugriffstoken.

Typ: apiKey
In: header

Beispiele

Update chat thread topic

Beispielanforderung

HTTP

PATCH https://contoso.westus.communications.azure.com/chat/threads/19:uni01_zbnh3nt2dfuffezc3sox7dog7wfhk6y5qe2rwlnfhlhdzirihdpq@thread.v2?api-version=2024-03-07

{
  "topic": "Updated Thread Topic"
}

Beispiel für eine Antwort

Statuscode:: 204

Statuscode:: 401

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

Statuscode:: 403

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

Statuscode:: 429

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

Statuscode:: 503

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

Definitionen

UpdateChatThreadRequest

Fordern Sie nutzlast zum Aktualisieren eines Chatthreads an.

Name	Typ	Beschreibung
topic	string	Thema "Chatthread".

Freigeben über