Kibotos
API referencekibotos.operator.v1

TemplateCatalogService

This page lists the methods of TemplateCatalogService in kibotos.operator.v1 with the messages and enums each one uses, generated from operator.proto and its comments. Those that several services use are on kibotos.operator.v1 types.

ctrl APICalled with an Operator certificate.How to call it

TemplateCatalogService is the Operator-only Template catalog admission surface: it answers which revisions a Template may be created from and which one it defaults to, and it carries the three named catalog changes. Template admission never names a Platform revision and never moves a PlatformKey default; the two catalogs are the two halves of one admission model and each half writes only its own objects. It is never mounted on the Native Workspace endpoint, and it never calls a node.

ListTemplateRevisionAdmissions

POST/kibotos.operator.v1.TemplateCatalogService/ListTemplateRevisionAdmissionsUnary
RequestListTemplateRevisionAdmissionsRequest

ListTemplateRevisionAdmissionsRequest pages one Template's revisions in bytewise revision order. template_id is required: the admission surface answers about one Template at a time.

ResponseListTemplateRevisionAdmissionsResponse

GetTemplateDefault

POST/kibotos.operator.v1.TemplateCatalogService/GetTemplateDefaultUnary
RequestGetTemplateDefaultRequest
ResponseGetTemplateDefaultResponse

SetTemplateRevisionSelection

POST/kibotos.operator.v1.TemplateCatalogService/SetTemplateRevisionSelectionUnary
RequestSetTemplateRevisionSelectionRequest

selectable true must come without a reason and clears any recorded one; selectable false requires one of the two recorded reasons.

ResponseSetTemplateRevisionSelectionResponse

SetTemplateDefault

POST/kibotos.operator.v1.TemplateCatalogService/SetTemplateDefaultUnary
RequestSetTemplateDefaultRequest

expected_revision is the compare-and-swap token. Pass expect_no_default instead to state that this Template has no default yet; passing neither or both is rejected, because a caller who believes it is swapping must not submit an unconditional write.

ResponseSetTemplateDefaultResponse

WithdrawTemplateRevision

POST/kibotos.operator.v1.TemplateCatalogService/WithdrawTemplateRevisionUnary
RequestWithdrawTemplateRevisionRequest

reason is required and must already be normalized; a withdrawal without a recorded reason leaves nobody able to say why the Template revision went away.

ResponseWithdrawTemplateRevisionResponse

Messages and enums

Several methods of TemplateCatalogService use these messages and enums.

TemplateRevisionAdmission

TemplateRevisionAdmission is one registered Template revision and the two admission facts an Operator can change about it. It carries no Platform revision: which Platform a Workspace launches on is resolved by ctrl, not selected here.

TemplateDefault

TemplateDefault is the revision new Workspaces use when none is given. revision is empty when this Template has no default yet.

TemplateSelectionState

TemplateSelectionState is derived from the stored revision, not a persisted state machine: a withdrawn revision is never selectable again.

  • TEMPLATE_SELECTION_STATE_UNSPECIFIED= 0
  • TEMPLATE_SELECTION_STATE_SELECTABLE= 1
  • TEMPLATE_SELECTION_STATE_NOT_SELECTABLE= 2

On this page