gRPC: tenants

Multi-tenant self-service (docs/cloud/SELF_SERVICE.md §2, §3, §5): tenants, their quotas, users, servers and monthly usage. Bodies travel as JSON in the schemas of the REST API (/v1/tenants, docs/api/openapi.yaml); the rules are the REST rules.

`TenantService`

Tenants of a self-service portal and their servers. Bodies are JSON in the shape of the REST API.

Method	Request	Response	Description
`ListTenants`	`Empty`	`JsonBody`	TenantView[] (Kyvernon.Tenant.Read on the root).
`GetTenant`	`TenantRequest`	`JsonBody`	TenantView.
`CreateTenant`	`JsonBody`	`JsonBody`	CreateTenantRequest -> TenantView.
`SetQuota`	`TenantJsonRequest`	`JsonBody`	QuotaView -> TenantView.
`SuspendTenant`	`TenantRequest`	`TaskRef`	Suspends a tenant: its virtual machines shut down and its users become read-only.
`ResumeTenant`	`TenantRequest`	`TaskRef`	Resumes a suspended tenant and starts the virtual machines that ran.
`CloseTenant`	`TenantJsonRequest`	`TaskRef`	CloseTenantRequest.
`GetUsage`	`UsageRequest`	`JsonBody`	TenantUsageView of `month` (YYYY-MM, empty: current).
`ListServers`	`TenantRequest`	`JsonBody`	ServerView[].
`GetServer`	`ServerRequest`	`JsonBody`	ServerView.
`CreateServer`	`TenantJsonRequest`	`JsonBody`	CreateServerRequest -> ServerTaskView (with the generated password, once).
`ServerAction`	`ServerActionRequest`	`JsonBody`	One server operation -> ServerTaskView (console: ConsoleTicketView).

Messages

`JsonBody`

A JSON document.

Field	Number	Type	Description
`json`	1	`string`	The body as JSON, in the shape of the REST API.

`TenantRequest`

Names a tenant.

Field	Number	Type	Description
`tenant`	1	`string`	Id of the tenant.

`TenantJsonRequest`

A tenant and a JSON body.

Field	Number	Type	Description
`tenant`	1	`string`	Id of the tenant.
`json`	2	`string`	The body as JSON, in the shape of the REST API.

`UsageRequest`

Usage of a tenant in a month.

Field	Number	Type	Description
`tenant`	1	`string`	Id of the tenant.
`month`	2	`string`	`YYYY-MM`; empty for the current month.

`ServerRequest`

Names a server of a tenant.

Field	Number	Type	Description
`tenant`	1	`string`	Id of the tenant.
`server`	2	`string`	Id of the server.

`ServerActionRequest`

One operation on a server.

Field	Number	Type	Description
`tenant`	1	`string`	Id of the tenant.
`server`	2	`string`	Id of the server.
`action`	3	`string`	delete, power (json: ServerPowerRequest), reinstall (ReinstallServerRequest), resize (ResizeServerRequest), rescue (RescueServerRequest), unrescue, reset-password, snapshot (ServerSnapshotRequest), remove-snapshot, revert-snapshot, console.
`json`	4	`string`	The operation as JSON, in the shape of the REST API.
`snapshot`	5	`uint32`	Snapshot key of remove-snapshot and revert-snapshot.