Server Information Structure¶

A Server Information structure is returned from getServerInfo().

allowRemoteControl: This indicates whether the server accepts API connections from remote hosts. If this is false, API connections are only accepted from localhost.
apiControlPort: The port number on which the server will accept API connections.
APITokensAvailable: This indicates whether the server supports creation and use of API tokens. See createAPIToken().
apiVersion: The API compatibility version for the connected server. API methods are aware of the server version required, and will report an error if the API versions do not match.
authRequired: This indicates whether this server requires authentication for API connections. If True then you must call either auth() or authAsync() after calling connect().
bandwidthLimits: Server Bandwidth Limits Structure
certificateValidation: Number of days remaining until SSL certificate expiry.
configuration: Server Configuration Structure. Note that this key only exists for superusers. See superuser().
encryptionAvailable: This indicates whether this server supports encrypted connections.
eventLogAvailable: This indicates whether the server’s event log is active. If active, the getEventLog command may be used to retrieve the server’s event history.
hostName: The name of the machine host that is running the server. This is different from the serverName, which is assigned to the JetStream server itself.
license: Server License Structure
minCipher: A server’s minimum supported transfer cipher.
multiplexAvailable: This indicates whether the same port number can be used for both the sending and receiving traffic. If multiplex is not supported, unique ports must be used for each.
publicKey: A server’s public key, used for encrypted connections.
receiver: Receiver Server Information Structure
revision: An integer representing revision (version) of the server.
serverExternalAddress: Hostname and port, as specified by the --external-address option at server start.
serverId: A string that uniquely identifies a server instance. This ID is regenerated every time a server is launched.
serverName: A friendly name assigned to a server.
serverPlatform: A string that represents the OS running the server. One of windows, linux, or macOS.
serverTime: A timestamp indicating the current time on this server. See Timestamps.
serverUid: A string that uniquely identifies a server. This ID is generated once, and stored in the server’s persistent state.
sharedTokensAvailable: This indicates whether the server supports creation and use of shared tokens. See createSharedToken().
user: Server User Structure
version: A string representing the version of the server.

Changed in version 1.5.0: Added version and revision keys.

Changed in version 1.6.0: Added bandwidthLimits.

Changed in version 1.7.0: Added certificateValidation.

Changed in version 2.4.0: Added APITokensAvailable.

Receiver Server Information Structure¶

A Receiver Server Information structure is returned as part of the Server Information Structure.

authRequired: True if the server required a username and password for transfers.
encryptionEnabled: True if the server has encryption enabled. If encryption is enabled, transfers can only be initiated to a server which also has encryption enabled.
onlyAuthorizedClientsAllowed: Indicates whether this receiving server allows only pre-authenticated clients. Clients may be pre-authenticated using the addAuthorizedClientAsync() command.
receiverIP: The IP for the receiver connection. An IP of 0.0.0.0 is a wildcard that means the server is listening for connections from any IP.
receiverPort: The port for the receiver connection.
relayIP: The IP for the relay server, if using a relay. Will be None if not using a relay.
relayPort: The port for the relay server, if using a relay. Will be None if not using a relay.
socketRecvBufferSize: The size of the buffer allocated for receiving data.
socketSendBufferSize: The size of the buffer allocated for sending data.

Server Bandwidth Limits Structure¶

A Bandwidth Limits structure is returned as part of the Server Information Structure.

borrowIncoming: If both incoming and outgoing rate limits are active, add unused incoming bandwidth to the outgoing rate limit.
borrowOutgoing: If both incoming and outgoing rate limits are active, add unused outgoing bandwidth to the incoming rate limit.
incomingLimitActive: Whether incoming limits are applied.
incomingMaxConnections: The maximum number of incoming connections.
incomingRateLimit: The maximum incoming data rate, in kilobits-per-second.
outgoingLimitActive: Whether outgoing limits are applied.
outgoingRateLimit: The maximum outgoing data rate, in kilobits-per-second.

Server Configuration Structure¶

A Configuration structure is returned as part of the Server Information Structure. It holds data about how the server is configured and is only available to a superuser. See superuser().

cloudFileCache: Cloud File Cache Structure
garbageCollect: Garbage Collection Structure
persistentStateDir: The path to which the server will save its encryption key files. If this directory is specified at launch, the server will provide a consistent public key for its encryption interfaces.
triggersAvailable: This indicates whether the server’s trigger system is active. If active, any triggers found in the triggersDir will be executed in response to their associated events.

Changed in version 1.8.0: Added fileCache and garbageCollect keys.

Changed in version 2.6.0: Renamed fileCache to cloudFileCache.

Cloud File Cache Structure¶

A Cloud File Cache structure is returned as part of the Server Configuration Structure. It holds the server’s cloud file cache information.

highWatermark: The size, in bytes, of memory allocated to cloud file cache.
maximumSize: Maximum size, in bytes, of the cloud file cache. This can be defined at server startup using --max-cloud-cache-size

Garbage Collection Structure¶

A Garbage Collection structure is returned as part of the Server Configuration Structure. It holds the server’s garbage collection configuration.

intervalSeconds: The time, in seconds, between each garbage collection.
timeLimitSeconds: The grace period, in seconds, to allow for items that are ready to be garbage collected.

Server License Structure¶

A License structure is returned as part of the Server Information Structure.

errorMessage: If a license is invalid, a message indicating the reason.
expiry: The date on which the JetStream license expires for this server.
valid: This indicates whether the license is currently valid (True) or invalid (False).

Server User Structure¶

A User structure is returned as part of the Server Information Structure.

authed: This indicates whether authentication has been performed on the current API connection.
permissions: Permissions granted to this user. See PERMISSIONS
sandboxed: This indicates whether the user is restricted to a sandbox directory, instead of full filesystem access. Returns None when not authenticated.
superuser: This indicates whether the authenticated user is a superuser. If not authenticated, this will be False.
token: The token of the currently authenticated user. If not authenticated or user name auth was used, this will be None.
tokenSession: The token session of the currently authenticated user. If not authenticated or user name auth was used, this will be None.
userName: The name of the currently authenticated user. If not authenticated or if token auth was used, this will be None.

Changed in version 1.5.0: Renamed username to userName.

Changed in version 2.4.0: Added permissions.