# Commande d'un accès Internet avec un port Fabric Equinix Internet Access (EIA) fournit un accès Internet mixte à l'aide de plusieurs fournisseurs d'accès Internet (ISPs) de niveau 1 et d'échanges Internet Equinix (ix) pour offrir une disponibilité, une fiabilité et une vitesse élevées. * La connexion Fabric entre votre port Fabric et le profil de service d'accès Internet Equinix est fournie gratuitement. * Lorsque vous [déprovisionnez votre instance de service d'accès Internet](https://docs.equinix.com/fr-CA/internet-access/eia-api/deprovision-eia-api.md) , la connexion Fabric associée est également déprovisionnée. * En cas de problème de provisionnement d'une instance de service d'accès Internet, la connexion Fabric associée est automatiquement déprovisionnée. Equinix Internet Access avec Fabric est disponible pour les organisations intégrées à la [gestion des identités et des accès Equinix](https://docs.equinix.com/fr-CA/iam.md) , et le compte utilisé pour envoyer les demandes API doit avoir le `Equinix Fabric Manager` rôle. Si votre organisation n'a pas été intégrée à la gestion des identités et des accès Equinix, vous pouvez [commander Equinix Internet Access avec port dédié](https://docs.equinix.com/fr-CA/internet-access/eia-api/order-eia-dedicated-port-api.md) . ## Conditions préalables[​](#conditions-préalables "Lien direct vers Conditions préalables") 1. Authentification - Soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète client pour OAuth2 authentification. Pour obtenir des instructions sur la façon d'appeler l'API OAuth pour valider et authentifier vos identifiants, reportez-vous à [authentification API](https://docs.equinix.com/fr-CA/equinix-api/api-authentication.md). 2. Déterminez les informations A-Side. Pour obtenir les informations de votre port Fabric, envoyez `GET`une demande au [`/fabric/v4/ports`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/ports/getports.md)point final. Vous avez besoin du ou des UUID du port, du type de protocole de liaison (DOT1Q ou QINQ). Si vous créez une connexion redondante, choisissez à la fois un `PRIMARY` port et un `SECONDARY` port. Vous avez besoin de ces informations pour la demande de création de connexion. 3. Déterminez les informations Z-Side. Le profil de service d'accès à Internet est de type `IA_PROFILE` et son identifiant est `32d81829-0bf8-45d5-84e2-7289a553dbb6`. Pour déterminer l'emplacement métropolitain pour votre service, envoyez une `GET` demande au [`/internetAccess/v2/ibxs`](https://docs.equinix.com/fr-CA/api-catalog/internetaccessv2/product-availability/getibxs.md)terminal afin de trouver les emplacements où l'accès Internet est disponible. Vous avez besoin de ces informations pour commander votre service d’accès Internet. ## Création d'une connexion Internet[​](#création-dune-connexion-internet "Lien direct vers Création d'une connexion Internet") Pour créer la connexion pour votre service d’accès Internet, envoyez une `POST` demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/createconnection.md)point final. La connexion `type` est `IA_VC`. Indiquez vos informations de port dans l'`aSide`objet, notamment : * `accessPoint.type` as `COLO` * Indiquez l'UUID de votre port à `port.uuid` Si vous vous connectez à partir d'un port Dot1q: * LinkProtocol.type AS `DOT1Q` * Indiquez l'identifiant VLAN à `linkProtocol.vlanTag` Si vous vous connectez à partir d'un port QinQ: * LinkProtocol.type AS `QINQ` * Indiquez l'identifiant de l'étiquette interne à `linkProtocol.vlanCTag` * Indiquez l'identifiant de la balise externe à `linkProtocol.vlanSTag` * Si vous créez des connexions redondantes, faites deux requêtes. L'une des demandes doit avoir votre port principal et `redundancy.priority` défini sur `PRIMARY`, et l'autre votre port secondaire et `redundancy.priority` défini sur `SECONDARY` et vous devez spécifier `redundancy.group` comme UUID de la première connexion. Fournir le profil de service d’accès Internet dans l’`zSide`objet, y compris : * `accessPoint.type` as `SP`. * `profile.type` as `IA_PROFILE` * `profile.uuid` as `32d81829-0bf8-45d5-84e2-7289a553dbb6` * `metroCode` Code métropolitain à deux lettres du métro d'accès Internet auquel vous vous connectez. Exemples de demandes de curl : Exemple de connexion principale ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "type": "IA_VC", "name": "", "bandwidth": , "redundancy": { "priority": "PRIMARY" }, "aSide": { "accessPoint": { "type": "COLO", "port": { "uuid": "" }, "linkProtocol": { "type": "DOT1Q", "vlanTag": } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "IA_PROFILE", "uuid": "32d81829-0bf8-45d5-84e2-7289a553dbb6" }, "location": { "metroCode": "" } } }, "project": { "projectId": "" }, "order": { "purchaseOrderNumber": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` Exemple de connexion secondaire ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "type": "IA_VC", "name": "", "bandwidth": , "redundancy": { "priority": "SECONDARY", "group": "" }, "aSide": { "accessPoint": { "type": "COLO", "port": { "uuid": "" }, "linkProtocol": { "type": "DOT1Q", "vlanTag": } } }, "zSide": { "accessPoint": { "type": "SP", "profile": { "type": "IA_PROFILE", "uuid": "32d81829-0bf8-45d5-84e2-7289a553dbb6" }, "location": { "metroCode": "" } } }, "project": { "projectId": "" }, "order": { "purchaseOrderNumber": "" }, "notifications": [ { "type": "ALL", "emails": [ "" ] } ] }' ``` > **Important** > > La réponse contient un `uuid`identifiant de connexion de votre service d'accès Internet. Vous devez disposer de cet UUID de connexion pour commander le service d’accès Internet. ## Service de commande avec blocage IP attribué par le fournisseur[​](#service-de-commande-avec-blocage-ip-attribué-par-le-fournisseur "Lien direct vers Service de commande avec blocage IP attribué par le fournisseur") Pour commander votre service d’accès Internet, envoyez une `POST` demande au [`/internetAccess/v2/services`](https://docs.equinix.com/fr-CA/api-catalog/internetaccessv2/eia-service/createequinixinternetaccessv2.md)terminal. Pour la redondance, si vous avez créé deux connexions pour votre service, définissez `type` sur `DUAL`et fournissez les deux IDS de connexion à la `connections` baie. Si vous avez créé une connexion unique pour votre service, définissez `type` sur `SINGLE` et fournissez l'ID de connexion à la `connections` baie. Dans l'`routingProtocol`objet, spécifiez : * Votre `routingProtocol.type` de `STATIC`, , `DIRECT`ou `BGP`. * Lors de la commande de votre service à l'aide de blocs IP appartenant à Equinix (PA), définissez la `ipBlock.prefixLength` valeur sur la taille du bloc IP dont vous avez besoin. > **Remarque** > > Lors de la commande d'une instance de service EIA située dans l'un de nos datacentres IBX dans la région APAC, veillez à ajouter les `addressingPlans`informations et `questions`à l'`ipBlock`objet en cas de blocage IPv4 PA. Pour plus d'informations, reportez-vous à la [référence API](https://docs.equinix.com/fr-CA/api-catalog/internetaccessv2/eia-service/createequinixinternetaccessv2.md). ### Routage statique[​](#routage-statique "Lien direct vers Routage statique") La documentation sur le routage statique est [disponible ici](https://docs.equinix.com/fr-CA/internet-access/routing/static-routing.md). Exemples de demandes de curl : Exemple de service statique unique dans la région APAC ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "STATIC", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": , "addressingPlans": [ { "afterThreeMonths": , "immediate": , "purpose": "", "size": } ], "questions": [ { "answer": "YES", "type": "PRIVATE_SPACE_CONSIDERED" }, { "answer": "NO", "type": "REFUSED_PREVIOUSLY" }, { "answer": "NO", "type": "RETURNING_ADDRESS_SPACE" } ] } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` Exemple de service statique double ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "STATIC", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ### Routage direct[​](#routage-direct "Lien direct vers Routage direct") La documentation sur le routage direct peut être trouvée [ici](https://docs.equinix.com/fr-CA/internet-access/routing/direct-routing.md). Exemples de demandes de curl : Exemple de service direct unique ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "DIRECT", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` Exemple de service Dual Direct ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "DIRECT", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ### Routage BGP[​](#routage-bgp "Lien direct vers Routage BGP") Spécifiez les détails de votre configuration BGP dans l'`routingProtocol`objet : * Les routes que vous souhaitez annoncer sur Internet, `FULL`, `DEFAULT`, , `FULL_DEFAULT`ou `PARTIAL`dans `routingProtocol.exportPolicy`. * Indiquez la plage d'ASN du client BITS\_16 pour l'ASN 16 bits ou BITS\_32 pour l'ASN 32 bits dans `routingProtocol.customerAsnRange`. * Si nécessaire, saisissez bgpAuthKey`routingProtocol.bgpAuthKey`. La documentation sur le routage BGP est [disponible ici](https://docs.equinix.com/fr-CA/internet-access/routing/bgp-routing.md). Exemples de demandes de curl : Exemple de service BGP unique ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "My Internet Access Service", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "BGP", "customerAsnRange": "", "bgpAuthKey": "", "exportPolicy": "", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` Exemple de service Dual BGP ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "BGP", "customerAsnRange": "", "bgpAuthKey": "", "exportPolicy": "", "ipv4": { "customerRoutes": [ "ipBlock": { "prefixLength": } } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ## Service de commande avec blocage IP indépendant du fournisseur[​](#service-de-commande-avec-blocage-ip-indépendant-du-fournisseur "Lien direct vers Service de commande avec blocage IP indépendant du fournisseur") Lors de la commande de votre service à l'aide de votre propre IP Block (PI), spécifiez-le dans `customerRoutes.prefix` ### Routage statique[​](#routage-statique-1 "Lien direct vers Routage statique") Exemples de demandes de curl : Exemple de service statique unique ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "STATIC", "ipv4": { "customerRoutes": [ { "prefix": "" } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` Exemple de service statique double ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "STATIC", "ipv4": { "customerRoutes": [ { "prefix": "" } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ### Routage direct[​](#routage-direct-1 "Lien direct vers Routage direct") Spécifiez les adresses IP de votre bloc IP qui peuvent être utilisées à des fins d'appairage dans l'`peering`objet. Pour le type de service unique, fournissez une seule adresse IP dans la `equinixPeerIps` baie. Pour le type de service double, indiquez deux adresses IP dans la `equinixPeerIps` baie et l'adresse IP VRRP dans le `equinixVRRPIp` champ. Exemples de demandes de curl : Exemple de service direct unique ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "DIRECT", "ipv4": { "customerRoutes": [ { "prefix": "" } ], "peerings": [ { "equinixPeerIps": [ "" ] } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ], "peerings": [ { "equinixPeerIps": [ "" ] } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` Exemple de service Dual Direct ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "DIRECT", "ipv4": { "customerRoutes": [ { "prefix": "" } ], "peerings": [ { "equinixPeerIps": [ "", "" ], "equinixVRRPIp": "" } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ], "peerings": [ { "equinixPeerIps": [ "", "" ], "equinixVRRPIp": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ### Routage BGP[​](#routage-bgp-1 "Lien direct vers Routage BGP") Exemples de demandes de curl : Exemple de service BGP unique ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "BGP", "customerAsnRange": "", "bgpAuthKey": "", "exportPolicy": "", "ipv4": { "customerRoutes": [ { "prefix": "" } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` Exemple de service Dual BGP ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "DUAL", "connections": [ "", "" ], "routingProtocol": { "type": "BGP", "customerAsnRange": "", "bgpAuthKey": "", "exportPolicy": "", "ipv4": { "customerRoutes": [ { "prefix": "" } ] }, "ipv6": { "customerRoutes": [ { "prefix": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ## Service de commande avec blocs PA et PI IP[​](#service-de-commande-avec-blocs-pa-et-pi-ip "Lien direct vers Service de commande avec blocs PA et PI IP") Lors de la commande de votre service avec des blocs IP attribués par le fournisseur (PA) et indépendants du fournisseur (PI), spécifiez deux objets de routage client ou plus avec les champs appropriés : * `ipBlock.prefixLength` En cas de blocage IP (PA) fourni par Equinix. * `customerRoutes.prefix` En cas d'utilisation de votre propre IP Block (PI). > **Important** > > Plusieurs blocs IP peuvent être demandés uniquement avec le protocole de routage statique et BGP. Exemples de demandes de curl : Exemple de blocs IP attribués au fournisseur et indépendants du fournisseur ``` curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "name": "", "type": "SINGLE", "connections": [ "" ], "routingProtocol": { "type": "STATIC", "ipv4": { "customerRoutes": [ { "ipBlock": { "prefixLength": } }, { "prefix": "" } ] }, "ipv6": { "customerRoutes": [ { "ipBlock": { "prefixLength": } }, { "prefix": "" } ] } }, "order": { "purchaseOrder": { "number": "" } } }' ``` ## Suivi de vos demandes[​](#suivi-de-vos-demandes "Lien direct vers Suivi de vos demandes") Pour afficher le statut de votre demande de création de connexion, envoyez une `GET` demande au [`fabric/v4/connections/{connectionId}`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/connections/getconnectionbyuuid.md)point final. Pour afficher les détails de votre service d’accès Internet, utilisez le [`internetAccess/v2/services/{serviceId}`](https://docs.equinix.com/fr-CA/api-catalog/internetaccessv2/eia-service/getequinixinternetaccessservicedetails.md) point de terminaison. En cas de problème lors de la mise en service de votre instance de service d'accès Internet, la connexion associée est automatiquement désactivée.