Se connecter à un fournisseur de services sur Fabric
Établissez une connexion entre vos actifs colocalisés IBX et un profil de service.
Conditions préalables
-
Authentifier - envoyez vos identifiants utilisateur, votre identifiant client et votre secret client pour l'authentification OAuth2. Pour obtenir des instructions sur la façon d'appeler l'API OAuth pour valider et authentifier vos identifiants, reportez-vous à authentification API.
-
Déterminez les informations sur le port A-Side. Obtenez vos informations de port pertinentes à l'aide du point de terminaisonobtenir tous les ports.
-
Choisissez l'emplacement Metro z-Side. Utilisez le point de terminaisonobtenir toutes les métros pour trouver toutes les métros où Equinix Fabric est disponible et déterminer l'emplacement de destination de votre connexion.
-
Identifiez les informations du profil de service du fournisseur de services. Utilisez le point de terminaison récupérer les profils de service pour rechercher un profil de service spécifique ou le point de terminaisonrépertorier les profils de service pour répertorier tous les profils de service disponibles et identifier le profil auquel vous souhaitez vous connecter.
Création d'une connexion depuis un port DOT1Q vers un fournisseur de services
Pour créer une connexion entre un port DOT1Q et un fournisseur de services, envoyez une POST demande au /fabric/v4/connectionspoint final. Spécifiez les détails de configuration de votre connexion dans le corps de la demande.
POST /fabric/v4/connections | |
|---|---|
| Méthode | POST |
| Terminal | /fabric/v4/connections |
| En-têtes | Authorization, Content-Type |
| Paramètres du chemin | Non applicable |
| Paramètres de requête | Non applicable |
| Paramètres corporels | type, name, order, redundancy, , bandwidth``aSide, zSide, notifications |
Pour valider en toute sécurité cette demande en production sans créer de connexion, voir test en production (API à sec).
Exemple de requête cURL:
curl -X
POST 'https: //api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
"type": "EVPL_VC",
"name": "Conn-1",
"order": {
"purchaseOrderNumber": "1-129105284100"
},
"bandwidth": 1000,
"redundancy": {
"group": "b767f685-41b0-1b07-6de0-320a5c00abdd",
"priority": "SECONDARY"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": 1001
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"
},
"location": {
"metroCode": "SV"
}
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test@equinix.com"
]
}
]
}'
Les paramètres inclus dans le corps de la demande sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, reportez-vous à la référence API .
Exemple de réponse:
{
"href": "https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62",
"type": "EVPL_VC",
"uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62",
"name": "Conn-1",
"state": "PROVISIONING",
"order": {
"purchaseOrderNumber": "1-129105284100",
"billingTier": "Up to 1 Gbps"
},
"bandwidth": 1000,
"redundancy": {
"group": "b767f685-41b0-1b07-6de0-320a5c00abdd",
"priority": "SECONDARY"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",
"type": "XF_PORT",
"uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": 1001
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"href": "https://api.equinix.com/fabric/v4/serviceProfiles/a867f685-41b0-1b07-6de0-320a5c00abdd",
"type": "L2_Profile",
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"location": {
"href": "https://api.equinix.com/v4/metros/SV",
"metrocode": "SV",
"region": "AMER"
}
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test2@equinix.com"
]
}
],
"operation": {
"equinixStatus": "PENDING_APPROVAL",
"providerStatus": "NOT_AVAILABLE"
},
"changeLog": {
"createdDateTime": "2021-07-15T19:30:29.526Z"
}
}
La charge utile de réponse comprend les paramètres de configuration définis dans le corps de la demande. Pour obtenir la liste complète des paramètres possibles et leurs descriptions, reportez-vous à la référence API .
Création d'une connexion depuis un port QINQ vers un fournisseur de services
Pour créer une connexion entre un port QINQ et un fournisseur de services, envoyez POSTune demande au /fabric/v4/connectionspoint final. Spécifiez les détails de configuration de votre connexion dans le corps de la demande.
Exemple de requête cURL:
curl -X
POST 'https: //api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
"type": "EVPL_VC",
"name": "Conn-1",
"order": {
"purchaseOrderNumber": "1-129105284100"
},
"bandwidth": 1000,
"redundancy": {
"group": "b767f685-41b0-1b07-6de0-320a5c00abdd",
"priority": "SECONDARY"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
},
"linkProtocol": {
"type": "QINQ",
"vlanCTag": 1001,
"vlanSTag": 1002
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"
},
"location": {
"metroCode": "SV"
}
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test@equinix.com"
]
}
]
}'
Les paramètres inclus dans le corps de la demande sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, reportez-vous à la référence API .
Surveillance de la connexion
Utilisez le point de terminaisonobtenir la connexion spécifiée pour surveiller l'état de la connexion.
equinixStatus valeurs des paramètres | providerStatus valeurs des paramètres | Description |
|---|---|---|
PENDING_APPROVAL | NOT_AVAILABLE | Demande de connexion en attente d'approbation. |
PROVISIONING ou REJECTED | NOT_AVAILABLE | Établissement de connexion en cours ou le vendeur a refusé la connexion. |
PROVISIONED | AVAILABLE | Connexion établie. |
