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 , 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 , 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é .
Conditions préalables
-
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.
-
Déterminez les informations A-Side. Pour obtenir les informations de votre port Fabric, envoyez
GETune demande au/fabric/v4/portspoint 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 unPRIMARYport et unSECONDARYport. Vous avez besoin de ces informations pour la demande de création de connexion. -
Déterminez les informations Z-Side. Le profil de service d'accès à Internet est de type
IA_PROFILEet son identifiant est32d81829-0bf8-45d5-84e2-7289a553dbb6. Pour déterminer l'emplacement métropolitain pour votre service, envoyez uneGETdemande au/internetAccess/v2/ibxsterminal 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
Pour créer la connexion pour votre service d’accès Internet, envoyez une POST demande au /fabric/v4/connectionspoint final. La connexion type est IA_VC.
Indiquez vos informations de port dans l'aSideobjet, notamment :
-
accessPoint.typeasCOLO -
Indiquez l'UUID de votre port à
port.uuidSi 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
- LinkProtocol.type AS
-
Si vous créez des connexions redondantes, faites deux requêtes. L'une des demandes doit avoir votre port principal et
redundancy.prioritydéfini surPRIMARY, et l'autre votre port secondaire etredundancy.prioritydéfini surSECONDARYet vous devez spécifierredundancy.groupcomme UUID de la première connexion.
Fournir le profil de service d’accès Internet dans l’zSideobjet, y compris :
accessPoint.typeasSP.profile.typeasIA_PROFILEprofile.uuidas32d81829-0bf8-45d5-84e2-7289a553dbb6metroCodeCode 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 <token>' \
-d '{
"type": "IA_VC",
"name": "<your_connection_name>",
"bandwidth": <connection_speed>,
"redundancy": {
"priority": "PRIMARY"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "<your_port_uuid>"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": <vlan_id>
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"type": "IA_PROFILE",
"uuid": "32d81829-0bf8-45d5-84e2-7289a553dbb6"
},
"location": {
"metroCode": "<metro_code>"
}
}
},
"project": {
"projectId": "<project_id>"
},
"order": {
"purchaseOrderNumber": "<purchase_order_number>"
},
"notifications": [
{
"type": "ALL",
"emails": [
"<contact_email>"
]
}
]
}'
Exemple de connexion secondaire
curl -X POST 'https://api.equinix.com/fabric/v4/connections' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"type": "IA_VC",
"name": "<your_connection_name>",
"bandwidth": <connection_speed>,
"redundancy": {
"priority": "SECONDARY",
"group": "<primary_connection_uuid>"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "<your_port_uuid>"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": <vlan_id>
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"type": "IA_PROFILE",
"uuid": "32d81829-0bf8-45d5-84e2-7289a553dbb6"
},
"location": {
"metroCode": "<metro_code>"
}
}
},
"project": {
"projectId": "<project_id>"
},
"order": {
"purchaseOrderNumber": "<purchase_order_number>"
},
"notifications": [
{
"type": "ALL",
"emails": [
"<contact_email>"
]
}
]
}'
La réponse contient un uuididentifiant 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
Pour commander votre service d’accès Internet, envoyez une POST demande au /internetAccess/v2/servicesterminal.
Pour la redondance, si vous avez créé deux connexions pour votre service, définissez type sur DUALet 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'routingProtocolobjet, spécifiez :
- Votre
routingProtocol.typedeSTATIC, ,DIRECTouBGP. - Lors de la commande de votre service à l'aide de blocs IP appartenant à Equinix (PA), définissez la
ipBlock.prefixLengthvaleur sur la taille du bloc IP dont vous avez besoin.
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 addressingPlansinformations et questionsà l'ipBlockobjet en cas de blocage IPv4 PA. Pour plus d'informations, reportez-vous à la référence API.
Routage statique
La documentation sur le routage statique est disponible ici.
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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>,
"addressingPlans": [
{
"afterThreeMonths": <number_of_ip_addresses_used_after_three_months>,
"immediate": <number_of_ip_addresses_used_instantly>,
"purpose": "<purpose_of_ip_block>",
"size": <number_of_ip_addresses_requested>
}
],
"questions": [
{
"answer": "YES",
"type": "PRIVATE_SPACE_CONSIDERED"
},
{
"answer": "NO",
"type": "REFUSED_PREVIOUSLY"
},
{
"answer": "NO",
"type": "RETURNING_ADDRESS_SPACE"
}
]
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Exemple de service statique double
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Routage direct
La documentation sur le routage direct peut être trouvée ici.
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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "DIRECT",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Exemple de service Dual Direct
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "DIRECT",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Routage BGP
Spécifiez les détails de votre configuration BGP dans l'routingProtocolobjet :
- Les routes que vous souhaitez annoncer sur Internet,
FULL,DEFAULT, ,FULL_DEFAULTouPARTIALdansroutingProtocol.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.
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 <token>' \
-d '{
"name": "My Internet Access Service",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "BGP",
"customerAsnRange": "<asn_range>",
"bgpAuthKey": "<bgp_auth_key>",
"exportPolicy": "<route_advertisement_code>",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Exemple de service Dual BGP
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "BGP",
"customerAsnRange": "<asn_range>",
"bgpAuthKey": "<bgp_auth_key>",
"exportPolicy": "<route_advertisement_code>",
"ipv4": {
"customerRoutes": [
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
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
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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Exemple de service statique double
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Routage direct
Spécifiez les adresses IP de votre bloc IP qui peuvent être utilisées à des fins d'appairage dans l'peeringobjet.
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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "DIRECT",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
],
"peerings": [
{
"equinixPeerIps": [
"<peering_ip_address>"
]
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
],
"peerings": [
{
"equinixPeerIps": [
"<peering_ip_address>"
]
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Exemple de service Dual Direct
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "DIRECT",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
],
"peerings": [
{
"equinixPeerIps": [
"<peering_ip_address>",
"<peering_ip_address>"
],
"equinixVRRPIp": "<virtual_router_group_ip_address>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
],
"peerings": [
{
"equinixPeerIps": [
"<peering_ip_address>",
"<peering_ip_address>"
],
"equinixVRRPIp": "<virtual_router_group_ip_address>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "BGP",
"customerAsnRange": "<asn_range>",
"bgpAuthKey": "<bgp_auth_key>",
"exportPolicy": "<route_advertisement_code>",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Exemple de service Dual BGP
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "BGP",
"customerAsnRange": "<asn_range>",
"bgpAuthKey": "<bgp_auth_key>",
"exportPolicy": "<route_advertisement_code>",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
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.prefixLengthEn cas de blocage IP (PA) fourni par Equinix.customerRoutes.prefixEn cas d'utilisation de votre propre IP Block (PI).
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 <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
},
{
"prefix": "<your_ipv4_ip_block>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
},
{
"prefix": "<your_ipv6_ip_block>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
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}point final.
Pour afficher les détails de votre service d’accès Internet, utilisez le internetAccess/v2/services/{serviceId} 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.