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
==========
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
Close
Hashes for linode_cli-1.0.3b4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0fbc9d7a6009f59caacf3c0dbb55c778c0e66dd6fe359a57a6433c709e6ddf7c |
|
MD5 | d5b39a6c5b82edcc7b32d28e54cb227e |
|
BLAKE2b-256 | f4258a32fdd6c20ea668b8d8dbd5f0212caca05db52d3d326b9fdc28bb4f03bb |