Muokkaa

Jaa

plannerRoster resource type

  • Artikkeli

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a collection of users who are collaborating on a plannerPlan. A plannerRoster is a simple set of users, where everyone has the same level of permissions and they can be created by everyone, unless disabled by the tenant administrator. A plannerRoster can contain one plan.

Deleting a plannerRoster also deletes the plan and all tasks in the plan. A plannerRoster is also automatically deleted under the following conditions:

  • The plannerRoster doesn't contain a plan 24 hours after its creation. Membership information is erased within 30 days of this deletion.
  • The plannerRoster doesn't have any users remaining in the membership list because the last user removed themselves. Roster, its plan, and all contained tasks are deleted within 30 days of this operation.
  • The plannerRoster doesn't have any users remaining in the membership list because the last user was permanently deleted. Roster, its plan, and all contained tasks are deleted immediately. Deleted users are permanently erased within 30 days of their deletion; however, tenant administrators can also choose to permanently delete users without this delay.

Methods

Method Return type Description
Create plannerRoster Create a new plannerRoster object.
Get plannerRoster Read the properties and relationships of a plannerRoster object.
Delete None Delete a plannerRoster object.
List members of roster plannerRosterMember collection Get the plannerRosterMember resources from the members navigation property.
Add member to roster plannerRosterMember Create a new plannerRosterMember object.
List plans in roster plannerPlan collection Get the plannerPlan resources from the plans navigation property.
List user's plans in rosters plannerPlan collection Get the plannerPlans contained by the plannerRosters that the user is a member.
Assign sensitivity label plannerRoster] Assign a sensitivity label to a plannerRoster object.

Properties

Property Type Description
assignedSensitivityLabel sensitivityLabelAssignmentMethod The sensitivity label applied to the roster. If mandatory labeling is enabled for the user and no label is specified, the user can't create the roster. Also, if labels are mandatory for the user, the user can't change the label of the roster to null. Possible values are: standard, privileged, auto, unknownFutureValue.
id String Identifier of the plannerRoster. Read only. Inherited from entity

Relationships

Relationship Type Description
members plannerRosterMember collection Retrieves the members of the plannerRoster.
plans plannerPlan collection Retrieves the plans contained by the plannerRoster.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.plannerRoster",
  "assignedSensitivityLabel": "#microsoft.graph.sensitivityLabelAssignment",
  "id": "String (identifier)"
}