groupLifecyclePolicy: addGroup

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 .

Fügt einer Lifecycle-Richtlinie bestimmte Gruppen hinzu. Mit dieser Aktion wird die Gruppenlebenszyklusrichtlinie nur dann auf eine Gruppe von Gruppen beschränkt, wenn die managedGroupTypes-Eigenschaft von groupLifecyclePolicy auf Selectedfestgelegt ist.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

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

HTTP-Anforderung

POST /groupLifecyclePolicies/{id}/addGroup

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich.
Content-Type	application/json

Anforderungstext

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.

Parameter	Typ	Beschreibung
groupId	Zeichenfolge	Der Bezeichner der Gruppe, die der Richtlinie hinzugefügt werden soll.

Wenn die managedGroupTypes-Eigenschaft von groupLifecyclePolicy festgelegt Selectedist, können Sie der Liste bis zu 500 Gruppen hinzufügen. Wenn Sie mehr als 500 Gruppen hinzufügen müssen, muss die managedGroupTypes-Eigenschaft von groupLifecyclePolicy auf Allfestgelegt werden.

Pro Anforderung kann nur eine Gruppe hinzugefügt werden.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 200 OK zurückgegeben. Wenn die Gruppe der Richtlinie hinzugefügt wird, wird ein true Wert im Antworttext zurückgegeben. Andernfalls wird ein false Wert im Antworttext zurückgegeben.

Beispiel

Anforderung

POST https://graph.microsoft.com/beta/groupLifecyclePolicies/{id}/addGroup
Content-type: application/json

{
  "groupId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
}

Antwort

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": true
}