ayurishchevandClaude Sonnet 5
582b44f314
Adds POST /api/v1/admin/ips/scan (plus an optional periodic ticker) to
discover free Floating IPs in the OpenStack project and feed them straight
into the check queue. More importantly, decouples check/event history from
ip_queue's lifecycle: a new ip_registry table (migration 0007) gives every
address ever submitted a durable identity, so deleting it from the queue no
longer destroys its history — it's still reachable via the new
GET /api/v1/admin/registry[/{ip}] endpoints and the dashboard's /registry
pages, with retention depth configurable in check cycles per address
(history_retention_cycles, 0 = unlimited).
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
120 lines
3.4 KiB
Go
120 lines
3.4 KiB
Go
package httpapi
|
|
|
|
import "time"
|
|
|
|
// DTOs for the admin queue-management and dynamic-config endpoints
|
|
// (/api/v1/admin/ips, /api/v1/admin/config/*). Unlike the older read-only
|
|
// admin endpoints (which marshal internal/db model structs directly, in
|
|
// PascalCase), these use explicit snake_case JSON tags to match the
|
|
// agent/prober DTO convention.
|
|
|
|
type submitIPsRequest struct {
|
|
Addresses []string `json:"addresses"`
|
|
}
|
|
|
|
type submitIPsResponse struct {
|
|
Added []string `json:"added"`
|
|
Requeued []string `json:"requeued"`
|
|
Reordered []string `json:"reordered"`
|
|
SkippedInProgress []string `json:"skipped_in_progress"`
|
|
}
|
|
|
|
type deleteIPsRequest struct {
|
|
Addresses []string `json:"addresses"`
|
|
}
|
|
|
|
type deleteIPsResponse struct {
|
|
Deleted []string `json:"deleted"`
|
|
NotFound []string `json:"not_found"`
|
|
}
|
|
|
|
type clearQueueResponse struct {
|
|
Deleted []string `json:"deleted"`
|
|
}
|
|
|
|
type scanIPsResponse struct {
|
|
ScannedFree int `json:"scanned_free"`
|
|
Added []string `json:"added"`
|
|
Requeued []string `json:"requeued"`
|
|
Reordered []string `json:"reordered"`
|
|
SkippedInProgress []string `json:"skipped_in_progress"`
|
|
}
|
|
|
|
// registryDTO is one row of the durable per-address registry — see
|
|
// db.RegistrySummary.
|
|
type registryDTO struct {
|
|
IPAddress string `json:"ip_address"`
|
|
FirstSeenAt time.Time `json:"first_seen_at"`
|
|
LastSeenAt time.Time `json:"last_seen_at"`
|
|
TotalCycles int `json:"total_cycles"`
|
|
LastResult string `json:"last_result"`
|
|
LastCheckedAt *time.Time `json:"last_checked_at"`
|
|
InQueue bool `json:"in_queue"`
|
|
CurrentState string `json:"current_state"`
|
|
}
|
|
|
|
type validatorDTO struct {
|
|
ValidatorID string `json:"validator_id"`
|
|
Hostname string `json:"hostname"`
|
|
OSPortID string `json:"os_port_id"`
|
|
State string `json:"state"`
|
|
LastHeartbeatAt *time.Time `json:"last_heartbeat_at"`
|
|
}
|
|
|
|
type createValidatorRequest struct {
|
|
ValidatorID string `json:"validator_id"`
|
|
OSPortID string `json:"os_port_id"`
|
|
}
|
|
|
|
type updateValidatorRequest struct {
|
|
OSPortID string `json:"os_port_id"`
|
|
}
|
|
|
|
type siteDTO struct {
|
|
Index int `json:"index"`
|
|
SiteID string `json:"site_id"`
|
|
Hostname string `json:"hostname"`
|
|
State string `json:"state"`
|
|
LastHeartbeatAt *time.Time `json:"last_heartbeat_at"`
|
|
}
|
|
|
|
type putSiteRequest struct {
|
|
SiteID string `json:"site_id"`
|
|
}
|
|
|
|
type targetGroupDTO struct {
|
|
Name string `json:"name"`
|
|
Targets []string `json:"targets"`
|
|
}
|
|
|
|
type putTargetGroupRequest struct {
|
|
Targets []string `json:"targets"`
|
|
}
|
|
|
|
type checkTypeDTO struct {
|
|
Name string `json:"name"`
|
|
Enabled bool `json:"enabled"`
|
|
Targets []string `json:"targets"`
|
|
}
|
|
|
|
type putCheckTypeRequest struct {
|
|
Enabled bool `json:"enabled"`
|
|
Targets []string `json:"targets"`
|
|
}
|
|
|
|
// orchestratorSettingsDTO doubles as both the GET response and the PUT
|
|
// request body for /api/v1/admin/config/orchestrator — a single-field DTO,
|
|
// same shape both ways, like putSiteRequest/siteDTO.
|
|
type orchestratorSettingsDTO struct {
|
|
FIPSettleSeconds int `json:"fip_settle_seconds"`
|
|
HistoryRetentionCycles int `json:"history_retention_cycles"`
|
|
}
|
|
|
|
// inboundChecksDTO doubles as both the GET response and the PUT request
|
|
// body for /api/v1/admin/config/inbound-checks. Same field shape as
|
|
// proberAssignment.Ports/ICMP (dto.go).
|
|
type inboundChecksDTO struct {
|
|
Ports []int `json:"ports"`
|
|
ICMP bool `json:"icmp"`
|
|
}
|