If you prefer to follow a video tutorial, check out this short video on how to get started.
avn client is an ideal way to use Aiven’s services in a scriptable way. This tool accesses the same API that powers the web console.
avn utility is a Python package, so you can install using
pip install aiven-client
Check your install by running
avn and looking for usage output.
There are two options for authenticating. The first is to use your username, and then enter your password when prompted:
avn user login <email@example.com>
For security reasons, it is recommended to use an access token, especially if you use SSO. You can use a command like:
avn user login <firstname.lastname@example.org> --token
To learn how to create an authentication token refer to Create an authentication token
This command will prompt you for a token rather than a password.
Top-level commands for the Aiven CLI are listed here, along with some information about the features found in each section.
Handle the accounts you have access to, and also configure the teams for the accounts.
Find more info on the help article about Accounts, Teams, Members and Roles
A set of administrative commands to set up billing groups and manage which projects should be linked to which billing group. Find more information in the User Guide for Billing Groups.
The billing group command also enables access to the credit code features, and detailed invoice line data.
Manage the payment cards on your account.
avn cloud list to see all the currently-available clouds on Aiven. This is useful for looking up the cloud name to use with
Claim or view the history of credit codes.
Inspect the events on your account such as the services created/deleted, and which users triggered each event.
Detailed help on using the CLI.
Manage the replication flows for Apache Kafka® MirrorMaker 2.
Manage all the projects on your Aiven account, and switch which one is the default option for
avn commands. Manage project invitations for all users.
Download the CA cert for this project (CA certs are common for all services in a project).
The kitchen sink! All the commands specific to a service are available here.
Create or list tickets. An alternative support ticket interface to either email or the chat widget found on our web console.
Log in/out and manage your user tokens here. You can also create other users.
Manage your VPC configuration including user/peer networks.
--json switch to any command to get more information, in a JSON format.