PaasService

platform.v1.PaasService

PaasService is the customer API for managed services. CatalogAdmin stays off this surface.

RPCs

ListPaasKinds

• Request: ListPaasKindsRequest
• Response: ListPaasKindsResponse
• REST mapping: GET /v1/paas:kinds

ListPaasApps

• Request: ListPaasAppsRequest
• Response: ListPaasAppsResponse
• REST mapping: GET /v1/paas

GetPaasApp

• Request: GetPaasAppRequest
• Response: PaasApp
• REST mapping: GET /v1/paas/{id}

CreatePaasApp

• Request: CreatePaasAppRequest
• Response: CreatePaasAppResponse
• REST mapping: POST /v1/paas

DeletePaasApp

• Request: DeletePaasAppRequest
• Response: Operation
• REST mapping: DELETE /v1/paas/{id}

Messages

CreatePaasAppRequest

Field	Type	#	Notes
name	string	1
kind	string	2
region	string	3
instance_type	string	4
image	string	5	empty picks an image that can run cloud-init
ssh_keys	string	6

CreatePaasAppResponse

Field	Type	#	Notes
operation	Operation	1
service	PaasApp	2

DeletePaasAppRequest

Field	Type	#	Notes
id	string	1

GetPaasAppRequest

Field	Type	#	Notes
id	string	1

ListPaasAppsRequest

No fields.

ListPaasAppsResponse

Field	Type	#	Notes
services	PaasApp	1

ListPaasKindsRequest

No fields.

ListPaasKindsResponse

Field	Type	#	Notes
kinds	PaasKindInfo	1

Operation

Operation is returned by every mutating RPC. Clients poll GetOperation or subscribe to the SSE stream to observe progress.

Field	Type	#	Notes
id	string	1	opaque, type-prefixed: op_…
action	string	2	permission string, e.g. compute.instance.create
resource_id	string	3
resource_type	string	4	e.g. compute.instance
state	OperationState	5
message	string	6
progress	int32	7	0..100
app	string	8

PaasApp

PaasApp is one managed service. It runs on its own compute instance, which the platform launches internally. Kind is a registered id such as “kubernetes” or “postgres”.

Field	Type	#	Notes
id	string	1
name	string	2
app	string	3
kind	string	4
region	string	5
instance_type	string	6
image	string	7
instance_id	string	8
state	ResourceState	9
public_ip	string	10
hostname	string	11
endpoint	string	12
secret	string	14	Secret is the generated credential (a Postgres password). List omits it; Get and Create return it.