Skip to content

Commit 06da129

Browse files
JoanneHendricksonVesaJuvonen
authored andcommitted
Update export-amr-api.md (SharePoint#4991)
* Update export-amr-api.md Updates to amr-api including removal of limitations, and guidance for performance * update export-amr-api Per PM remove recommendation for performance recommendation of over 1million items * Update export-amr-api.md table fix * Update export-amr-api.md Content update Remove table of limitations, obsolete. * Update export-amr-api.md Content update: Added row to performance table, additional info regarding capacity.
1 parent eb55763 commit 06da129

File tree

1 file changed

+13
-20
lines changed

1 file changed

+13
-20
lines changed

docs/apis/export-amr-api.md

Lines changed: 13 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -6,12 +6,10 @@ author: JoanneHendrickson
66
manager: pamgreen
77
audience: ITPro
88
ms.topic: article
9-
ms.prod: sharepoint-server-itpro
109
localization_priority: Priority
11-
ROBOTS: NOINDEX, NOFOLLOW
1210
ms.collection:
13-
- Strat_SP_gtc
1411
- SPMigration
12+
- m365-collaboration
1513
description: "SharePoint Migration Export (Asynchronous Metadata Read) API"
1614
---
1715

@@ -248,27 +246,22 @@ Suggestion:
248246
## Limitations
249247
<a name="limitations"> </a>
250248

251-
By default, each URL supports up to 1 million limits. At the start of the migration, the asynchronous read migration function will check. If more than 1 million is detected an error will be thrown. Multiple versions of a single file will count as one. This limit may be changed in the future.
252-
253-
**SharePoint Migration Export (Asynchronous Metadata Read) API Limitations**</br>
254-
255-
256-
|**Type**|**SharePoint Online Limit**|**Recommended limit</br>for async read**|**Description**|
257-
|:-----|:-----|:-----|:-----|
258-
|Lists|30 million items|1 million|Per list URL, the migration read will process up to 1 million rea|
259-
|Document Library|30 million files/folders|1 million|Per list URL, the migration job will process up to 1 million reads|
260-
|Users|2 million per site collection|1 million|Per site collection. This is only supported in a future permission setting.|
249+
Asynchronous Metadata Read (Export API) now supports unlimited list, document library, file, and folder metadata export.
261250

262251

263252
## Performance Expectation
264-
The preliminary performance test provides a rough estimate of more than 200 items per second throughput. This does not account for any potential throttle over the network. If the read asynchronous function fails to reach the server due to throttling, then performance will be impacted.
265253

266-
This measure of throughput assumes the software package has a sufficient items per read. The recommendation is to read greater than 10K per package. This is because at the start of read asynchronous migration, the server calculates the number of objects to confirm that it is within the 1 million object limit, hence there is an overhead. If only a few thousand are being read, it results in a less than ideal performance.
254+
The preliminary performance test provides a rough estimate of more than 400 items per second throughput for every 250K of objects read. We have seen over 700 items per second throughput in a testing environment. However, this is highly dependent on the number of items that are being read plus the implementation of the AMR API. This does not account for any potential throttle over the network. If the asynchronous read function fails to reach the server due to throttling, then performance will be impacted.
267255

268-
For single read query or small items read (e.g. 1000 items), it is faster to use Graph API or RESTful/CSOM query as the asynchronous read metadata will have the overhead cost.
269-
270-
However, one of the key performance benefits of the asynchronous metadata read is the ability to balance the server-side load and the backend query is much more efficient than individual CSOM load reducing your chance of throttling.
271-
272-
256+
This measure of throughput assumes the software package has a sufficient number of items per read. Microsoft recommends the following:
273257

258+
|**Folder size**|**Recommendation**|
259+
|:-----|:-----|
260+
|Less than 10,000 items|Combine the URLs of multiple folders into a single call|
261+
|Greater than 10,000 items but less than 1,000,000|Run AMR at the root folder level|
262+
|Greater than 1,000,000|Method is at the discretion of the ISV|
274263

264+
For a single read query, it is faster to use the Graph API or a RESTful/CSOM query.
265+
266+
One of the key performance benefits of using the asynchronous metadata read is the ability to balance the server-side load and the backend query. It is much more efficient than using individual CSOM load reducing to lessen your chance of throttling.
267+

0 commit comments

Comments
 (0)