Feedback Bearbeiten

Anruf löschen

  • Artikel
  • 5 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Löschen oder Auflegen eines aktiven Anrufs. Bei Gruppenanrufen wird dadurch nur ihr Anrufabschnitt gelöscht, und der zugrunde liegende Gruppenanruf wird weiterhin fortgesetzt.

Berechtigungen

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) Nicht unterstützt.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt.
Anwendung Calls.Initiate.All, Calls.AccessMedia.All

Hinweis: Berechtigungen werden überprüft, wenn der Aufruf erstellt wird. Beim Aufrufen dieser API wird keine zusätzliche Berechtigungsprüfung durchgeführt. Calls.AccessMedia.All ist nur für Anrufe erforderlich, die von der App gehostete Medien verwenden.

HTTP-Anforderung

DELETE /app/calls/{id}
DELETE /communications/calls/{id}

Hinweis: Der /app-Pfad ist veraltet. Verwenden Sie in Zukunft den /communications-Pfad.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich.

Anforderungstext

Geben Sie für diese Methode keinen Anforderungstext an.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben. Im Antworttext wird nichts zurückgegeben.

Beispiel

Anforderung

Das folgende Beispiel zeigt die Antwort.

DELETE https://graph.microsoft.com/beta/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896

Antwort

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 204 No Content

Benachrichtigung – Beenden

POST https://bot.contoso.com/api/calls
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.commsNotifications",
  "value": [
    {
      "@odata.type": "#microsoft.graph.commsNotification",
      "changeType": "updated",
      "resourceUrl": "/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896",
      "resourceData": {
        "@odata.type": "#microsoft.graph.call",
        "state": "terminating"
      }
    }
  ]
}

Benachrichtigung – beendet

POST https://bot.contoso.com/api/calls
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.commsNotifications",
  "value": [
    {
      "@odata.type": "#microsoft.graph.commsNotification",
      "changeType": "deleted",
      "resourceUrl": "/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896",
      "resourceData": {
        "@odata.type": "#microsoft.graph.call",
        "state": "terminated",
        "resultInfo": {
          "@odata.type": "#microsoft.graph.resultInfo",
          "code": "200",
          "subcode": "5001",
          "message": "The conversation has ended."
        }
      }
    }
  ]
}

Anrufendegrundcodes

Dies sind einige der häufigsten Fehlercodes, die beim Beenden des Anrufs per Benachrichtigung empfangen werden.

Code Untercode Kündigungsgrund
200 4097 Der Anruf wurde vom anderen Teilnehmer des Anrufs beendet.
200 4521 Der Anruf wurde vom anderen Teilnehmer an Peer-to-Peer-Anrufen beendet.
200 5000 Von einem anderen Teilnehmer aus der Unterhaltung entfernt.
200 5001 Die Unterhaltung wurde beendet.
200 5002 Die Unterhaltung wurde beendet, da alle anderen Teilnehmer den Anruf verlassen haben.
200 5003 Die Unterhaltung wurde beendet.
200 5007 Die Unterhaltung wurde beendet, als der Initiator des Gruppenanrufs die Unterhaltung verlassen hat.
200 5010 Die Unterhaltung wurde beendet, da nur ein Teilnehmer in der Unterhaltung verblieben ist.
200 5012 Die Unterhaltung wurde beendet, da keine Teilnehmer in der eingehenden Liste vorhanden sind.
200 5013 Die Unterhaltung wurde beendet, da niemand anderer dem Gruppenanruf beigetreten ist.
200 5014 Die Unterhaltung wurde beendet, da wir keinen potenziellen Host für den Gruppenanruf ermitteln konnten.
200 5020 Die Unterhaltung wurde beendet, da keine nicht ausgeblendeten Teilnehmer in der eingehenden Teilnehmerliste vorhanden sind.
200 5030 Die Unterhaltung wurde beendet, da die Dauer des Unterbrechungsraums abgelaufen ist.
200 5300 Der Teilnehmer wurde von einem anderen Teilnehmer aus der Unterhaltung entfernt.
200 5855 Teilnehmer, die im Wartebereich warten, wurden aus der Unterhaltung entfernt, nachdem die Inaktivitätszeitüberschreitung in der Warteschleife aufgetreten ist.
200 7000 Die Unterhaltung wurde von Bot beendet.
200 7015 Der Anruf wurde beendet, wenn die Übertragung erfolgreich abgeschlossen wurde.
200 10550 Die Unterhaltung wurde von Bot beendet.
200 18503 Der andere Teilnehmer am Peer-to-Peer-Anruf hat die Unterhaltung verlassen.
200 540000/560000 Der Anruf wurde vom PSTN-Benutzer beendet.
408 8537 Keep Alive-Timeout, inaktiver Aufruf bereinigt.
408 1106 Es wurde keine Bestätigung für die Anrufannahme in der zugewiesenen Zeit empfangen.
408 10057 Anruftimeout aufgrund kein Signal von angerufenen Endpunkten.
410 301005 Medienkonnektivitätsfehler.
480 10037 Es wurden keine Endpunkte des Angerufenen gefunden.
480 10076 Der Angerufene konnte nicht erreicht werden.
480 10134 Anruf wurde abgelehnt, weil der Anruf nicht weitergeleitet werden kann.
480 10199 Anrufe, die als private Anrufe abgelehnt werden, sind für den Benutzer deaktiviert.
500 1005 Beim Server ist ein Verbindungsfehler mit Bots Medien aufgetreten. Überprüfen Sie die Medienkonnektivität zwischen Bot und Microsoft.