API Cloud Avenue

Aperçu

Cloud Avenue vous fournit un accès direct à son API, vous trouverez toutes les actions qu’il est possible de réaliser avec celle-ci dans la documentation ci-dessous :

https://swagger.cloudavenue.orange-business.com

L’API Cloud Avenue se base sur l’API de vCloud Director. Pour vous authentifier, il faudra donc utiliser vos identifiants de vCloud Director (username@organisation_name)

Exemple : Création d’un vDC

Authentification

Nous allons voir ensemble comment créer un vDC dans votre organisation. La documentation d’API mise à votre disposition est prête à l’emploi. Vous pouvez donc l’utiliser directement dans votre navigateur internet dans le cadre de vos tests. Vous pouvez aussi télécharger le schéma d’API afin de l’importer dans Postman ou un autre client REST.

Dans un premier temps nous allons avoir besoin de nous authentifier à vCloud Director. Pour cela cliquer sur le bouton Authorize et renseignez vos identifiants vCloud Director

Valider votre saisie en cliquant sur Authorize puis Close.

Vous pouvez maintenant utiliser la première route afin de vous authentifier et ainsi récupérer le token qui vous servira pour les autres routes API. Ouvrez la route d’authentification, cliquez sur Try it out puis Execute. Si tout se passe bien, vous devriez obtenir une réponse avec code de retour 200. Dans les response headers, copiez la valeur associée au header x-vmware-vcloud-access-token puis, ouvrez la fenêtre des autorisations en cliquant sur le bouton Authorize comme à l’étape précédente puis collez ce token dans le champs associé. Cliquez sur Authorize puis Close.

Toutes les routes sont désormais utilisable directement depuis votre navigateur. Il ne vous reste qu’à choisir la route dont vous avez besoin, cliquer sur Try it out, modifier les paramètres si besoin puis lancer votre requête en cliquant sur Execute.

Creation d’un vDC

Dans la documentation, descendez jusqu’à la section vDC. Choisissez la route POST /api/customers/v2.0/vdcs puis cliquez sur Try it out. Modifiez les données de la requête comme désiré puis cliquez sur Execute.

If your request is correct you should get a 201 response with a body containing je Job ID of your request. You can use this jobId in Jobs route to have the status of your request. After few seconds your vDC should be ready. You can verify it in vCloud Director portal or using GET /api/customers/v2.0/vdcs

---