Agent

Agent discovery, details, and lifecycle management.

Methods

Method	Description
List(ctx)	Retrieve all active agents
Get(ctx, hostname)	Get detailed agent info by hostname
Drain(ctx, hostname)	Drain agent (stop accepting jobs)
Undrain(ctx, hostname)	Undrain agent (resume accepting jobs)
ListPending(ctx)	List agents awaiting PKI enrollment
Accept(ctx, hostname, fingerprint)	Accept a pending enrollment request
Reject(ctx, hostname)	Reject a pending enrollment request

Usage

import "github.com/osapi-io/osapi/pkg/sdk/client"

c := client.New("http://localhost:8080", token)

// List all agents
resp, err := c.Agent.List(ctx)
for _, a := range resp.Data.Agents {
    fmt.Printf("%s  status=%s\n", a.Hostname, a.Status)
}

// Get specific agent details
resp, err := c.Agent.Get(ctx, "web-01")

// Drain an agent (stop new jobs)
resp, err := c.Agent.Drain(ctx, "web-01")

// Undrain an agent (resume jobs)
resp, err := c.Agent.Undrain(ctx, "web-01")

Enrollment

When PKI is enabled, agents submit enrollment requests that must be accepted before they join the fleet.

// List pending enrollment requests
pending, err := c.Agent.ListPending(ctx)
for _, a := range pending.Data.Agents {
    fmt.Printf("%s  fingerprint=%s\n",
        a.Hostname, a.Fingerprint)
}

// Accept by hostname
resp, err := c.Agent.Accept(ctx, "web-01", "")

// Accept by fingerprint
resp, err := c.Agent.Accept(ctx, "web-01", "SHA256:ab12cd34...")

// Reject
resp, err := c.Agent.Reject(ctx, "web-01")

Examples

See examples/sdk/client/agent.go for agent discovery and facts.

See examples/sdk/client/enrollment.go for PKI enrollment operations.

Enrollment Types

PendingAgent

Field	Type	Description
MachineID	string	Machine ID of the agent
Hostname	string	Agent hostname
Fingerprint	string	SHA256 public key fingerprint
RequestedAt	time.Time	When enrollment was requested

PendingAgentList

Field	Type	Description
Agents	[]PendingAgent	List of pending agents
Total	int	Total number of pending agents

Permissions

Requires agent:read for List, Get, and ListPending. Drain, Undrain, Accept, and Reject require agent:write.