מיקרוסופט Graph מחזירה 429 Too Many Requests בסקריפטים של עיבוד המוני: מה לשנות
By Mirko Peters ·
הסקריפט של Graph מאט עד זחילה או נכשל עם 429 גם בקצב של בקשה אחת כל עשר שניות. למדו מדוע מאפיינים יקרים והמכסות המשותפות חשובים, וכיצד לסגת, לפצל קריאות ולקבץ בקשות (batch) בבטחה.
Automatically translated with AI from the original post. Read the English original
סקריפט קורא נתוני משתמשים מ-Microsoft Graph, משתמש אחד בכל פעם, בקצב איטי וזהיר. ובכל זאת הוא מקבל 429 Too Many Requests. שרשור Q&A של מיקרוסופט ממאי 2026 מתאר בדיוק מקרה כזה: קריאה למשתמש אחד, רשימה ארוכה של $select הכוללת את signInActivity, $expand=manager, ולקוח שמוגדר לבקשה אחת כל עשר שניות עם בקשה אחת פעילה בכל רגע.
עיקרי הדברים
- קצב בקשות קבוע אינו מגן עליכם. המגבלות תלויות בסוג הבקשה, ביישום ובדייר. Learn מגדיר את GET signInActivity על 10 בקשות לדקה.
- המתינו את מספר השניות שבכותרת Retry-After ורק אז נסו שוב. Learn מציין ש-Graph ממשיכה לרשום שימוש גם בזמן שאתם מוגבלים, ולכן ניסיונות חוזרים מיידיים רק מחמירים את המצב.
- הוצאת מאפיינים יקרים מקריאות פר-משתמש, מעבר על הנתונים עם $top גדול יותר, ושימוש ב-delta או בהתראות על שינויים, מפחיתים את מספר הבקשות.
- בקריאת $batch, כל בקשה נבדקת בנפרד. ה-batch עצמו מחזיר 200, בעוד שבקשות בודדות בתוכו נכשלות עם 429, ואינן מתנסות מחדש עבורכם.
שרשור שני, מפברואר 2026, שאל כיצד פועל ה-throttling כאשר דרייבים רבים של SharePoint ו-OneDrive נקראים במקביל. ביחד, שני השרשורים מראים מדוע הגבלת קצב פשוטה בצד הלקוח אינה מספיקה. מאמר זה מסביר מה ש-Microsoft Learn מתעד ומה ששרשורי השאלות והתשובות רק הציעו. זהו מדריך לפתרון בעיות, ואינו נוהל רשמי של מיקרוסופט.
מה שדיווחו השרשורים
שרשור מאי 2026 (נקודת הקצה users). השואל קיבל 429 על GET /v1.0/users/{id} עם מאפיינים רבים, כולל signInActivity, בנוסף ל-$expand=manager. עימוד וסינון לא עזרו, משום שכל קריאה החזירה משתמש אחד. מנחה מטעם מיקרוסופט ענה שהמאפיינים היקרים, ולא רק קצב הבקשות, הם שמניעים את ה-throttling. המנחה הציע לפצל את הקריאות (פרופיל, פעילות כניסה, מנהל), לכבד את Retry-After עם exponential backoff, לבצע caching ולקרוא את פעילות הכניסה לעתים רחוקות יותר. תשובה זו לא סומנה כמקובלת. תשובה שנוצרה על ידי AI, ואותה סימן השואל כמקובלת, אמרה דברים דומים מאוד. השואל לא ציין אם ה-429 פסקו.
שרשור פברואר 2026 (driveItems). השואל רצה לדעת אם ההגבלה חלה לפי אתר או לפי כונן, ואיזה מספר בקשות במקביל בטוח. תשובה אנונימית, שהשואל קיבל, אמרה שהמגבלות מוערמות בין הדייר, האפליקציה והשירות, שבקשות לאתרים שונים יכולות לשאוב מאותה מכסה, ושצריך לכבד את Retry-After, להשתמש ב-$batch ולהעדיף שאילתות דלתא והתראות שינוי על פני polling. לא ניתן שם מספר לבקשות במקביל. השואל כתב שזה עזר לו.
שלב 1: קוראים נכון את שגיאת 429
בכל כשל יש לתעד שלושה דברים: כתובת הבקשה, הערך של Retry-After והשעה. דף פתרון הבעיות של Graph PowerShell ב-Learn מציע להריץ cmdlet עם -Debug כדי לראות את שיטת ה-HTTP, ה-URI וקוד הסטטוס, ומציין שאם פותחים קריאת תמיכה יש לרשום את כותרות התגובה request-id ו-date.
בשרשור מאי 2026 לא צוין ערך של Retry-After. בלעדיו אי אפשר לדעת איזו מגבלה הסקריפט פגע בה.
שלב 2: כבדו את Retry-After
דף ההגבלות (throttling) ב-Learn ברור בנושא:
- המתינו את מספר השניות שבכותרת
Retry-After. - נסו שוב את הבקשה.
- אם הבקשה נכשלת שוב עם 429, המשיכו להשתמש באותו פער זמן עד שהבקשה מצליחה.
Learn מסביר למה: Microsoft Graph ממשיך לתעד את צריכת המשאבים בזמן שהלקוח מוגבל, ולכן נסיגה לפי הכותרת היא הדרך המהירה ביותר להתאושש. ניסיונות חוזרים מיידיים רק מגדילים את הצריכה. אם התגובה אינה כוללת כותרת Retry-After, Learn ממליץ על exponential backoff.
Learn קובע שה-SDKs של Microsoft Graph כבר מטפלים בכך. הוא אינו אומר את אותו הדבר לגבי cmdlets של Graph PowerShell, ולכן אין להניח זאת. אם הסקריפט שלכם עוטף קריאות גולמיות, כגון Invoke-MgGraphRequest, יש לבנות את ההמתנה בעצמכם.
שלב 3: מאתרים את הקריאות היקרות
בדף מגבלות ספציפיות לשירותים ב-Learn יש סעיף לדוחות זהות וגישה. הוא מונה את המספרים הבאים, שעשויים להשתנות:
- כל בקשה בקבוצה הזו: 122 בקשות לכל 10 שניות לכל אפליקציה על פני כל הדיירים, ו-5 בקשות לכל 10 שניות לכל אפליקציה לכל דייר.
GET signInActivity: 10 בקשות לדקה.
הסקריפט שלכם, שמבצע קריאה אחת לכל עשר שניות, מבצע 6 קריאות בדקה, וזה מתחת ל-10 על הנייר. השרשור אינו מציין אם עבודות אחרות מאותו רישום אפליקציה רצו במקביל. עבודות כאלה היו חולקות את התקציב, מכיוון שהמגבלות חלות לפי אפליקציה ולפי דייר. זו מסקנה מטבלת המגבלות של Learn, ולא משהו שנכתב בשרשור.
Learn מציין גם ש-$select=signInActivity בקריאת List users עלול לגרום להגבלה מחמירה יותר מקריאות רגילות. ההמלצה שלו:
- השתמשו ב-
$top=500, גודל העמוד המקסימלי כאשר בוחרים אתsignInActivity, במקום ברירת המחדל של 100. - השתמשו ב-
$filterעלcreatedDateTimeכדי לשאול טווחי זמן קטנים יותר. התחילו בכשלושה ימי נתונים וצמצמו את הטווח אם מופעלת הגבלה. - לפי דף List users ב-Learn, מאפיין
signInActivityדורש רישיון Microsoft Entra ID P1 או P2 וההרשאהAuditLog.Read.All.
אם אתם צריכים מידע על פעילות כניסה של משתמשים רבים, קריאת רשימה כגון GET /v1.0/users?$select=displayName,userPrincipalName,signInActivity&$top=500 מחזירה עד 500 משתמשים בבקשה אחת. משמעות הדבר היא הרבה פחות בקשות מאשר קריאה אחת לכל משתמש. דף List users ב-Learn מתעד בקשה זו עם signInActivity. אם היא גם קלה יותר בצד השירות לא נכתב, ולכן כדאי למדוד.
המנחה בשרשור מאי הציע לקרוא את signInActivity דרך נקודת הקצה ה-beta. מחבר ה-reference הנוכחי של v1.0 ב-Learn מתעד את signInActivity, ולכן כנראה אין צורך ב-beta לשם כך. בדקו את המאפיין בנקודת הקצה שבה אתם משתמשים.
שלב 4: מצמצמים את מספר הבקשות
שיטות העבודה המומלצות של Learn הולכות באותו כיוון:
- הפחיתו את מספר הפעולות בכל בקשה ואת תדירות הקריאות.
- הימנעו מ-polling מתמיד וסריקות קבועות של אוספים גדולים. השתמשו במעקב אחר שינויים (שאילתות דלתא) ובהתראות שינוי כשהן זמינות.
- שמרו במטמון נתונים שלא משתנים לעיתים קרובות, כגון יחסי מנהל-עובד. זו המלצה של המנחה בשרשור מאי, ולא הצהרה של Learn.
שלב 5: משתמשים ב-$batch בזהירות
Batching יכול לצמצם מעברי רשת הלוך ושוב. דף JSON batching ב-Learn קובע מגבלה של 20 בקשות בודדות בכל batch. הוא גם מציין:
- כל בקשה בתוך batch נבדקת מול מגבלות ה-throttling שלה באופן עצמאי. אם בקשה חורגת מהן, היא נכשלת עם 429, בעוד ה-batch עצמו מחזיר 200. ייתכן שכמה בקשות ב-batch אחד יקבלו throttling.
- בצעו ניסיון חוזר לכל בקשה שנכשלה, תוך שימוש בערך
retry-afterשמופיע בגוף התשובה עבור אותה בקשה. לפי Learn, אפשר לשלוח את כולן מחדש ב-batch חדש לאחר ההמתנה לערךretry-afterהארוך ביותר. - אם SDK מבצע ניסיון חוזר אוטומטי לבקשות שהוגבלו כשהן אינן מקובצות, בקשות שהוגבלו בתוך batch לא יבוצעו מחדש אוטומטית.
לכן batching אינו מסיר את המגבלה. הוא מעביר את לוגיקת ה-retry לתוך הקוד שלכם.
שלב 6: תכנון קריאות ל-SharePoint ו-OneDrive
בנוגע לסריקות של דיסקים, דף ה-throttling של SharePoint ב-Learn קובע ש-SharePoint Online מחזיר 429 או 503 עם כותרת Retry-After, וש-בקשות שהוגבלו נספרות במסגרת המגבלות. הדף מפרט throttling ברמת משתמש, דייר ואפליקציה, והמגבלות היחידות לכל אתר הן עבור קישורים אנונימיים ותעבורה אנונימית יוצאת. אין לתכנן סביב מכסה נפרדת לכל אתר. נקודות נוספות מאותו דף:
- תעבורה ללא app ID וללא מחרוזת User-Agent היא תעבורה לא מזוהה. לפי Learn, תעבורה מזוהה היטב מקבלת עדיפות על פני תעבורה לא מזוהה. פורמטי ה-User-Agent המתועדים הם
ISV|CompanyName|AppName/Versionו-NONISV|CompanyName|AppName/Version. - שאילתה לפריט יחיד עולה יחידת משאב אחת, שאילתה לריבוי פריטים או כתיבה עולה שתיים, ופעולות הרשאות, כולל
$expand=permissions, עולות חמש. מומלץ להימנע מהרחבת הרשאות בסריקות המוניות. - לפי Learn, מומלץ להשתמש ב-Microsoft Graph במקום ב-CSOM וב-REST כשאפשר, מכיוון שהוא בדרך כלל צורך פחות משאבים.
שרשור פברואר עסק גם ב-410 Gone בשאילתות delta. התשובה שם קבעה שהמשמעות היא שאסימון ה-delta אינו שמיש עוד, וש-הלקוח צריך להתחיל מחדש עם שאילתת delta ראשונית חדשה. יש לתכנן לכך בכל סנכרון incremental.
אימות
- רשמו את מספר תשובות ה-429 ואת ערכי
Retry-Afterלריצה אחת לפני השינויים ואחריהם. - הריצו את הסקריפט לבד, ללא עבודה אחרת שמשתמשת באותה רישום אפליקציה, כדי לראות את ההשפעה של הקריאות שלכם בלבד.
- אם ה-throttling נמשך למרות backoff נכון וצמצום קריאות, אספו את הכותרות
request-idו-dateופתחו קריאת תמיכה.
מגבלות
- לשרשור מאי 2026 אין תוצאה מאושרת, והתשובה המקובלת בו נוצרה על ידי AI. ההנחיות של Learn שלמעלה הן הראיה שבה נעשה שימוש כאן.
- השאלה של השואל על משתמשים ללא בלוק
signInActivityלא נענתה בשרשור. Learn גם אינו מתאר זאת, ולכן יש להתייחס לבלוק חסר כלא ידוע. Learn כן מציין ש-lastSuccessfulSignInDateTimeאינו מושלם לאחור לפני 1 בדצמבר 2023, ולכן ערך ריק אינו מוכיח שהמשתמש מעולם לא התחבר. - המגבלות שמפרט Learn מסומנות כניתנות לשינוי. בדקו את הדף העדכני לפני שאתם בונים סביב מספר כלשהו.
קשור
מקורות
- Microsoft Learn: Microsoft Graph throttling guidance
- Microsoft Learn: Microsoft Graph service-specific throttling limits
- Microsoft Learn: שילוב של בקשות מרובות באמצעות JSON batching
- Microsoft Learn: List users
- Microsoft Learn: signInActivity resource type
- Microsoft Learn: הימנעות מהגבלת קצב (throttling) או חסימה ב-SharePoint Online
- Microsoft Learn: פתרון שגיאות נפוצות ב-Microsoft Graph PowerShell
- Microsoft Q&A: בעיית Throttling בנקודת הקצה users (מאי 2026)
- Microsoft Q&A: התנהגות Throttling של Microsoft Graph בעיבוד driveItems במקביל (פברואר 2026)