Admin, Ops & Multi-Tenancy

Operators run backups, restores, and compaction via BackupClient; manage pipelines, feeds, notification rules, jobs, and LLM config via SystemClient; manage tenants, tiers, sharing, and platform usage via TenantAdminClient; and mint/revoke bearer tokens via TokenClient.

46 methods across this domain. Signatures, parameters (incl. keyword-only tunable defaults), and the three SDK spellings are ported from the live SDK source; flagship methods carry a hand-written When to use + example.

BackupClient

restore(snapshot_id, tenant=None, point_in_time_ns=None)

When to use. Restore from a snapshot; poll with wait_for_restore / restore_status.

  • Python — client.backupclient.restore(snapshot_id, tenant=None, point_in_time_ns=None)
  • TypeScript — restore(snapshotId, opts)
  • Go — Restore(snapshotID)

Parameters: snapshot_id, tenant=None, point_in_time_ns=None

Example

rid = BackupClient.from_client(relata).restore(snapshot_id="snap-9")

compact()

compact()`

  • Python — client.backupclient.compact()
  • TypeScript — compact()
  • Go — Compact()

create(kind='full', tenant=None)

create(kind='full', tenant=None)`

  • Python — client.backupclient.create(kind='full', tenant=None)
  • TypeScript — create(opts)
  • Go — Create()

Parameters: kind='full', tenant=None

list()

list()`

  • Python — client.backupclient.list()
  • TypeScript — list()
  • Go — List()

restore_status(restore_id)

restore_status(restore_id)`

  • Python — client.backupclient.restore_status(restore_id)
  • TypeScript — restoreStatus(restoreId)
  • Go — RestoreStatus(restoreID)

Parameters: restore_id

wait_for_restore(restore_id, timeout_secs=300.0, poll_interval_secs=2.0)

wait_for_restore(restore_id, timeout_secs=300.0, poll_interval_secs=2.0)`

  • Python — client.backupclient.wait_for_restore(restore_id, timeout_secs=300.0, poll_interval_secs=2.0)
  • TypeScript — waitForRestore(restoreId, opts)
  • Go — WaitForRestore(restoreID)

Parameters: restore_id, timeout_secs=300.0, poll_interval_secs=2.0

RelataClient

cluster_drain(node_id)

cluster_drain(node_id)`

  • Python — client.relataclient.cluster_drain(node_id)
  • TypeScript — clusterDrain(nodeId)
  • Go — ClusterDrain(nodeID)

Parameters: node_id

cluster_nodes()

cluster_nodes()`

  • Python — client.relataclient.cluster_nodes()
  • TypeScript — clusterNodes()
  • Go — ClusterNodes()

cluster_rebalance()

cluster_rebalance()`

  • Python — client.relataclient.cluster_rebalance()
  • TypeScript — clusterRebalance()
  • Go — ClusterRebalance()

cluster_topology()

cluster_topology()`

  • Python — client.relataclient.cluster_topology()
  • TypeScript — clusterTopology()
  • Go — ClusterTopology()

SystemClient

create_notification_rule(rule)

create_notification_rule(rule)`

  • Python — client.systemclient.create_notification_rule(rule)
  • TypeScript — createNotificationRule(rule)
  • Go — CreateNotificationRule(rule)

Parameters: rule

define_pipeline(definition)

define_pipeline(definition)`

  • Python — client.systemclient.define_pipeline(definition)
  • TypeScript — definePipeline(definition)
  • Go — DefinePipeline(definition)

Parameters: definition

delete_notification_rule(rule_id)

delete_notification_rule(rule_id)`

  • Python — client.systemclient.delete_notification_rule(rule_id)
  • TypeScript — deleteNotificationRule(id)
  • Go — DeleteNotificationRule(id)

Parameters: rule_id

feed_channels()

feed_channels()`

  • Python — client.systemclient.feed_channels()
  • TypeScript — feedChannels()
  • Go — FeedChannels()

feed_health()

feed_health()`

  • Python — client.systemclient.feed_health()
  • TypeScript — feedHealth()
  • Go — FeedHealth()

feed_publish(channel, payload)

feed_publish(channel, payload)`

  • Python — client.systemclient.feed_publish(channel, payload)
  • TypeScript — feedPublish(channel, payload)
  • Go — FeedPublish(channel, payload)

Parameters: channel, payload

get_workflow(name)

get_workflow(name)`

  • Python — client.systemclient.get_workflow(name)
  • TypeScript — getWorkflow(name)
  • Go — GetWorkflow(name)

Parameters: name

job_status(name)

job_status(name)`

  • Python — client.systemclient.job_status(name)
  • TypeScript — jobStatus(name)
  • Go — JobStatus(name)

Parameters: name

jobs_status()

jobs_status()`

  • Python — client.systemclient.jobs_status()
  • TypeScript — jobsStatus()
  • Go — JobsStatus()

list_pipelines()

list_pipelines()`

  • Python — client.systemclient.list_pipelines()
  • TypeScript — listPipelines()
  • Go — ListPipelines()

list_workflows()

list_workflows()`

  • Python — client.systemclient.list_workflows()
  • TypeScript — listWorkflows()
  • Go — ListWorkflows()

llm_config()

llm_config()`

  • Python — client.systemclient.llm_config()
  • TypeScript — llmConfig()
  • Go — LLMConfig()

notification_rules()

notification_rules()`

  • Python — client.systemclient.notification_rules()
  • TypeScript — notificationRules()
  • Go — NotificationRules()

register_workflow(name, steps)

register_workflow(name, steps)`

  • Python — client.systemclient.register_workflow(name, steps)
  • TypeScript — registerWorkflow(name, steps)
  • Go — RegisterWorkflow(name, steps)

Parameters: name, steps

run_workflow(name)

run_workflow(name)`

  • Python — client.systemclient.run_workflow(name)
  • TypeScript — runWorkflow(name)
  • Go — RunWorkflow(name)

Parameters: name

test_llm(prompt, model=None)

test_llm(prompt, model=None)`

  • Python — client.systemclient.test_llm(prompt, model=None)
  • TypeScript — testLlm(prompt, opts)
  • Go — TestLLM(prompt)

Parameters: prompt, model=None

workflow_run(run_id)

workflow_run(run_id)`

  • Python — client.systemclient.workflow_run(run_id)
  • TypeScript — workflowRun(runId)
  • Go — WorkflowRun(runID)

Parameters: run_id

workflow_status(name)

workflow_status(name)`

  • Python — client.systemclient.workflow_status(name)
  • TypeScript — workflowStatus(name)
  • Go — WorkflowStatus(name)

Parameters: name

TenantAdminClient

create_sharing(tenant_id, partner_tenant, object_type, action='read', expires_ns=None)

When to use. Establish a governed cross-tenant data-sharing agreement.

  • Python — client.tenantadminclient.create_sharing(tenant_id, partner_tenant, object_type, action='read', expires_ns=None)
  • TypeScript — createSharing(tenantId, partnerTenant, opts)
  • Go — CreateSharing(tenantID, partnerTenant, objectType)

Parameters: tenant_id, partner_tenant, object_type, action='read', expires_ns=None

Example

TenantAdminClient.from_client(relata).create_sharing("acme", partner_tenant="beta")

set_tier(tenant_id, tier)

When to use. Move a tenant between tiers (operator surface, cluster-only multi-tenant).

  • Python — client.tenantadminclient.set_tier(tenant_id, tier)
  • TypeScript — setTier(tenantId, tier)
  • Go — SetTier(tenantID, tier)

Parameters: tenant_id, tier

Example

TenantAdminClient.from_client(relata).set_tier("acme", tier="enterprise")

create(tenant_id, tier='standard', **fields)

create(tenant_id, tier='standard', **fields)`

  • Python — client.tenantadminclient.create(tenant_id, tier='standard', **fields)
  • TypeScript — create(tenantId, opts)
  • Go — Create(tenantID)

Parameters: tenant_id, tier='standard', **fields

delete(tenant_id)

delete(tenant_id)`

  • Python — client.tenantadminclient.delete(tenant_id)
  • Go — Delete(tenantID)

Parameters: tenant_id

get(tenant_id)

get(tenant_id)`

  • Python — client.tenantadminclient.get(tenant_id)
  • TypeScript — get(tenantId)
  • Go — Get(tenantID)

Parameters: tenant_id

list_sharing(tenant_id)

list_sharing(tenant_id)`

  • Python — client.tenantadminclient.list_sharing(tenant_id)
  • TypeScript — listSharing(tenantId)
  • Go — ListSharing(tenantID)

Parameters: tenant_id

me()

me()`

  • Python — client.tenantadminclient.me()
  • TypeScript — me()
  • Go — Me()

platform_license()

platform_license()`

  • Python — client.tenantadminclient.platform_license()
  • TypeScript — platformLicense()
  • Go — PlatformLicense()

platform_usage()

platform_usage()`

  • Python — client.tenantadminclient.platform_usage()
  • TypeScript — platformUsage()
  • Go — PlatformUsage()

reactivate(tenant_id)

reactivate(tenant_id)`

  • Python — client.tenantadminclient.reactivate(tenant_id)
  • TypeScript — reactivate(tenantId)
  • Go — Reactivate(tenantID)

Parameters: tenant_id

set_quota(tenant_id, quota)

set_quota(tenant_id, quota)`

  • Python — client.tenantadminclient.set_quota(tenant_id, quota)
  • TypeScript — setQuota(tenantId, quota)
  • Go — SetQuota(tenantID, quota)

Parameters: tenant_id, quota

suspend(tenant_id)

suspend(tenant_id)`

  • Python — client.tenantadminclient.suspend(tenant_id)
  • TypeScript — suspend(tenantId)
  • Go — Suspend(tenantID)

Parameters: tenant_id

tenant_usage(tenant_id)

tenant_usage(tenant_id)`

  • Python — client.tenantadminclient.tenant_usage(tenant_id)
  • TypeScript — tenantUsage(tenantId)
  • Go — TenantUsage(tenantID)

Parameters: tenant_id

usage()

usage()`

  • Python — client.tenantadminclient.usage()
  • TypeScript — usage()
  • Go — Usage()

TokenClient

check(token_id)

check(token_id)`

  • Python — client.tokenclient.check(token_id)
  • TypeScript — check(tokenId)
  • Go — Check(tokenID)

Parameters: token_id

remember(token_id, ttl_secs=None)

remember(token_id, ttl_secs=None)`

  • Python — client.tokenclient.remember(token_id, ttl_secs=None)
  • TypeScript — remember(tokenId, opts)
  • Go — Remember(tokenID)

Parameters: token_id, ttl_secs=None

revoke(token_id)

revoke(token_id)`

  • Python — client.tokenclient.revoke(token_id)
  • TypeScript — revoke(tokenId)
  • Go — Revoke(tokenID)

Parameters: token_id

stats()

stats()`

  • Python — client.tokenclient.stats()
  • TypeScript — stats()
  • Go — Stats()