Skip to main content

CLI for Linode API v4

Project description

linode-cli
==========

A reimplementation of the `Linode CLI`_ using the `Python Library`_ and
`API V4`_.

Installation
------------
::

pip3 install linode-cli

Building from Source
-------------------

To build this package from source:

- Clone this repository.
- ``python3 setup.py install``

Usage
-----

While the Linode API V4 is in beta, this package installs the command
``linode-beta``.

When running the CLI for the first time, configure it by running
``linode-beta configure``. This will prompt for for your API V4
personal access token and some defaults.

This is intended to be used like the existing Linode CLI, and you can
use `the existing CLI docs`_ for reference.

In addition, the following commands have been added:

- ``linode-beta event list`` - lists recent Events
- ``linode-beta event seen`` - marks all Events as seen
- ``linode-beta backups-show LINODE`` - show backups for a Linode
- ``linode-beta snapshot LINODE`` - create a snapshot of a Linode
- ``linode-beta backups-restore LINODE BACKUPID -l TARGET -f`` - restore a backup
- ``linode-beta backups-enable LINODE`` - enable backups for a Linode
- ``linode-beta backups-cancel LINODE`` - cancel backups for a Linode
- ``linode-beta ticket list`` - list tickets open on your account
- ``linode-beta ticket show TICKETID`` - show a ticket and its replies

Examples
--------

List all linodes and their status:

``linode-beta list``

Create a new Linode with a root password of "hunter7" and label "cli-test-1"
in your default region with your default type:

``linode-beta create -P hunter7 -l cli-test-1``

Shut down your new linode:

``linode-beta stop cli-test-1``

Show a Linode's Backups:

``linode-beta backups-show cli-test-1``

List your domains:

``linode-beta domain list``

Show recent events:

``linode-beta event list``

Show open tickets:

``linode-beta ticket list``

.. _API v4: https://developers.linode.com
.. _Linode CLI: https://linode.com/cli
.. _Python Library: https://github.com/linode/python-linode-api
.. _the existing CLI docs: https://www.linode.com/docs/platform/linode-cli#using-the-cli


Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

linode_cli-1.0.3b4-py3-none-any.whl (21.3 kB view details)

Uploaded Python 3

File details

Details for the file linode_cli-1.0.3b4-py3-none-any.whl.

File metadata

File hashes

Hashes for linode_cli-1.0.3b4-py3-none-any.whl
Algorithm Hash digest
SHA256 0fbc9d7a6009f59caacf3c0dbb55c778c0e66dd6fe359a57a6433c709e6ddf7c
MD5 d5b39a6c5b82edcc7b32d28e54cb227e
BLAKE2b-256 f4258a32fdd6c20ea668b8d8dbd5f0212caca05db52d3d326b9fdc28bb4f03bb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page