Ressourcentyp plannerPlanContainer

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.

Stellt einen Container für einen plannerPlan dar. Der Container ist eine Ressource, die Autorisierungsregeln und die Lebensdauer des Plans angibt. Nur Personen, die berechtigt sind, mit der Ressource zu arbeiten, die den Plan enthält, dürfen mit dem Plan und seinen Aufgaben arbeiten. Wenn die enthaltende Ressource gelöscht wird, werden auch die enthaltenen Pläne gelöscht. Eigenschaften von plannerPlanContainer werden nur geändert, wenn ein Plan von einem Container in einen anderen verschoben wird, wobei plan move to container verwendet wird.

Planner unterstützt derzeit die in der folgenden Tabelle aufgeführten Containertypen. Wenn eine Anforderung zum Erstellen eines Plans empfangen wird, muss die containerUrl-Eigenschaft mit dem Pfad der in der Tabelle identifizierten Ressource angegeben werden.

Typ	Beschreibung	Pfad zur Ressource
Gruppe	Der Plan ist in einer Gruppe enthalten.	https://graph.microsoft.com/beta/groups/<id>
Liste	Der Plan ist in einem plannerRoster enthalten.	https://graph.microsoft.com/beta/planner/rosters/<id>
Projekt	Der Plan ist in einem Projekt von Microsoft Project für das Web enthalten.	Microsoft Project verfügt derzeit nicht über einen Ressourcenpfad in Microsoft Graph. Projektdetails und -elemente können über Microsoft Project verwaltet werden.
driveItem	Der Plan ist in einem driveItem enthalten.	https://graph.microsoft.com/beta/drives/<driveId>/items/<itemId>
Benutzer	Plan ist in einem Benutzer enthalten	https://graph.microsoft.com/beta/users/<id>

Eigenschaften

Eigenschaft	Typ	Beschreibung
containerId	Zeichenfolge	Der Bezeichner der Ressource, die den Plan enthält. Optional.
type	plannerContainerType	Der Typ der Ressource, die den Plan enthält. Informationen zu unterstützten Typen finden Sie in der vorherigen Tabelle. Mögliche Werte sind: group, unknownFutureValue, roster, project, driveItemund user. Sie müssen den Anforderungsheader Prefer: include-unknown-enum-members verwenden, um den folgenden Wert in dieser verteilbaren Enumeration abzurufen: roster, project, driveItemund user. Optional.
url	Zeichenfolge	Die vollständige kanonische URL des Containers. Optional.

Beziehungen

Keine.

JSON-Darstellung

Im folgenden Beispiel wird eine JSON-Darstellung eines Plancontainers angezeigt.

{
  "@odata.type": "#microsoft.graph.plannerPlanContainer",
  "url": "String",
  "containerId": "String",
  "type": "String"
}