lbcli list servers

AI Tools

List of servers resources.

lbcli list servers [flags]

Examples:

# List all servers in yaml format: lbcli -J $JWT list servers --output-format=yaml

Flag

Short

Type

Default

Description


--uuid


string


The UUID of the server.


--name


string


Server name.


--riskOfServiceLossState


string

“None”

Indicates if disabling a server will cause a service loss for some volume.


--help

-h

bool


Help for servers.


This command returns the following fields for each server. The default output format is human-readable. The human-readable output only shows some of these fields. The json/yaml output format is also supported and includes additional fields.

The fields in bold below will be returned by the human-readable output.

Field

Type

Description

Name

string

The server name.

ID

integer

Server ID.

Risk Of Service Loss State

string

Indicates if disabling a server will cause a service loss for some volume.

State

string

Enable/Disable status of the server.

LightOS Version

string

The current Lightbits version.

Upgrade Status

string

Upgrade status of the specific server (only in json/yaml format).

ApiEndpoints

list of strings

List of API endpoints exposed on this server (only in json/yaml format).

Server End Points

list of strings

List of server control endpoints URIs; i.e., http://192.168.80.14:2379 (only in json/yaml format)

Etag

String

For internal use (only in json/yaml format).

NodesUUIDs

list of strings

List of Lightbits nodes (identified by UUID) running over this server (only in json/yaml format).

LastUpgrade/Status

string

3.3.1 and above

Current status of the upgrade. The possible values are:

  • None

  • Upgrading

  • Rebooting

  • Recovering

  • UpgradeFailed

For a healthy upgrade flow, the upgrade should cycle through these statuses:

None > Upgrading > Rebooting > Recovering > None

LastUpgrade/StartTime

timestamp

Start time of the upgrade on this server.

LastUpgrade/EndTime

timestamp

End time of the upgrade on this server.

LastUpgrade/TargetVersion

string

Lighbits version the server is being upgraded to.

LastUpgrade/ErrorMessage

string

Detailed error message if the upgrade operation failed.

Note: ErrorMessage is limited to 40 characters, so in some cases long error messages will be concatenated.

LastUpgrade/ProgressStep

int

Progress of the upgrade operation.

LastUpgrade/ProgressTotal

int

The total steps in the upgrade operation.

Note

All upgrade information is structured into LastUpgrade. This will return either the information for a current ongoing upgrade, or if not, the upgrade in process will return information for the last upgrade that was run over this server.


On This Page
lbcli list servers