Aperçu

Deux types d’API sont disponibles :

• Les API de vCloud Director
• Les API de Cloud Avenue

Toutes ces API sont exposées sur internet et sur le BVPN.

Accès aux API

L’utilisation d’un compte « administrateur de l’organisation » est nécessaire pour accéder aux API. Ce compte peut être :

• local (créé par un administrateur de l’organisation)
• fédéré (créé par un référent du contrat dans l’Espace Client Cloud) et fonctionnant avec en SSO.

Documentations en ligne

Les API utilisables sur Cloud Avenue sont listées ci-dessous :

Suivre le lien vers la page API Cloud Avenue

Composant	Liens vers la documentation en ligne
API Cloud Director & NSX	https://github.com/ccouzens/vcloud-rest-openapi https://vdc-download.vmware.com/vmwb-repository/dcr-public/772aa4c5-7e61-4d80-8432-b8e0d821c969/2747ec83-6aef-4560-b1d1-55ed9adc4e73/vcd-openapi-docs.html
API DraaS avec VCDA	https://developer.vmware.com/apis/1173/vmware-cloud-director-availability#/
API Kubernetes API avec CSE	https://developer.vmware.com/apis/vmware-cloud-director/latest/cloudapi/1.0.0/tkgClusters/post/
API Cloud Avenue pour les clients	Suivre le lien vers la page API Cloud Avenue
API vROPS Tenant	https://github.com/bakingclouds/vRealize-Operations-Tenant-App/blob/main/TenantApp%20v8.6_swagger.json
API Backup API avec NSS	https://backup3.flexible-computing-advanced.orange-business.com/NetBackupSelfServiceNetBackupPanels/Swagger/
API vCenter pour vCoD (si option WLD commandée)	https://support.citrix.com/article/CTX214389
API UseItCloud v1.0	https://195.25.22.52/api/v1.0/docs/

Outils recommandés

Postman

Cette application permet de construire et exécuter des requêtes HTTP, et bien plus !

A télécharger ici : https://www.postman.com/downloads/

Ansible

C’est la référence des logiciels d’automatisation basé sur les appels API.

Documentation et téléchargement ici : https://github.com/vmware/ansible-module-vcloud-director/blob/master/docs/index.md

Terraform

Terraform est très utilisé par les développeurs orientés « infra as code« . Terraform fonctionne avec des « provider », qui sont des traducteurs permettant d’interfacer les commandes standard Terraform aux API locales.

Nous avons développé un provider spécifique pour Cloud Avenue, qui fournit de nombreuses fonctionnalités supplémentaires (sauvegardes des VMs, stockage S3, etc.).

La documentation en ligne de notre provider Terraform se trouve ici : https://registry.terraform.io/providers/orange-cloudavenue/cloudavenue/latest/docs

VCD CLI

Voir la fiche pratique sur les API

---