# Solicite acceso a Internet con Network Edge

Equinix Internet Access (EIA) proporciona acceso combinado a Internet utilizando múltiples proveedores de servicios de Internet (ISP) de primer nivel y Equinix Internet Exchanges (IX) para ofrecer alta disponibilidad, fiabilidad y velocidad. Para solicitar Internet Access a través de la API:

* La conexión Fabric entre su dispositivo Network Edge y el perfil de servicio Equinix Internet Access se proporciona de forma gratuita.
* Cuando [desaprovisiona su instancia de servicio Internet Access](https://docs.equinix.com/es/internet-access/eia-api/deprovision-eia-api.md), también se desaprovisiona la conexión Fabric asociada.
* En caso de que haya un problema con el aprovisionamiento de una instancia de servicio de Internet Access, la conexión Fabric asociada se desaprovisiona automáticamente.

Equinix Internet Access con Network Edge está disponible para las organizaciones incorporadas a [Equinix Identity and Access Management](https://docs.equinix.com/es/iam.md), y la cuenta utilizada para enviar solicitudes de API debe tener los roles `Equinix Fabric Manager`, `Network Edge Connections Manager` y `Network Edge Device Manager`.

## Requisitos previos

1. Autenticar - Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para OAuth2 autenticación. Consulte [API Authentication](https://docs.equinix.com/es/equinix-api/api-authentication.md) para obtener instrucciones sobre cómo llamar a la API OAuth para validar y autenticar sus credenciales.

2. Determine la información del lado A. Necesita un dispositivo virtual, dispositivos redundantes o clúster de Network Edge aprovisionado con una licencia registrada. Envíe una solicitud `GET` al punto final [`/ne/v1/devices`](https://docs.equinix.com/es/api-catalog/network-edgev1.md#tag/Virtual-Device/operation/getVirtualDevices) o al punto final [`/ne/v1/devices/{id}`](https://docs.equinix.com/es/api-catalog/network-edgev1.md#tag/Virtual-Device/operation/getVirtualDeviceByUuid). Puede elegir cualquier interfaz disponible en el dispositivo para su conexión. Sin embargo, Equinix seleccionará una interfaz si usted no especifica ninguna.

3. Determine la información del lado Z. El perfil del servicio Internet Access es del tipo `IA_PROFILE` y su ID es `32d81829-0bf8-45d5-84e2-7289a553dbb6`. Para determinar la ubicación metropolitana de su servicio, envíe una solicitud `GET` al punto final [`/internetAccess/v2/ibxs`](https://docs.equinix.com/es/api-catalog/internetaccessv2.md#tag/Product-Availability/operation/getIbxs) para encontrar las ubicaciones en las que está disponible Internet Access. Necesitará esta información para solicitar su servicio de Internet Access.

## Creación de la conexión Internet Access

Para crear la conexión para su servicio Internet Access, envíe una solicitud `POST` al punto final [`/fabric/v4/connections`](https://docs.equinix.com/es/api-catalog/fabricv4.md#tag/Connections/operation/createConnection). El `tipo` de conexión es `IA_VC`.

Proporcione la información de su dispositivo virtual en el objeto `aSide`, incluyendo:

* `accessPoint.type` as `VD`
* `virtualDevice.type` como `EDGE`
* `virtualDevice.uuid` como UUID de su dispositivo

Proporcione el perfil de servicio Internet Access en el objeto `zSide`, incluyendo:

* `accessPoint.type` as `SP`.
* `profile.type` como `IA_PROFILE`
* `profile.uuid` como `32d81829-0bf8-45d5-84e2-7289a553dbb6`
* `metroCode` como el código de metro de dos letras del metro de Internet Access al que se está conectando.

Si está creando conexiones redundantes, haga dos peticiones. Una solicitud debe tener el valor `redundancy.priority` en `PRIMARY`, y la otra `redundancy.priority` en `SECONDARY` y debe especificar `redundancy.group` como UUID de la primera conexión. Utilice un clúster de dispositivos virtuales o un par de dispositivos redundantes (uno para el primario y otro para el secundario) para el lado A.

Ejemplos de solicitudes 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>"

      ]

    }

  ]

}'
```

Importante

La respuesta contiene un `uuid` que es el ID de conexión de su servicio de Internet Access. Debe disponer de este UUID de conexión para solicitar el servicio Internet Access.

## Solicitud de servicio con bloque IP asignado por el proveedor

nota

Si utiliza conexiones redundantes con dispositivos redundantes o un clúster, sólo se admite el enrutamiento BGP.

Para solicitar su servicio de Internet Access, envíe una solicitud `POST` al punto final [`/internetAccess/v2/services`](https://docs.equinix.com/es/api-catalog/internetaccessv2.md#tag/EIA-Service/operation/createEquinixInternetAccessv2).

Cuando solicite su servicio utilizando direcciones IP propiedad de Equinix (PA), establezca el valor `ipBlock.prefixLength` en el tamaño de la subred que necesite.

Si solicita el servicio a través de una única conexión:

* Establezca `type` en `SINGLE` y proporcione el ID de conexión a la matriz `connections`.
* Elija su `routingProtocol.type` entre `STATIC`, `DIRECT` o `BGP`.

Si solicita el servicio a través de un par de conexiones redundantes:

* Establezca `type` en `DUAL` y proporcione ambos ID de conexión a la matriz `connections`.
* Establezca su `routingProtocol.type` en `BGP`.

nota

Cuando solicite una instancia de servicio EIA ubicada en uno de nuestros centros de datos IBX de la región APAC, asegúrese de añadir la información `addressingPlans` y `questions` al objeto `ipBlock` en caso de PA IPv4 Block. Consulte la [referencia API](https://docs.equinix.com/es/api-catalog/internetaccessv2.md#tag/EIA-Service/operation/createEquinixInternetAccessv2) para obtener más información.

### Enrutamiento estático

Puede encontrar documentación sobre el enrutamiento estático [aquí](https://docs.equinix.com/es/internet-access/routing/static-routing.md).

Ejemplos de solicitudes 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>"

    }

  }

}'
```

### Enrutamiento directo

Puede encontrar documentación sobre el enrutamiento directo [aquí](https://docs.equinix.com/es/internet-access/routing/direct-routing.md).

Ejemplos de solicitudes 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>"

    }

  }

}'
```

### Enrutamiento BGP

Especifique los detalles de su configuración BGP en el objeto `routingProtocol`:

* qué rutas quiere que se anuncien a Internet, `FULL`, `DEFAULT`, `FULL_DEFAULT`, o `PARTIAL` en `routingProtocol.exportPolicy`.
* proporcione el rango ASN de cliente BITS\_16 para ASN de 16 bits o BITS\_32 para ASN de 32 bits en `routingProtocol.customerAsnRange`.
* proporcione bgpAuthKey en `routingProtocol.bgpAuthKey` si es necesario.

Encontrará documentación sobre el enrutamiento BGP [aquí](https://docs.equinix.com/es/internet-access/routing/bgp-routing.md).

Ejemplos de solicitudes 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>"

    }

  }

}'
```

## Solicitud de servicio con bloque de IP independiente del proveedor

Cuando solicite su servicio utilizando su propio bloque IP (PI), especifíquelo en `customerRoutes.prefix`.

### Enrutamiento estático

Ejemplos de solicitudes 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>"

    }

  }

}'
```

### Enrutamiento directo

Especifique qué IPs de su bloque de IPs pueden utilizarse con fines de peering en el objeto `peering`. Para el tipo de servicio Single, proporcione sólo una dirección IP en la matriz `equinixPeerIps`.

Ejemplos de solicitudes 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>"

    }

  }

}'
```

### Enrutamiento BGP

Ejemplos de solicitudes 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>"

    }

  }

}'
```

## Servicio de pedidos con bloques IP PA y PI

Cuando solicite su servicio con bloques IP tanto asignados por el proveedor (PA) como independientes del proveedor (PI) especifique dos o más objetos de ruta de cliente con los campos adecuados:

* `ipBlock.prefixLength` en caso de bloque IP (PA) proporcionado por Equinix.
* `customerRoutes.prefix` en caso de utilizar su propio bloque IP (PI).

Importante

Los bloques IP múltiples sólo pueden solicitarse con protocolo de enrutamiento estático y BGP.

Ejemplos de solicitudes 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>"

    }

  }

}'
```

## Seguimiento de sus solicitudes

Para ver el estado de su solicitud de creación de conexión, envíe una solicitud `GET` al punto final [`fabric/v4/connections/{connectionId}`](https://docs.equinix.com/es/api-catalog/fabricv4.md#tag/Connections/operation/getConnectionByUuid).

Para ver los detalles de su servicio de Internet Access, utilice el punto final [`internetAccess/v2/services/{serviceId}`](https://docs.equinix.com/es/api-catalog/internetaccessv2.md#tag/EIA-Service/operation/getEquinixInternetAccessServiceDetails).

Si se produce algún problema con el aprovisionamiento de su instancia de servicio de Internet Access, la conexión asociada se desaprovisiona automáticamente.