Expand description
Rust SDK for the mountOS provider API.
Wraps the appserv provider API (/api/v1/*) with ED25519 JWT authentication.
Construct a Client from a Config and call typed methods grouped by
resource, e.g. client.accounts.list(..).
use mountos_admin_sdk::{Client, Config};
let client = Client::new(Config {
base_url: "https://appserv.example.com".into(),
private_key: "<base64 ED25519 key>".into(),
..Default::default()
})?;
let account = client.accounts.get(1).await?;
println!("{}", account.name);The private_key is a base64-encoded ED25519 key - either a 32-byte seed or
a 64-byte seed+public-key. JWT tokens are signed locally and cached for ~55
minutes (1h TTL with a 5-minute refresh margin).
Re-exports§
pub use serde_json;
Structs§
- Account
- Account
List Options - Accounts
Service - Operations on the
Accountsresource. - AddUser
Request - Alert
Count Response - Alert
List Options - Alerts
Service - Operations on the
Alertsresource. - Audit
Log - Audit
LogList Options - Audit
Logs Service - Operations on the
AuditLogsresource. - Block
Member - Block
Volume - Bulk
User Request - Bulk
User Response - Client
- mountOS Admin API client. Construct with
Client::new. - Client
Session - Client
Session List Options - Client
Sessions Service - Operations on the
ClientSessionsresource. - Cluster
List Options - Clusters
Service - Operations on the
Clustersresource. - Config
- Client configuration.
- Create
Account Request - Create
Region Cluster Request - Create
Region Request - Create
Storage Request - Create
Storage Response - Create
Volume Fork Request - Create
Volume Request - Create
Volume Response - Cursor
Paginated Response - Cursor-based list response.
- Dashboard
Service - Operations on the
Dashboardresource. - Dashboard
Stats - Dashboard
User - Deactivate
Volume Request - Delete
Fork Volume Response - Delete
Volume Fork Request - Discover
Endpoint - Discover
Meta Response - Discover
Service - Operations on the
Discoverresource. - Edit
Account Request - Edit
Region Cluster Request - Edit
Region Request - Edit
Storage Request - Edit
User Request - Edit
Volume Request - Fork
- Fork
Entry Detail - Fork
Entry Version - Fork
Tree Entry - Fork
Tree Match - GenerateAPI
Keys Volume Response - Generate
VolumeAPI Keys Request - IdResponse
- Identifier returned by create/edit/toggle endpoints.
- License
Details - License
Quota - License
Service - Operations on the
Licenseresource. - License
Terms - List
Options - Page-based pagination options.
- Move
Cluster Volume Response - Move
Volume Cluster Request - Nodes
Service - Operations on the
Nodesresource. - Paginated
Response - Page-based list response.
- Pagination
Meta - Pagination metadata returned by page-based list endpoints.
- Ref
- Region
- Region
Alert - Region
Alert List Options - Region
Alerts Service - Operations on the
RegionAlertsresource. - Region
Audit LogList Options - Region
Audit Logs Service - Operations on the
RegionAuditLogsresource. - Region
Cluster - Region
Cluster List Options - Region
Clusters Service - Operations on the
RegionClustersresource. - Region
List Options - Region
Volume Metrics - Regions
Service - Operations on the
Regionsresource. - Restore
Volume Fork Request - Revoke
VolumeAPI KeyRequest - Revoke
VolumeAPI Keys ByUser Request - Service
Alert - Service
Node - Service
Nodes Service - Operations on the
ServiceNodesresource. - Session
Summary - Session
Summary Facet - Session
Summary Status Entry - SetReady
Region Cluster Response - SetRegion
Cluster Ready Request - Size
History Volume Response - Stats
Volume Response - Storage
- Storage
List Options - Storages
Service - Operations on the
Storagesresource. - Test
Bucket Storage Response - Test
Storage Bucket Request - Test
Storage Bucket Storage Response - Update
Account Quota Request - Update
Volume Quota Request - User
- User
List Options - User
Lite - Users
Service - Operations on the
Usersresource. - Vault
Service - Operations on the
Vaultresource. - Volume
- Volume
Fork Entries Service - Operations on the
VolumeForkEntriesresource. - Volume
Fork Entry List Options - Volume
Fork Search List Options - Volume
Fork Searches Service - Operations on the
VolumeForkSearchesresource. - Volume
Fork Tree List Options - Volume
Fork Trees Service - Operations on the
VolumeForkTreesresource. - Volume
List Options - Volume
Ref - Volume
Size Point - Volumes
Service - Operations on the
Volumesresource.
Enums§
- Error
- An error from the mountOS Admin API or the transport beneath it.
Constants§
- CLIENT_
SESSION_ STATUS_ ACTIVE - CLIENT_
SESSION_ STATUS_ CONNECTED - CLIENT_
SESSION_ STATUS_ DISCONNECTED - CLIENT_
SESSION_ STATUS_ EXPIRED - CLIENT_
SESSION_ STATUS_ UNHEALTHY - CLIENT_
SESSION_ STATUS_ UNKNOWN - LICENSE_
QUOTA_ STATE_ EXCEEDED - LICENSE_
QUOTA_ STATE_ OK - LICENSE_
STATUS_ EXPIRED - LICENSE_
STATUS_ EXPIRED_ ACCESS - LICENSE_
STATUS_ EXPIRING - LICENSE_
STATUS_ GRACE - LICENSE_
STATUS_ VALID - PROVIDER_
TYPE_ AZURE - PROVIDER_
TYPE_ BACKBLAZE - PROVIDER_
TYPE_ CLOUDFLARE - PROVIDER_
TYPE_ DIGITAL_ OCEAN - PROVIDER_
TYPE_ IBM_ CLOUD - PROVIDER_
TYPE_ IMPOSSIBLE_ CLOUD - PROVIDER_
TYPE_ LYVE - PROVIDER_
TYPE_ MOUNTOS - PROVIDER_
TYPE_ S3 - PROVIDER_
TYPE_ S3_ COMPATIBLE - PROVIDER_
TYPE_ WASABI
Functions§
- sign_
dashboard_ user - Produces the signed
X-MountOS-Dashboard-Userheader value, stampingexpat now + 10 minutes.hmac_secretis the dedicated dashboard-user HMAC secret shared with appserv (DASHBOARD_USER_HMAC_KEY), never the public verification key.
Type Aliases§
- Client
Session Status ClientSessionStatusvalues accepted/returned on the wire.- License
Quota State LicenseQuotaStatevalues accepted/returned on the wire.- License
Status LicenseStatusvalues accepted/returned on the wire.