Utiliser votre Cloud
Une fois votre compte client créé, vous pouvez utiliser votre Cloud suivant 2 méthodes :
Via le manager
Le manager est un interface graphique de gestion de votre Cloud accessible ici.
Le manager permet de contrôler l'ensemble de votre Cloud et de sa facturation. Vous pouvez y créer des instances et des stockages, et suivre l'état de chacun des éléments de votre Cloud.
En utilisant l'API Cloud
Directement dans votre langage de programmation préféré. L'API Cloud regroupe l'ensemble des actions possibles sur le Cloud. L'appel de fonctions se fait directement via le web service OVH.
Pour utiliser les webs services OVH, il vous suffit de les exécuter à partir d'une machine connectée à l'Internet. Un serveur en local, ou une ligne de commande, peut suffire...
Pour un détail de l'ensemble des fonctions de l'API et les structures de données, rendez-vous sur la page de documentation de l'API Cloud
OVH met à votre disposition le script "ovhcloud" qui vous permet d'utiliser l'ensemble des fonctions de l'API Cloud de manière simplifiée.
Dans un premier temps, commencez par récupérer le script et le rendre executable :
# rendez le executable
~$ chmod +x ovhcloud
Exécutez le script une première fois pour installer les éventuels modules nécessaires :
~$ Cannot load module: JSON.
Would you like to install JSON now? (yes/no):
# Installez les modules complémentaires
Une fois les modules installés, vous avez accès au cloud. Exécutez le script pour avoir accès à la documentation. Vous pouvez appeler l'ensemble des fonctions de l'API via le script ovhcloud.
Specify namespace
USAGE:
call function:
./ovhcloud [instance|storage] functionName [[-v+] [--noskip|-n] [--parameterName parameter] ...
ssh to instance:
./ovhcloud instance ssh instanceId
get help for function:
./ovhcloud [instance|storage] help [-v+] [functionName|regex]
verbosity levels:
-v - warn
-vv - debug
don't skip optional parameters:
--noskip, -n
A savoir
Si vous lancez une commande sans paramètres, ovhcloud vous les demandera étape par étape lors de son exécution ;
login (string): nic
password (string): ***
Function login results:
$RESULT1 = {
'__class' => 'sessionType:session',
'language' => 'fr',
'billingCountry' => 'FR',
'id' => 'nic-ae1e528a4a139c3640d3b47a7bf3b2eb',
'startDate' => '2011-12-07T15:33:05+01:00',
'login' => 'nic'
};
~$
Création d'une session et préparation à l'appel de fonctions
Cette section représente l'intégralité d'un script pour utiliser les fonctions de l'API Cloud.
Il se connecte au web service,
Crée une session utilisateur,
Et prévoit les cas d'erreur principaux dans les "catch{}".
ini_set('soap.wsdl_cache_enabled', '0');
$nicHandle = '';
$password = '[Votre mot de passe reçu par email lors de la commande]';
$Client = new SoapClient(
'https://ws.ovh.com/cloud/public/instance/r1/soap.wsdl',
array(
'location' => 'https://ws.ovh.com/cloud/public/instance/r1/soap.dispatcher',
)
);
$sessionClient = new SoapClient( 'https://ws.ovh.com/sessionHandler/r1/soap.wsdl',
array(
'location' => 'https://ws.ovh.com/sessionHandler/r1/soap.dispatcher',
)
);
try {
// Connexion et création de la session
$result = $sessionClient->login( array(
'login' => $nicHandle, 'password' => $password, 'language' => 'fr', 'multisession' => 'true',
));
// Session
$session = $result->value->id;
// Affichage du résultat de session (facultatif)
print( 'session id : ['.$session."]\n");
// L'appel des fonctions se fera ici
}
// Récupération d'une erreur au cas où l'appel de l'API Cloud a échoué
catch (SoapFault $fault)
{
trigger_error("SOAP Fault: (faultcode: {$fault->faultcode}, faultstring: {$fault->faultstring})", E_USER_ERROR);
}
// Fermeture de la session
try {
# close session
$sessionClient->logout( array( 'sessionId' => $session ));
}
catch (SoapFault $ignore) { }
?>
Appel d'une fonction
Votre session étant créée, et votre script prêt, vous pouvez maintenant vous concentrer sur l'appel de fonctions.
Cet appel se fait dans la section try{}, depuis l'appel jusqu'au retour de résultats. Ici, le retour de résultat est fait via un print_r, mais il vous est possible de le retourner à une fonction propre qui pourra traiter les résultats comme vous le souhaitez.
Pour un détail de l'ensemble des fonctions de l'API et les structures de données, rendez-vous sur la page de documentation de l'API Cloud
// Pour appeler une fonction, créez la variable $result,
// puis utilisez la commande :
// $Client-> Nom de la fonction (
// puis passez les paramètres sous forme de tableau
// array(
// 'sessionId' => $session,
// ...
// )
//
// Par exemple pour appeler la fonction 'newinstance'
$result = $Client->newInstance( array(
'sessionId' => $session,
'projectId' => 'votre ID',
'name' => 'monInstance',
'zone' => '[Datacentre de votre choix]'
'offerName' => '[Choisissez une instance dans la gamme : xs s l xl]',
'distributionName' => '[Choisissez l'OS]',
'persistentDiskSize' => '[valeur en GB]',
'scriptUrl' => '[http://....../install.sh]',
));
// Affichage des résultats
print_r( $result->value);