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

Conditions préalables

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.
Déterminez vos informations A-Side. Soit :
- Déterminez vos informations de ports Equinix Fabric en envoyant une GET demande au /fabric/v4/portspoint 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/serviceTokenspoint 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/searchterminal. Vous avez besoin de l'UUID du routeur.
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 pageprésentation de Azure ExpressRoute.
- Azure ExpressRoute - a1390b22-bbe0-4e93-ad37-85beef9d254d
- Azure Government ExpressRoute - 0de4e413-edd7-4325-912f-7c8a4428e156
Identifiez et validez votre clé de service ExpressRoute. Envoyez une POST demande au /fabric/v4/connections/validatepoint 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

Pour créer une connexion entre votre port DOT1Q et Azure ExpressRouter, envoyez POSTune demande au /fabric/v4/connectionspoint de terminaison. La connexion type est EVPL_VC.

Indiquez vos informations de port dans l'aSideobjet, 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 emplacementzSide, 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.
(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 redundancyle 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 .

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 créer une connexion entre votre port DOT1Q et Azure ExpressRouter, envoyez POSTune demande au /fabric/v4/connectionspoint de terminaison. La connexion type est EVPL_VC.

Indiquez vos informations de port dans l'aSideobjet, 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 emplacementzSide, 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.
(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.

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 créer une connexion entre votre port DOT1Q et Azure ExpressRouter, envoyez POSTune demande au /fabric/v4/connectionspoint de terminaison. La connexion type est EVPL_VC.

Attribuez votre UUID de jeton de service à dans l'aSideobjet. 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 emplacementzSide, 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.
(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.

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 créer une connexion entre votre appareil Network Edge et AWS, envoyez une POST demande au /fabric/v4/connectionsterminal. La connexion type est IP_VC.

Définissez votre Fabric Cloud Router dans l'aSideobjet, 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 emplacementzSide, 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.
(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.

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

Envoyer une GET demande au fabric/v4/connections/{connectionId}point final pour surveiller l'état de la connexion.

États de connexion Equinix		États d'Azur
`equinixStatus` valeurs d'attribut	`providerStatus` valeurs d'attribut	Statut du fournisseur	État des peerings	Description
`PROVISIONING`	`PROVISIONING`	Non approvisionné	Non approvisionné	La demande de connexion n'a pas encore été envoyée à Microsoft.
`PENDING_BGP_PEERING`	`PENDING_BGP`	Provisionné	Non approvisionné	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 APIactions de connexion. Si vous vous connectez à Azure ExpressRoute à partir d'un Fabric Cloud Router, vous devez également configurer vos détails de routage pour la connexion dans le Equinix Customer Portal.
`PROVISIONING`	`PROVISIONED`			Le provisionnement est terminé du côté de Microsoft et la connexion est en cours de provisionnement du côté d'Equinix.
`PROVISIONED`	`PROVISIONED`			Connexion établie.

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