root / snf-astakos-app / astakos / im / templates / im / api_access_base.html @ 82db931d
History | View | Annotate | Download (5 kB)
1 |
{% extends "im/account_base.html" %} |
---|---|
2 |
{% load filters %} |
3 |
|
4 |
{% block page.body %} |
5 |
<div class="api-access-view"> |
6 |
<div class="subsection"> |
7 |
{% block page.body.title %} |
8 |
<h2>API ACCESS</h2> |
9 |
{% endblock %} |
10 |
{% block page.body.description %} |
11 |
<div class="two-cols dotted clearfix"> |
12 |
<div class="rt"> |
13 |
<p>
|
14 |
If |
15 |
you want to learn more about the specification of the REST API itself, |
16 |
please take a look at the <a href="https://www.synnefo.org/docs" |
17 |
alt="Synnefo documentation">Synnefo documentation</a>. |
18 |
</p>
|
19 |
</div>
|
20 |
<div class="lt"> |
21 |
<p>{{ BRANDING_SERVICE_NAME }} provides a complete REST API that allows you to access and
|
22 |
control your virtual resources programmatically. This means you can execute |
23 |
all the actions you do from the {{ BRANDING_SERVICE_NAME }} Web UI by using a command |
24 |
line client or importing the corresponding library inside your own code.</p>
|
25 |
</div>
|
26 |
|
27 |
</div>
|
28 |
|
29 |
{% endblock %} |
30 |
</div>
|
31 |
|
32 |
<div class="subsection dotted"> |
33 |
{% block page.body.token %} |
34 |
<h2>API details</h2> |
35 |
<p>
|
36 |
To use {{ BRANDING_SERVICE_NAME }} via its REST API the only things you will need is your |
37 |
Authentication Token and the Identity Service's public URL, which you can |
38 |
find right below.<br /><br /> |
39 |
</p>
|
40 |
<div class="token-view"> |
41 |
<div class="detail small clearfix"> |
42 |
<span class="title">Authentication url</span> |
43 |
<input type="text" value="{{ token_url }}" disabled |
44 |
</div |
45 |
<div ="detail "> |
46 |
<div class="facts"> |
47 |
<span class="title">API Token</span> |
48 |
<input type="text" value="{{ request.user.auth_token }}" disabled |
49 |
<span ="expires"> |
50 |
<span class="date"> |
51 |
expires in {{ request.user.auth_token_expires|timeuntil }} |
52 |
({{ request.user.auth_token_expires|date }}) |
53 |
</span>
|
54 |
</span>
|
55 |
</div>
|
56 |
<div class="actions"> |
57 |
<div class="renew-token"> |
58 |
<a href="#" class="do">renew token</a> |
59 |
<a href="#" class="confirm">confirm</a> |
60 |
<a href="#" class="close">x</a> |
61 |
<p class="sub">Make sure to set the new token in any clientyou may be using each |
62 |
time you renew your token.</p>
|
63 |
</div>
|
64 |
</div>
|
65 |
|
66 |
|
67 |
<span class="extra-img" id="token-span"> </span> |
68 |
</div>
|
69 |
|
70 |
</div>
|
71 |
{% endblock %} |
72 |
</div>
|
73 |
|
74 |
|
75 |
|
76 |
<div class="two-cols dotted clearfix"> |
77 |
<div class="rt"> |
78 |
{% block page.body.api_advanced %} |
79 |
<h2>API Advanced Usage</h2> |
80 |
<p>
|
81 |
Apart from using the kamaki command line client, you can also import the |
82 |
kamaki library inside your code and use it directly. More details on how |
83 |
to do that on the corresponding kamaki |
84 |
<a href="{{ client_url }}">kamaki </a>page.</p> |
85 |
<p>You can also implement the REST API calls by yourself, without
|
86 |
using the official kamaki library if you feel confident with your |
87 |
programming skills. To do so, you first need to get a good grasp of the |
88 |
API itself; for more information take a look at the corresponding page |
89 |
inside the |
90 |
<a href="https://synnefo.org/docs/">Synnefo documentation</a>. |
91 |
</p>
|
92 |
{% endblock %} |
93 |
</div>
|
94 |
<div class="lt"> |
95 |
{% block page.body.clients %} |
96 |
<h2>Kamaki</h2> |
97 |
<p><a href="{{ client_url }}" alt="kamaki">Kamaki</a> is the official |
98 |
{{ BRANDING_SERVICE_NAME }} command line client. You can use it to control your virtual |
99 |
resources from the command line or use it inside your scripts.</p>
|
100 |
<p>Kamaki allows you to execute all the operations you do from the Web UI. You can use kamaki to<br><br> |
101 |
- register images,<br>- spawn clusters of customized VMs,<br>- connect them to |
102 |
Private Virtual Networks,<br>- have them executing computations dynamically and
|
103 |
many other neat things.</p>
|
104 |
<p> Kamaki is available for most Linux distributions,
|
105 |
Windows and Mac OS X. To use it you will need to set it up using your |
106 |
Authentication Token and the Identity Service's public URL, found above. To |
107 |
learn more about kamaki and how to install, configure and use, take a look |
108 |
at its <a href="http://www.synnefo.org/docs/kamaki/latest/index.html">corresponding page</a> |
109 |
</p>
|
110 |
<p class="download">You can download kamaki |
111 |
from the <a href="{{ client_url }}">project homepage</a></p> |
112 |
|
113 |
</div>
|
114 |
{% endblock %} |
115 |
</div>
|
116 |
</div>
|
117 |
{% endblock %} |