Connecter un périphérique Network Edge à un port distant

Établissez une connexion non étiquetée entre votre périphérique virtuel Network Edge et un port Fabric distant à l'aide de Fabric API .

Conditions préalables pour l'API Fabric

Authentifier - Soumettez vos informations d'identification, votre ID client et votre secret client pour OAuth2. authentification. Reportez-vous à authentification API pour obtenir des instructions sur la façon d'appeler OAuth API pour valider et authentifier vos informations d'identification.
Déterminez vos informations sur le côté A. Récupérez les informations sur vos périphériques Network Edge à l'aide de l'option obtenir des périphériques virtuels ou obtenir un périphérique virtuel {UUID}. Vous pouvez choisir n'importe quelle interface disponible sur l'appareil pour votre connexion. Cependant, Equinix sélectionnera une interface si vous n'en spécifiez pas une.
Récupérez les informations de vos ports Equinix Fabric à l'aide de la requêteGet All ports API.

Connexion à un port distant non marqué

Pour créer une connexion à partir d'un terminal Network Edge vers un port distant avec un trafic non balisé, envoyez POSTune demande au /fabric/v4/connectionspoint final. Spécifiez les détails de configuration de votre connexion dans le corps de la demande.

note

Vous ne pouvez créer qu'une seule connexion non balisée entre un périphérique virtuel Network Edge et un port distant.

	POST /fabric/v4/connections
Méthode	`POST`
Point d'extrémité	`/fabric/v4/connections`
En-têtes	`Authorization` `Content-Type`
Paramètres du chemin d'accès	Non applicable
Paramètres d'interrogation	Non applicable
Paramètres du corps	`type`, `name`, `order`, `bandwidth`, , aSide``zSide, `project`, `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",  
    "bandwidth": 100,  
    "redundancy": {  
        "priority": "PRIMARY"  
    },  
    "name": "ConnectionName-1",  
    "order": {  
        "purchaseOrderNumber": "1-3232923"  
    },  
    "aSide": {  
        "accessPoint": {  
            "type": "VD",  
            "virtualDevice": {  
                "type": "EDGE",  
                "uuid": "fd5342f3-d067-4683-a24f-be952279630b"  
            },  
            "interface": {  
                "type": "NETWORK",  
                "id": 45645  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "COLO",  
            "port": {  
                "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"  
            },  
            "linkProtocol": {  
                "type": "UNTAGGED"  
            }  
        }  
    },  
    "project": {  
        "projectId": 567  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "test@equinix.com",  
                "test1@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 leurs descriptions, reportez-vous à la référence API .

Connexion à un port distant du DOT1Q

Pour créer une connexion entre un terminal Network Edge et un port distant DOT1Q, envoyez une POST demande au /fabric/v4/connectionsnoeud 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": "EVPL_VC",  
    "bandwidth": 1000,  
    "name": "vd to COLO",  
    "aSide": {  
    "accessPoint": {  
        "type": "VD",  
        "virtualDevice": {  
        "type": "EDGE",  
        "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"  
        },  
        "interface": {  
        "type": "NETWORK",  
        "id": 45645  
        }  
    }  
    },  
    "zSide": {  
    "accessPoint": {  
        "type": "COLO",  
        "port": {  
        "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"  
        },  
        "linkProtocol": {  
        "type": "DOT1Q",  
        "vlanTag": 300  
        }  
    }  
    },  
    "order": {  
    "purchaseOrderNumber": "1-129105284100"  
    },  
    "notifications": [  
    {  
        "type": "ALL",  
        "emails": [  
        "test@equinix.com",  
        "test1@equinix.com"  
        ]  
    }  
    ]  
}'

Exemple de réponse :

{  
    "type": "EVPL_VC",  
    "href": "https://api.equinix.com/fabric/v4/connections/c193c1c4-2c7e-472d-8c91-0283bc3b5a71",  
    "uuid": "c193c1c4-2c7e-472d-8c91-0283bc3b5a71",  
    "name": "ConnectionName-1",  
    "state": "PROVISIONING",  
    "operation": {  
        "providerStatus": "NOT_AVAILABLE",  
        "equinixStatus": "PROVISIONING"  
    },  
    "order": {  
        "purchaseOrderNumber": "1-3232923"  
    },  
    "project": {  
        "projectId": 567  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "testqq@equinix.com"  
            ]  
        }  
    ],  
    "account": {  
        "accountNumber": 270217,  
        "orgId": 92287,  
        "globalOrgId": "0016u000003JZ53AAG"  
    },  
    "changeLog": {  
        "createdBy": "eqxnfvuser",  
        "createdDateTime": "2022-03-22T23:14:23.546Z"  
    },  
    "bandwidth": 100,  
    "redundancy": {  
        "group": "79a0e626-55fe-4fe1-89a5-4d7ca52214db",  
        "priority": "PRIMARY"  
    },  
    "isRemote": true,  
    "direction": "INTERNAL",  
    "aSide": {  
        "accessPoint": {  
            "interface": {  
                "uuid": "bf8a606b-32b2-4a53-a450-6eabd7d9ccab",  
                "id": 45645,  
                "type": "CLOUD"  
            },  
            "type": "VD",  
            "account": {  
                "accountNumber": 270217,  
                "orgId": 92287,  
                "organizationName": "eqx-nfv",  
                "globalOrgId": "0016u000003JZ53AAG"  
            },  
            "location": {  
                "href": "https://api.equinix.com/fabric/v4/metros/DC",  
                "region": "AMER",  
                "metroName": "Ashburn",  
                "metroCode": "DC"  
            },  
            "virtualDevice": {  
                "href": "https://api.equinix.com/ne/v1/devices/fd5342f3-d067-4683-a24f-be952279630b",  
                "uuid": "fd5342f3-d067-4683-a24f-be952279630b",  
                "name": "ha-json",  
                "type": "EDGE"  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "COLO",  
            "account": {  
                "accountNumber": 270224,  
                "orgId": 92287,  
                "organizationName": "eqx-nfv",  
                "globalOrgId": "0016u000003JZ53AAG"  
            },  
            "location": {  
                "href": "https://api.equinix.com/fabric/v4/metros/SY",  
                "region": "APAC",  
                "metroName": "Sydney",  
                "metroCode": "SY"  
            },  
            "port": {  
                "href": "https://api.equinix.com/fabric/v4/ports/c791f8cb-5d73-d730-8ce0-306a5c00a4ee",  
                "uuid": "c791f8cb-5d73-d730-8ce0-306a5c00a4ee",  
                "name": "eqx-nfv-SY1-L-Dot1q-BO-PRI-10G-JN-1147"  
            },  
            "linkProtocol": {  
                "type": "DOT1Q"  
            }  
        }  
    },  
    "additionalInfo": []  
}

La charge utile de réponse comprend des paramètres de configuration définis dans le corps de la requête. Pour une liste complète des paramètres possibles et leurs descriptions, reportez-vous à la référence API .

Connexion à un port distant QinQ

Pour créer une connexion entre un périphérique Network Edge et un port distant QinQ, envoyez une POST 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": "EVPL_VC",  
    "bandwidth": 1000,  
    "name": "vd to COLO",  
    "aSide": {  
    "accessPoint": {  
        "type": "VD",  
        "virtualDevice": {  
        "type": "EDGE",  
        "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"  
        },  
        "interface": {  
        "type": "NETWORK",  
        "id": 45645  
        }  
    }  
    },  
    "zSide": {  
    "accessPoint": {  
        "type": "COLO",  
        "port": {  
        "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"  
        },  
        "linkProtocol": {  
        "type": "QINQ",  
        "vlanSTag": 300,  
        "vlanCTag": 400  
        }  
    }  
    },  
    "order": {  
    "purchaseOrderNumber": "1-129105284100"  
    },  
    "notifications": [  
    {  
        "type": "ALL",  
        "emails": [  
        "test@equinix.com",  
        "test1@equinix.com"  
        ]  
    }  
    ]  
}  
'

Contrôle de votre connexion

Utilisez le point de terminaisonGet Specified Connection API pour surveiller l'état de la connexion.

Conditions préalables pour l'API Fabric​

Connexion à un port distant non marqué​

Connexion à un port distant du DOT1Q​

Connexion à un port distant QinQ​

Contrôle de votre connexion​

Conditions préalables pour l'API Fabric

Connexion à un port distant non marqué

Connexion à un port distant du DOT1Q

Connexion à un port distant QinQ

Contrôle de votre connexion