Resources / AgentAction

AgentAction

One action an agent decided on, with its outcome. Written by the platform only; approve or deny one that waits with an AgentApproval.

Overview

APIintelligence.etorm.com/v1alpha1
Resourceagentactions (cluster-scoped inside its cluster)
Short namesagact
Available inproject clusters only
Statuswritten by a controller through /status

Minimal example

apiVersion: intelligence.etorm.com/v1alpha1
kind: AgentAction
metadata:
  name: example
spec:
  agentRef:
    name: "<name>"
  verb: get
  resource: "<resource>"

Spec

FieldTypeRequiredDefaultAllowedDescription
agentRefobjectyesThe agent.
agentRef.namestringyeslength 1 to 63Name of the Agent.
stepintegerat least 0The agent's step number.
verbstring (one of)yesget, list, create, update, patch, deleteThe API verb.
groupstringup to 253 charactersAPI group of the target kind (empty for the core group).
resourcestringyeslength 1 to 63Plural resource name of the target kind.
namestringup to 63 charactersThe target object, when there is one.
riskstring (one of)low, medium, highlow reads, medium creates or changes, high deletes.
reasonstringup to 1000 charactersThe agent's stated reason. Written by the model: data, not a fact.
bodyDigeststringup to 64 charactersSHA-256 of the request body, hex.

Status

FieldTypeRequiredDefaultAllowedDescription
phasestringAwaitingApproval, Approved, Denied, Expired, Succeeded, Refused or Failed.
codeintegerHTTP status of the call.
messagestringWhat happened.
approvalRefobjectThe decision that let it run or stopped it.
approvalRef.namestringName of the AgentApproval.
completedAtstringWhen it ended (RFC 3339).
conditionslist of objectDetailed state.
conditions[].typestringAspect.
conditions[].statusstringTrue or False.
conditions[].reasonstringMachine-readable reason.
conditions[].messagestringHuman-readable detail.

Columns in listings

ColumnFrom
Agent.spec.agentRef.name
Verb.spec.verb
Resource.spec.resource
Target.spec.name
Risk.spec.risk
Phase.status.phase

All resources