Saltar al contenido principal

Cómo solicitar Internet Access con un puerto Fabric

Equinix Internet Access (EIA) proporciona acceso combinado a Internet mediante múltiples proveedores de servicios de Internet de nivel 1 (ISPs) e intercambios de Internet Equinix (IX) para ofrecer alta disponibilidad, fiabilidad y velocidad.

  • La conexión Fabric entre su puerto Fabric y el perfil de servicio Equinix Internet Access se proporciona de forma gratuita.
  • Cuando desaprovisiona su instancia de servicio de acceso a Internet , la conexión de Fabric asociada también se desaprovisiona.
  • En caso de que haya un problema con el aprovisionamiento de una instancia de servicio de acceso a Internet, la conexión de Fabric asociada se desaprovisiona automáticamente.

Equinix Internet Access con Fabric está disponible para las organizaciones integradas en Equinix Identity and Access Management, y la cuenta utilizada para enviar solicitudes de API debe tener el Equinix Fabric Manager rol.

Si su organización no se ha incorporado a la gestión de identidades y accesos de Equinix, puede solicitar Equinix Internet Access con puerto dedicado .

Requisitos previos​

  1. Autenticar - Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para OAuth2 autenticación. Consulte Autenticación de API para obtener instrucciones sobre cómo llamar al API de OAuth para validar y autenticar sus credenciales.

  2. Determine la información de A-Side. Para obtener la información de su puerto de Fabric, envíe una GET solicitud al /fabric/v4/ports punto final. Necesita los UUID del puerto, el tipo de protocolo de enlace (DOT1Q o QINQ). Si está creando una conexión redundante, elija tanto un PRIMARY puerto como SECONDARYun puerto. Necesita esta información para la solicitud de creación de conexión.

  3. Determine la información de Z-Side. El perfil del servicio de acceso a Internet es de tipo IA_PROFILE y su ID es 32d81829-0bf8-45d5-84e2-7289a553dbb6. Para determinar la ubicación metropolitana de su servicio, envíe una GET solicitud al /internetAccess/v2/ibxs punto final para buscar las ubicaciones donde está disponible el acceso a Internet. Necesita esta información para solicitar su servicio de acceso a Internet.

Creación de la conexión Internet Access​

Para crear la conexión para su servicio de acceso a Internet, envíe una POST solicitud al /fabric/v4/connections punto final. La conexión type es IA_VC.

Proporcione la información de su puerto en el aSide objeto, incluyendo:

  • accessPoint.type as COLO

  • Proporcione el UUID de su puerto a port.uuid

    Si se está conectando desde un puerto Dot1q:

    • LinkProtocol.type as DOT1Q
    • Proporcione el ID de VLAN a linkProtocol.vlanTag

    Si se conecta desde un puerto QinQ:

    • LinkProtocol.type as QINQ
    • Proporcione el ID de etiqueta interno a linkProtocol.vlanCTag
    • Proporcione el ID de la etiqueta externa a linkProtocol.vlanSTag
  • Si está creando conexiones redundantes, realice dos solicitudes. Una solicitud debe tener su puerto principal y redundancy.priority estar configurado en PRIMARY, y la otra su puerto secundario y redundancy.priority configurado en SECONDARY y debe especificar redundancy.group como el UUID de la primera conexión.

Proporcione el perfil de servicio de acceso a Internet en el zSide objeto, incluidos:

  • accessPoint.type as SP.
  • profile.type as IA_PROFILE
  • profile.uuid as 32d81829-0bf8-45d5-84e2-7289a553dbb6
  • metroCode Como el código metropolitano de dos letras del área metropolitana de acceso a Internet al que se está conectando.

Ejemplos de solicitudes cURL:

Ejemplo de conexión primaria
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>"
]
}
]
}'
Ejemplo de conexión secundaria
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>"
]
}
]
}'
Importante

La respuesta contiene un uuidID de conexión de su servicio de acceso a Internet. Debe tener este UUID de conexión para solicitar el servicio de acceso a Internet.

Solicitud de servicio con bloque IP asignado por el proveedor​

Para solicitar su servicio de acceso a Internet, envíe una POST solicitud al /internetAccess/v2/services punto final.

Para la redundancia, si ha creado dos conexiones para su servicio, establezca type DUAL, y proporcione ambos IDS de conexión a la connections matriz. Si ha creado una única conexión para su servicio, establezca type SINGLEy proporcione el ID de conexión a la connections matriz.

En el routingProtocol objeto especifique:

  • Su routingProtocol.type de STATIC DIRECT, o BGP.
  • Cuando solicite su servicio utilizando bloques de IP propiedad de Equinix (PA), establezca el ipBlock.prefixLength valor en el tamaño del bloque de IP que necesita.
nota

Cuando solicite una instancia de servicio EIA ubicada en uno de nuestros centros de datos IBX en la región APAC, asegúrese de añadir la addressingPlansinformación AND questionsal ipBlock objeto en caso de bloque de PA IPv4. Consulte la referencia de API para obtener más información.

Enrutamiento estático​

La documentación sobre el enrutamiento estático se puede encontrar aquí.

Ejemplos de solicitudes cURL:

Ejemplo de servicio estático único en la región 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>"
}
}
}'
Ejemplo de servicio estático dual
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>"
}
}
}'

Enrutamiento directo​

La documentación sobre el enrutamiento directo se puede encontrar aquí.

Ejemplos de solicitudes cURL:

Ejemplo de servicio directo único
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>"
}
}
}'
Ejemplo de servicio directo dual
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>"
}
}
}'

Enrutamiento BGP​

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

  • En qué rutas desea que se anuncien en Internet, FULL DEFAULT, , , FULL_DEFAULTo PARTIAL en routingProtocol.exportPolicy.
  • Proporcione al cliente el rango ASN BITS_16 para ASN de 16 bits o BITS_32 para ASN de 32 bits IN routingProtocol.customerAsnRange.
  • Proporcione bgpAuthKey in routingProtocol.bgpAuthKey si es necesario.

La documentación sobre el enrutamiento de BGP se puede encontrar aquí.

Ejemplos de solicitudes cURL:

Ejemplo de servicio BGP único
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>"
}
}
}'
Ejemplo de servicio BGP dual
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 de IP (PI), especifíquelo en customerRoutes.prefix

Enrutamiento estático​

Ejemplos de solicitudes cURL:

Ejemplo de servicio estático único
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>"
}
}
}'
Ejemplo de servicio estático dual
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>"
}
}
}'

Enrutamiento directo​

Especifique qué IP de su bloque de IP se pueden utilizar con fines de emparejamiento en el peering objeto. Para el tipo de servicio único, proporcione solo una dirección IP en la equinixPeerIps matriz. Para el tipo de servicio dual, proporcione dos direcciones IP en la equinixPeerIps matriz y la dirección IP de VRRP en equinixVRRPIp el campo.

Ejemplos de solicitudes cURL:

Ejemplo de servicio directo único
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>"
}
}
}'
Ejemplo de servicio directo dual
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>"
}
}
}'

Enrutamiento BGP​

Ejemplos de solicitudes cURL:

Ejemplo de servicio BGP único
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>"
}
}
}'
Ejemplo de servicio BGP dual
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 de IP (PA) proporcionado por Equinix.
  • customerRoutes.prefix En caso de utilizar su propio bloque de IP (PI).
Importante

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

Ejemplos de solicitudes cURL:

Ejemplo de bloques IP asignados por el proveedor e independientes del proveedor
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 GET solicitud al fabric/v4/connections/{connectionId} punto final.

Para ver los detalles de su servicio de acceso a Internet, utilice el internetAccess/v2/services/{serviceId} punto final.

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.

¿Le ha resultado útil esta página?