Struct FlyioClient 

pub struct FlyioClient { /* private fields */ }

Fly.io API client for managing deployments

Implementations

impl FlyioClient

pub fn new(api_token: String) -> Self

pub fn api_token(&self) -> &str

Get the API token (used for Fly.io registry auth)

pub async fn create_app( &self, app_name: &str, org_slug: &str, ) -> Result<FlyioApp>

Create a new Fly.io app

pub async fn create_machine( &self, app_name: &str, config: FlyioMachineConfig, region: &str, registry_auth: Option<FlyioRegistryAuth>, ) -> Result<FlyioMachine>

Create a machine (instance) for the app

pub async fn update_machine( &self, app_name: &str, machine_id: &str, config: FlyioMachineConfig, registry_auth: Option<FlyioRegistryAuth>, ) -> Result<FlyioMachine>

Update a machine’s configuration (image, env vars, etc.)

pub async fn get_machine( &self, app_name: &str, machine_id: &str, ) -> Result<FlyioMachine>

Get machine status

pub async fn stop_machine(&self, app_name: &str, machine_id: &str) -> Result<()>

Stop a running machine (graceful shutdown, keeps the machine around so it can be restarted later without recreating its config).

pub async fn start_machine( &self, app_name: &str, machine_id: &str, ) -> Result<()>

Start a stopped machine.

pub async fn delete_machine( &self, app_name: &str, machine_id: &str, ) -> Result<()>

Delete a machine

pub async fn delete_app(&self, app_name: &str) -> Result<()>

Delete a Fly.io app

pub async fn allocate_ips(&self, app_name: &str) -> Result<()>

Allocate a shared IPv4 and a dedicated IPv6 address for an app

pub async fn get_app(&self, app_name: &str) -> Result<FlyioApp>

Get app info

pub async fn add_certificate( &self, app_name: &str, hostname: &str, ) -> Result<()>

Add a custom domain certificate to an app

This tells Fly.io to provision a Let’s Encrypt TLS certificate for the given hostname and route traffic for that hostname to this app via SNI.

pub async fn delete_certificate( &self, app_name: &str, hostname: &str, ) -> Result<()>

Remove a custom domain certificate from an app

pub async fn list_machines(&self, app_name: &str) -> Result<Vec<FlyioMachine>>

List machines for an app