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:
- Ou un fournisseur OIDC Equinix Customer Portal.
- Autorisations de création, de modification et de suppression propres au produit.
Flux d'autorisation de l'utilisateur
-
Sauvegardez et autorisez une demande sur 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 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 API OIDC .
Flux de requêtes
-
Utilisez un jeton d'accès OAuth valide pour autoriser une requête, puis faites un appel à 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 a été 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 Equinix prend en charge :
- Equinix Fabric - connexions virtuelles, routeurs cloud, flux et temps de précision
- Network Edge - périphériques réseau virtuels
Pour obtenir une documentation complète, des exemples et les ressources disponibles, consultez la documentation du fournisseur Terraform .
Références API
Le Equinix API est organisé en groupes fonctionnels versionnés. Chaque groupe fonctionnel contient un ensemble de noeuds finaux API qui vous permettent d'effectuer des opérations liées à ce groupe.
Les références API sont fournies au format OpenAPI qui inclut des informations détaillées sur chaque point de terminaison, y compris les formats de demande et de réponse, les paramètres requis et les exemples de demandes. Dans toute la documentation produit Equinix, vous trouverez des liens vers la « référence API » correspondant au produit ou service discuté.
Pour afficher une bibliothèque de toutes les références Equinix API par groupes fonctionnels, consultez le catalogue API . Vous pouvez également trouver des liens vers toutes les références Equinix API à l'aide de l'arborescence de navigation suivante. Dans cette vue, chaque chemin API principal est lié à sa référence API correspondante.