C# Academy · Pelajaran

Mengonfigurasi Middleware Pembatasan Laju

Terapkan batas laju per endpoint dan kebijakan.

Mengonfigurasi Middleware Pembatasan Laju adalah pelajaran C# Academy gratis di CoddyKit. Ini adalah pelajaran 2 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar C# Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus C# Academy mencakup 4 pelajaran total.

AddRateLimiter

Konfigurasi dimulai dengan AddRateLimiter dalam kontainer layanan. Anda menentukan satu atau beberapa kebijakan bernama serta kode status penolakan global opsional.

builder.Services.AddRateLimiter(options =>
{
    options.RejectionStatusCode =
        StatusCodes.Status429TooManyRequests;
});

Kebijakan Jendela Tetap

AddFixedWindowLimiter mendaftarkan kebijakan bernama. Tetapkan batas izin, durasi jendela, dan perilaku antrean.

options.AddFixedWindowLimiter("fixed", limiter =>
{
    limiter.PermitLimit = 100;
    limiter.Window = TimeSpan.FromMinutes(1);
    limiter.QueueProcessingOrder = QueueProcessingOrder.OldestFirst;
    limiter.QueueLimit = 0;
});

Kebijakan Jendela Bergeser

AddSlidingWindowLimiter menambahkan SegmentsPerWindow untuk mengatur tingkat kehalusan pembagian.

options.AddSlidingWindowLimiter("sliding", limiter =>
{
    limiter.PermitLimit = 100;
    limiter.Window = TimeSpan.FromMinutes(1);
    limiter.SegmentsPerWindow = 6;
    limiter.QueueLimit = 0;
});

Kebijakan Keranjang Token

AddTokenBucketLimiter menetapkan ukuran keranjang dan laju pengisian ulangnya.

options.AddTokenBucketLimiter("token", limiter =>
{
    limiter.TokenLimit = 100;
    limiter.TokensPerPeriod = 20;
    limiter.ReplenishmentPeriod = TimeSpan.FromSeconds(10);
    limiter.QueueLimit = 0;
});

Kebijakan Konkurensi

AddConcurrencyLimiter membatasi jumlah permintaan yang diproses secara bersamaan.

options.AddConcurrencyLimiter("concurrent", limiter =>
{
    limiter.PermitLimit = 5;
    limiter.QueueLimit = 10;
    limiter.QueueProcessingOrder = QueueProcessingOrder.OldestFirst;
});

Menambahkan Perangkat Perantara

Aktifkan pembatasan laju dalam alur pemrosesan dengan UseRateLimiter. Letakkan di awal, setelah perutean.

var app = builder.Build();

app.UseRateLimiter();

app.MapControllers();

RequireRateLimiting

Terapkan kebijakan bernama ke titik akhir dengan RequireRateLimiting (API Minimal) atau atribut [EnableRateLimiting] (pengontrol).

app.MapGet("/search", () => Results.Ok())
   .RequireRateLimiting("token");

// Controller equivalent:
// [EnableRateLimiting("token")]

Menonaktifkan pada Titik Akhir Tertentu

Kecualikan titik akhir dari pembatas grup atau global dengan DisableRateLimiting atau [DisableRateLimiting].

app.MapGet("/health", () => Results.Ok())
   .DisableRateLimiting();

Pembatas Global dengan Partisi

GlobalLimiter berlaku untuk setiap permintaan. Gunakan PartitionedRateLimiter.Create agar setiap pengguna atau IP memiliki penghitungnya sendiri.

options.GlobalLimiter = PartitionedRateLimiter.Create<HttpContext, string>(
    context =>
    {
        var key = context.User.Identity?.Name
                  ?? context.Connection.RemoteIpAddress?.ToString()
                  ?? "anon";
        return RateLimitPartition.GetFixedWindowLimiter(key, _ =>
            new FixedWindowRateLimiterOptions
            {
                PermitLimit = 100,
                Window = TimeSpan.FromMinutes(1)
            });
    });

Menyesuaikan Penolakan

OnRejected memungkinkan Anda menambahkan header Retry-After atau isi respons yang mudah dipahami ketika permintaan ditolak karena pembatasan laju.

options.OnRejected = async (context, token) =>
{
    if (context.Lease.TryGetMetadata(
            MetadataName.RetryAfter, out var retry))
        context.HttpContext.Response.Headers.RetryAfter =
            ((int)retry.TotalSeconds).ToString();
    await context.HttpContext.Response
        .WriteAsync("Rate limit exceeded.", token);
};

Menerapkan pada Grup Rute

Pasangkan kebijakan dengan seluruh grup rute agar setiap titik akhir di dalamnya berbagi batas yang sama.

var api = app.MapGroup("/api")
             .RequireRateLimiting("fixed");

api.MapGet("/products", () => Results.Ok());
api.MapGet("/orders", () => Results.Ok());

Pemeriksaan Singkat

Pastikan penyiapan perangkat perantara.

Rekapitulasi

Anda telah mengonfigurasi pembatasan laju:

AddRateLimiter menentukan kebijakan jendela tetap, jendela bergeser, keranjang token, dan konkurensi.
UseRateLimiter mengaktifkan perangkat perantara; RequireRateLimiting menerapkan kebijakan.
GlobalLimiter dengan PartitionedRateLimiter memberikan penghitung per klien.
OnRejected menyesuaikan respons 429.

Berikutnya: penyimpanan keluaran.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Mengonfigurasi Middleware Pembatasan Laju” gratis?

Ya — teks lengkap “Mengonfigurasi Middleware Pembatasan Laju” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus C# Academy, upgrade ke CoddyKit PRO. Kursus C# Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Mengonfigurasi Middleware Pembatasan Laju”?

Terapkan batas laju per endpoint dan kebijakan. Kamu berlatih C# Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai C# Academy?

Tidak diperlukan pengalaman sebelumnya. C# Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 2 dari 4.

Berapa lama pelajaran “Mengonfigurasi Middleware Pembatasan Laju” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran C# Academy ini?

Ya. Setiap pelajaran C# Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

Algoritme Pembatasan Laju
Mengonfigurasi Middleware Pembatasan Laju
Dasar-Dasar Caching Output
Kebijakan dan Invalidasi Cache

← Kembali ke C# Academy