API - Connexion à Microsoft Azure ExpressRoute

Établissez une connexion directe de couche 2 à Microsoft Azure pour accéder à l’infrastructure cloud Azure et à d’autres services cloud Azure.

remarque

Ce document explique comment créer une connexion à partir d'un port, d'un jeton de service ou d'un routeur infonuagique dans l'API. Pour plus d'informations sur la création d'une connexion à partir d'un appareil virtuel, y compris dans l'API, consultez Network Edge vers Azure ExpressRoute.

Conditions préalables

Authentification - Soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète client pour OAuth2 Authentification. Consultez Authentification API pour obtenir des instructions sur la façon d'appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.
Déterminez vos informations de la face A. Soit:
- Pour obtenir les informations relatives aux ports de votre infrastructure Equinix Fabric, envoyez une requête GET au point de terminaison /fabric/v4/ports. Vous aurez besoin du ou des UUID du port et du type de protocole de liaison (DOT1Q ou QINQ).
OU
- Récupérez votre ou vos jetons de service côté client en envoyant une requête GET au point de terminaison /fabric/v4/serviceTokens (https://docs.equinix.com/api-catalog/fabricv4/#tag/Service-Tokens/operation/getServiceTokens). Vous aurez besoin de l'UUID du jeton. Ce jeton côté client fournit les informations nécessaires à la configuration de la partie client de la connexion.
OU
- Déterminez les informations de votre routeur Fabric Cloud. Consultez la liste des routeurs infonuagiques disponibles en envoyant une requête POST au point de terminaison /fabric/v4/routers/search. Vous aurez besoin de l'UUID du routeur.
Identifiez les renseignements du profil de service Azure ExpressRoute. Pour plus d'informations sur le profil de service à choisir, consultez la page Présentation d'Azure ExpressRoute.
- Azure ExpressRoute - a1390b22-bbe0-4e93-ad37-85beef9d254d
- Administration express Azure - 0de4e413-edd7-4325-912f-7c8a4428e156
Identifiez et validez votre clé de service ExpressRoute. Envoyez une requête POST au point de terminaison /fabric/v4/connections/validate 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

Pour établir une connexion entre votre port DOT1Q et Azure ExpressRouter, envoyez une requête POST au point de terminaison /fabric/v4/connections. Le type de connexion est EVPL_VC.

Veuillez indiquer les informations relatives à votre port dans l'objet aSide, notamment:

accessPoint.type as COLO
Fournissez l'UUID de votre port à port.uuid
linkProtocol.type as DOT1Q
Fournissez l'ID du VLAN à linkProtocol.vlanTag

Fournissez les détails de votre itinéraire Azure ExpressRoute et les détails de localisation dans l'objet 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 le site Equinix Metro auquel vous vous connectez dans location.metroCode.
Définissez authenticationKey comme clé de service ExpressRoute.
Définissez peeringType sur MICROSOFT ou PRIVATE, selon les services pour lesquels vous utilisez la connexion. Pour plus d'informations, consultez Configuration du pairage.
(Optionnel) Définissez linkProtocol.type sur QINQ et spécifiez un linkProtocol.vlanCTag. Cela définit l'ID du VLAN ExpressRoute utilisé pour l'appairage. Vous pouvez également définir cette valeur dans le portail Azure après avoir créé la connexion.

Précisez les autres détails de configuration de connexion, y compris la bande passante et la redondance, dans le corps de la requête. Pour obtenir la liste complète des paramètres et leurs descriptions, consultez la référence de l'API.

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": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "COLO",
      "port": {
        "uuid": "<your_port_uuid>"
      },
      "linkProtocol": {
        "type": "DOT1Q",
        "vlanTag": <vlan_id>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "DC"
      },
      "linkProtocol": {
        "type": "QINQ",
        "vlanCTag": <vlan_id>
      },
      "peeringType": "<peering_type>",
      "authenticationKey": "<expressroute_service_key>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<purchase_order_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>"
      ]
    }
  ]
}

Connexion à partir d'un port QINQ

Pour établir une connexion entre votre port DOT1Q et Azure ExpressRouter, envoyez une requête POST au point de terminaison /fabric/v4/connections. Le type de connexion est EVPL_VC.

Veuillez indiquer les informations relatives à votre port dans l'objet aSide, notamment:

accessPoint.type as COLO
Fournissez l'UUID de votre port à port.uuid
linkProtocol.type as QINQ
Fournissez l'ID de la balise interne à linkProtocol.vlanCTag
Fournissez l'ID de la balise externe à linkProtocol.vlanSTag

Fournissez les détails de votre itinéraire Azure ExpressRoute et les détails de localisation dans l'objet 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 le site Equinix Metro auquel vous vous connectez dans location.metroCode.
Définissez authenticationKey comme clé de service ExpressRoute.
Définissez peeringType sur MICROSOFT ou PRIVATE, selon les services pour lesquels vous utilisez la connexion. Pour plus d'informations, consultez Configuration du pairage.
(Optionnel) Définissez linkProtocol.type sur QINQ et spécifiez un linkProtocol.vlanCTag. Cela définit l'ID du VLAN ExpressRoute utilisé pour l'appairage. Vous pouvez également définir cette valeur dans le portail Azure après avoir créé la connexion.

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": "EVPL_VC",
  "name": "<connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "COLO",
      "port": {
        "uuid": "<port_uuid>"
      },
      "linkProtocol": {
        "type": "QINQ",
        "vlanSTag": <vlan_id>,
        "vlanCTag": <vlan_id>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<metro_code>"
      },
      "authenticationKey": "<expressroute_service_key>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<purchase_order_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>"
      ]
    }
  ]
}'

Connexion à l'aide d'un jeton de service

Pour établir une connexion entre votre port DOT1Q et Azure ExpressRouter, envoyez une requête POST au point de terminaison /fabric/v4/connections. Le type de connexion est EVPL_VC.

Fournissez l'UUID de votre jeton de service dans l'objet aSide. Ce jeton de service fournit tous les autres renseignements nécessaires à l'établissement de la connexion.

Fournissez les détails de votre itinéraire Azure ExpressRoute et les détails de localisation dans l'objet 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 le site Equinix Metro auquel vous vous connectez dans location.metroCode.
Définissez authenticationKey comme clé de service ExpressRoute.
Définissez peeringType sur MICROSOFT ou PRIVATE, selon les services pour lesquels vous utilisez la connexion. Pour plus d'informations, consultez Configuration du pairage.
(Optionnel) Définissez linkProtocol.type sur QINQ et spécifiez un linkProtocol.vlanCTag. Cela définit l'ID du VLAN ExpressRoute utilisé pour l'appairage. Vous pouvez également définir cette valeur dans le portail Azure après avoir créé la connexion.

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": "EVPL_VC",
  "name": "<connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {  
    "serviceToken": {  
      "uuid": "<your_aside_service_token>"  
    } 
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<metro_code>"
      },
      "authenticationKey": "<expressroute_service_key>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<purchase_order_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>"
      ]
    }
  ]
}'

Connexion à partir d'un Fabric Cloud Router

Pour établir une connexion entre votre périphérique Network Edge et AWS, envoyez une requête POST au point de terminaison /fabric/v4/connections. Le type de connexion est IP_VC.

Définissez votre routeur Fabric Cloud dans l'objet aSide, en incluant:

Définir accessPoint.type sur CLOUD_ROUTER.
Définissez router.uuid comme l'UUID de votre routeur.

Fournissez les détails de votre itinéraire Azure ExpressRoute et les détails de localisation dans l'objet 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 le site Equinix Metro auquel vous vous connectez dans location.metroCode.
Définissez authenticationKey comme clé de service ExpressRoute.
Définissez peeringType sur MICROSOFT ou PRIVATE, selon les services pour lesquels vous utilisez la connexion. Pour plus d'informations, consultez Configuration du pairage.
(Optionnel) Définissez linkProtocol.type sur QINQ et spécifiez un linkProtocol.vlanCTag. Cela définit l'ID du VLAN ExpressRoute utilisé pour l'appairage. Vous pouvez également définir cette valeur dans le portail Azure après avoir créé la connexion.

curl -X  
POST 'https://api.equinix.com/fabric/v4/connections'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '{
  "type": "IP_VC",
    "name": "<connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "CLOUD_ROUTER",
      "router": {
        "uuid": "<router_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<metro_code>"
      },
      "authenticationKey": "<expressroute_service_key>"
    }
  },
  "order": {
    "purchaseOrderNumber": "<purchase_order_number>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
        "<contact_email>"
      ]
    }
  ]
}'

Surveillance de l'état de la connexion

Envoyez une requête GET au point de terminaison fabric/v4/connections/{connectionId} pour surveiller l'état de la connexion.

Equinix Connection States		Azure States
`equinixStatus` attribute values	`providerStatus` attribute values	Provider Status	Peerings Status	Description
`PROVISIONING`	`PROVISIONING`	Not provisioned	Not provisioned	Connection request has not been sent to Microsoft yet.
`PENDING_BGP_PEERING`	`PENDING_BGP`	Provisioned	Not provisioned	The connection has been approved and awaits for the customer to configure Microsoft peering on the Microsoft Azure portal. If you are connecting to Azure ExpressRoute from a Port, the status remains `PENDING_BGP_PEERING` until peering is completed in the Microsoft Azure portal and the status only changes to `PROVISIONED` once Equinix Fabric syncs with Microsoft. If you want to synchronize the BGP peering instantly, use Connection Actions API endpoint. If you are connecting to Azure ExpressRoute from a Fabric Cloud Router, you also need to configure your routing details for the connection in the Equinix Customer Portal.
`PROVISIONING`	`PROVISIONED`			Provisioning completed at Microsoft's end and the connection is provisioning at Equinix's end.
`PROVISIONED`	`PROVISIONED`			Connection established.

Conditions préalables​

Connexion à partir d'un port DOT1Q​

Connexion à partir d'un port QINQ​

Connexion à l'aide d'un jeton de service​

Connexion à partir d'un Fabric Cloud Router​

Surveillance de l'état de la connexion​

Conditions préalables

Connexion à partir d'un port DOT1Q

Connexion à partir d'un port QINQ

Connexion à l'aide d'un jeton de service

Connexion à partir d'un Fabric Cloud Router

Surveillance de l'état de la connexion