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
-
Authentification: soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète pour l’authentification OAuth2. Consultez la documentation relative à l’authentification API (Authentification API) pour savoir comment appeler l’API OAuth afin de valider et d’authentifier vos identifiants.
-
Récupérez les informations relatives aux ports à l'aide du point de terminaison Get All Ports. Plus précisément, 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 de différents clients ne peut être attribué qu'à d'autres connexions de type
ACCESS_EPL_VC. - Le port côté client doit être un port EPL et ne peut être affecté à aucune autre connexion à moins qu'il ne soit dans l'état
DEPROVISIONED.
Création d'une connexion - Port QINQ vers port EPL
Pour établir une connexion d'accès électronique entre un port QINQ et un port EPL, envoyez une requête POST au point de terminaison /fabric/v4/connections. Précisez les détails de configuration de votre connexion dans le corps de la requête.
| POST /fabric/v4/connections | |
|---|---|
| Method | POST |
| Endpoint | /fabric/v4/connections |
| Headers | Authorization, Content-Type |
| Path Parameters | Not applicable |
| Query Parameters | Not applicable |
| Body Parameters | type, name, order, redundancy, bandwidth, aSide, zSide, project, notifications |
Pour valider en toute sécurité cette requête en production sans créer de connexion, consultez Tests en production (exécution à blanc de l'API).
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 requête sont propres à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, consultez la référence de l'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 la réponse inclut les paramètres de configuration définis dans le corps de la requête. Pour obtenir la liste complète des paramètres possibles et leurs descriptions, consultez la référence de l'API.
Création d'une connexion - Port EPL vers port QINQ
Pour établir une connexion d'accès électronique entre un port EPL et un port QINQ, envoyez une requête POST au point de terminaison /fabric/v4/connections. Précisez les détails de configuration de votre connexion dans le corps de la requête.
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 requête sont propres à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, consultez la référence de l'API.
Surveillance de la connexion
Utilisez le point de terminaison Get Specified Connection pour surveiller l'état de la connexion.