Se connecter en tant qu'accès électronique
Permettez l'accès à vos services réseau sur Equinix Managed Services sans avoir à gérer les informations C-tag des connexions.
Conditions préalables
-
Authentifier - Soumettez vos informations d'identification de l'utilisateur, l'ID du client et le secret du client pour l'authentification OAuth2. Reportez-vous à API Authentication pour savoir comment appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.
-
Obtenez vos informations de port pertinentes à l'aide du point d'extrémité Get All Ports. Plus précisément, les ports doivent répondre aux critères suivants :
- Le port qui agrège le trafic de différents clients doit utiliser l'encapsulation QINQ.
- Le port qui agrège le trafic de différents clients ne peut être assigné qu'à d'autres connexions de type
ACCESS_EPL_VC. - Le port côté client doit être un port EPL, et il ne peut être assigné à aucune autre connexion à moins qu'il ne soit dans l'état
DEPROVISIONED.
Création d'une connexion - Port QINQ vers port EPL
Pour créer une connexion en tant qu'accès électronique d'un port QINQ à un port EPL, envoyez une requête POST au point de terminaison /fabric/v4/connections. Spécifiez 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 cette demande en toute sécurité en production sans créer de connexion, consultez Testing in Production (API Dry Run).
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 spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leur description, consultez la [Référence API] (/api-catalog/fabricv4#tag/Connections/operation/createConnection).
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 comprend les paramètres de configuration définis dans le corps de la demande. Pour une liste complète des paramètres possibles et de leurs descriptions, voir la [Référence API] (/api-catalog/fabricv4#tag/Connections/operation/createConnection).
Création d'une connexion - Port EPL vers port QINQ
Pour créer une connexion en tant qu'accès électronique d'un port EPL à un port QINQ, envoyez une requête POST au point de terminaison /fabric/v4/connections. Spécifiez 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 spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leur description, consultez la [Référence API] (/api-catalog/fabricv4#tag/Connections/operation/createConnection).
Contrôle de la connexion
Utilisez le point de terminaison Get Specified Connection pour surveiller l'état de la connexion.