Edit

Share via


sharePointGroupIdentityMapping resource type

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 cross-organization identity mapping for a group during a tenant-to-tenant (cross-tenant) migration. This resource defines the relationship between a source group in the originating organization and its corresponding target group in the destination organization. It includes source and target group identities, migration metadata, and group type information.

Inherits from sharePointIdentityMapping.

Methods

Method Return type Description
Get sharePointGroupIdentityMapping Retrieve a specific cross-organization group identity mapping based on the Microsoft Entra ID object ID of the source group.
Update sharePointGroupIdentityMapping Perform delta patch operations on group identity mappings for cross-organization migration.

Properties

Property Type Description
groupType sharePointIdentityMappingGroupType Indicates the type of group. The possible values are: none, regularGroup, m365Group, unknownFutureValue.
id String Unique identifier for the group identity mapping. Base64-encoded String. Generated automatically. Inherited from sharePointIdentityMapping.
sourceGroupIdentity identity The identity information of the source group in the originating organization. Contains the ID of the source group.
sourceOrganizationId Guid The unique identifier of the source organization in the migration. Inherited from sharePointIdentityMapping.
targetGroupIdentity identity The identity information of the target group in the destination organization. Contains the ID of the target group.
targetGroupMigrationData sharePointIdentityMappingGroupMigrationData Additional migration-specific data for the target group.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.sharePointGroupIdentityMapping",
  "groupType": "String",
  "id": "String (identifier)",
  "sourceGroupIdentity": {"@odata.type": "microsoft.graph.identity"},
  "sourceOrganizationId": "Guid",
  "targetGroupIdentity": {"@odata.type": "microsoft.graph.identity"},
  "targetGroupMigrationData": {"@odata.type": "microsoft.graph.sharePointIdentityMappingGroupMigrationData"}
}