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.

HTTP

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

C#

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Communications.Calls["{call-id}"].DeleteAsync();

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

CLI

// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc communications calls delete --call-id {call-id}

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Go

import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



graphClient.Communications().Calls().ByCallId("call-id").Delete(context.Background(), nil)

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.communications().calls().byCallId("{call-id}").delete();

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896')
	.delete();

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

PHP

<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->communications()->calls()->byCallId('call-id')->delete()->wait();

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

PowerShell

Import-Module Microsoft.Graph.CloudCommunications

Remove-MgCommunicationCall -CallId $callId

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Python

from msgraph import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


await graph_client.communications.calls.by_call_id('call-id').delete()

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

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.