# API - Connexion à AWS Direct Connect Avec Fabric et AWS Direct Connect, établissez une connexion directe de couche 2 entre vos équipements colocalisés IBX et vos ressources Amazon Web Services (AWS). Utilisez le API pour créer la connexion à partir d'un port, d'un appareil Network Edge ou d'un Fabric Cloud Router. ![](https://docs.equinix.com/fr-CA/assets/images/connectToAWS-e4d5112e10b97bf9a1a7d753bf90b11b.png) Si vous disposez d'un jeton de service fourni par AWS, reportez-vous à la rubrique [connexion à une destination à l'aide d'un jeton de service](https://docs.equinix.com/fr-CA/fabric/fabric-api/connect-using-service-token.md) . ## Prérequis de l'API[​](#prérequis-de-lapi "Lien direct vers Prérequis de l'API") 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. Soit : * Déterminez vos informations de ports Equinix Fabric en envoyant une `GET` demande au [`/fabric/v4/ports`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/ports/getports.md)point final. Vous avez besoin du(s) UUID(s) de port et du type de protocole de liaison (DOT1Q ou QINQ), OU * Récupérez vos jetons de service a-Side en envoyant une `GET` demande au [`/fabric/v4/serviceTokens`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Tokens/operation/getServiceTokens)point final. Vous avez besoin de l'UUID du jeton. Le jeton a-Side fournit les informations pertinentes pour configurer le a-Side de la connexion. OU * Déterminez les informations relatives à votre appareil Network Edge. Vérifiez vos périphériques virtuels et clusters disponibles en envoyant une `GET` demande au [`/ne/v1/devices`](https://docs.equinix.com/fr-CA/api-catalog/network-edgev1/virtual-device/getvirtualdevices)terminal. Vous avez besoin du ou des UUID de l'appareil. Envoyer une `GET` demande au [`/ne/v1/devices/{device_id}`](https://docs.equinix.com/fr-CA/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid)terminal pour obtenir les détails d'un appareil. Vous pouvez choisir n'importe quelle interface disponible sur l'appareil pour votre connexion. Si vous n'en spécifiez pas, la connexion est automatiquement attribuée à la prochaine interface disponible. OU * Déterminez vos informations Fabric Cloud Router. Vérifiez vos routeurs cloud disponibles en envoyant une `POST` demande au [`/fabric/v4/routers/search`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/cloud-routers/searchcloudrouters.md)terminal. Vous avez besoin de l'UUID du routeur. 3. Identifiez le profil de service AWS Direct Connect et les informations de localisation. Vous trouverez plus d'informations sur le profil de service que vous devez choisir sur la page[présentation de AWS Direct Connect](https://docs.equinix.com/fr-CA/fabric-marketplace/connecting-to-service-provider/aws/direct-connect-overview.md). * UUID AWS Direct Connect - `69ee618d-be52-468d-bc99-00566f2dd2b9` * UUID haute capacité AWS Direct Connect - `de55ca94-df3b-4680-845f-6f7093f76bef` * UUID redondant AWS Direct Connect - `8b5cbdbd-53da-4d37-9bfc-cc988eb522f1` * AWS Direct Connect- redondant haute capacité - `ed48616a-c182-40b4-a462-a78ba812e961` Pour trouver les informations de localisation, envoyez une `GET` demande au [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid)point final à l'aide de l'un des profils de service IDS AWS Direct Connect. L'`metros`objet de la réponse contient une liste des métros Equinix et leur région AWS associée. Vous avez besoin des deux pour créer une connexion. 4. Identifiez et validez votre identifiant de compte Amazon. Connectez-vous à AWS Management Console et recherchez votre numéro de compte. Pour savoir comment trouver votre numéro de compte, reportez-vous à la [documentation AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html). Envoyez une `POST` demande au [`/fabric/v4/connections/validate`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/validateconnections.md)point de terminaison pour vérifier que votre identifiant de compte AWS peut être utilisé pour créer une connexion au profil de service sélectionné dans la zone métropolitaine donnée. ## Connexion à partir d'un port DOT1Q[​](#connexion-à-partir-dun-port-dot1q "Lien direct vers Connexion à partir d'un port DOT1Q") Pour créer une connexion entre votre port DOT1Q et AWS, envoyez une `POST` demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/createconnection.md)point final. La connexion `type` est `EVPL_VC`. Indiquez vos informations de port dans l'`aSide`objet, notamment : * `accessPoint.type` as `COLO` * Indiquez l'UUID de votre port à `port.uuid` * LinkProtocol.type AS `DOT1Q` * Indiquez l'identifiant VLAN à `linkProtocol.vlanTag` Dans l'objet, indiquez les détails de votre AWS Direct Connect et de votre emplacement`zSide`, notamment : * Définir `accessPoint.type` comme `SP`. * Définir `profile.type` comme `L2_PROFILE`. * Spécifiez le profil de service AWS auquel vous vous connectez dans `profile.uuid`. * Spécifiez l'emplacement métropolitain Equinix auquel vous vous connectez dans `location.metroCode`. * Spécifiez la région AWS associée à la zone métropolitaine Equinix dans `sellerRegion`. Ces informations peuvent être trouvées à partir du [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid) terminal. Voir point de terminaison des[prérequis API](#api-prerequisites). Pour plus de détails, reportez-vous à la section [conditions préalables API](#api-prerequisites). * Définir `authenticationKey` comme identifiant de compte AWS. Dans `redundancy`le corps de la demande, spécifiez tout autre détail de configuration de connexion, y compris `bandwidth` et , . 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 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": "", "bandwidth": , "redundancy": { "priority": "" },   "aSide": {    "accessPoint": {      "type": "COLO",       "port": {        "uuid": ""       },       "linkProtocol": {         "type": "DOT1Q",         "vlanTag":       }     }   }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## Connexion à partir d'un port QINQ[​](#connexion-à-partir-dun-port-qinq "Lien direct vers Connexion à partir d'un port QINQ") Pour créer une connexion entre votre port QINQ et AWS, envoyez `POST`une demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/createconnection.md)point de terminaison. La connexion `type` est `EVPL_VC`. Indiquez vos informations de port dans l'`aSide`objet, notamment : * Définir `accessPoint.type` comme `COLO` * Indiquez l'UUID de votre port à `port.uuid` * `linkProtocol.type` as `QINQ` * Indiquez l'identifiant de l'étiquette interne à `linkProtocol.vlanCTag` * Indiquez l'identifiant de la balise externe à `linkProtocol.vlanSTag` Dans l'objet, indiquez les détails de votre AWS Direct Connect et de votre emplacement`zSide`, notamment : * Définir `accessPoint.type` comme `SP`. * Définir `profile.type` comme `L2_PROFILE`. * Spécifiez le profil de service AWS auquel vous vous connectez dans `profile.uuid`. * Spécifiez l'emplacement métropolitain Equinix auquel vous vous connectez dans `location.metroCode`. * Spécifiez la région AWS associée à la zone métropolitaine Equinix dans `sellerRegion`. Ces informations peuvent être trouvées à partir du [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid) terminal. Voir point de terminaison des[prérequis API](#api-prerequisites). Pour plus de détails, reportez-vous à la section [conditions préalables API](#api-prerequisites). * Définir `authenticationKey` comme identifiant de compte AWS. Dans `redundancy`le corps de la demande, spécifiez tout autre détail de configuration de connexion, y compris `bandwidth` et , . 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 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": "", "bandwidth": , "redundancy": { "priority": "" },   "aSide": {    "accessPoint": { "type": "COLO",       "port": {        "uuid": ""       },       "linkProtocol": {        "type": "QINQ",         "vlanCTag": ,         "vlanSTag":       } }   }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] } ``` ## Connexion à l'aide d'un jeton de service[​](#connexion-à-laide-dun-jeton-de-service "Lien direct vers Connexion à l'aide d'un jeton de service") Pour créer une connexion à AWS à l'aide d'un jeton de service A-Side, envoyez `POST`une demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/createconnection.md)point final. La connexion `type` est `EVPL_VC`. Attribuez votre UUID de jeton de service à dans l'`aSide`objet. Le jeton de service fournit toutes les autres informations nécessaires pour établir la connexion. Dans l'objet, indiquez les détails de votre AWS Direct Connect et de votre emplacement`zSide`, notamment : * Définir `accessPoint.type` comme `SP`. * Définir `profile.type` comme `L2_PROFILE`. * Spécifiez le profil de service AWS auquel vous vous connectez dans `profile.uuid`. * Spécifiez l'emplacement métropolitain Equinix auquel vous vous connectez dans `location.metroCode`. * Spécifiez la région AWS associée à la zone métropolitaine Equinix dans `sellerRegion`. Ces informations peuvent être trouvées à partir du [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid) terminal. Voir point de terminaison des[prérequis API](#api-prerequisites). Pour plus de détails, reportez-vous à la section [conditions préalables API](#api-prerequisites). * Définir `authenticationKey` comme identifiant de compte AWS. Dans `redundancy`le corps de la demande, spécifiez tout autre détail de configuration de connexion, y compris `bandwidth` et , . 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 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": "", "bandwidth": , "redundancy": { "priority": "" },   "aSide": {    "serviceToken": { "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4" } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] } ``` ## Connexion à partir d'un périphérique Network Edge[​](#connexion-à-partir-dun-périphérique-network-edge "Lien direct vers Connexion à partir d'un périphérique Network Edge") Pour créer une connexion entre votre appareil Network Edge et AWS, envoyez une `POST` demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/createconnection.md)terminal. La connexion `type` est `EVPL_VC`. Définissez votre dispositif Network Edge dans l'`aSide`objet, y compris : * `accessPoint.type` as `VD` * `virtualDevice.type` as `EDGE` * `virtualDevice.uuid` Comme UUID de votre appareil Dans l'objet, indiquez les détails de votre AWS Direct Connect et de votre emplacement`zSide`, notamment : * Définir `accessPoint.type` comme `SP`. * Définir `profile.type` comme `L2_PROFILE`. * Spécifiez le profil de service AWS auquel vous vous connectez dans `profile.uuid`. * Spécifiez l'emplacement métropolitain Equinix auquel vous vous connectez dans `location.metroCode`. * Spécifiez la région AWS associée à la zone métropolitaine Equinix dans `sellerRegion`. Ces informations peuvent être trouvées à partir du [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid) terminal. Voir point de terminaison des[prérequis API](#api-prerequisites). Pour plus de détails, reportez-vous à la section [conditions préalables API](#api-prerequisites). * Définir `authenticationKey` comme identifiant de compte AWS. Dans `redundancy`le corps de la demande, spécifiez tout autre détail de configuration de connexion, y compris `bandwidth` et , . 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 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": "", "bandwidth": , "redundancy": { "priority": "" }, "aSide": { "accessPoint": { "type": "VD", "virtualDevice": { "type": "EDGE", "uuid": "" } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## Connexion à partir d'un Fabric Cloud Router[​](#connexion-à-partir-dun-fabric-cloud-router "Lien direct vers Connexion à partir d'un Fabric Cloud Router") Pour créer une connexion entre votre Fabric Cloud Router et AWS, envoyez une `POST` demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/createconnection.md)terminal. La connexion `type` est `IP_VC`. Définissez votre Fabric Cloud Router dans l'`aSide`objet, y compris : * Définir `accessPoint.type` comme `CLOUD_ROUTER`. * Définir `router.uuid` comme UUID de votre routeur. Dans l'objet, indiquez les détails de votre AWS Direct Connect et de votre emplacement`zSide`, notamment : * Définir `accessPoint.type` comme `SP`. * Définir `profile.type` comme `L2_PROFILE`. * Spécifiez le profil de service AWS auquel vous vous connectez dans `profile.uuid`. * Spécifiez l'emplacement métropolitain Equinix auquel vous vous connectez dans `location.metroCode`. * Spécifiez la région AWS associée à la zone métropolitaine Equinix dans `sellerRegion`. Ces informations peuvent être trouvées à partir du [`/fabric/v4/serviceProfiles/{service_profile_ID}`](https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Profiles/operation/getServiceProfileByUuid) terminal. Voir point de terminaison des[prérequis API](#api-prerequisites). Pour plus de détails, reportez-vous à la section [conditions préalables API](#api-prerequisites). * Définir `authenticationKey` comme identifiant de compte AWS 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": "IP_VC", "name": "", "bandwidth": , "redundancy": { "priority": "" }, "aSide": { "accessPoint": { "type": "CLOUD_ROUTER", "router": { "uuid": "" } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "sellerRegion": "", "authenticationKey": "" } }, "project": { "projectId": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## 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/{connection_id}`](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 du AWS Direct Connect** | **Description** | | ---------------------------------- | ----------------------------------- | ------------------------------ | --------------------------------------------------------- | | `PROVISIONING` | `PROVISIONING` | | La demande de connexion n'a pas encore été envoyée à AWS. | | `PROVISIONED` | `PENDING_APPROVAL` | Commande -> Demandé | La connexion est en attente d'acceptation. | | `PROVISIONED` | `PROVISIONING` | En attente | Établissement de la connexion en cours. | | `PROVISIONED` | `PROVISIONED` | En attente -> Disponible | La connexion a été acceptée. |