Skip to content

Commit b4d0d80

Browse files
Merge pull request SharePoint#5878 from andrewconnell/buildfix-brokenlinks
Fixup build error reports
2 parents 41e7ae6 + caeb301 commit b4d0d80

File tree

5 files changed

+20
-19
lines changed

5 files changed

+20
-19
lines changed

docs/apis/migration-perm-guidance.md

Lines changed: 20 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Migration permission guidance
3-
ms.date: 06/02/2020
3+
ms.date: 06/14/2020
44
ms.author: jhendr
55
author: JoanneHendrickson
66
manager: pamgreen
@@ -10,7 +10,7 @@ f1.keywords:
1010
ms.topic: conceptual
1111
ms.service: sharepoint-online
1212
localization_priority: Priority
13-
ms.collection:
13+
ms.collection:
1414
- SPMigration
1515
- M365-collaboration
1616
search.appverid: MET150
@@ -27,22 +27,22 @@ Inherited permissions are set as the default at the root site collection level a
2727
Each time you break inheritance by granting access to a new user account or group at any level in a site, even on a single item, you are creating a new unique security “scope” ID. That scope is counted as a unique permission towards the total limit. A library (or list) cannot have greater than 50,000 unique security scopes.
2828

2929
![Site hierarchy](../images/hierarchy-perms.png)
30-
31-
When the number of unique security scopes exceeds the value of the list view threshold, added SQL server round trips take place that can affect performance.
32-
When migrating, we recommend that you have less than 5,000 unique scopes per library.
30+
31+
When the number of unique security scopes exceeds the value of the list view threshold, added SQL server round trips take place that can affect performance.
32+
When migrating, we recommend that you have less than 5,000 unique scopes per library.
3333

3434
## Role assignments
35-
35+
3636
A role assignment is a mapping between a user, a SharePoint object (Web, list, file) and a role (Design, Full Control, Contribute, etc.). The role assignment ties together the role definition (permission level) with the specific user or group, and the scope that that permission level will be applied to (such as list, folder, item).
3737

3838
There is a role assignment limit of 5,000 per security scope.
3939

40-
## Item limits
40+
## Item limits
4141

42-
When a library (or list) contains more than 100,000 items (files and folders or list items), you cannot break permissions inheritance on the list itself. There is a limit of 100,000 items that can be updated or removed as a part of creating a new SharePoint security scope.
42+
When a library (or list) contains more than 100,000 items (files and folders or list items), you cannot break permissions inheritance on the list itself. There is a limit of 100,000 items that can be updated or removed as a part of creating a new SharePoint security scope.
4343

4444
If you are migrating a structure that has more than 100,000 children (such as files, folders, lists, or other object types), you need to restructure the migration by importing security in multiple phases to avoid exceeding this limit. Any VROOM invite, REST share link, or any other permission-modifying function call will trigger an HTTP 429 throttle if the threshold is reached. Permissions will not be updated. Unlike other throttles, waiting and trying again will not resolve the situation as you have reached a hard limit of 100,000.
45-
To learn more about the service limits in SharePoint for Microsoft 365, see [SharePoint Limits](https://docs.microsoft.com/en-us/office365/servicedescriptions/sharepoint-online-service-description/sharepoint-online-limits#items-in-lists-and-libraries).
45+
To learn more about the service limits in SharePoint for Microsoft 365, see [SharePoint Limits](https://docs.microsoft.com/office365/servicedescriptions/sharepoint-online-service-description/sharepoint-online-limits#items-in-lists-and-libraries).
4646

4747
## Folders containing fewer than 100,000 items
4848

@@ -53,32 +53,33 @@ If your library (or list) has fewer than 100,000 items, and you have less than 5
5353
If you have a folder with more than 100,000 items, we recommend one of the following approaches. Determine how many items are in your source or root folder, including lists or other object types. Scan and determine which folder structures have greater than 100,000 items.
5454

5555
### Method 1: Restructure the source layout
56+
5657
The first option is to restructure your *source* layout.
5758

5859
For example, divide a single folder of 250,000 items into four folders at the root so each folder has less than 100,000 items. There is still “room to grow”, presuming users will continue to add content and make changes here.
5960

60-
Make sure that there are no more than 50,000 unique scopes in the structure: ideally less than 5,000.
61+
Make sure that there are no more than 50,000 unique scopes in the structure: ideally less than 5,000.
6162

6263
In this example, at the source, break up the structure into four folders, A, B, C, and D, each having less than 100,000 items. Then perform the migration. See the illustration below.
6364

64-
![Hierarchy ABCD](../images/hierarchy-abcd.png)
65-
65+
![Hierarchy ABCD](../images/hierarchy-ABCD.png)
66+
6667
>[!NOTE]
67-
>There are other limits that must be considered during migration. See [SharePoint Limits](https://docs.microsoft.com/en-us/office365/servicedescriptions/sharepoint-online-service-description/sharepoint-online-limits#items-in-lists-and-libraries) for details.
68+
>There are other limits that must be considered during migration. See [SharePoint Limits](https://docs.microsoft.com/office365/servicedescriptions/sharepoint-online-service-description/sharepoint-online-limits#items-in-lists-and-libraries) for details.
6869
6970
### Method 2: Create your destination layout to avoid exceeding limits
71+
7072
The alternate approach is to keep your source layout, applying unique scopes at the destination before migration.
7173

72-
**Example:** Your source folder has 250,000 items within it. At your target ___location, create folders A, B, C, and D and apply the unique scopes and scope ID. This will break inheritance. Then proceed with your content migration.
73-
If you do not want your end users to share items until migration is completed, use the Migration API to migrate the content & scopes, but set the scope to NULL to prevent any use.
74+
**Example:** Your source folder has 250,000 items within it. At your target ___location, create folders A, B, C, and D and apply the unique scopes and scope ID. This will break inheritance. Then proceed with your content migration.
75+
If you do not want your end users to share items until migration is completed, use the Migration API to migrate the content & scopes, but set the scope to NULL to prevent any use.
7476
After all the content and incremental migrations are completed, apply the proper scope.
7577

76-
After the incremental migration has completed, and only if you previously set the scope to NULL, you can reapply the unique scope for folders A, B, C, D separately. When you reapply the scope, evaluate your folder size starting at the lowest level of hierarchy.
78+
After the incremental migration has completed, and only if you previously set the scope to NULL, you can reapply the unique scope for folders A, B, C, D separately. When you reapply the scope, evaluate your folder size starting at the lowest level of hierarchy.
7779

7880
## Other Sharing/Permission related considerations
79-
81+
8082
The REST share link or any other permission-modifying function will not take effect if you attempt to update the permission on a file that is checked out by a user.
8183
Finally, if a SharePoint site or OneDrive ___location is being actively used during migration, the existing permissions applied on that site, user or document will be enforced.
82-
83-
**Example:** If you attempt to modify the permission on a site that only allows access to existing users already defined on the site, and the user you are trying to add to a file or folder does not already have permissions on the site itself, the permission call (e.g. VROOM Invite) will not be able to make the modification.
8484

85+
**Example:** If you attempt to modify the permission on a site that only allows access to existing users already defined on the site, and the user you are trying to add to a file or folder does not already have permissions on the site itself, the permission call (e.g. VROOM Invite) will not be able to make the modification.
File renamed without changes.
File renamed without changes.

hierarchy-ABCD.png

-10.1 KB
Binary file not shown.

hierarchy-perms.png

-9.2 KB
Binary file not shown.

0 commit comments

Comments
 (0)