Connecter le dispositif de périphérie de réseau à d'autres fournisseurs de services

Établissez une connexion directe de couche 2 aux fournisseurs de services cloud depuis votre dispositif Network Edge à l'aide de l'API Fabric.

Conditions préalables pour l'API Fabric

1. Authentifier - Soumettez vos informations d'identification, votre ID client et votre secret client pour OAuth2. authentification. Reportez-vous à API Authentication pour savoir comment appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.

2. Déterminez vos informations côté A. Récupérez les informations sur vos appareils Network Edge à l'aide de Get Virtual Devices ou Get Virtual Device {uuid}. Vous pouvez choisir n'importe quelle interface disponible sur le périphérique pour votre connexion. Toutefois, Equinix sélectionnera une interface si vous n'en spécifiez pas.

3. Choisissez l'emplacement du métro côté Z. Utilisez la requête API Get All Metros pour trouver tous les métros où Equinix Fabric est disponible et déterminer l'emplacement de destination.

4. Identifiez le profil de service du fournisseur de services en nuage. Utilisez la requête API Retrieve Service Profiles pour rechercher un profil de service spécifique ou utilisez la requête API Get Service Profiles pour répertorier tous les profils de service disponibles et identifier le fournisseur de services en nuage auquel vous souhaitez vous connecter.

Connexion à un fournisseur de services

Pour connecter votre dispositif Network Edge à un fournisseur de services, 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, bandwidth, aSide, zSide, notifications

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": "vd2other-sp-0412a",  
    "bandwidth": 1000,  
    "aSide": {  
        "accessPoint": {  
            "type": "VD",  
            "virtualDevice": {  
                "type": "EDGE",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXX"  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "type": "L2_PROFILE",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX"  
            },  
            "location": {  
                "metroCode": "DC"  
            }  
        }  
    },  
    "project": {  
        "projectId": "16799d66-ef43-445c-ba29-d17522d8a137"  
    },  
    "order": {  
        "purchaseOrderNumber": "1-129105284100"  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "x@gmail.com"  
            ]  
        }  
    ]  
}'

Exemple de réponse :

{  
    "type": "EVPL_VC",  
    "href": "https://api.equinix.com/fabric/v4/connections/53c89f1a-0be7-44a1-9c03-28059632a72d",  
    "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
    "name": "vd2other-sp-0425a",  
    "operation": {  
        "providerStatus": "PROVISIONING",  
        "equinixStatus": "PROVISIONING"  
    },  
    "order": {  
        "purchaseOrderNumber": "1-129105284100",  
        "billingTier": "Up to 1G"  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "x@gmail.com"  
            ]  
        }  
    ],  
    "changeLog": {  
        "createdBy": "fabricamcrh1",  
        "createdByFullName": "fabric amcrh1",  
        "createdByEmail": "x@gmail.com",  
        "createdDateTime": "2024-04-25T20:40:40.676Z",  
        "updatedBy": "fabricamcrh1",  
        "updatedByFullName": "fabric amcrh1",  
        "updatedByEmail": "x@gmail.com",  
        "updatedDateTime": "2024-04-25T20:40:40.677Z"  
    },  
    "bandwidth": 1000,  
    "redundancy": {  
        "group": "43009a55-87ee-4dff-8ae4-70ccb7c3d4e9",  
        "priority": "PRIMARY"  
    },  
    "aSide": {  
        "accessPoint": {  
            "interface": {  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
                "id": 5,  
                "type": "CLOUD"  
            },  
            "location": {  
                "metroCode": "DC"  
            },  
            "virtualDevice": {  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
                "type": "EDGE"  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "location": {  
                "metroCode": "DC"  
            },  
            "profile": {  
                "href": "https://api.equinix.com/fabric/v4/serviceProfiles/60ef0382-cdaa-44e7-bd36-b803731816b8",  
                "type": "L2_PROFILE",  
                "name": "Other Service Provider",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  
            }  
        }  
    }  
}

Contrôle de l'état de la connexion

Utilisez le point de terminaison Get Specified Connection pour surveiller l'état de la connexion.

equinixStatus parameter values	providerStatus attribute values	Description
PROVISIONING	PROVISIONING	Connection request has not been sent to Oracle yet.
PROVISIONED	PROVISIONING	Connection establishment in progress.
PROVISIONED	PROVISIONED	Connection established.