Bare simple Command Line Interface (CLI) for OVH.
>>> ./ovh-eu domain Last update Domain Name server type Offer Transfer lock status Owo supported ------------------------- ------------------ ------------------ -------- ---------------------- --------------- 2014-04-15T10:44:32+02:00 yadutaf.net hosted gold locked True 2014-04-15T10:41:06+02:00 yadutaf.eu hosted gold locked False 2014-04-15T10:41:06+02:00 yadutaf.fr hosted gold locked False 2014-04-15T10:44:32+02:00 yadutaf.org hosted gold locked True 2014-04-15T10:44:26+02:00 yadutaf.com hosted gold locked True
- FULL OVH-EU, OVH-CA, RunAbove-ca API support
- does not require any password
- pretty printing, as you would expect (tables, list, graphs, ...)
- ... but raw json output is still available
Even though this is quite feature complete, this code is still an alpha hence
it is only available via git clone for now.
Get the code:
git clone https://github.com/yadutaf/ovh-cli
cd ovh-cli
# optional, but highly encouraged. See http://virtualenvwrapper.readthedocs.org for more informations
# mkvirtualenv ovh-cli
pip install -r requirements.txtovh-cli is designed to interact with your account in a secure way. As such,
it will never ask you for a password. Instead, it fully relies on OVH's API
authentication mechanism.
Depending on the API you plan to use, you may use one of these URLs to grant full script access to your account. Feel free to restrict accesses permissions as required by your usage for a better security!
For Runabove, you may use included create-consumer-key.py runabove-ca to generate your consumer key.
Then you should put your credentials in ~/.ovh.conf like:
[ovh-eu]
; configuration specific to 'ovh-eu' endpoint
; other supported endpoints includes 'ovh-ca' and 'runabove-ca'
application_key=my_app_key
application_secret=my_application_secret
consumer_key=my_consumer_keyFor more informations on configuration mechanism, please visit: https://github.com/ovh/python-ovh/blob/master/README.rst#configuration
Depending on the API you will use, you may want to try:
./ovh-eu --help./ovh-ca --help./runabove-ca --help
Provided that necessary keys were installed.
>>> ./ovh-eu me # this is a shotcut for './ovh-eu me list' -------------------------------------- ---------------------- Sex male Legalform individual Ovh company ovh City Paris Zip 75001 Area Organisation State complete Company national identification number None Email [email protected] Vat Spare email None Fax Firstname Jean-Tiare Phone +33.123456789 Birth city Address 12, Open Source Street Corporation type National identification number None Name LE BIGOT Language fr_FR Ovh subsidiary FR Country FR Nichandle ab12345-ovh Birth day -------------------------------------- ----------------------
>>> ./ovh-eu me --help
Method 'me': Details about your OVH identifier
Actions:
update Alter this object properties
show Get this object properties (default)
Methods:
refund List the billing.Refund objects
ovh-account List the billing.OvhAccount objects
access-restriction
password-recover Request a password recover
bill List the billing.Bill objects
payment-mean
ip-organisation List the nichandle.Ipv4Org objects
order List the billing.Order objects
subscription List the nichandle.Subscription objects
api
ipxe-script List the nichandle.ipxe objects
installation-template List the dedicated.installationTemplate.Templates objects
ssh-key List the nichandle.sshKey objects
change-password changePassword operations
agreements List the agreements.ContractAgreement objects
>>> ./ovh-eu xdsl xdsl-ab12345-1 ips ID Reverse Ip Range Version Dns list Monitoring enabled --------------------- ------------------ --------------------- ------- --------- ----------------------------------------------- -------------------- 2001:41d0:xxxx:xx00:: 2001:41d0:xxxx:xx00:: 56 v6 2001:41 d0:1:e2 b8::1, 2001:41 d0:3:163::1 False 109.190.xxx.xxx home.my-domain.fr. 109.190.xxx.xxx 32 v4 91.121.161.184, 91.121.164.227, 188.165.197.144 True
List declared applications:
>>> ./ovh-eu me api application status applicationKey applicationId name description -------- ---------------- --------------- ------------ ----------------------- active xxxxxxxxxxxxxxxx 1234 batchDomains batch domain operations active yyyyyyyyyyyyyyyy 5678 console console
Delete an application: (all users will loose access)
>>> ./ovh-eu me api application 1234 delete Success >>> ./ovh-eu me api application 1234 delete The requested object (id = 1234) does not exist
The same logic works exactly identically for "credentials". Credentials are access granted to your account to third party applications.
>>> ./ovh-eu xdsl xdsl-lj75593-1 statistics --period daily --type traffic:download 19/09/2014 16:10 0.026 Mbps | 19/09/2014 16:50 0.027 Mbps | 19/09/2014 17:30 0.027 Mbps | 19/09/2014 18:10 0.026 Mbps | 19/09/2014 18:50 0.026 Mbps | 19/09/2014 19:30 0.022 Mbps | 19/09/2014 20:10 0.021 Mbps | 19/09/2014 20:50 0.021 Mbps | 19/09/2014 21:30 0.021 Mbps | 19/09/2014 22:10 0.021 Mbps | 19/09/2014 22:50 0.021 Mbps | 19/09/2014 23:30 0.021 Mbps | 20/09/2014 00:10 0.480 Mbps | ............... 20/09/2014 00:50 0.308 Mbps | ......... 20/09/2014 01:30 0.477 Mbps | ............... 20/09/2014 02:10 0.029 Mbps | 20/09/2014 02:50 0.051 Mbps | . 20/09/2014 03:30 0.036 Mbps | . 20/09/2014 04:10 0.022 Mbps | 20/09/2014 04:50 0.023 Mbps | 20/09/2014 05:30 0.023 Mbps | 20/09/2014 06:10 0.025 Mbps | 20/09/2014 06:50 0.027 Mbps | 20/09/2014 07:30 0.030 Mbps | 20/09/2014 08:10 0.030 Mbps | 20/09/2014 08:50 0.040 Mbps | . 20/09/2014 09:30 0.032 Mbps | . 20/09/2014 10:10 0.161 Mbps | ..... 20/09/2014 10:50 0.484 Mbps | ............... 20/09/2014 11:30 0.550 Mbps | ................. 20/09/2014 12:10 0.559 Mbps | ................. 20/09/2014 12:50 0.303 Mbps | ......... 20/09/2014 13:30 0.858 Mbps | ........................... 20/09/2014 14:10 0.854 Mbps | .......................... 20/09/2014 14:50 1.011 Mbps | ............................... 20/09/2014 15:30 0.889 Mbps | ............................ 20/09/2014 16:10 0.125 Mbps | ... 20/09/2014 16:50 0.605 Mbps | ................... 20/09/2014 17:30 0.924 Mbps | ............................. 20/09/2014 18:10 0.769 Mbps | ........................ 20/09/2014 18:50 0.842 Mbps | .......................... 20/09/2014 19:30 0.733 Mbps | ....................... 20/09/2014 20:10 0.942 Mbps | ............................. 20/09/2014 20:50 0.780 Mbps | ........................ 20/09/2014 21:30 0.607 Mbps | ................... 20/09/2014 22:10 0.641 Mbps | .................... 20/09/2014 22:50 0.867 Mbps | ........................... 20/09/2014 23:25 0.896 Mbps | ............................
... and so on. Feel free to explore using the 'console' (see below) or the almighty '--help'!
- Documentation: https://eu.api.ovh.com/
- Community support: [email protected]
- Console: https://eu.api.ovh.com/console
- Create application credentials: https://eu.api.ovh.com/createApp/
- Create script credentials (all keys at once): https://eu.api.ovh.com/createToken/
- Documentation: https://ca.api.ovh.com/
- Community support: [email protected]
- Console: https://ca.api.ovh.com/console
- Create application credentials: https://ca.api.ovh.com/createApp/
- Create script credentials (all keys at once): https://ca.api.ovh.com/createToken/
- Documentation: https://eu.api.soyoustart.com/
- Community support: [email protected]
- Console: https://eu.api.soyoustart.com/console/
- Create application credentials: https://eu.api.soyoustart.com/createApp/
- Create script credentials (all keys at once): https://eu.api.soyoustart.com/createToken/
- Documentation: https://ca.api.soyoustart.com/
- Community support: [email protected]
- Console: https://ca.api.soyoustart.com/console/
- Create application credentials: https://ca.api.soyoustart.com/createApp/
- Create script credentials (all keys at once): https://ca.api.soyoustart.com/createToken/
- Documentation: https://eu.api.kimsufi.com/
- Community support: [email protected]
- Console: https://eu.api.kimsufi.com/console/
- Create application credentials: https://eu.api.kimsufi.com/createApp/
- Create script credentials (all keys at once): https://eu.api.kimsufi.com/createToken/
- Documentation: https://ca.api.kimsufi.com/
- Community support: [email protected]
- Console: https://ca.api.kimsufi.com/console/
- Create application credentials: https://ca.api.kimsufi.com/createApp/
- Create script credentials (all keys at once): https://ca.api.kimsufi.com/createToken/
- Community support: https://community.runabove.com/
- Console: https://api.runabove.com/console/
- Create application credentials: https://api.runabove.com/createApp/
- High level SDK: https://github.com/runabove/python-runabove
- Create script credentials (all keys at once): https://api.runabove.com/createToken/
- OVH official SDK: https://github.com/ovh/python-ovh
- contribute: https://github.com/yadutaf/ovh-cli
- Report bugs: https://github.com/yadutaf/ovh-cli/issues