L'API d'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 de manière programmatique avec vos ressources Equinix, notamment les projets, les dispositifs, 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 flux de demande.
L'interaction avec les produits Equinix par le biais de l'API nécessite :
- Compte Equinix Customer Portal ou un fournisseur OIDC.
- Permissions de création, de modification et de suppression spécifiques à un produit.
Flux d'autorisation des utilisateurs
-
Enregistrer et autoriser 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 demande vous renvoie le jeton d'accès OAuth éphémère et le jeton de rafraîchissement qui lui est associé.
Pour plus d'informations et des instructions plus détaillées, voir API Authentication.
Flux d'autorisation du jeton 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 demande renvoie le jeton d'accès éphémère.
Pour plus d'informations, voir OIDC API Authentication.
Le flux des demandes
-
En utilisant un jeton d'accès OAuth valide pour autoriser une demande, faites un appel à un point de terminaison de l'API avec l'en-tête d'autorisation requis.
-
La passerelle API valide la demande et appelle l'API Equinix correspondante.
-
La réponse est reçue par la passerelle API.
-
La réponse vous est renvoyée.
Infrastructure as 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, Cloud Router, Streams et Precision Time
- Network Edge - périphériques réseau virtuels
Pour une documentation complète, des exemples et des ressources disponibles, consultez la [Documentation du fournisseur Terraform] (/terraform/).
Références API
L'API d'Equinix est organisée en groupes fonctionnels versionnés. Chaque groupe fonctionnel contient un ensemble de points d'accès à l'API qui vous permettent d'effectuer des opérations liées à ce groupe.
Les références API sont fournies au format OpenAPI, qui comprend des informations détaillées sur chaque point de terminaison, notamment les formats de demande et de réponse, les paramètres requis et des exemples de demandes. Dans la documentation produit d'Equinix, vous trouverez des liens vers la " Référence API " correspondant au produit ou au service dont il est question.
Pour consulter une bibliothèque de toutes les références API d'Equinix par groupes fonctionnels, consultez le Catalogue API. Vous pouvez également trouver des liens vers toutes les références API d'Equinix en utilisant l'arbre de navigation suivant. Chaque chemin d'accès principal à l'API est lié à la référence API correspondante dans cette vue.