ImageService

platform.v1.ImageService

ImageService manages the unified Image resource: SYSTEM (catalog/base) and MACHINE (created from an instance). Launch-from-image feeds the create flow by passing the image id as CreateInstance.image.

RPCs

`CreateImageFromInstance`

Request: CreateImageFromInstanceRequest
Response: Operation
REST mapping: POST /v1/images:from-instance

`ListImages`

Request: ImagesListRequest
Response: ImagesListResponse
REST mapping: GET /v1/images

`GetImage`

Request: GetImageRequest
Response: Image
REST mapping: GET /v1/images/{id}

`DeleteImage`

Request: DeleteImageRequest
Response: Operation
REST mapping: DELETE /v1/images/{id}

`UpdateImage`

Request: UpdateImageRequest
Response: Image
REST mapping: PATCH /v1/images/{id}

Messages

`CreateImageFromInstanceRequest`

CreateImageFromInstance captures a source instance into a launchable MACHINE image (AWS “create image”; never “AMI”).

Field	Type	#
`instance_id`	`string`	1
`name`	`string`	2
`description`	`string`	3

`DeleteImageRequest`

Field	Type	#	Notes
`id`	`string`	1

`GetImageRequest`

Field	Type	#	Notes
`id`	`string`	1

`Image`

Field	Type	#	Notes
`id`	`string`	1	ubuntu-24.04 (SYSTEM) or img_… (MACHINE)
`name`	`string`	2
`os`	`string`	3
`version`	`string`	4
`type`	`ImageType`	5	Phase 2 unified-image fields (populated for MACHINE images; SYSTEM images leave provider-scoped fields empty).
`description`	`string`	6
`app`	`string`	7
`org`	`string`	8
`region`	`string`	9
`provider`	`string`	10
`status`	`string`	11	pending \| available \| failed
`visibility`	`string`	12	private \| public
`platform`	`string`	13	linux \| windows
`architecture`	`string`	14	x86_64 \| arm64
`root_device_type`	`string`	15
`source_instance`	`string`	16
`created_at`	`string`	18
`updated_at`	`string`	19
`machine_image_id`	`string`	20	platform machine image this custom image was captured from

`ImagesListRequest`

ImagesListRequest filters by type; IMAGE_TYPE_UNSPECIFIED returns all.

Field	Type	#	Notes
`type`	`ImageType`	1

`ImagesListResponse`

Field	Type	#	Notes
`images`	`Image`	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

`UpdateImageRequest`

Field	Type	#	Notes
`id`	`string`	1
`description`	`string`	2