Skip to navigation
ReferenceAPI Gateway HTTP referenceHeimdall Service

Update Advice reconciliation status

View as Markdown

Record an idempotent, generation-scoped reconciliation observation.

Path parameters

heimdallJobIdstringRequired
UUID of the Advice record being observed.

Request

Generation-scoped reconciliation status.

observedGenerationstringOptionalformat: "int64"
Advice generation observed by the controller.
dispositionenumOptionalDefaults to ADVICE_RECONCILIATION_DISPOSITION_UNSPECIFIED

AdviceReconciliationDisposition describes whether one Advice generation still needs work.

  • ADVICE_RECONCILIATION_DISPOSITION_UNSPECIFIED: The disposition is not specified.
  • ADVICE_RECONCILIATION_DISPOSITION_PENDING: Reconciliation has not reached a terminal observation.
  • ADVICE_RECONCILIATION_DISPOSITION_CONVERGED: Fresh scheduler state satisfies the desired state.
  • ADVICE_RECONCILIATION_DISPOSITION_ABANDONED: The desired state can no longer be reached for this generation.
Allowed values:
reasonenumOptionalDefaults to ADVICE_RECONCILIATION_REASON_UNSPECIFIED

AdviceReconciliationReason is a bounded explanation for a reconciliation disposition.

  • ADVICE_RECONCILIATION_REASON_UNSPECIFIED: The reason is not specified.
  • ADVICE_RECONCILIATION_REASON_DESIRED_STATE_OBSERVED: Fresh scheduler state exactly matches the desired state.
  • ADVICE_RECONCILIATION_REASON_ALREADY_SATISFIED: The target already satisfied the desired state before an action was needed.
  • ADVICE_RECONCILIATION_REASON_ADVICE_EXPIRED: Ordinary Advice exceeded its configured maximum age.
  • ADVICE_RECONCILIATION_REASON_STALE_ATTEMPT: A newer persisted attempt is beyond this recommendation’s applicability window.
  • ADVICE_RECONCILIATION_REASON_TARGET_STATE_FINAL: The target is final and cannot accept the recommendation.
  • ADVICE_RECONCILIATION_REASON_SUCCESSOR_ALREADY_RUNNING: A live successor cannot safely receive the required constraints.
  • ADVICE_RECONCILIATION_REASON_INVALID_RECOMMENDATION: The recommendation has no reconciliation path.
  • ADVICE_RECONCILIATION_REASON_UNSUPPORTED_RECOMMENDATION: The controller cannot implement the recommendation.
observedAtdatetimeOptional
Time of the fresh scheduler or policy observation.
transitionedAtdatetimeOptional
Time the disposition or reason last changed.
diagnosticMessagestringOptional
Optional bounded diagnostic text for operators.

Response

A successful response.
statusobjectOptional

AdviceReconciliationStatus records one generation-scoped reconciliation observation.