Connectez-vous en tant qu'accès électronique
Activez l'accès à vos services réseau sur Equinix Fabric sans avoir à gérer les informations de balise C des connexions.

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.
-
Obtenez vos informations de port pertinentes à l'aide du point de terminaisonobtenir tous les ports. En particulier, les ports doivent répondre aux critères suivants :
- Le port qui regroupe le trafic provenant de différents clients doit utiliser l’encapsulation QINQ.
- Le port qui agrège le trafic provenant de différents clients peut être attribué à d'autres
ACCESS_EPL_VCtypes de connexions uniquement. - Le port côté client doit être un port EPL, et il ne peut être attribué à aucune autre connexion, sauf s'il est dans l'
DEPROVISIONEDétat.
Création d'une connexion - Port QINQ au port EPL
Pour créer une connexion en tant qu'accès électronique à partir d'un port QINQ vers un port EPL, envoyez POSTune 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, , project``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": "ACCESS_EPL_VC",
"name": "Conn-1",
"order": {
"purchaseOrderNumber": "1-129105284100"
},
"bandwidth": 50,
"redundancy": {
"priority": "PRIMARY"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "3312101f-5bd0-43d5-b21a-d442b35816a5"
},
"linkProtocol": {
"type": "QINQ",
"vlanSTag": 1001
}
}
},
"zSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "ca655bb1-cca0-ca01-75e0-306a5c00ae38"
}
}
},
"project": {
"projectId": 568
},
"notifications": [
{
"type": "ALL",
"emails": [
"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:
{
"type": "ACCESS_EPL_VC",
"href": "https://api.equinix.com/fabric/v4/connections/eb45d323-5281-44dc-842b-c19a15ac837f",
"uuid": "eb45d323-5281-44dc-842b-c19a15ac837f",
"name": "Conn-1",
"state": "PROVISIONING",
"operation": {
"providerStatus": "NOT_AVAILABLE",
"equinixStatus": "PROVISIONING"
},
"order": {
"purchaseOrderNumber": "1-129105284100",
"billingTier": "Up to 50 Mbps"
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com"
]
}
],
"project": {
"projectId": 568
},
"account": {
"accountNumber": 272235,
"orgId": 91604,
"globalOrgId": "0016u000003JZ6HAAW"
},
"changeLog": {
"createdBy": "EPL-account01-user",
"createdDateTime": "2022-03-26T11:07:47.325Z"
},
"bandwidth": 50,
"redundancy": {
"group": "5c0e9384-aa79-4ec9-b7a2-557f8c307292",
"priority": "PRIMARY"
},
"isRemote": false,
"direction": "INTERNAL",
"aSide": {
"accessPoint": {
"type": "COLO",
"account": {
"accountNumber": 272235,
"orgId": 91604,
"organizationName": "EPL-account01",
"globalOrgId": "0016u000003JZ6HAAW"
},
"location": {
"href": "https://api.equinix.com/fabric/v4/metros/DA",
"region": "AMER",
"metroName": "Dallas",
"metroCode": "DA"
},
"port": {
"href": "https://api.equinix.com/fabric/v4/ports/3312101f-5bd0-43d5-b21a-d442b35816a5",
"uuid": "3312101f-5bd0-43d5-b21a-d442b35816a5",
"name": "272235-DA1-CX-Primary-01"
},
"linkProtocol": {
"type": "QINQ",
"vlanSTag": 689,
"vlanCTag": 0
}
}
},
"zSide": {
"accessPoint": {
"type": "COLO",
"account": {
"accountNumber": 272235,
"orgId": 91604,
"organizationName": "EPL-account01",
"globalOrgId": "0016u000003JZ6HAAW"
},
"location": {
"href": "https://api.equinix.com/fabric/v4/metros/DA",
"region": "AMER",
"metroName": "Dallas",
"metroCode": "DA"
},
"port": {
"href": "https://api.equinix.com/fabric/v4/ports/ca655bb1-cca0-ca01-75e0-306a5c00ae38",
"uuid": "ca655bb1-cca0-ca01-75e0-306a5c00ae38",
"name": "EPL-account01-DA1-NL-EPL-STD-SEC-10G-NK-28"
},
"linkProtocol": {
"type": "UNTAGGED"
}
}
}
}
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 - Port EPL vers port QINQ
Pour créer une connexion en tant qu'accès électronique à partir d'un port EPL vers un port QINQ, 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": "ACCESS_EPL_VC",
"name": "Conn-1",
"order": {
"purchaseOrderNumber": "1-129105284100"
},
"bandwidth": 50,
"redundancy": {
"priority": "PRIMARY"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
}
}
},
"zSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"linkProtocol": {
"type": "QINQ",
"vlanSTag": 1001
}
}
},
"project": {
"projectId": 568
},
"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.