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
-
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.
-
Determine la información de A-Side. Para obtener la información de su puerto de Fabric, envíe una
GETsolicitud al/fabric/v4/portspunto final. Necesita los UUID del puerto, el tipo de protocolo de enlace (DOT1Q o QINQ). Si está creando una conexión redundante, elija tanto unPRIMARYpuerto comoSECONDARYun puerto. Necesita esta información para la solicitud de creación de conexión. -
Determine la información de Z-Side. El perfil del servicio de acceso a Internet es de tipo
IA_PROFILEy su ID es32d81829-0bf8-45d5-84e2-7289a553dbb6. Para determinar la ubicación metropolitana de su servicio, envíe unaGETsolicitud al/internetAccess/v2/ibxspunto 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.typeasCOLO -
Proporcione el UUID de su puerto a
port.uuidSi 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
- LinkProtocol.type as
-
Si está creando conexiones redundantes, realice dos solicitudes. Una solicitud debe tener su puerto principal y
redundancy.priorityestar configurado enPRIMARY, y la otra su puerto secundario yredundancy.priorityconfigurado enSECONDARYy debe especificarredundancy.groupcomo el UUID de la primera conexión.
Proporcione el perfil de servicio de acceso a Internet en el zSide objeto, incluidos:
accessPoint.typeasSP.profile.typeasIA_PROFILEprofile.uuidas32d81829-0bf8-45d5-84e2-7289a553dbb6metroCodeComo 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>"
]
}
]
}'
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.typedeSTATICDIRECT, oBGP. - Cuando solicite su servicio utilizando bloques de IP propiedad de Equinix (PA), establezca el
ipBlock.prefixLengthvalor en el tamaño del bloque de IP que necesita.
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,
FULLDEFAULT, , ,FULL_DEFAULToPARTIALenroutingProtocol.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.bgpAuthKeysi 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.prefixLengthEn caso de bloque de IP (PA) proporcionado por Equinix.customerRoutes.prefixEn caso de utilizar su propio bloque de IP (PI).
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.