Como usar a API de Ikoula de nuvem privada
Este artigo foi traduzido por um sistema de tradução automática. Você pode visualizar a fonte do artigo aqui.
Quando você se registrar para o serviço b. Cloud Ikoula privado, você recebeu um e-mail com uma chave de API e uma chave secreta. Esta informação permitirá que você para se conectar ao b API. Cloud Ikoula privado.
API DE URL : https://cloudstack.ikoula.com/client/api
As especificações de API de administrador e usuário de domínio são respectivamente :
Admin : http://cloudstack.apache.org/docs/api/apidocs-4.2/TOC_Domain_Admin.html Usuário : http://cloudstack.apache.org/docs/api/apidocs-4.2/TOC_User.html
O uso da API, para :
- Sua chave de API
- Sua chave secreta
- Enviar consultas "https://cloudstack.ikoula.com/client/api" com um método de HTTP
- Tratar o retorno XML ou JSON (escolha )
Exemplo de uma consulta tem o API usando o método GET :
- https://cloudstack.ikoula.com/client/api/
- ?comando =deployVirtualMachine
- &serviceOfferingId =1
- &diskOfferingId =1
- &templateId =2
- &zoneId =4
- &apiKey =miVr 6X7u6bN_EJTVwZ 0nUkkJbPmY 3y2bciKwFQ
- &assinatura =LXX 1DM 40AjcXU %2FcaiK 8RAP 0O1hU %3D
A linha 1 corresponde ao ponto de entrada (o link para o API b. Cloud Ikoula privado ) A linha 2 correspond a la comando e a envoyer, ici on veut crée une nouvelle VM A linha 3-6 correspondent aux différents paramètres de la comando e. Você pode adicionar os campos "response" que definiu o retorno com o formato de parâmetro (XML /JSON ) A linha 7 contém sua chave de API (Aqui está um exemplo inválido chave, substitua seu ) A linha 8 est la assinatura générée à partir de la comando e et de votre clé secrète
Comment générer la assinatura ?
Temos de garantir que todos os espaços são substituídos por "%20" em vez de "+"
Para classificar em ordem alfabética enviou campos. Atenção para as configurações de um depois do outro separados por uma & (E comercial )e a seqüência de caracteres em minúsculas.
Exemplo de parâmetros de seqüência de caracteres : apiKey =mivr 6x7u6bn_ejtvwz 0nukkjbpmy 3y2bcikwfq &comando =listvirtualmachines &Networkid =5
Finalmente, aplique um hmac_SHA 1 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 assinatura avec la assinatura générée
$args é uma matriz associativa de todos os argumentos
// classement par clef
ksort($args);
$query = http_build_query($args);
// sécurité pour l'encodage des espaces
$query = str_replace("+", "%20", $query);
// minuscule
strtolower($query)
// calcul du hash
$hash = hash_hmac("SHA1", $query, $secretKey, true);
// encodage en base 64
$signature = base64_encode($hash);
?>
Ativar a atualização automática de comentários