L'API Equinix
Equinix™ fournit un API HTTP RESTful accessible à l'adresse https://api.equinix.com/. Ce document décrit le API et son utilisation.
L'API vous permet d'interagir par programmation avec vos ressources Equinix, notamment les projets, les appareils, les connexions, les commandes, les déploiements de colocation, les tickets d'assistance et la gestion des identités et des accès.
Utilisation de l'API Equinix
L'utilisation de l'API peut être décomposée en flux d'autorisation et en flux de requête.
L'interaction avec les produits Equinix via l'API nécessite:
- Compte du portail client Equinix ou fournisseur OIDC.
- Autorisations de création, de modification et de suppression propres au produit.
Flux d'autorisation de l'utilisateur
-
Enregistrez et autorisez une application dans le portail client.
-
Demandez l'accès et actualisez les informations du jeton en appelant le système
/oauth2/v1/tokenavec la clé Client, le secret Client et vos identifiants utilisateur.
-
Votre requête vous retourne le jeton d'accès OAuth à durée de vie limitée et son jeton d'actualisation associé.
Pour plus d'informations et des instructions plus détaillées, consultez Authentification API.
Flux d'autorisation des jetons OIDC
-
Créez un fournisseur OIDC dans le Portail client ou dans Equinix API.
-
Demandez un accès en appelant le
/v1/tokenterminal avec votre jeton de fournisseur d'identité et votre périmètre.
- Votre requête retourne le jeton d'accès temporaire.
Pour plus d'informations, consultez Authentification de l'API OIDC.
Le flux de requêtes
-
À l’aide d’un jeton d’accès OAuth valide pour autoriser une demande, appelez un point de terminaison d’API avec l’en-tête d’autorisation requis.
-
La passerelle API valide la demande et appelle l'API Equinix concernée.
-
La réponse est reçue par la passerelle API.
-
La réponse vous est renvoyée.
Infrastructure en tant que code avec Terraform
En plus du API REST, Equinix fournit également un fournisseur Terraform qui vous permet de gérer les ressources Equinix en utilisant l'infrastructure comme code. Le fournisseur Terraform enveloppe le Equinix API et fournit un moyen déclaratif de définir et de gérer votre infrastructure.
Le fournisseur Terraform d'Equinix prend en charge:
- Equinix Fabric - Connexions virtuelles, routeurs infonuagiques, flux et synchronisation temporelle précise
- Network Edge - périphériques réseau virtuels
Pour obtenir la documentation complète, des exemples et les ressources disponibles, consultez la Documentation du fournisseur Terraform.
Références API
L'API Equinix est organisée en groupes fonctionnels versionnés. Chaque groupe fonctionnel contient un ensemble de points de terminaison d'API permettant d'effectuer des opérations liées à ce groupe.
Les références API sont fournies au format OpenAPI et incluent des informations détaillées sur chaque point de terminaison, notamment les formats de requête et de réponse, les paramètres requis et des exemples de requêtes. La documentation produit Equinix contient des liens vers la « Référence API » correspondant au produit ou service concerné.
Pour consulter la bibliothèque de toutes les références API Equinix par groupe fonctionnel, consultez le Catalogue API. Vous trouverez également des liens vers toutes les références API Equinix via l'arborescence de navigation ci-dessous. Chaque chemin d'API principal est lié à sa référence API correspondante dans cette vue.