Operations and Management

Production tier: GA

LiteBus.Extensions.AspNetCore exposes HTTP management endpoints for inbox/outbox processors, retention, and diagnostics. Map routes with AddLiteBusManagementEndpoints() after registering AddLiteBusManagement().

When an axis is not registered on the host (for example inbox-only configuration), requests under that axis prefix return 404 Not Found with an axis-not-configured message instead of 500 Internal Server Error.

Packages to Install

Registration

builder.Services.AddLiteBusManagement(options =>
{
    options.AuthorizationPolicy = "LiteBusOperator";
    options.FailHealthWhenNoProbes = true;
});

var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
app.AddLiteBusManagementEndpoints();
app.Run();

Register authentication before mapping routes. When AllowAnonymousManagement is false (default), unauthenticated callers receive 401 unless you assign AuthorizationPolicy.

Options Reference

Endpoints (Summary)

Purge Confirmation (v6)

Unrestricted purge (no narrowing query parameters) requires JSON body:

{ "confirm": true }

Requests without confirm: true return 400. Narrow filters (status, age, tenant) may purge without the body when the filter is explicit.

Error Responses

Endpoint failures use application/problem+json with stable type, title, status, and detail values. The traceId extension identifies the request in host logs. Responses never include exception messages from managers, stores, or transport adapters. Invalid input and operator safety rejections return 400; unexpected failures return 500.

Guarantees and Non-Guarantees

Operations

Tests

Related Docs

• Diagnostics and health
• Hosted services
• Production runbook