# Commander un accès à Internet avec Network Edge

Equinix Internet Access (EIA) fournit un accès Internet mixte en utilisant plusieurs fournisseurs d'accès Internet (FAI) de niveau 1 et les points d'échange Internet (IX) d'Equinix pour offrir une disponibilité, une fiabilité et une vitesse élevées. Pour commander Internet Access via l'API :

* La Fabric Connection entre votre appareil Network Edge et le profil de service Equinix Internet Access est fournie gratuitement.
* Lorsque vous [déprovisionnez votre instance de service Internet Access](https://docs.equinix.com/fr/internet-access/eia-api/deprovision-eia-api.md), la connexion Fabric associée est également déprovisionnée.
* En cas de problème lors du provisionnement d'une instance de service Internet Access, la connexion Fabric associée est automatiquement déprovisionnée.

Equinix Internet Access with Network Edge est disponible pour les organisations intégrées à [Equinix Identity and Access Management](https://docs.equinix.com/fr/iam.md), et le compte utilisé pour envoyer des demandes d'API doit avoir les rôles `Equinix Fabric Manager`, `Network Edge Connections Manager`, et `Network Edge Device Manager`.

## Conditions préalables

1. Authentifier - Soumettez vos informations d'identification, votre ID client et votre secret client pour OAuth2. authentification. Reportez-vous à [API Authentication](https://docs.equinix.com/fr/equinix-api/api-authentication.md) pour savoir comment appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.

2. Déterminez les informations du côté A. Vous avez besoin d'un dispositif virtuel Network Edge provisionné, de dispositifs redondants ou d'un cluster avec une licence enregistrée. Envoyez une requête `GET` au point d'extrémité [`/ne/v1/devices`](https://docs.equinix.com/fr/api-catalog/network-edgev1.md#tag/Virtual-Device/operation/getVirtualDevices) ou au point d'extrémité [`/ne/v1/devices/{id}`](https://docs.equinix.com/fr/api-catalog/network-edgev1.md#tag/Virtual-Device/operation/getVirtualDeviceByUuid). Vous pouvez choisir n'importe quelle interface disponible sur le périphérique pour votre connexion. Toutefois, Equinix sélectionnera une interface si vous n'en spécifiez pas.

3. Déterminez les informations du côté Z. Le profil de service Internet Access est de type `IA_PROFILE` et son ID est `32d81829-0bf8-45d5-84e2-7289a553dbb6`. Pour déterminer l'emplacement du métro pour votre service, envoyez une requête `GET` au point de terminaison [`/internetAccess/v2/ibxs`](https://docs.equinix.com/fr/api-catalog/internetaccessv2.md#tag/Product-Availability/operation/getIbxs) pour trouver les emplacements où Internet Access est disponible. Vous avez besoin de ces informations pour commander votre service Internet Access.

## Création de la connexion Internet Access

Pour créer la connexion pour votre service Internet Access, envoyez une requête `POST` au point de terminaison [`/fabric/v4/connections`](https://docs.equinix.com/fr/api-catalog/fabricv4.md#tag/Connections/operation/createConnection). Le `type` de connexion est `IA_VC`.

Fournissez les informations sur votre appareil virtuel dans l'objet `aSide`, y compris :

* `accessPoint.type` as `VD`
* `virtualDevice.type` as `EDGE`
* `virtualDevice.uuid` comme UUID de votre appareil

Fournissez le profil du service Internet Access dans l'objet `zSide`, y compris :

* `accessPoint.type` as `SP`.
* `profile.type` as `IA_PROFILE`
* `profile.uuid` as `32d81829-0bf8-45d5-84e2-7289a553dbb6`
* `metroCode` comme le code métro à deux lettres du métro Internet Access auquel vous vous connectez.

Si vous créez des connexions redondantes, faites deux demandes. Une requête doit avoir `redundancy.priority` fixé à `PRIMARY`, et l'autre `redundancy.priority` fixé à `SECONDARY` et vous devez spécifier `redundancy.group` comme l'UUID de la première connexion. Utilisez un cluster de périphériques virtuels ou une paire de périphériques redondants (un pour le primaire et un pour le secondaire) pour le côté A.

Exemples de requêtes cURL :

Primary connection example

```
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": "VD",

      "virtualDevice": {

        "type": "EDGE",

        "uuid": "<your_virtual_device_uuid>"

      }

    }

  },

  "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>"

      ]

    }

  ]

}'
```

Secondary connection example

```
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": "VD",

      "virtualDevice": {

        "type": "EDGE",

        "uuid": "<your_virtual_device_uuid>"

      }

    }

  },

  "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 `uuid` qui est l'identifiant de connexion de votre service Internet Access. Vous devez disposer de cet UUID de connexion pour commander le service Internet Access.

## Commande d'un service avec bloc IP attribué par le fournisseur

note

Si vous utilisez des connexions redondantes vers des appareils redondants ou un cluster, seul le routage BGP est pris en charge.

Pour commander votre service Internet Access, envoyez une requête `POST` au point de terminaison [`/internetAccess/v2/services`](https://docs.equinix.com/fr/api-catalog/internetaccessv2.md#tag/EIA-Service/operation/createEquinixInternetAccessv2).

Lorsque vous commandez votre service en utilisant des adresses IP appartenant à Equinix (PA), définissez la valeur `ipBlock.prefixLength` à la taille du sous-réseau dont vous avez besoin.

Si vous commandez un service sur une seule connexion :

* Définissez `type` à `SINGLE` et fournissez l'ID de la connexion au tableau `connections`.
* Choisissez votre `routingProtocol.type` parmi `STATIC`, `DIRECT`, ou `BGP`.

Si vous commandez un service sur une paire de connexions redondantes :

* Définissez `type` à `DUAL`, et fournissez les deux identifiants de connexion au tableau `connections`.
* Définissez votre `routingProtocol.type` à `BGP`.

note

Lorsque vous commandez une instance de service EIA située dans l'un de nos centres de données IBX dans la région APAC, assurez-vous d'ajouter les informations `addressingPlans` et `questions` à l'objet `ipBlock` dans le cas d'un bloc PA IPv4. Consultez la \[référence API] (/api-catalog/internetaccessv2/#tag/EIA-Service/operation/createEquinixInternetAccessv2) pour plus d'informations.

### Routage statique

La documentation sur le routage statique se trouve [ici](https://docs.equinix.com/fr/internet-access/routing/static-routing.md).

Exemples de requêtes cURL :

Single Static Service in APAC region example

```
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>"

    }

  }

}'
```

### Routage direct

La documentation sur le routage direct est disponible [ici](https://docs.equinix.com/fr/internet-access/routing/direct-routing.md).

Exemples de requêtes cURL :

Single Direct Service example

```
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>"

    }

  }

}'
```

### Routage BGP

Spécifiez les détails de votre configuration BGP dans l'objet `routingProtocol` :

* les routes que vous voulez voir annoncées à l'Internet, `FULL`, `DEFAULT`, `FULL_DEFAULT`, ou `PARTIAL` dans `routingProtocol.exportPolicy`.
* fournissez la plage d'ASN du client BITS\_16 pour un ASN de 16 bits ou BITS\_32 pour un ASN de 32 bits dans `routingProtocol.customerAsnRange`.
* fournissez bgpAuthKey dans `routingProtocol.bgpAuthKey` si nécessaire.

La documentation sur le routage BGP est disponible [ici](https://docs.equinix.com/fr/internet-access/routing/bgp-routing.md).

Exemples de requêtes cURL :

Single BGP Service example

```
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": [

        {

          "ipBlock": {

            "prefixLength": <size_of_ipv4_ip_block>

          }

        }

      ]

    },

    "ipv6": {

      "customerRoutes": [

        {

          "ipBlock": {

            "prefixLength": <size_of_ipv6_ip_block>

          }

        }

      ]

    }

  },

  "order": {

    "purchaseOrder": {

      "number": "<purchase_order_number>"

    }

  }

}'
```

Dual BGP Service example

```
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>"

    }

  }

}'
```

## Commander un service avec un bloc IP indépendant du fournisseur

Lorsque vous commandez votre service en utilisant votre propre bloc IP (PI), spécifiez-le dans `customerRoutes.prefix`

### Routage statique

Exemples de requêtes cURL :

Single Static Service example

```
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>"

    }

  }

}'
```

### Routage direct

Spécifiez quelles IP de votre bloc IP peuvent être utilisées pour le peering dans l'objet `peering`. Pour un type de service unique, veuillez fournir une seule adresse IP dans le tableau `equinixPeerIps`.

Exemples de requêtes cURL :

Single Direct Service example

```
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>"

    }

  }

}'
```

### Routage BGP

Exemples de requêtes cURL :

Single BGP Service example

```
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>"

    }

  }

}'
```

Dual BGP Service example

```
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>"

    }

  }

}'
```

## Commande de service avec les blocs IP PA et PI

Lorsque vous commandez votre service avec des blocs IP attribués par le fournisseur (PA) et indépendants du fournisseur (PI), spécifiez au moins deux objets route client avec les champs appropriés :

* `ipBlock.prefixLength` dans le cas d'un bloc IP fourni par Equinix (PA).
* `customerRoutes.prefix` en cas d'utilisation de votre propre bloc IP (PI).

Important

Les blocs IP multiples ne peuvent être demandés qu'avec les protocoles de routage statique et BGP.

Exemples de requêtes cURL :

Provider Assigned and Provider Independent IP Blocks example

```
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 l'état de votre demande de création de connexion, envoyez une requête `GET` au point de terminaison [`fabric/v4/connections/{connectionId}`](https://docs.equinix.com/fr/api-catalog/fabricv4.md#tag/Connections/operation/getConnectionByUuid).

Pour afficher les détails de votre service Internet Access, utilisez le point de terminaison [`internetAccess/v2/services/{serviceId}`](https://docs.equinix.com/fr/api-catalog/internetaccessv2.md#tag/EIA-Service/operation/getEquinixInternetAccessServiceDetails).

En cas de problème de provisionnement de votre instance de service Internet Access, la connexion associée est déprovisionnée automatiquement.