M365Con 2027 – konferensi online gratis · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Microsoft Graph Mengembalikan 429 Too Many Requests pada Skrip Massal: Apa yang Perlu Diubah

By ·

Skrip Graph Anda melambat hingga hampir terhenti atau gagal dengan 429 meskipun hanya satu permintaan setiap sepuluh detik. Pelajari mengapa properti yang mahal dan kuota bersama itu penting, serta cara melakukan backoff, memecah panggilan, dan melakukan batching dengan aman.

Automatically translated with AI from the original post. Read the English original

Sebuah skrip membaca data pengguna dari Microsoft Graph, satu pengguna per waktu, dengan laju yang lambat dan hati-hati. Skrip tetap menerima 429 Too Many Requests. Sebuah utas Microsoft Q&A pada Mei 2026 menggambarkan kasus yang persis sama: satu panggilan untuk satu pengguna, daftar $select yang panjang dengan signInActivity, sebuah $expand=manager, dan klien yang diatur untuk satu permintaan setiap sepuluh detik dengan satu permintaan yang sedang berjalan.

Poin Penting

  • Laju permintaan yang tetap tidak melindungi Anda. Batasan bergantung pada jenis permintaan, aplikasi, dan penyewa. Learn mencantumkan GET signInActivity sebesar 10 permintaan per menit.
  • Tunggu sejumlah detik yang tertera pada header Retry-After, lalu coba lagi. Learn menyatakan bahwa Graph terus mencatat penggunaan saat Anda terkena throttling, sehingga percobaan ulang secara langsung justru memperburuk keadaan.
  • Memisahkan properti yang mahal dari panggilan per pengguna, melakukan paging dengan $top yang lebih besar, serta menggunakan delta atau notifikasi perubahan dapat mengurangi jumlah permintaan.
  • Dalam panggilan $batch, setiap permintaan dinilai secara terpisah. Batch mengembalikan 200 sementara permintaan tunggal di dalamnya gagal dengan 429, dan permintaan tersebut tidak dicoba ulang secara otomatis.

Utas kedua, dari Februari 2026, menanyakan bagaimana throttling bekerja ketika banyak drive SharePoint dan OneDrive dibaca secara paralel. Jika digabungkan, kedua utas tersebut menunjukkan mengapa batas laju sederhana di sisi klien tidak cukup. Artikel ini menjelaskan apa yang didokumentasikan Microsoft Learn dan apa yang hanya disarankan oleh utas-utas tersebut. Ini adalah panduan pemecahan masalah, bukan prosedur resmi Microsoft.

Yang dilaporkan oleh utas-utas tersebut

Utas Mei 2026 (endpoint users). Penanya menerima 429 pada GET /v1.0/users/{id} dengan banyak properti, termasuk signInActivity, ditambah $expand=manager. Paging dan filter tidak membantu, karena setiap panggilan hanya mengembalikan satu pengguna. Seorang moderator Microsoft menjawab bahwa properti yang mahal, bukan hanya laju permintaan, yang memicu throttling. Moderator menyarankan memecah panggilan (profil, aktivitas masuk, manajer), menghormati Retry-After dengan exponential backoff, melakukan caching, dan membaca aktivitas masuk lebih jarang. Jawaban itu tidak ditandai sebagai diterima. Sebuah jawaban yang dihasilkan AI, yang ditandai diterima oleh penanya, mengatakan hal yang kurang lebih sama. Penanya tidak menyebutkan apakah 429 tersebut berhenti.

Thread Februari 2026 (driveItems). Penanya ingin tahu apakah throttling berlaku per situs atau per drive, dan berapa konkurensi yang aman. Sebuah jawaban anonim, yang diterima penanya, menyatakan bahwa batas diterapkan secara berlapis di tingkat penyewa, aplikasi, dan layanan, bahwa permintaan ke situs yang berbeda dapat menggunakan kuota yang sama, serta bahwa Anda sebaiknya menghormati Retry-After, menggunakan $batch, dan lebih memilih delta query serta change notification daripada polling. Jawaban itu tidak menyebutkan angka konkurensi. Penanya mengatakan jawaban tersebut membantu.

Langkah 1: Baca 429 dengan benar

Catat tiga hal pada setiap kegagalan: URL permintaan, nilai Retry-After, dan waktunya. Halaman troubleshooting Graph PowerShell di Learn menyarankan untuk menjalankan cmdlet dengan -Debug guna melihat metode HTTP, URI, dan kode status, serta menyebutkan agar Anda mencatat header respons request-id dan date jika membuka tiket dukungan.

Thread Mei 2026 tidak mengutip nilai Retry-App. Tanpa nilai tersebut, tidak ada yang bisa memastikan batas mana yang dilampaui skrip itu.

Langkah 2: Hormati Retry-After

Halaman throttling di Learn sangat jelas mengenai hal ini:

  1. Tunggu sejumlah detik yang ditentukan dalam header Retry-After.
  2. Coba kirim ulang permintaan.
  3. Jika permintaan gagal lagi dengan 429, pertahankan jeda yang sama sampai permintaan berhasil.

Learn menjelaskan alasannya: Microsoft Graph terus mencatat penggunaan sumber daya selama klien mengalami throttling, sehingga menunggu sesuai header adalah cara tercepat untuk pulih. Percobaan ulang segera hanya menambah penggunaan Anda. Jika respons tidak memiliki header Retry-After, Learn merekomendasikan exponential backoff.

Learn menyatakan bahwa Microsoft Graph SDK sudah menangani hal ini. Learn tidak menyatakan hal yang sama untuk cmdlet Graph PowerShell, jadi jangan berasumsi demikian. Jika skrip Anda membungkus panggilan mentah, misalnya Invoke-MgGraphRequest, buat sendiri logika jeda tersebut.

Langkah 3: Temukan panggilan yang mahal

Halaman batas khusus layanan di Learn memiliki bagian untuk laporan identitas dan akses. Halaman itu mencantumkan angka-angka berikut, yang dapat berubah:

  • Setiap permintaan dalam grup tersebut: 122 permintaan per 10 detik per aplikasi di semua penyewa, dan 5 permintaan per 10 detik per aplikasi per penyewa.
  • GET signInActivity: 10 permintaan per menit.

Skrip Anda yang berjalan setiap sepuluh detik membuat 6 panggilan per menit, yang secara teori masih di bawah 10. Thread tersebut tidak menyebutkan apakah pekerjaan lain dari registrasi aplikasi yang sama berjalan bersamaan. Pekerjaan tersebut akan berbagi kuota, karena batas berlaku per aplikasi dan per penyewa. Ini merupakan kesimpulan dari tabel batas di Learn, bukan sesuatu yang dinyatakan dalam thread.

Learn juga menyatakan bahwa $select=signInActivity pada List users dapat menyebabkan throttling yang lebih ketat dibandingkan panggilan standar. Sarannya:

  • Gunakan $top=500, ukuran halaman maksimum saat Anda memilih signInActivity, alih-alih 100 bawaan.
  • Gunakan $filter pada createdDateTime untuk mengkueri rentang waktu yang lebih kecil. Mulailah dengan sekitar tiga hari data dan persempit rentangnya jika mengalami throttling.
  • Properti signInActivity memerlukan lisensi Microsoft Entra ID P1 atau P2 serta izin AuditLog.Read.All, sesuai halaman List users di Learn.

Jika Anda memerlukan data aktivitas masuk untuk banyak pengguna, panggilan daftar seperti GET /v1.0/users?$select=displayName,userPrincipalName,signInActivity&$top=500 mengembalikan hingga 500 pengguna per permintaan. Artinya, jumlah permintaan jauh lebih sedikit dibandingkan satu panggilan per pengguna. Halaman List users di Learn mendokumentasikan permintaan ini dengan signInActivity. Apakah permintaan ini juga lebih ringan di sisi layanan tidak dinyatakan, jadi ukurlah sendiri.

Moderator di thread Mei menyarankan membaca signInActivity melalui endpoint beta. Referensi v1.0 Learn yang berlaku saat ini mendokumentasikan signInActivity, sehingga Anda seharusnya tidak memerlukan beta untuk itu. Periksa properti tersebut pada endpoint yang Anda gunakan.

Langkah 4: Kurangi jumlah permintaan

Praktik terbaik Learn mengarah ke hal yang sama:

  • Kurangi jumlah operasi per permintaan dan frekuensi panggilan.
  • Hindari polling terus-menerus dan pemindaian rutin pada koleksi besar. Gunakan pelacakan perubahan (delta query) dan change notification jika tersedia.
  • Simpan data yang jarang berubah dalam cache, seperti relasi manajer. Ini merupakan saran dari moderator di thread Mei, bukan pernyataan dari Learn.

Langkah 5: Gunakan $batch dengan hati-hati

Batching dapat mengurangi round trip jaringan. Halaman JSON batching di Learn menetapkan batas 20 permintaan individual per batch. Halaman tersebut juga menyatakan:

  • Setiap permintaan dalam batch dievaluasi terhadap batas throttling secara terpisah. Jika satu permintaan melampaui batas tersebut, permintaan itu gagal dengan 429, sementara batch itu sendiri tetap mengembalikan 200. Beberapa permintaan dapat di-throttle dalam satu batch.
  • Coba ulang setiap permintaan yang gagal dengan menggunakan nilai retry-after dalam isi respons untuk permintaan tersebut. Learn menyebutkan Anda dapat mencoba ulang semuanya dalam batch baru setelah nilai retry-after terpanjang.
  • Jika SDK mencoba ulang permintaan yang di-throttle saat permintaan tidak dikirim dalam batch, permintaan yang di-throttle di dalam batch tidak dicoba ulang secara otomatis.

Jadi, batching tidak menghilangkan batas tersebut. Batching justru memindahkan logika percobaan ulang ke dalam kode Anda.

Langkah 6: Rencanakan pembacaan SharePoint dan OneDrive

Untuk pemindaian drive, halaman throttling SharePoint dari Learn menyatakan bahwa SharePoint Online mengembalikan 429 atau 503 dengan header Retry-After, dan bahwa permintaan yang di-throttle tetap dihitung terhadap batas. Halaman itu mencantumkan throttling pada cakupan pengguna, penyewa, dan aplikasi, serta satu-satunya batas per situs hanya berlaku untuk tautan anonim dan egress anonim. Jangan merencanakan kuota terpisah untuk setiap situs. Poin lain dari halaman tersebut:

  • Lalu lintas tanpa app ID dan tanpa string User-Agent disebut undecorated. Learn menyatakan bahwa lalu lintas yang well-decorated diprioritaskan dibandingkan lalu lintas undecorated. Format User-Agent yang didokumentasikan adalah ISV|CompanyName|AppName/Version dan NONISV|CompanyName|AppName/Version.
  • Kueri satu item menghabiskan 1 resource unit, kueri atau penulisan banyak item menghabiskan 2, dan operasi izin, termasuk $expand=permissions, menghabiskan 5. Hindari perluasan izin dalam pemindaian massal.
  • Learn merekomendasikan Microsoft Graph dibanding CSOM dan REST jika memungkinkan, karena biasanya menggunakan lebih sedikit resource.

Utas Februari juga menyinggung 410 Gone untuk kueri delta. Jawabannya menyebutkan bahwa ini berarti delta token tidak lagi dapat digunakan, dan klien sebaiknya memulai ulang dengan kueri delta awal yang baru. Rencanakan hal tersebut pada setiap sinkronisasi inkremental.

Verifikasi

  1. Catat jumlah respons 429 dan nilai Retry-After untuk satu kali jalan, baik sebelum maupun sesudah perubahan Anda.
  2. Jalankan skrip sendiri, tanpa pekerjaan lain yang menggunakan app registration yang sama, untuk melihat dampak dari panggilan Anda sendiri.
  3. Jika throttling tetap terjadi meskipun backoff sudah benar dan jumlah panggilan sudah dikurangi, kumpulkan header request-id dan date, lalu buka kasus dukungan.

Batas

  • Utas Mei 2026 tidak memiliki hasil yang terkonfirmasi, dan jawaban yang diterima di utas tersebut dibuat oleh AI. Panduan Learn di atas menjadi bukti yang digunakan di sini.
  • Pertanyaan penanya tentang pengguna tanpa blok signInActivity tidak pernah dijawab dalam utas tersebut. Learn juga tidak menjelaskannya, sehingga blok yang tidak ada perlu diperlakukan sebagai tidak diketahui. Learn memang menyebutkan bahwa lastSuccessfulSignInDateTime tidak diisi ulang sebelum 1 Desember 2023, sehingga nilai kosong tidak membuktikan bahwa pengguna tidak pernah masuk.
  • Batas yang tercantum di Learn ditandai sebagai dapat berubah. Periksa halaman langsung sebelum Anda membangun sesuatu berdasarkan angka tertentu.

Terkait

Sumber

Entities in this article

Microsoft Graph Microsoft Graph PowerShell Throttling

Related articles

RSS