Différences entre versions de « Comment utiliser l'API Cloud Privé d’Ikoula »
m |
m |
||
| Ligne 89 : | Ligne 89 : | ||
[[Category:cloud public]] | [[Category:cloud public]] | ||
| + | [[Category:cloud privé]] | ||
[[Category:API cloudstack]] | [[Category:API cloudstack]] | ||
[[Category:cloudstack]] | [[Category:cloudstack]] | ||
<br /> | <br /> | ||
<comments /> | <comments /> | ||
Version du 3 novembre 2015 à 17:52
ro:Cum să utilizaţi nor Ikoula privat API ru:Как использовать API частных облачных Ikoula pl:Jak korzystać z interfejsu API prywatne Cloud Ikoula ja:クラウド Ikoula 専用 API を使用する方法 ar:كيفية استخدام API الخاصة "عكلة سحابة" zh:如何使用云 Ikoula 私有 API de:Wie Sie die private Cloud Ikoula-API verwenden nl:Hoe de wolk Ikoula privé API kunt gebruiken it:Come utilizzare l'API privata Cloud Ikoula pt:Como usar a API de Ikoula de nuvem privada es:Cómo utilizar la API privada de nube Ikoula en:How to use the Cloud Ikoula private API
Lors de votre inscription au service cloud privé d’ikoula, vous avez reçu un mail avec une clé d'API et une clé secrète.
Ces informations vous permettrons de vous connecter à l'API cloud privé d’ikoula.
URL API : https://cloudstack.ikoula.com/client/api
Les spécifications de l'API administrateur de domaine et utilisateur sont respectivement :
- Admin : http://cloudstack.apache.org/docs/api/apidocs-4.2/TOC_Domain_Admin.html
- User : http://cloudstack.apache.org/docs/api/apidocs-4.2/TOC_User.html
Pour l'utililsation de l'API, il faut :
- Votre clé d'API
- Votre clé secréte
- Envoyer les requêtes sur "https://cloudstack.ikoula.com/client/api" avec une méthode du protocole HTTP
- Traiter les retours XML ou JSON (au choix)
Exemple de requete a l'API utilisant la methode GET :
1https://cloudstack.ikoula.com/client/api/
2 ?command=deployVirtualMachine
3 &serviceOfferingId=1
4 &diskOfferingId=1
5 &templateId=2
6 &zoneId=4
7 &apiKey=miVr6X7u6bN_EJTVwZ0nUkkJbPmY3y2bciKwFQ
8 &signature=Lxx1DM40AjcXU%2FcaiK8RAP0O1hU%3D
- La ligne 1 correspond au point de d’entrée (le lien vers l'API cloud privé d’ikoula)
- La ligne 2 correspond a la commande a envoyer, ici on veut crée une nouvelle VM
- La ligne 3-6 correspondent aux différents paramètres de la commande. Vous pouvez rajouter le champs "response" qui définie le format de retour avec le paramètre (XML/JSON)
- La ligne 7 contient votre clé d'API (Ici est une clé d'exemple invalide, a remplacer par la votre)
- La ligne 8 est la signature générée à partir de la commande et de votre clé secrète
Comment générer la signature
Il faut s'assurer que tout les espaces sont remplacés par "%20" au lieu de "+"
Il faut trier par ordre alphabétique les champs envoyés. Attention à mettre les paramètres les uns après les autres séparés par un & (et commercial)et la chaîne de paramètres en minuscule.
Exemple de string de paramètres : apikey=mivr6x7u6bn_ejtvwz0nukkjbpmy3y2bcikwfq&command=listvirtualmachines&domainId=5
Enfin appliquer un hmac_SHA1 sur la chaîne générée avec comme clé de hashage votre clé secréte. Pour envoyer la requête il vous suffit de rajouter le champs signature avec la signature générée
$args est un tableau associatif de tous les arguments
1<?
2// classement par clef
3ksort($args);
4$query = http_build_query($args);
5// sécurité pour l'encodage des espaces
6$query = str_replace("+", "%20", $query);
7// minuscule
8strtolower($query)
9// calcul du hash
10$hash = hash_hmac("SHA1", $query, $secretKey, true);
11// encodage en base 64
12$signature = base64_encode($hash);
13?>
Activer l'actualisation automatique des commentaires