plannerPlanContainer resource type

Namespace: microsoft.graph

Represents a container for a plannerPlan. The container is a resource that specifies authorization rules and the lifetime of the plan. This means that only the people who are authorized to work with the resource containing the plan will be able to work with the plan and the tasks within it. When the containing resource is deleted, the contained plans are also deleted. The properties of the plannerPlanContainer cannot be changed after the plan is created.

Microsoft Planner currently supports the container types listed in the following table. When you create a plan, you must specify the containerUrl property with the path of the resource identified in the following table.

Type	Description	Path to the resource
group	Plan is contained by a group.	https://graph.microsoft.com/v1.0/groups/{id}
roster	Plan is contained by a plannerRoster	https://graph.microsoft.com/beta/planner/rosters/{id}. Rosters as containers for plans (plannerRoster resources) are currently accessible only through the beta endpoint.

Properties

Property	Type	Description
containerId	String	The identifier of the resource that contains the plan. Optional.
type	plannerContainerType	The type of the resource that contains the plan. For supported types, see the previous table. Possible values are: group, unknownFutureValue, roster. Note that you must use the Prefer: include-unknown-enum-members request header to get the following value in this evolvable enum: roster. Optional.
url	String	The full canonical URL of the container. Optional.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

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