PlatformCatalogService

This page lists the methods of PlatformCatalogService 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

PlatformCatalogService is the Operator-only Platform catalog surface: it answers what has been registered, which revision each PlatformKey currently defaults to, and it carries the three named catalog changes. It is never mounted on the Native Workspace endpoint, and it never calls a node.

ListPlatformRevisions

POST/kibotos.operator.v1.PlatformCatalogService/ListPlatformRevisionsUnary

RequestListPlatformRevisionsRequest

ListPlatformRevisionsRequest filters before it pages. key must carry all five fields or none of them; state UNSPECIFIED means every state.

ResponseListPlatformRevisionsResponse

platform_revisionsrepeatedPlatformRevision= 1
next_page_tokenstring= 2

GetPlatformRevision

POST/kibotos.operator.v1.PlatformCatalogService/GetPlatformRevisionUnary

RequestGetPlatformRevisionRequest

revisionstring= 1

ResponseGetPlatformRevisionResponse

canonical_manifest is the exact byte sequence revision digests, so a caller can verify the two against each other without trusting this response.

platform_revision PlatformRevision= 1
canonical_manifestbytes= 2

ListPlatformDefaults

POST/kibotos.operator.v1.PlatformCatalogService/ListPlatformDefaultsUnary

RequestListPlatformDefaultsRequest

page_sizeuint32= 1
page_tokenstring= 2
key PlatformKey= 3

ResponseListPlatformDefaultsResponse

platform_defaultsrepeatedPlatformDefault= 1
next_page_tokenstring= 2

ApprovePlatformRevision

POST/kibotos.operator.v1.PlatformCatalogService/ApprovePlatformRevisionUnary

RequestApprovePlatformRevisionRequest

revisionstring= 1
command_idstring= 2

ResponseApprovePlatformRevisionResponse

platform_revision PlatformRevision= 1

WithdrawPlatformRevision

POST/kibotos.operator.v1.PlatformCatalogService/WithdrawPlatformRevisionUnary

RequestWithdrawPlatformRevisionRequest

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

revisionstring= 1
command_idstring= 2
reasonstring= 3

ResponseWithdrawPlatformRevisionResponse

platform_revision PlatformRevision= 1

SetPlatformDefault

POST/kibotos.operator.v1.PlatformCatalogService/SetPlatformDefaultUnary

RequestSetPlatformDefaultRequest

expected_revision and expected_default_version are the compare-and-swap pair. Give both or neither: neither means this PlatformKey has no default yet.

key PlatformKey= 1
revisionstring= 2
command_idstring= 3
expected_revisionstring= 4
expected_default_versionuint64= 5

ResponseSetPlatformDefaultResponse

platform_default PlatformDefault= 1

ListPlatformRevisionBindings

POST/kibotos.operator.v1.PlatformCatalogService/ListPlatformRevisionBindingsUnary

RequestListPlatformRevisionBindingsRequest

ListPlatformRevisionBindingsRequest pages the Workspaces still bound to one exact Platform revision. It stays answerable after the revision is withdrawn: a withdrawal has no reverse action, and the Workspaces using it only leave on their own next explicit start.

revisionstring= 1
page_sizeuint32= 2
page_tokenstring= 3

ResponseListPlatformRevisionBindingsResponse

workspace_bindingsrepeatedWorkspaceLaunchBinding= 1
next_page_tokenstring= 2

WorkspaceLaunchBinding

WorkspaceLaunchBinding answers "who is still bound to this revision" and nothing else: no Workspace spec, no state, no ownership, no Platform manifest content.

workspace_idstring= 1
launch_refstring= 2
launch_binding_versionuint64= 3

Messages and enums

Several methods of PlatformCatalogService use these messages and enums.

PlatformKey

PlatformKey addresses one line of Platform revisions. Every field comes from the Platform manifest; a caller cannot name a Platform any other way.

backendstring= 1
architecturestring= 2
kernel_seriesstring= 3
guest_protocoluint32= 4
rootfs_contractuint32= 5

PlatformRevision

PlatformRevision is one registered Platform. revision is the sha256 digest of the canonical manifest and is the only stable name a Platform has.

revisionstring= 1
key PlatformKey= 2
provenance_refstring= 3
state PlatformRevisionState= 4
published_atgoogle.protobuf.Timestamp= 5
approved_atgoogle.protobuf.Timestamp= 6
withdrawn_atgoogle.protobuf.Timestamp= 7
created_atgoogle.protobuf.Timestamp= 8
reclaimed_atgoogle.protobuf.Timestamp= 9
reclaimed_at is set once the artifact store no longer publishes this revision's manifest. The derived state stays WITHDRAWN.

PlatformDefault

PlatformDefault is the revision new Launches resolve to for one PlatformKey. version is the compare-and-swap token; it advances on every move.

key PlatformKey= 1
platform_revisionstring= 2
versionuint64= 3
updated_atgoogle.protobuf.Timestamp= 4

PlatformRevisionState

PlatformRevisionState is derived from the authority record, not stored: a withdrawn revision stays withdrawn even though it was approved first.

PLATFORM_REVISION_STATE_UNSPECIFIED= 0
PLATFORM_REVISION_STATE_REGISTERED= 1
PLATFORM_REVISION_STATE_APPROVED= 2
PLATFORM_REVISION_STATE_WITHDRAWN= 3

PlatformCatalogService

ListPlatformRevisionsCopy Anchor Link

GetPlatformRevisionCopy Anchor Link

ListPlatformDefaultsCopy Anchor Link

ApprovePlatformRevisionCopy Anchor Link

WithdrawPlatformRevisionCopy Anchor Link

SetPlatformDefaultCopy Anchor Link

ListPlatformRevisionBindingsCopy Anchor Link

WorkspaceLaunchBindingCopy Anchor Link

Messages and enumsCopy Anchor Link

PlatformKeyCopy Anchor Link

PlatformRevisionCopy Anchor Link

PlatformDefaultCopy Anchor Link

PlatformRevisionStateCopy Anchor Link

On this page