Passer au contenu principal

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​

  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.

  2. 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 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/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.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’zSideobjet, 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 <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>"
]
}
]
}'
Important

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.type de STATIC, , DIRECTou 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 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_DEFAULTou PARTIALdans 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 bgpAuthKeyroutingProtocol.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.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 <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.

Cette page vous a-t-elle été utile ?