Passer au contenu principal

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​

  1. 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.

  2. 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_VC types 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éthodePOST
Terminal/fabric/v4/connections
En-têtesAuthorization, Content-Type
Paramètres du cheminNon applicable
Paramètres de requêteNon applicable
Paramètres corporelstype, 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.

Cette page vous a-t-elle été utile ?