API - Connexion à AWS Direct Connect

Établissez une connexion directe de couche 2 entre vos ressources IBX colocalisées et vos ressources Amazon Web Services (AWS) avec Fabric et AWS Direct Connect. Utilisez l'API pour créer la connexion depuis un port, un périphérique Network Edge ou un Fabric Cloud Router.

Si vous disposez d'un jeton de service fourni par AWS, consultez Se connecter à une destination à l'aide d'un jeton de service.

Prérequis de l'API

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

2. 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 appareil Network Edge. Consultez vos périphériques virtuels et grappes disponibles en envoyant une requête GET au point de terminaison /ne/v1/devices. Vous aurez besoin du ou des UUID du périphérique. Envoyez une requête GET au point de terminaison /ne/v1/devices/{device_id} pour obtenir les spécificités d'un périphérique. Vous pouvez choisir n'importe quelle interface disponible pour votre connexion. Si vous n'en précisez pas, la connexion sera automatiquement attribuée à la première interface disponible.

   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.

3. Identifiez le profil de service AWS Direct Connect et les informations de localisation. Pour plus d'informations sur le profil de service à choisir, consultez la page Présentation d'AWS Direct Connect.

   • 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 - Capacité redondante élevée - ed48616a-c182-40b4-a462-a78ba812e961

   Pour obtenir les informations de localisation, envoyez une requête GET au point de terminaison /fabric/v4/serviceProfiles/{service_profile_ID} en utilisant l'un des ID de profil de service AWS Direct Connect. L'objet « metros » dans la réponse contient la liste des serveurs Equinix Metro et leur région AWS associée. Ces deux informations sont nécessaires pour établir une connexion.

4. Identifiez et validez votre ID de compte Amazon. Connectez-vous à la console de gestion AWS et localisez votre numéro de compte. Consultez la [documentation AWS pour savoir comment le trouver. Envoyez une requête POST au point de terminaison /fabric/v4/connections/validate pour vérifier que votre ID de compte AWS peut être utilisé pour établir une connexion au profil de service sélectionné dans la zone métropolitaine indiquée.

Connexion à partir d'un port DOT1Q

Pour établir une connexion entre votre port DOT1Q et AWS, 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 connexion AWS Direct Connect et de votre emplacement dans l'objet 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 le site Equinix Metro auquel vous vous connectez dans location.metroCode.
• Spécifiez la région AWS associée à Equinix Metro dans sellerRegion. Cette information est disponible via le point de terminaison /fabric/v4/serviceProfiles/{service_profile_ID}. Consultez la section Prérequis de l'API pour plus de détails.
• Définissez authenticationKey comme votre ID de compte AWS.

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": "<port_uuid>"
      },
      "linkProtocol": {
        "type": "DOT1Q",
        "vlanTag": <vlan_ID>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}'

Connexion à partir d'un port QINQ

Pour établir une connexion entre votre port QINQ et AWS, 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:

• Définir accessPoint.type sur 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 connexion AWS Direct Connect et de votre emplacement dans l'objet 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 le site Equinix Metro auquel vous vous connectez dans location.metroCode.
• Spécifiez la région AWS associée à Equinix Metro dans sellerRegion. Cette information est disponible via le point de terminaison /fabric/v4/serviceProfiles/{service_profile_ID}. Consultez la section Prérequis de l'API pour plus de détails.
• Définissez authenticationKey comme votre ID de compte AWS.

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": "<port_uuid>"
      },
      "linkProtocol": {
        "type": "QINQ",
        "vlanCTag": <inner_tag_ID>,
        "vlanSTag": <outer_tag_ID>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}

Connexion à l'aide d'un jeton de service

Pour établir une connexion à AWS à l'aide d'un jeton de service côté A, 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 connexion AWS Direct Connect et de votre emplacement dans l'objet 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 le site Equinix Metro auquel vous vous connectez dans location.metroCode.
• Spécifiez la région AWS associée à Equinix Metro dans sellerRegion. Cette information est disponible via le point de terminaison /fabric/v4/serviceProfiles/{service_profile_ID}. Consultez la section Prérequis de l'API pour plus de détails.
• Définissez authenticationKey comme votre ID de compte AWS.

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": {
    "serviceToken": {
      "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}

Connexion à partir d'un périphérique Network Edge

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

Définissez votre périphérique Network Edge dans l'objet aSide, notamment:

• accessPoint.type as VD
• virtualDevice.type as EDGE
• virtualDevice.uuid as your device's UUID

Fournissez les détails de votre connexion AWS Direct Connect et de votre emplacement dans l'objet 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 le site Equinix Metro auquel vous vous connectez dans location.metroCode.
• Spécifiez la région AWS associée à Equinix Metro dans sellerRegion. Cette information est disponible via le point de terminaison /fabric/v4/serviceProfiles/{service_profile_ID}. Consultez la section Prérequis de l'API pour plus de détails.
• Définissez authenticationKey comme votre ID de compte AWS.

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": "VD",
      "virtualDevice": {
        "type": "EDGE",
        "uuid": "<device_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}'

Connexion à partir d'un Fabric Cloud Router

Pour établir une connexion entre votre routeur Fabric Cloud 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 connexion AWS Direct Connect et de votre emplacement dans l'objet 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 le site Equinix Metro auquel vous vous connectez dans location.metroCode.
• Spécifiez la région AWS associée à Equinix Metro dans sellerRegion. Cette information est disponible via le point de terminaison /fabric/v4/serviceProfiles/{service_profile_ID}. Consultez la section Prérequis de l'API pour plus de détails.
• Définissez authenticationKey comme votre ID 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 <token>'
-d '{
  "type": "IP_VC",
  "name": "<your_connection_name>",
    "bandwidth": <connection_speed>,
    "redundancy": {
      "priority": "<redundancy_code>"
    },
  "aSide": {
    "accessPoint": {
      "type": "CLOUD_ROUTER",
      "router": {
        "uuid": "<cloud_router_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "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/{connection_id} pour surveiller l'état de la connexion.

equinixStatus attribute values	providerStatus attribute values	AWS Direct Connect State	Description
PROVISIONING	PROVISIONING		Connection request has not been sent to AWS yet.
PROVISIONED	PENDING_APPROVAL	Ordering -> Requested	The connection awaits for acceptance.
PROVISIONED	PROVISIONING	Pending	Connection establishment in progress.
PROVISIONED	PROVISIONED	Pending -> Available	The connection has been accepted.