# API - Se connecter à IBM Cloud Direct Link sur Classic Établissez une connexion avec IBM Cloud™ Direct Link on Classic pour connecter vos actifs colocalisés IBX à vos ressources IBM Cloud. ![](https://docs.equinix.com/fr-CA/assets/images/connectToIbmDirectLink20-d03a5f72aff4e50771a2f6d848d6952d.jpg) ## Identifiez votre identifiant de compte IBM[​](#identifiez-votre-identifiant-de-compte-ibm "Lien direct vers Identifiez votre identifiant de compte IBM") Connectez-vous à la [console IBM Cloud](https://cloud.ibm.com/login) et sélectionnez *gérer* > *compte* pour localiser votre identifiant de compte IBM. ## Prérequis de l'API Fabric[​](#prérequis-de-lapi-fabric "Lien direct vers Prérequis de l'API Fabric") 1. Authentification - Soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète client pour OAuth2 authentification. Pour savoir comment appeler OAuth API pour valider et authentifier vos identifiants, reportez-vous à [authentification API](https://docs.equinix.com/fr-CA/equinix-api/api-authentication.md). 2. Déterminez vos informations A-Side. Récupérez les informations de vos ports Equinix Fabric à l'aide de la demande[Get All ports](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/ports/getports.md) API. 3. Choisissez l'emplacement métropolitain Z-Side. Utilisez la demande[Get All Metros](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/metros/getmetros.md) API pour trouver toutes les[métros](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/metros/getmetros.md) où Equinix Fabric est disponible et déterminer l'emplacement de destination. 4. Identifiez le profil de service. Utilisez la demande API [récupérer les profils de service](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/service-profiles/searchserviceprofiles.md) pour rechercher un profil de service spécifique ou la demande API[répertorier les profils de service](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/service-profiles/listserviceprofiles.md) pour répertorier tous les profils de[service](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/service-profiles/listserviceprofiles.md) disponibles et identifier le système profil auquel vous voulez vous connecter. ## Connexion à IBM Cloud Direct Link sur Classic à partir d'un port DOT1Q[​](#connexion-à-ibm-cloud-direct-link-sur-classic-à-partir-dun-port-dot1q "Lien direct vers Connexion à IBM Cloud Direct Link sur Classic à partir d'un port DOT1Q") Pour créer une connexion entre votre port DOT1Q et IBM Cloud Direct Link on Classic, envoyez `POST`une demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/createconnection.md)point final. Spécifiez les détails de configuration de votre connexion dans le corps de la demande. | | **POST /fabric/v4/connections** | | --------------------- | ------------------------------------------------------------------------------------------------------- | | Méthode | `POST` | | Terminal | `/fabric/v4/connections` | | En-têtes | `Authorization`, `Content-Type` | | Paramètres du chemin | Non applicable | | Paramètres de requête | Non applicable | | Paramètres corporels | `type`, `name`, `order`, `bandwidth`, , `redundancy``aSide`, `zSide`, , `additionalInfo``notifications` | Exemple de requête cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' -H 'content-type: application/json' -H 'authorization: Bearer ' -d '{     "type": "EVPL_VC",     "name": "Conn-1",     "order": {         "purchaseOrderNumber": "1-129105284100"     },     "bandwidth": 1000,     "redundancy": {         "priority": "PRIMARY"     },     "aSide": {         "accessPoint": {             "type": "COLO",             "port": {                 "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"             },             "linkProtocol": {                 "type": "DOT1Q",                 "vlanTag": 1001             }         }     },     "zSide": {         "accessPoint": {             "type": "SP",             "profile": {                 "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"             },             "location": {                 "metroCode": "SV"             },             "authenticationKey": "xx-xxx-xx",             "sellerRegion": "us-west-1"         }     },     "additionalInfo": [         {             "key": "ASN",             "value": "12345"         },         {             "key": "Global",             "value": "false"         }     ],     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test2@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](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/createconnection.md) . Exemple de réponse: ``` {     "href": "https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62",     "type": "EVPL_VC",     "uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62",     "name": "Conn-1",     "state": "PROVISIONING",     "order": {         "purchaseOrderNumber": "1-129105284100",         "billingTier": "Up to 1 Gbps"     },     "bandwidth": 1000,     "redundancy": {         "group": "m167f685-41b0-1b07-6de0-320a5c00abeu",         "priority": "PRIMARY"     },     "aSide": {         "accessPoint": {             "type": "COLO",             "port": {                 "href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",                 "type": "XF_PORT",                 "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"             },             "linkProtocol": {                 "type": "DOT1Q",                 "vlanTag": 1001             }         }     },     "zSide": {         "accessPoint": {             "type": "SP",             "profile": {                 "href": "https://api.equinix.com/fabric/v4/services/serviceProfiles/20d32a80-0d61-4333-bc03-707b591ae2f5",                 "type": "L2_PROFILE",                 "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"             },             "location": {                 "href": "https://api.equinix.com/v4/metros/SV",                 "metroCode": "SV",                 "region": "AMER"             },             "sellerRegion": "us-west-1"         }     },     "additionalInfo": [         {             "key": "ASN",             "value": "12345"         },         {             "key": "Global",             "value": "false"         }     ],     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test2@equinix.com"             ]         }     ],     "operation": {         "equinixStatus": "PROVISIONING",         "providerStatus": "PROVISIONING"     },     "changeLog": {         "createdDateTime": "2021-07-15T19:30:29.526Z"     } } ``` 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](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/createconnection.md) . ## Connexion à IBM Cloud Direct Link on Classic depuis un port QINQ[​](#connexion-à-ibm-cloud-direct-link-on-classic-depuis-un-port-qinq "Lien direct vers Connexion à IBM Cloud Direct Link on Classic depuis un port QINQ") Pour créer une connexion entre votre port QINQ et IBM Cloud Direct Link on Classic, envoyez `POST`une demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/createconnection.md)point 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 ' -d '{     "type": "EVPL_VC",     "name": "Conn-1",     "order": {         "purchaseOrderNumber": "1-129105284100"     },     "bandwidth": 1000,     "redundancy": {         "priority": "PRIMARY"     },     "aSide": {         "accessPoint": {             "type": "COLO",             "port": {                 "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"             },             "linkProtocol": {                 "type": "QINQ",                 "vlanCTag": 1001,                 "vlanSTag": 1002             }         }     },     "zSide": {         "accessPoint": {             "type": "SP",             "profile": {                 "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"             },             "location": {                 "metroCode": "SV"             },             "authenticationKey": "xx-xxx-xx",             "sellerRegion": "us-west-1"         }     },     "additionalInfo": [         {             "key": "ASN",             "value": "12345"         },         {             "key": "Global",             "value": "false"         }     ],     "notifications": [         {             "type": "ALL",             "emails": [                 "test@equinix.com",                 "test2@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](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/createconnection.md) . ## Surveillance de l'état de la connexion[​](#surveillance-de-létat-de-la-connexion "Lien direct vers Surveillance de l'état de la connexion") Envoyer une `GET` demande au [`fabric/v4/connections/{connectionId}`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/getconnectionbyuuid.md)point final pour surveiller l'état de la connexion. | `equinixStatus`valeurs d'attribut | `providerStatus`valeurs d'attribut | État d'**IBM Direct Link** | **Description** | | --------------------------------- | ---------------------------------- | -------------------------------- | --------------------------------------------------------- | | `PROVISIONING` | `PROVISIONING` | - | La demande de connexion n'a pas encore été envoyée à IBM. | | `PENDING_PROVIDER_VLAN` | `PENDING_APPROVAL` | Créer une approbation en attente | La connexion est en attente d'approbation. | | `PROVISIONED` | `PROVISIONING / PROVISIONED` | Création en cours | Établissement de la connexion en cours. | | `PROVISIONED` | `PROVISIONED` | Provisionné | Connexion établie. | ## Accepter la connexion[​](#accepter-la-connexion "Lien direct vers Accepter la connexion") Connectez-vous à la [console IBM Cloud](https://cloud.ibm.com/login) et accédez à la [page IBM Cloud Direct Link Exchange](https://cloud.ibm.com/classic/network/directlink/exchange) pour vérifier et accepter la connexion en attente.