Python Secrets and Checkpoints

Stored Secrets

Interface	Purpose
`runta.secrets.create(name, value, …)`	Store a tenant credential.
`runta.secrets.list()`	List stored secret metadata.
`runta.secrets.get(id_or_name)`	Fetch stored secret metadata.
`runta.secrets.delete(id_or_name)`	Delete a stored secret.

Async
Sync

secret = await runta.secrets.create(
    "github-token",
    "ghp_example",
    cache_ttl_secs=300,
)
print(secret.id)

secrets = await runta.secrets.list()
same_secret = await runta.secrets.get("github-token")
await runta.secrets.delete("github-token")

secret = runta.secrets.create(
    "github-token",
    "ghp_example",
    cache_ttl_secs=300,
)
print(secret.id)

secrets = runta.secrets.list()
same_secret = runta.secrets.get("github-token")
runta.secrets.delete("github-token")

Secret Injection Rules

Interface	Purpose
`runtime.secrets.create_rule(…)`	Add a runtime-scoped injection rule.
`runtime.secrets.list_rules()`	List runtime injection rules.
`runtime.secrets.get_rule(id)`	Fetch one injection rule.
`runtime.secrets.delete_rule(id)`	Delete one injection rule.

Async
Sync

from runta import Injection

rule = await runtime.secrets.create_rule(
    "https://api.github.com",
    path="/repos/*",
    injection=Injection(
        credential="github-token",
        header="Authorization",
        value="Bearer ${credential}",
    ),
)

rules = await runtime.secrets.list_rules()
rule = await runtime.secrets.get_rule(rule.id)
await runtime.secrets.delete_rule(rule.id)

from runta import Injection

rule = runtime.secrets.create_rule(
    "https://api.github.com",
    path="/repos/*",
    injection=Injection(
        credential="github-token",
        header="Authorization",
        value="Bearer ${credential}",
    ),
)

rules = runtime.secrets.list_rules()
rule = runtime.secrets.get_rule(rule.id)
runtime.secrets.delete_rule(rule.id)

Checkpoints

Interface	Purpose
`runtime.checkpoints.create(name=…)`	Create a full checkpoint from a runtime.
`runta.checkpoints.list(include_system=…)`	List checkpoints.
`runta.checkpoints.get(id)`	Fetch checkpoint metadata.
`runta.runtimes.create(name, checkpoint_id=…)`	Restore a new runtime from a checkpoint.
`runta.checkpoints.delete(id)`	Delete a checkpoint.

Async
Sync

checkpoint = await runtime.checkpoints.create(name="demo-prepared")
print(checkpoint.id, checkpoint.state)

checkpoints = await runta.checkpoints.list(include_system=True)
checkpoint = await runta.checkpoints.get(checkpoint.id)

restored = await runta.runtimes.create(
    "demo-restored",
    checkpoint_id=checkpoint.id,
)

await runta.checkpoints.delete(checkpoint.id)

checkpoint = runtime.checkpoints.create(name="demo-prepared")
print(checkpoint.id, checkpoint.state)

checkpoints = runta.checkpoints.list(include_system=True)
checkpoint = runta.checkpoints.get(checkpoint.id)

restored = runta.runtimes.create(
    "demo-restored",
    checkpoint_id=checkpoint.id,
)

runta.checkpoints.delete(checkpoint.id)