# API - Connexion à Microsoft Azure ExpressRoute Établir une connexion directe, de couche 2, à Microsoft Azure pour accéder à l'infrastructure du cloud Azure et à d'autres services du cloud Azure. ![](https://docs.equinix.com/fr/assets/images/connectToMicrosoftAzure-7cbea56c79acbe0302b172a682b43b7e.jpg) > **Note** > > Ce document traite de la création d'une connexion à partir d'un port, d'un jeton de service ou d'un routeur cloud dans le API. Pour plus d'informations sur la création d'une connexion à partir d'un périphérique virtuel, y compris dans le API, consultez [Network Edge to Azure ExpressRoute](https://docs.equinix.com/fr/fabric-marketplace/connecting-to-service-provider/microsoft/ne-azure-expressroute.md) ## Conditions préalables[​](#conditions-préalables "Lien direct vers 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](https://docs.equinix.com/fr/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/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 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/api-catalog/fabricv4/cloud-routers/searchcloudrouters.md)terminal. Vous avez besoin de l'UUID du routeur. 3. Identifiez les informations du profil de service Azure ExpressRoute. Vous trouverez plus d'informations sur le profil de service que vous devez choisir sur la page[présentation de Azure ExpressRoute](https://docs.equinix.com/fr/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#azure-express-route-service-profiles). * Azure ExpressRoute - `a1390b22-bbe0-4e93-ad37-85beef9d254d` * Azure Government ExpressRoute - `0de4e413-edd7-4325-912f-7c8a4428e156` 4. Identifiez et validez votre clé de service ExpressRoute. Envoyez une `POST` demande au [`/fabric/v4/connections/validate`](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/validateconnections.md)point de terminaison pour vérifier que votre clé de service ExpressRoute peut être utilisée 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 Azure ExpressRouter, envoyez `POST`une demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr/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 : * `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 Azure ExpressRoute 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 Azure ExpressRoute auquel vous vous connectez dans `profile.uuid`. * Spécifiez l'emplacement métropolitain Equinix auquel vous vous connectez dans `location.metroCode`. * Définir `authenticationKey` comme clé de service ExpressRoute . * Définir `peeringType` comme `MICROSOFT` ou `PRIVATE`, en fonction des services pour lesquels vous utilisez la connexion. Pour plus d'informations, consultez [Configuration de l'appairage](https://docs.equinix.com/fr/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering). * (*Facultatif*) définissez `linkProtocol.type` sur `QINQ` et spécifiez un `linkProtocol.vlanCTag`. Ceci définit l'identifiant VLAN ExpressRoute utilisé pour l'appairage. Vous pouvez également définir cette valeur dans le portail Azure après avoir créé la connexion. 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/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": "DC" }, "linkProtocol": { "type": "QINQ", "vlanCTag": }, "peeringType": "", "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "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 DOT1Q et Azure ExpressRouter, envoyez `POST`une demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr/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 : * `accessPoint.type` as `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 Azure ExpressRoute 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 Azure ExpressRoute auquel vous vous connectez dans `profile.uuid`. * Spécifiez l'emplacement métropolitain Equinix auquel vous vous connectez dans `location.metroCode`. * Définir `authenticationKey` comme clé de service ExpressRoute . * Définir `peeringType` comme `MICROSOFT` ou `PRIVATE`, en fonction des services pour lesquels vous utilisez la connexion. Pour plus d'informations, consultez [Configuration de l'appairage](https://docs.equinix.com/fr/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering). * (*Facultatif*) définissez `linkProtocol.type` sur `QINQ` et spécifiez un `linkProtocol.vlanCTag`. Ceci définit l'identifiant VLAN ExpressRoute utilisé pour l'appairage. Vous pouvez également définir cette valeur dans le portail Azure après avoir créé la connexion. 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/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", "vlanSTag": , "vlanCTag": } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "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 entre votre port DOT1Q et Azure ExpressRouter, envoyez `POST`une demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md)point de terminaison. 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 Azure ExpressRoute 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 Azure ExpressRoute auquel vous vous connectez dans `profile.uuid`. * Spécifiez l'emplacement métropolitain Equinix auquel vous vous connectez dans `location.metroCode`. * Définir `authenticationKey` comme clé de service ExpressRoute . * Définir `peeringType` comme `MICROSOFT` ou `PRIVATE`, en fonction des services pour lesquels vous utilisez la connexion. Pour plus d'informations, consultez [Configuration de l'appairage](https://docs.equinix.com/fr/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering). * (*Facultatif*) définissez `linkProtocol.type` sur `QINQ` et spécifiez un `linkProtocol.vlanCTag`. Ceci définit l'identifiant VLAN ExpressRoute utilisé pour l'appairage. Vous pouvez également définir cette valeur dans le portail Azure après avoir créé la connexion. 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/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": "" } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "L2_PROFILE", "uuid": "" }, "location": { "metroCode": "" }, "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "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 appareil Network Edge et AWS, envoyez une `POST` demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr/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 Azure ExpressRoute 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 Azure ExpressRoute auquel vous vous connectez dans `profile.uuid`. * Spécifiez l'emplacement métropolitain Equinix auquel vous vous connectez dans `location.metroCode`. * Définir `authenticationKey` comme clé de service ExpressRoute . * Définir `peeringType` comme `MICROSOFT` ou `PRIVATE`, en fonction des services pour lesquels vous utilisez la connexion. Pour plus d'informations, consultez [Configuration de l'appairage](https://docs.equinix.com/fr/fabric-marketplace/connecting-to-service-provider/microsoft/azure-express-route-overview.md#configuring-peering). * (*Facultatif*) définissez `linkProtocol.type` sur `QINQ` et spécifiez un `linkProtocol.vlanCTag`. Ceci définit l'identifiant VLAN ExpressRoute utilisé pour l'appairage. Vous pouvez également définir cette valeur dans le portail Azure après avoir créé la connexion. 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/api-catalog/fabricv4/connections/createconnection.md) . ``` 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": "" }, "authenticationKey": "" } }, "order": { "purchaseOrderNumber": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` ## Contrôle de l'état de la connexion[​](#contrôle-de-létat-de-la-connexion "Lien direct vers Contrôle de l'état de la connexion") Envoyer une `GET` demande au [`fabric/v4/connections/{connectionId}`](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/getconnectionbyuuid.md)point final pour surveiller l'état de la connexion. | États de connexion Equinix | | États d'Azure | | | | -------------------------------------- | --------------------------------------- | ------------------------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **`equinixStatus`** valeurs d'attribut | **`providerStatus`** valeurs d'attribut | **Statut du fournisseur** | **État des peerings** | **Description** | | `PROVISIONING` | `PROVISIONING` | Non provisionné | Non provisionné | La demande de connexion n'a pas encore été envoyée à Microsoft. | | `PENDING_BGP_PEERING` | `PENDING_BGP` | Provisionné | Non provisionné | La connexion a été approuvée et attend que le client configure le peering Microsoft sur le portail Microsoft Azure. Si vous vous connectez à Azure ExpressRoute à partir d'un port, l'état reste `PENDING_BGP_PEERING` jusqu'à ce que l'appairage soit terminé dans le portail Microsoft Azure et l'état ne passe qu'`PROVISIONED`à une fois que Equinix Fabric est synchronisé avec Microsoft. Si vous souhaitez synchroniser l'appairage BGP instantanément, utilisez le point de terminaison API[actions de connexion](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnectionaction.md). Si vous vous connectez à Azure ExpressRoute à partir d'un Fabric Cloud Router, vous devez également [configurer vos détails de routage](https://docs.equinix.com/fr/fabric-cloud-router/bgp/fcr-bgp.md) pour la connexion dans le Equinix Customer Portal. | | `PROVISIONING` | `PROVISIONED` | | | Le provisionnement s'est achevé du côté de Microsoft et la connexion est en cours de provisionnement du côté d'Equinix. | | `PROVISIONED` | `PROVISIONED` | | | Connexion établie. |