ambiser
/
ovh-api-bash-client
mirror of https://github.com/denouche/ovh-api-bash-client.git
9
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
A bash client for OVH API
21 Commits
2 Branches
0 Tags
91 KiB
Shell 99.3%
Makefile 0.7%
 
 
Go to file
Didier BONNEFOI 1a0e3f220f Allow multiple API keys management with profiles 
- add --profile to override default configuration location
- add --list-profile to display available profiles
- rework messages to display command with the current profile if set

Bugfix
- ensure OVH App Key an App Secret are defined when creating consumer key

Enhancements
- when using --init, allow override default "all permissions grants" if --data is set
- add -h/--help
 		2017-06-13 18:06:41 +02:00
.gitignore Allow multiple API keys management with profiles 2017-06-13 18:06:41 +02:00
Makefile first commit 2014-04-17 19:53:28 +02:00
README.md Allow multiple API keys management with profiles 2017-06-13 18:06:41 +02:00
ovh-api-bash-client.sh Allow multiple API keys management with profiles 2017-06-13 18:06:41 +02:00

README.md

ovh API Bash client

A bash client for OVH API (https://api.ovh.com/)

Initialize

Retrieve dependency

First in order to retrieve needed dependency, run:

    make

Create an OVH API Application

In order to create a new OVH API application, run:

    ./ovh-api-bash-client.sh --initApp

Create a Consumer Key

In order to create a new consumer key, run:

    ./ovh-api-bash-client.sh --init

Options

Show help

    ./ovh-api-bash-client.sh --help

Possible arguments are:

    --url <url>         : the API URL to call, for example /domains (default is /me)
    --method <method>   : the HTTP method to use, for example POST (default is GET)
    --data <JSON data>  : the data body to send with the request
    --target <CA|EU>    : the target API (default is EU)
    --init              : to initialize the consumer key
    --initApp           : to initialize the API application
    --profile <dir>     : load a configuration from profile/ directory, (override default location)
    --list-profile      : list available profiles in profile/ directory

Usage

Just some examples:

To make a basic call on GET /me just run:

    ./ovh-api-bash-client.sh

To retrieve your domain list, run:

    ./ovh-api-bash-client.sh --url "/domain"

To activate the monitoring on your dedicated server, run:

    ./ovh-api-bash-client.sh --method PUT --url "/dedicated/server/ns00000.ovh.net" --data '{"monitoring": true}'

create a Consumer key for different account or usage

    mkdir profile/demo1
    mkdir profile/demo2
    ./ovh-api-bash-client.sh --profile demo1 --init
    ./ovh-api-bash-client.sh --profile demo2 --init