Skip to main content

Se connecter à un réseau

Établir une connexion directe et à faible latence entre vos réseaux et vos ports et appareils virtuels.

Conditions préalables​

  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. Obtenez les informations sur votre réseau Fabric - envoyez une requête POST au point de terminaison fabric/v4/networks/search pour rechercher et récupérer une liste de vos réseaux disponibles.

  3. Déterminez les informations relatives au port ou à l'appareil virtuel.

    • Récupérez les informations sur les ports de votre Equinix Fabric à l'aide du point d'extrémité Get All Ports. Pour obtenir des informations sur un port spécifique, utilisez le point d'extrémité Get Specified Port.

    • Déterminez les informations relatives à votre périphérique Network Edge. Vous devez disposer d'un dispositif virtuel, d'un dispositif redondant ou d'un cluster Equinix provisionné avec une licence enregistrée. Vérifiez vos dispositifs virtuels et clusters disponibles en appelant 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.

Création d'une connexion entre un port balisé et un réseau EVPLAN​

Pour créer une connexion entre un port balisé et un réseau EVPLAN, 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
MethodPOST
Endpoint/fabric/v4/connections
HeadersAuthorization, Content-Type
Path ParametersNot applicable
Query ParametersNot applicable
Body Parameterstype, name, order, bandwidth, aSide, zSide, notifications, redundancy

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": "EVPLAN_VC",  
  "name": "MY-EVPLAN-CONNECTION-1",  
  "bandwidth": 1000,  
  "aSide": {  
    "accessPoint": {  
      "type": "COLO",  
      "port": {  
        "uuid": "9127bb72-5f4f-4517-be74-3af7ce612687"  
      },  
      "linkProtocol": {  
        "type": "DOT1Q",  
        "vlanTag": 300  
      }  
    }  
  },  
  "zSide": {  
    "accessPoint": {  
      "type": "NETWORK",  
      "network": {  
        "uuid": "25f8884e-85e3-4eaa-8ea9-a7ad2ca5b3c2"  
      }  
    }  
  },  
  "order": {  
    "purchaseOrderNumber": "1-129105284100"  
  },  
  "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).

Exemple de réponse :

{  
"type": "EVPLAN_VC",  
"href": "https://uat2api.npclouda.equinix.com/fabric/v4/connections/01df5124-eed1-4a30-89bb-240c33d5cd12",  
"uuid": "01df5124-eed1-4a30-89bb-240c33d5cd12",  
"name": "test2",  
"operation": {  
    "providerStatus": "NOT_AVAILABLE",  
    "equinixStatus": "PROVISIONING"  
},  
"order": {  
    "billingTier": "Up to 50 MB"  
},  
"notifications": [  
    {  
    "type": "ALL",  
    "emails": [  
        "1eqxnfvuser1@equinix.com"  
    ]  
    }  
],  
"changeLog": {  
    "createdBy": "eqxnfvuser1",  
    "createdByFullName": "eqxnfvuser eqxnfvuser",  
    "createdByEmail": "1eqxnfvuser1@equinix.com",  
    "createdDateTime": "2023-03-27T18:29:53.117Z",  
    "updatedBy": "eqxnfvuser1",  
    "updatedByFullName": "eqxnfvuser eqxnfvuser",  
    "updatedByEmail": "1eqxnfvuser1@equinix.com",  
    "updatedDateTime": "2023-03-27T18:29:53.117Z"  
},  
"bandwidth": 50,  
"redundancy": {  
    "priority": "PRIMARY",  
    "group": "7a58dd05-f46d-4b1d-a154-2e85c396ea63"  
},  
"aSide": {  
    "accessPoint": {  
    "location": {  
        "metroCode": "DC"  
    },  
    "port": {  
        "type": "XF_PORT",  
        "href": "https://uat2api.npclouda.equinix.com/fabric/v4/ports/e569f0bb-96d5-6d5e-92e0-387a5c00a379",  
        "uuid": "e569f0bb-96d5-6d5e-92e0-387a5c00a379",  
        "name": "eqx-nfv-DC5-L-Dot1q-STD-Pri-1G-JP-2"  
    },  
    "linkProtocol": {  
        "type": "DOT1Q",  
        "vlanTag": 44  
    }  
    }  
},  
"zSide": {  
    "accessPoint": {  
    "network": {  
        "href": "https://uat2api.npclouda.equinix.com/fabric/v4/networks/ecc81fe0-7a96-4e08-94f2-0ab52fae662b",  
        "uuid": "ecc81fe0-7a96-4e08-94f2-0ab52fae662b",  
        "name": "EVPLAN-AMER-1",  
        "platformUuid": "52c6ec8b-4aad-4167-be6d-1972a12d1b83",  
        "state": "ACTIVE",  
        "type": "EVPLAN",  
        "scope": "REGIONAL",  
        "location": {  
        "region": "AMER"  
        }  
    }  
    }  
}  
}

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

Création d'une connexion entre un port non marqué et un réseau EPLAN​

Pour créer une connexion à partir d'un port non marqué vers un réseau EPLAN, 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.

curl -X  
POST 'https://api.equinix.com/fabric/v4/connections'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '  
{  
  "type": "EPLAN_VC",  
  "name": "MY-EPLAN-CONNECTION-1",  
  "bandwidth": 1000,  
  "aSide": {  
    "accessPoint": {  
      "type": "COLO",  
      "port": {  
        "uuid": "9127bb72-5f4f-4517-be74-3af7ce612687"  
      }  
    }  
  },  
  "zSide": {  
    "accessPoint": {  
      "type": "NETWORK",  
      "network": {  
        "uuid": "25f8884e-85e3-4eaa-8ea9-a7ad2ca5b3c2"  
      }  
    }  
  },  
  "order": {  
    "purchaseOrderNumber": "1-129105284100"  
  },  
  "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).

Création d'une connexion entre un appareil virtuel et le réseau EVPLAN​

Pour créer une connexion entre un Virtual Device et EVPLAN Network, 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.

curl -X  
POST 'https://api.equinix.com/fabric/v4/connections'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '  
{  
  "type": "EVPLAN_VC",  
  "name": "MY-VD-EVPLAN-CONNECTION-1",  
  "bandwidth": 1000,  
  "aSide": {  
    "accessPoint": {  
      "type": "VD",  
      "virtualDevice": {  
        "type": "EDGE",  
        "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"  
      },  
      "interface": {  
        "type": "NETWORK",  
        "id": 7  
      }  
    }  
  },  
  "zSide": {  
    "accessPoint": {  
      "type": "NETWORK",  
      "network": {  
        "uuid": "25f8884e-85e3-4eaa-8ea9-a7ad2ca5b3c2"  
      }  
    }  
  },  
  "order": {  
    "purchaseOrderNumber": "1-129105284100"  
  },  
  "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).

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