StorageService

platform.v1.StorageService

RPCs

`CreateVolume`

Request: CreateVolumeRequest
Response: Operation
REST mapping: POST /v1/volumes

`GetVolume`

Request: GetVolumeRequest
Response: Volume
REST mapping: GET /v1/volumes/{id}

`ListVolumes`

Request: ListVolumesRequest
Response: ListVolumesResponse
REST mapping: GET /v1/volumes

`AttachVolume`

Request: AttachVolumeRequest
Response: Operation
REST mapping: POST /v1/volumes/{id}:attach

`DetachVolume`

Request: DetachVolumeRequest
Response: Operation
REST mapping: POST /v1/volumes/{id}:detach

`ModifyVolume`

Request: ModifyVolumeRequest
Response: Operation
REST mapping: POST /v1/volumes/{id}:modify

`DeleteVolume`

Request: DeleteVolumeRequest
Response: Operation
REST mapping: DELETE /v1/volumes/{id}

`CreateSnapshot`

Request: CreateSnapshotRequest
Response: Operation
REST mapping: POST /v1/snapshots

`ListSnapshots`

Request: ListSnapshotsRequest
Response: ListSnapshotsResponse
REST mapping: GET /v1/snapshots

`GetSnapshot`

Request: GetSnapshotRequest
Response: Snapshot
REST mapping: GET /v1/snapshots/{id}

`DeleteSnapshot`

Request: DeleteSnapshotRequest
Response: Operation
REST mapping: DELETE /v1/snapshots/{id}

`RestoreVolumeFromSnapshot`

Request: RestoreVolumeFromSnapshotRequest
Response: Operation
REST mapping: POST /v1/snapshots/{id}:restore

`CreateVolumeFromSnapshot`

Request: CreateVolumeFromSnapshotRequest
Response: Operation
REST mapping: POST /v1/snapshots/{id}:createVolume

`CreateBackupPolicy`

---- Phase 6: volume backup policies (schedule + retention) ----

Request: CreateBackupPolicyRequest
Response: BackupPolicy
REST mapping: POST /v1/backup-policies

`ListBackupPolicies`

Request: ListBackupPoliciesRequest
Response: ListBackupPoliciesResponse
REST mapping: GET /v1/backup-policies

`GetBackupPolicy`

Request: GetBackupPolicyRequest
Response: BackupPolicy
REST mapping: GET /v1/backup-policies/{id}

`UpdateBackupPolicy`

Request: UpdateBackupPolicyRequest
Response: BackupPolicy
REST mapping: PATCH /v1/backup-policies/{id}

`DeleteBackupPolicy`

Request: DeleteBackupPolicyRequest
Response: BackupPolicy
REST mapping: DELETE /v1/backup-policies/{id}

`RunBackupPolicy`

Request: RunBackupPolicyRequest
Response: Operation
REST mapping: POST /v1/backup-policies/{id}:run

Messages

`AttachVolumeRequest`

AttachVolumeRequest performs the “Switch Volume” operation.

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

`BackupPolicy`

BackupPolicy schedules retained snapshots of a volume (Phase 6). A backup is just a snapshot with origin=backup; the policy owns cadence + retention.

Field	Type	#	Notes
`id`	`string`	1	bpol_…
`name`	`string`	2
`app`	`string`	3
`org`	`string`	4
`source_volume`	`string`	5	volume id to back up
`provider`	`string`	6
`schedule`	`string`	7	hourly \| daily \| weekly \| “@every <dur>”
`retention_keep`	`int32`	8	keep N most recent backups (0 = unlimited)
`retention_days`	`int32`	9	expire backups older than N days (0 = no expiry)
`enabled`	`bool`	10

`CreateBackupPolicyRequest`

Field	Type	#
`name`	`string`	1
`source_volume_id`	`string`	2
`schedule`	`string`	3
`retention_keep`	`int32`	4
`retention_days`	`int32`	5
`enabled`	`bool`	6

`CreateSnapshotRequest`

Field	Type	#
`source_volume_id`	`string`	1
`source_instance_id`	`string`	2
`description`	`string`	3
`name`	`string`	4

`CreateVolumeFromSnapshotRequest`

Field	Type	#	Notes
`id`	`string`	1	snapshot id
`name`	`string`	2	new volume name

`CreateVolumeRequest`

Field	Type	#	Notes
`volume`	`Volume`	1

`DeleteBackupPolicyRequest`

Field	Type	#	Notes
`id`	`string`	1

`DeleteSnapshotRequest`

Field	Type	#	Notes
`id`	`string`	1

`DeleteVolumeRequest`

Field	Type	#	Notes
`id`	`string`	1

`DetachVolumeRequest`

Field	Type	#	Notes
`id`	`string`	1
`force`	`bool`	2

`GetBackupPolicyRequest`

Field	Type	#	Notes
`id`	`string`	1

`GetSnapshotRequest`

Field	Type	#	Notes
`id`	`string`	1

`GetVolumeRequest`

Field	Type	#	Notes
`id`	`string`	1

`ListBackupPoliciesRequest`

Field	Type	#	Notes
`page`	`PageRequest`	1

`ListBackupPoliciesResponse`

Field	Type	#	Notes
`policies`	`BackupPolicy`	1
`meta`	`ListMeta`	2

`ListSnapshotsRequest`

Field	Type	#	Notes
`page`	`PageRequest`	1

`ListSnapshotsResponse`

Field	Type	#	Notes
`snapshots`	`Snapshot`	1
`meta`	`ListMeta`	2

`ListVolumesRequest`

Field	Type	#	Notes
`page`	`PageRequest`	1

`ListVolumesResponse`

Field	Type	#	Notes
`volumes`	`Volume`	1
`meta`	`ListMeta`	2

`ModifyVolumeRequest`

Field	Type	#
`id`	`string`	1
`size_gb`	`int64`	2
`type`	`string`	3
`iops`	`int32`	4
`throughput`	`int32`	5

`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

`RestoreVolumeFromSnapshotRequest`

Field	Type	#	Notes
`id`	`string`	1

`RunBackupPolicyRequest`

Field	Type	#	Notes
`id`	`string`	1

`Snapshot`

Snapshot is a disk backup of a volume or instance disk.

Field	Type	#	Notes
`id`	`string`	1	snap_…
`name`	`string`	2
`description`	`string`	3
`app`	`string`	4
`org`	`string`	5
`region`	`string`	6
`source_volume`	`string`	7
`source_instance`	`string`	8
`size_gb`	`int64`	9
`status`	`string`	10	pending \| available \| failed
`progress`	`int32`	11
`encrypted`	`bool`	12
`origin`	`string`	13	manual \| backup

`UpdateBackupPolicyRequest`

Field	Type	#
`id`	`string`	1
`name`	`string`	2
`schedule`	`string`	3
`retention_keep`	`int32`	4
`retention_days`	`int32`	5
`enabled`	`bool`	6

`Volume`

Field	Type	#	Notes
`id`	`string`	1	vol_…
`name`	`string`	2
`app`	`string`	3
`org`	`string`	4
`region`	`string`	5
`size_gb`	`int64`	6
`state`	`ResourceState`	7
`attached_to`	`string`	8	instance id, empty if detached
`type`	`string`	12	Phase 3 EBS-style attributes.
`iops`	`int32`	13
`throughput`	`int32`	14
`source_snapshot`	`string`	15
`encrypted`	`bool`	16
`availability_zone`	`string`	17