Freigeben über


Anruf löschen

Namespace: microsoft.graph

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

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Nicht unterstützt Nicht unterstützt
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung Calls.Initiate.All Calls.AccessMedia.All

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

HTTP-Anforderung

DELETE /communications/calls/{id}

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

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

Beispiel

Anforderung

Das folgende Beispiel zeigt die Antwort.

DELETE https://graph.microsoft.com/v1.0/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 – Wird beendet

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."
        }
      }
    }
  ]
}

Anruf-End-Ursachencodes

Dies sind einige der gängigen Fehlercodes, die über die Benachrichtigung empfangen werden, wenn der Anruf beendet wird.

Code Untercode Kündigungsgrund
200 4097 Der Anruf wurde vom anderen Teilnehmer des Anrufs beendet.
200 4521 Der Anruf wurde vom anderen Teilnehmer am Peer-to-Peer-Anruf beendet.
200 5000 Wurde 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 an der Unterhaltung verblieb.
200 5012 Die Unterhaltung wurde beendet, da keine Teilnehmer in der eingehenden Liste vorhanden sind.
200 5013 Die Unterhaltung wurde beendet, da sich noch niemand an dem Gruppenanruf angeschlossen hat.
200 5014 Die Unterhaltung wurde beendet, weil wir keinen potenziellen Host für den Gruppenanruf ermitteln konnten.
200 5020 Die Unterhaltung wurde beendet, da keine nicht ausgeblendeten Teilnehmer in der eingehenden Liste vorhanden sind.
200 5030 Die Unterhaltung wurde beendet, da die Dauer des Gruppenraums abgelaufen ist.
200 5300 Der Teilnehmer wurde von einem anderen Teilnehmer aus der Unterhaltung entfernt.
200 5855 Teilnehmer, der im Wartebereich wartete, wurde nach dem Timeout der Lobby-Inaktivität aus der Unterhaltung entfernt.
200 7000 Die Unterhaltung wurde vom Bot beendet.
200 7015 Der Aufruf wurde beendet, da die Übertragung erfolgreich abgeschlossen wurde.
200 10550 Die Unterhaltung wurde vom 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 Für die Anrufannahme wurde in der vorgesehenen Zeit keine Bestätigung empfangen.
408 10057 Ein Aufruftimeout ist aufgrund einer fehlenden Signalisierung von angerufenen Endpunkten erfolgt.
410 301005 Medienkonnektivitätsfehler.
480 10037 Es wurden keine aufgerufenen Endpunkte gefunden.
480 10076 Der Angerufene konnte nicht erreicht werden.
480 10134 Der Aufruf wurde abgelehnt, weil der Anruf nicht weitergeleitet werden kann.
480 10199 Der als private Anruf abgelehnte Anruf ist für den Benutzer deaktiviert.
500 1005 Beim Server ist ein Konnektivitätsfehler mit den Medien des Bots aufgetreten. Überprüfen Sie die Medienkonnektivität zwischen Bot und Microsoft.