Team aus Gruppe erstellen

Namespace: microsoft.graph

Erstellen eines neuen Teams unter einer Gruppe.

Damit ein Team daraus erstellt werden kann, muss die Gruppe mindestens einen Besitzer haben.

Wenn die Erstellung des Teamanrufs verzögert wird, können Sie den Anruf bis zu dreimal wiederholen, bevor Sie aufgrund einer Weitergabeverzögerung 15 Minuten warten müssen. Wenn die Gruppe vor weniger als 15 Minuten erstellt wurde, schlägt der Aufruf möglicherweise aufgrund von Replikationsverzögerungen mit einem 404 Fehlercode fehl.

Wenn die Gruppe vor weniger als 15 Minuten erstellt wurde, ist es möglich, dass ein Aufruf zum Erstellen eines Teams aufgrund laufender Replikationsverzögerungen mit dem Fehlercode 404 fehlschlägt. Das empfohlene Muster besteht darin, den Aufruf zum Erstellen des Teams drei Mal mit einer Verzögerung von 10 Sekunden zwischen Aufrufen zu wiederholen.

Hinweis: Die SharePoint-Bereitstellung erfolgt nicht in Echtzeit, es handelt sich um einen Hintergrundprozess. Der Abschluss der Bereitstellung kann nicht bestimmt werden.

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) Group.ReadWrite.All Directory.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung Group.ReadWrite.All Directory.ReadWrite.All

Hinweis: Diese API unterstützt Administratorberechtigungen. Globale Administratoren und Microsoft Teams-Dienstadministratoren können auf Gruppen zugreifen, in denen sie kein Mitglied sind.

HTTP-Anforderung

PUT /groups/{id}/team

Anforderungsheader

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

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung eines team-Objekts an.

Antwort

Bei erfolgreicher Ausführung sollte die Methode den Antwortcode 201 Created und ein team-Objekt im Antworttext zurückgeben.

Beispiel

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PUT https://graph.microsoft.com/v1.0/groups/{id}/team
Content-type: application/json

{
  "memberSettings": {
    "allowCreatePrivateChannels": true,
    "allowCreateUpdateChannels": true
  },
  "messagingSettings": {
    "allowUserEditMessages": true,
    "allowUserDeleteMessages": true
  },
  "funSettings": {
    "allowGiphy": true,
    "giphyContentRating": "strict"
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

HTTP/1.1 201 Created
Content-type: application/json

{
  "memberSettings": {
    "allowCreateUpdateChannels": true,
    "allowDeleteChannels": true,
    "allowAddRemoveApps": true,
    "allowCreateUpdateRemoveTabs": true,
    "allowCreateUpdateRemoveConnectors": true
  },
  "guestSettings": {
    "allowCreateUpdateChannels": true,
    "allowDeleteChannels": true
  },
  "messagingSettings": {
    "allowUserEditMessages": true,
    "allowUserDeleteMessages": true,
    "allowOwnerDeleteMessages": true,
    "allowTeamMentions": true,
    "allowChannelMentions": true
  },
  "funSettings": {
    "allowGiphy": true,
    "giphyContentRating": "strict",
    "allowStickersAndMemes": true,
    "allowCustomMemes": true
  }
}