File: config_file.rst

package info (click to toggle)
python-softlayer 6.1.4-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 5,100 kB
  • sloc: python: 53,771; makefile: 289; sh: 57
file content (37 lines) | stat: -rw-r--r-- 1,083 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
.. _config_file:


Configuration File
==================
The SoftLayer API bindings load your settings from a number of different
locations.

* Input directly into SoftLayer.create_client_from_env(...)
* Enviorment variables (`SL_USERNAME`, `SL_API_KEY`)
* Config file locations (`~/.softlayer`, `/etc/softlayer.conf`)
* Or argument (`-C/path/to/config` or `--config=/path/to/config`)

The configuration file is INI-based and requires the `softlayer` section to be
present. The only required fields are `username` and `api_key`. You can
optionally supply the `endpoint_url` as well. This file is created
automatically by the `slcli setup` command detailed here:
:ref:`config_setup`.

*Config Example*
::

  [softlayer]
  username = username
  api_key = oyVmeipYQCNrjVS4rF9bHWV7D75S6pa1fghFl384v7mwRCbHTfuJ8qRORIqoVnha
  endpoint_url = https://api.softlayer.com/xmlrpc/v3/
  timeout = 40


*Cloud.ibm.com Config Example*
::

  [softlayer]
  username = apikey
  api_key = 123cNyhzg45Ab6789ADyzwR_2LAagNVbySgY73tAQOz1
  endpoint_url = https://api.softlayer.com/rest/v3.1/
  timeout = 40