conversationMember: entfernen

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Entfernen Sie mehrere Mitglieder aus einem Team in einer einzigen Anforderung. Die Antwort enthält Details darüber, welche Mitgliedschaften entfernt werden konnten und welche nicht.

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

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. 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) TeamMember.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung TeamMember.ReadWrite.All Nicht verfügbar.

HTTP-Anforderung

Dies ist eine gebundene Aktion, um mehrere Elemente aus einer conversationMember-Sammlung in einer einzigen Anforderung zu entfernen.

POST /teams/{team-id}/members/remove

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext die JSON-Darstellung der Liste der conversationMember-Derivate an, die aus einem Team entfernt werden sollen. Es können maximal 20 conversationMember-Derivate in einer einzigen Anforderung entfernt werden.

Die folgende Tabelle zeigt den Parameter, den Sie mit dieser Methode verwenden können.

Parameter Typ Beschreibung
values conversationMember-Sammlung Eine Liste der Unterhaltungsmitglieder, die entfernt werden sollen.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode entweder eine 204 No Content Antwort zurück, wenn alle angegebenen Mitglieder erfolgreich aus dem Team entfernt wurden, oder eine 207 Multi-Status Antwort, wenn nur einige Mitglieder entfernt wurden. Der Aufrufer sollte die Antwortnutzlast überprüfen, um zu ermitteln, welche Mitglieder entfernt werden konnten. Der Antworttext enthält eine Auflistung von Ableitungen der actionResultPart-Ressource . Wenn die Anforderung fehlschlägt, gibt die API einen Fehler zurück. Weitere Informationen zu Microsoft Graph-Fehlern finden Sie unter Microsoft Graph-Fehlerantworten und Ressourcentypen.

Beispiele

Beispiel 1: Entfernen von Mitgliedern in einem Massenvorgang aus einem Team

Das folgende Beispiel zeigt, wie Sie mehrere Mitglieder in einer einzigen Anforderung aus einem Team entfernen können.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/teams/e4183b04-c9a2-417c-bde4-70e3ee46a6dc/members/remove
Content-Type: application/json

{
    "values": [
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "user@odata.bind": "https://graph.microsoft.com/beta/users('18a80140-b0fb-4489-b360-2f6efaf225a0')"
        },
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "user@odata.bind": "https://graph.microsoft.com/beta/users('86503198-b81b-43fe-81ee-ad45b8848ac9')"
        }
    ]
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Beispiel 2: Massenentfernen von Mitgliedern aus einem Team mithilfe des Benutzerprinzipalnamens

Im folgenden Beispiel wird gezeigt, wie mehrere Mitglieder in einer einzigen Anforderung unter Verwendung ihrer Benutzerprinzipalnamen aus einem Team entfernt werden.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/teams/e4183b04-c9a2-417c-bde4-70e3ee46a6dc/members/remove
Content-Type: application/json

{
    "values": [
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "user@odata.bind": "https://graph.microsoft.com/beta/users('jacob@contoso.com')"
        },
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "user@odata.bind": "https://graph.microsoft.com/beta/users('alex@contoso.com')"
        }
    ]
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Beispiel 3: Massenentfernen von Mitgliedern aus einem Team mit fehlgeschlagenen Entfernungen

Das folgende Beispiel zeigt, wie Sie mehrere Mitglieder aus einem Team entfernen, wenn das Entfernen eines Mitglieds fehlschlägt.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/teams/e4183b04-c9a2-417c-bde4-70e3ee46a6dc/members/remove
Content-Type: application/json

{
    "values": [
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "user@odata.bind": "https://graph.microsoft.com/beta/users('c04f28bf-ab68-40a2-974b-e6af31fa78fb')"
        },
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "user@odata.bind": "https://graph.microsoft.com/beta/users('86503198-b81b-43fe-81ee-ad45b8848ac9')"
        }
    ]
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

HTTP/1.1 207 Multi-Status
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.aadUserConversationMemberResult)",
    "value": [
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "c04f28bf-ab68-40a2-974b-e6af31fa78fb",
            "error": {
                "code": "NotFound",
                "message": "Could not find resource"
            }
        },
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "86503198-b81b-43fe-81ee-ad45b8848ac9",
            "error": null
        }
    ]
}

Mitglied aus Team entfernen