Connecter le dispositif Network Edge au port distant

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

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 à API Authentication pour savoir comment appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.
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.
Récupérez les informations sur les ports de votre Equinix Fabric à l'aide de la demande d'API Get All Ports.

Connexion à un port distant non marqué

Pour créer une connexion à partir d'un dispositif Network Edge vers un port distant avec un trafic non marqué, envoyez une requête POST au point de terminaison /fabric/v4/connexions. Spécifiez les détails de configuration de votre connexion dans le corps de la requête.

note

Vous ne pouvez créer qu'une seule connexion non marquée entre un dispositif virtuel Network Edge et un port distant.

	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`, `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 leur description, consultez la [Référence API] (/api-catalog/fabricv4#tag/Connections/operation/createConnection).

Connexion à un port distant du DOT1Q

Pour créer une connexion à partir d'un périphérique Network Edge vers un port distant DOT1Q, 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": "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 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).

Connexion à un port distant QinQ

Pour créer une connexion entre un périphérique Network Edge et un port distant 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": "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 terminaison de l'API Get Specified Connection 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