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.

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 .

Prérequis de l'API

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 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/devicesterminal. Vous avez besoin du ou des UUID de l'appareil. Envoyer une GET demande au /ne/v1/devices/{device_id}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/searchterminal. Vous avez besoin de l'UUID du routeur.
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 pageprésentation de 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- 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}point final à l'aide de l'un des profils de service IDS AWS Direct Connect. L'metrosobjet 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.
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. Envoyez une POST demande au /fabric/v4/connections/validatepoint 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

Pour créer une connexion entre votre port DOT1Q et AWS, envoyez une POST demande au /fabric/v4/connectionspoint final. 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 AWS Direct Connect et de votre emplacementzSide, 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} terminal. Voir point de terminaison desprérequis API. Pour plus de détails, reportez-vous à la section conditions préalables API.
Définir authenticationKey comme identifiant de compte AWS.

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

Indiquez vos informations de port dans l'aSideobjet, 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 emplacementzSide, 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} terminal. Voir point de terminaison desprérequis API. Pour plus de détails, reportez-vous à la section conditions préalables API.
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 <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 créer une connexion à AWS à l'aide d'un jeton de service A-Side, envoyez POSTune demande au /fabric/v4/connectionspoint final. 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 AWS Direct Connect et de votre emplacementzSide, 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} terminal. Voir point de terminaison desprérequis API. Pour plus de détails, reportez-vous à la section conditions préalables API.
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 <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 créer une connexion entre votre appareil Network Edge et AWS, envoyez une POST demande au /fabric/v4/connectionsterminal. La connexion type est EVPL_VC.

Définissez votre dispositif Network Edge dans l'aSideobjet, 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 emplacementzSide, 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} terminal. Voir point de terminaison desprérequis API. Pour plus de détails, reportez-vous à la section conditions préalables API.
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 <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 créer une connexion entre votre Fabric Cloud Router 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 AWS Direct Connect et de votre emplacementzSide, 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} terminal. Voir point de terminaison desprérequis API. Pour plus de détails, reportez-vous à la section conditions préalables API.
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 <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

Envoyer une GET demande au fabric/v4/connections/{connection_id}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.

Prérequis de l'API​

Connexion à partir d'un port DOT1Q​

Connexion à partir d'un port QINQ​

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

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

Connexion à partir d'un Fabric Cloud Router​

Surveillance de l'état de la connexion​

Prérequis de l'API

Connexion à partir d'un port DOT1Q

Connexion à partir d'un port QINQ

Connexion à l'aide d'un jeton de service

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

Connexion à partir d'un Fabric Cloud Router

Surveillance de l'état de la connexion