Passer au contenu principal

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. Pour savoir comment appeler OAuth API pour valider et authentifier vos identifiants, reportez-vous à authentification API.

  2. Obtenir les informations sur votre réseau Fabric : envoyez une POST demande au fabric/v4/networks/searchterminal 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 de vos ports Equinix Fabric à l'aide du point de terminaisonobtenir tous les ports. Pour trouver des informations sur un port spécifique, utilisez le point de terminaisonobtenir le port spécifié.

    • Déterminez les informations relatives à votre appareil Network Edge. Vous avez besoin d'un dispositif virtuel Equinix/de dispositifs redondants/de clusters provisionnés avec une licence enregistrée. Vérifiez vos dispositifs virtuels et clusters disponibles en appelant GetVirtualDevices ou Get Virtual Device {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.

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 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 chemin d'accèsNon applicable
Paramètres d'interrogationNon applicable
Paramètres du corpstype, name, order, bandwidth, , aSide``zSide, notifications, redondance

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": "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 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": "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 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 entre un port non marqué et un réseau EPLAN​

Pour créer une connexion entre un port non balisé et un réseau EPLAN, envoyez POSTune demande au /fabric/v4/connectionspoint final. Spécifiez les détails de configuration de votre connexion dans le corps de la demande.

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

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

Pour créer une connexion entre un appareil virtuel et un réseau EVPLAN, envoyez POSTune demande au /fabric/v4/connectionspoint de terminaison. Spécifiez les détails de configuration de votre connexion dans le corps de la demande.

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

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