linode-cli-account
Manage your Linode account
TLDR
View account
View account settings
Make a payment
View account notifications
SYNOPSIS
linode-cli account <subcommand> [options]
Common subcommands include:
linode-cli account view
linode-cli account view-billing
linode-cli account update [--email <email>] [--company <company>] ...
linode-cli account settings
linode-cli account users <action> [<user_id>]
linode-cli account events <action> [<event_id>]
PARAMETERS
view
Displays primary account information, such as your Linode ID, company name, address, and current balance.
view-billing
Provides detailed billing and payment method information, including credit card details (last 4 digits), current balance, and last payment amount.
update
Allows modification of various account contact and address details. This subcommand requires specific fields to be provided as options, such as --email, --company, --address_1, --city, --state, --zip, --country, and --phone.
settings
Shows current account-wide settings, such as the network_helper status, which determines if Network Helper is enabled by default for new Linodes.
users
Manages Linode users associated with the account. This subcommand acts as a group for its own sub-actions like list (to view all users), view (to see details of a specific user), create, update, and delete for comprehensive user management.
events
Lists a chronological history of account-level events and activities, such as Linode deployments, reboots, or user logins. Similar to users, this subcommand provides sub-actions like list (to view all events) and view (for details of a specific event).
DESCRIPTION
The linode-cli account subcommand group provides a comprehensive interface for viewing and managing various aspects of your Linode account. It allows users to retrieve general account details, billing information, current account settings, and manage account-level users. This group of commands is essential for administrators and users who need to monitor usage, review invoices, update contact information, or control user access within their Linode infrastructure directly from the command line, offering a quick alternative to the Linode Cloud Manager web interface.
CAVEATS
Caveats:
Requires a configured Linode CLI with an API token for authentication.
The update subcommand fields (e.g., --email, --company, --address_1) must be provided explicitly to modify account details; attempting to update without specifying a field will have no effect on that field.
view-billing displays sensitive information, including the last four digits of your credit card. Ensure your terminal environment is secure.
Frequent requests may be subject to Linode API rate limits, which can temporarily block further commands.
GLOBAL OPTIONS
The linode-cli supports various global options that apply to all subcommands, including those under account. These options control output formatting and general CLI behavior. Common global options include:
--json: Outputs data in JSON format.
--text: Outputs data in human-readable plain text format (default).
--delimiter <char>: Specifies a character to delimit columns in text output.
--no-headers: Suppresses column headers in text output.
--format <columns>: Specifies which columns to display in text output (e.g., --format "id,label,status").
--help or -h: Displays a help message for the command or subcommand.
AUTHENTICATION
The Linode CLI requires an API token for authentication. This token can be configured using the linode-cli configure command, which guides you through the setup process, or by setting the LINODE_CLI_TOKEN environment variable in your shell environment.
API VERSION
The linode-cli interacts with the Linode API v4, ensuring compatibility with the latest Linode services and features. This allows users to manage their resources using the most up-to-date API capabilities.
HISTORY
The Linode CLI has evolved significantly since its initial release, moving from a basic Python script to a more robust and modular tool. The account subcommand group has been a core component since early versions, providing essential access to account-level data. Its functionality has expanded to include more specific details (e.g., billing information via view-billing) and direct management capabilities (e.g., user management directly under account users), mirroring the growth and capabilities of the Linode API itself and ensuring comprehensive command-line control over Linode services.
SEE ALSO
linode-cli(1), linode-cli linodes(1), linode-cli domains(1), linode-cli account users