Struct ngrok_api::tunnel_sessions::Client

pub struct Client { /* private fields */ }

Tunnel Sessions represent instances of ngrok agents or SSH reverse tunnel sessions that are running and connected to the ngrok service. Each tunnel session can include one or more Tunnels.

Implementations

impl Client

pub fn new(c: Client) -> Self

pub fn list(&self, req: Paging) -> List

List all online tunnel sessions running on this account.

pub async fn get(&self, id: &str) -> Result<TunnelSession, Error>

Get the detailed status of a tunnel session by ID

pub async fn restart(&self, id: &str) -> Result<(), Error>

Issues a command instructing the ngrok agent to restart. The agent restarts itself by calling exec() on platforms that support it. This operation is notably not supported on Windows. When an agent restarts, it reconnects with a new tunnel session ID.

pub async fn stop(&self, id: &str) -> Result<(), Error>

Issues a command instructing the ngrok agent that started this tunnel session to exit.

pub async fn update(&self, id: &str) -> Result<(), Error>

Issues a command instructing the ngrok agent to update itself to the latest version. After this call completes successfully, the ngrok agent will be in the update process. A caller should wait some amount of time to allow the update to complete (at least 10 seconds) before making a call to the Restart endpoint to request that the agent restart itself to start using the new code. This call will never update an ngrok agent to a new major version which could cause breaking compatibility issues. If you wish to update to a new major version, that must be done manually. Still, please be aware that updating your ngrok agent could break your integration. This call will fail in any of the following circumstances: there is no update available the ngrok agent’s configuration disabled update checks the agent is currently in process of updating the agent has already successfully updated but has not yet been restarted

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Client

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.