Conexiones virtuales de tejido facturadas

Las conexiones virtuales Fabric Billed se utilizan para realizar una conexión desde sus puertos Fabric o dispositivos Network Edge a Equinix Metal, ya sea dentro del mismo metro o a través de metros. Los casos de uso incluyen el uso de un dispositivo Network Edge como enrutador para sus servicios Equinix Metal o la conexión de Equinix Metal a un proveedor de servicios en nube a través de Metros. Todos los cargos por uso, Network Edge y dispositivo virtual aparecerán en su cuenta de Equinix Fabric.

Nota: esta función sustituye a Puertos Compartidos para los usuarios anteriores de dispositivos Equinix Fabric y Network Edge con su infraestructura Equinix Metal. Las interconexiones de puertos compartidos existentes seguirán funcionando y se indicarán en el portal y en la API como Legacy.

Información del sistema

• Cada conexión virtual de Fabric puede ser un puerto único o un conjunto de puertos redundantes. Los puertos redundantes se recomiendan para una mayor disponibilidad. Con un solo puerto, no hay tiempo de actividad garantizado.

• Cada conexión virtual de Fabric viene con un único circuito virtual al que se puede conectar una VLAN o un VRF. Si utiliza puertos redundantes, cada puerto tendrá un circuito virtual.

• La relación de los circuitos virtuales con las VLAN es 1:1. Sólo se puede conectar una VLAN a un circuito virtual y un circuito virtual a una VLAN. No se puede conectar la misma VLAN a dos o más circuitos virtuales. Como consecuencia, si está diseñando para alta disponibilidad con puertos Primarios y Secundarios, necesitará una VLAN para cada uno, y necesitará tener enrutamiento inter-vlan o algún otro conocimiento de aplicación de capa-3.

• Para el enrutamiento, las conexiones virtuales Fabric pueden utilizar Enrutamiento y reenvío virtuales. Para más información, consulte la página VRF para interconexiones.

• Las conexiones virtuales de Fabric tienen un ancho de banda máximo de 10 Gbps.

• Fabric Virtual Connection admite una unidad de transmisión máxima (MTU) de hasta 9000 bytes y tramas Ethernet jumbo.

Orígenes y destinos

Origin	Destination	Supported
Cualquier puerto físico en Fabric (no en un [Perfil de Servicio)	Fabric Billed Fabric VC	Sí Dispositivo virtual único ([no en un perfil de servicio)

Solicitud de una conexión virtual de Fabric facturada por Fabric

Console

Para solicitar una conexión virtual Fabric, abra la página Interconnections del proyecto. Haga clic en + Solicitar nueva interconexión.

En la sección Tipo de interconexión, haga clic en el desplegable bajo Fabric VC, y seleccione Fabric Billed.

• Seleccione la ubicación de la nueva conexión en el menú desplegable. Deberá elegir el metro en el que residen sus servidores y VLAN de Equinix Metal, o en el que tiene previsto aprovisionarlos.
• Dale un nombre a tu conexión.
• Elija si desea un conjunto de puertos redundantes. Obtendrás un puerto principal y un puerto secundario con un circuito virtual cada uno para conectar dos VLAN, lo que te proporcionará un cierto grado de redundancia y alta disponibilidad.
• La Velocidad máxima de interconexión está ajustada al máximo por defecto de 10 Gbps. Usted seleccionará la velocidad real de la conexión cuando canjee su vale de servicio en el portal de Fabric.

A continuación, seleccione si va a conectar sus puertos a una VLAN o a un VRF.

• Si sólo utiliza VLAN, seleccione la VLAN o las VLAN que se conectarán a sus puertos. Las VLAN tienen que estar en el mismo proyecto y ubicación que su Fabric VC. Si no tiene ninguna VLAN elegible, puede hacer clic en + Crear una VLAN para crearlas. Una misma VLAN no puede conectarse a dos o más circuitos virtuales, por lo que si solicita puertos redundantes, seleccione una VLAN para cada uno. Nota: No podrá actualizar o cambiar la VLAN una vez creado el Fabric VC.

• Si está utilizando VRF, seleccione el VRF para sus puertos. Hay documentación adicional en la página VRF para interconexiones.

Revise el resumen de su solicitud. Haga clic en Enviar solicitud para recibir sus tokens de servicio z-side.

Los tokens caducan en 7 días. También debería recibir un correo electrónico con sus tokens y la información de caducidad. En la página Interconnections, su recién solicitada conexión virtual Fabric aparecerá en la pestaña Pending Requests.

CLI

Para solicitar un Fabric VC facturado por Fabric en la CLI, utilice el comando metal interconnections create.

metal interconnections create -p <project_id> -n <name> -m <metro> -r redundant -t shared -T z_side [--vlans <vlan_id>, <vlan_id> | --vrfs <vrf_uuid>, <vrf_uuid>]

Opciones:

• -p, --project-id (required) - Your Project's UUID.
• -r, --redundancy - Select primary or redundant. If you select a redundant connection, you will get a primary and secondary port to attach VLANs or VRFs to, increasing the connection's redundancy and high availability.
• -T, --service-token-type (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to z_side.
• -t, --type (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to "shared".
• --vlan" - A list of VLAN IDs that will be used for the connection. If you select a redundant connection, the first VLAN in the list will be used for the primary port, and the second VLAN listed will be used for the secondary port. You can not connect the same VLAN to both ports; specify a different VLAN for each. Note: The vlan option is required if you are using VLANs. If you are using VRF, this field is NOT required. You will not be able to modify the VLANs after Fabric VC creation.
• --vrfs - A list of VRFs that will be used for the connection. If you select a redundant connection, the first VRF in the list will be used for the primary port, and the second VRF listed will be used for the secondary port. The two VRFs can be the same if both the primary and secondary ports will be in the same VRF. Note: The vrfs option is required if you are using VRFs. If you are using VLANs, this field is NOT required.

Nota: Utilice el campo "vlans" o el campo "vrfs". Son mutuamente excluyentes y se requiere al menos uno u otro.

El envío de la solicitud crea genera sus tokens de servicio z-side. Los tokens se incluyen en el objeto de respuesta. Si has solicitado una conexión redundante, recibirás dos tokens.

API

Para solicitar una conexión a través de la API, envíe una solicitud POST al punto final /projects/{project_id}/connections. Si está adjuntando VLANs a este VC de Fabric, entonces utilice el parámetro "vlans" en el cuerpo de la solicitud. Si está utilizando VRF, entonces utilice el parámetro "vrfs" en el cuerpo de la petición.

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{project_id}/connections" \
-d '{
    "name": "<string>",
    "description": "<string>",
    "contact_email": "<string>",
    "metro": "<metro_slug>",
    "type": "shared",
    "service_token_type": "z_side",
    "redundancy": "redundant",
    "vlans": [ <integer>, <integer> ]  
}'

Parámetros corporales:

• "name" (required) - The name of your new Fabric Virtual Connection.
• "description" (optional) - A user-friendly description for your Fabric Virtual Connection.
• "contact_email" - The preferred email used for communication and notifications about the Interconnection. Required when using a Project API key. Optional and defaults to your user email address when using a User API key.
• "metro" (required) - The metro where the Fabric Virtual Connection lives.
• "type" (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to "shared".
• "service_token_type" (required) - This parameter is required when requesting a Fabric-billed Fabric Virtual Connection. Set the value to z_side.
• "redundancy" (required) - Select "primary" or "redundant". If you select a redundant connection, you will get a primary and secondary port to attach VLANs or VRFs to, increasing the connection's redundancy and high availability.
• "vlans" - A list of VLAN IDs that will be used for the connection. If you select a redundant connection, the first VLAN in the list will be used for the primary port, and the second VLAN listed will be used for the secondary port. You can not connect the same VLAN to both ports; specify a different VLAN for each. Note: The "vlans" field is required if you are using VLANs. If you are using VRF, this field is NOT required. You will not be able to modify the VLANs after Fabric VC creation.
• "vrfs" - A list of VRFs that will be used for the connection. If you select a redundant connection, the first VRF in the list will be used for the primary port, and the second VRF listed will be used for the secondary port. The two VRFs can be the same if both the primary and secondary ports will be in the same VRF. Note: The "vrfs" field is required if you are using VRFs. If you are using VLANs, this field is NOT required.

Nota: Utilice el campo "vlans" o el campo "vrfs". Son mutuamente excluyentes y se requiere al menos uno u otro.

El envío de la solicitud crea genera sus tokens de servicio del lado z. Los tokens se incluyen en la respuesta en el objeto "service_tokens". Si ha solicitado una conexión redundante, recibirá dos tokens.

"service_tokens": [ 
    {
    “id”: "ff0cf4dc-a897-426d-9621-14e5b985058f",
    “role”: "primary",
    “state”: "inactive",
        “max_allowed_speed”: 10000000000,
    “service_token_type”: "z_side",
    “expires_at”: "2019-09-30T20:22:20",
    }
],

Los tokens caducan en 7 días. También debería recibir un correo electrónico con sus tokens de servicio y la información de caducidad. Puede comprobar su solicitud y recuperar los tokens durante esta ventana enviando una solicitud GET al punto final /connections/{connection_id}.

curl -X GET -H 'X-Auth-Token: $API_TOKEN' \
"https://api.equinix.com/metal/v1/connections/{connection_id}"

Canje del vale de servicio Z-side

Para canjear su token, inicie sesión en el portal Equinix Fabric y en el menú desplegable Conexiones, haga clic en Crear una conexión.

En Conexiones frecuentes, seleccione el mosaico Conectarse utilizando un token de servicio y haga clic en Introduzca un token de servicio.

En el cuadro de diálogo, pegue su token en el campo Enter Service Token y haga clic en Validar.

Compruebe que los datos del token son correctos y haga clic en Canjear para canjear su token y terminar de configurar su conexión a Fabric.

Conexiones heredadas - Si ha utilizado anteriormente Shared Ports en Equinix Metal, es posible que haya utilizado el campo Fabric Token para canjear su token y configurar su conexión. Si tiene conexiones heredadas existentes, seguirán funcionando como se esperaba. Si tiene tokens heredados sin canjear, ya no es posible canjear esos tokens en Equinix Fabric. Tendrá que solicitar nuevos tokens de servicio y utilizar los nuevos pasos para canjearlos en Fabric.

Configuración del origen

Ahora puede continuar configurando su conexión en el portal de Fabric. Como ha canjeado un token de servicio preconfigurado, Equinix Metal se establecerá automáticamente como destino de la conexión y usted elegirá el origen.

En primer lugar, seleccione la ubicación del origen de la conexión. En la mayoría de los casos se trata de un dispositivo virtual, pero también puede ser uno de sus propios puertos de Equinix Fabric. El dispositivo virtual o puerto puede estar en cualquier metro.

Si utiliza un dispositivo virtual, seleccione el tipo de dispositivo y el tipo de conexión. Actualmente, los Dispositivos redundantes y los Clusters no son compatibles.

En la página Detalles de la conexión, dé a su conexión virtual un nombre amigable, especifique con qué interfaces del dispositivo virtual se va a conectar (si es necesario), y especifique un número de Orden de Compra si su organización lo requiere a efectos de facturación. La VLAN del lado z es autoasignada por el token de servicio, y no tiene por qué coincidir con sus ID de VLAN en Equinix Metal.

A continuación, establezca la velocidad de la conexión. Equinix Metal establece la velocidad máxima para las conexiones virtuales Fabric - Fabric Billed en 10 Gbps. Elija entre las opciones de velocidad y precios de Fabric.

La última página es una revisión, donde puede revisar sus elecciones y volver atrás para hacer cambios. Cuando esté listo para realizar el pedido, haga clic en Enviar pedido. Esto inicia un proceso de configuración de la conexión entre Fabric y Equinix Metal en segundo plano que puede tardar hasta 10 minutos en completarse.

Si ha recibido dos tokens para una conexión redundante, asegúrese de repetir el proceso para canjear su segundo token.

Si necesita recuperar los tokens, están disponibles en la pestaña Solicitud de interconexión. Haga clic en Gestionar en la Interconexión para la que desea los tokens.

Gestión de conexiones virtuales de Fabric

Console

Una vez establecida la interconexión entre Fabric y Equinix Metal, aparecerá en la página Interconnections de su proyecto, en la sección Fabric VC, con el estado Active.

• Las conexiones virtuales Fabric facturadas tienen el tipo Fabric facturado.
• Metal Billed Fabric Las conexiones virtuales tienen el tipo Metal Billed.
• Las interconexiones que se configuraron como Puertos compartidos se indican con el tipo Legacy.

Tenga en cuenta que los Puertos Dedicados se gestionan a nivel de organización, por lo que si existen Puertos Dedicados en su organización, también aparecerán en la sección Puertos Dedicados.

Si hace clic en el nombre de la interconexión, accederá a su página Overview, que contiene una vista detallada, así como un resumen de las configuraciones del puerto primario y del puerto secundario.

Al hacer clic en Puerto principal o en Puerto secundario se muestra el estado y la configuración del puerto.

CLI

Enumere todas las Interconexiones de su Proyecto, incluyendo las Conexiones Virtuales Fabric facturadas, con el comando metal interconnections get. Especifique el Proyecto con -p, o --project_id.

metal interconnections get -p <project_id>

Nota: Los puertos dedicados se gestionan a nivel de organización y se comparten entre todos los proyectos de la organización. Si hay puertos dedicados en su organización, también aparecerán en la respuesta.

Obtenga los detalles de una Conexión Virtual de Fabric específica con el comando metal interconnections get, especificando la Conexión Virtual de Fabric por su UUID y -i o --connID.

metal interconnections get -i <fabric_vc_uuid>

Para actualizar una Conexión Virtual de Fabric, utilice el comando metal interconnections update. El UUID de la Conexión Virtual de Fabric es obligatorio. Todos los demás campos son opcionales, por lo que pueden actualizarse independientemente.

metal interconnections update -i <fabric_vc_uuid> -n <name> -d <description> -r <redundant|primary> -e <e-mail> --tags="<tag1>,<tag2>"

Opciones:

• -i, --id (required) - The UUID of the interconnection.
• -e, --contactEmail - Adds or updates the email contact for the Fabric Virtual Connection.
• -n, --name - Updates the name.
• -d, --description - Adds or updates the description.
• -r, --redundancy - Updating to primary will remove a secondary port, while updating to redundant will add a secondary port.
• -t, --tags - Adds or updates the tags.

API

Para listar todas las interconexiones de un proyecto, envíe una solicitud GET al punto final /organizations/{organization_id}/connections, filtrando la respuesta a su proyecto en la ruta de la solicitud.

Nota: Los puertos dedicados se gestionan a nivel de organización y se comparten entre todos los proyectos de la organización. Si hay puertos dedicados en su organización, también aparecerán en la respuesta.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/organizations/{organization_id}/connections?project={project_id}

Para obtener los detalles de un Fabric Billed Fabric VC, envíe una solicitud GET al punto final /connections/{connection_id}, especificando el UUID en la ruta de solicitud.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{connection_id}

Puede utilizar esta información para gestionar y actualizar el Fabric Billed Fabric VC enviando una solicitud PUT al punto final /connections/{connection_id}. Especifique lo que desea cambiar en el cuerpo de la solicitud. Todos los campos son opcionales, por lo que pueden actualizarse independientemente.

curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/connections/{connection_id}" \
-d '{
    "contact_email": "<string>",
    "description": "<string>",
    "name": "<string>",
    "redundancy": "<string>",
    "tags": [
        "<string>"
    ]
}'

Parámetros corporales:

• "contact_email" - Adds or updates the email contact for the Fabric Virtual Connection.
• "name" - Updates the name.
• "description" - Adds or updates the description.
• "redundancy" - Updating to "primary" will remove a secondary port, while updating to "redundant" will add a secondary port.
• "tags" - Añade o actualiza las etiquetas.

También puede obtener la información de los puertos de sus interconexiones.

Para obtener una lista de los puertos de un Fabric Billed Fabric VC, envíe una solicitud GET al punto final /connections/{connection_id}/ports.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{connection_id}/ports

Y para obtener uno de los detalles del puerto, envíe una solicitud GET al punto final /connections/{connection_id}/ports/{id}.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{connection_id}/ports/{id}

Circuitos virtuales

Cada uno de sus puertos, primario y secundario, tiene un único circuito virtual al que se puede conectar una VLAN o VRF.

Si utiliza VLANs, sus Circuitos Virtuales se conectarán a las VLANs que haya especificado. Éstas no pueden modificarse ni cambiarse. Si necesita un Fabric VC con una VLAN diferente, tendrá que desmontar y volver a crear el Fabric VC.

Nota: Si previamente había añadido, eliminado o modificado VLANs en un Circuito Virtual a través de la consola o la API, esas opciones no estarán disponibles después de 29 de febrero de 2024. Las solicitudes de actualización (PUT) al punto final /virtual-circuits/{id} tendrán una cabecera sunset en su respuesta. Hay una excepción sólo para los Fabric VC aprovisionados antes de 1 de marzo de 2024 que estén Waiting on customer VLAN.

Si está utilizando VRF, sus Circuitos Virtuales tendrán como estado Waiting on Peering Details.

Configuración de VRF

Console

Si está utilizando VRF en sus circuitos virtuales, haga clic en el menú de tres barras para abrir el panel Manage Peering Details. Rellene los campos con la información solicitada.

Aquí se especifica la subred del rango de direcciones IP del VRF que se utilizará para direccionar el VRF y el lado remoto del circuito virtual. La reserva de direcciones IP para esta subred se creará automáticamente.

Encontrará documentación más detallada en la página VRF para interconexiones.

Haga clic en Actualizar circuito virtual.

Si tiene puertos redundantes, repita este proceso en el puerto secundario.

API

Para actualizar su Circuito Virtual con los detalles de peering para su VRF. Envíe una solicitud PUT al punto final /virtual-circuits/{vrf_virtual_circuit_id}.

Aquí se especifica la subred del rango de direcciones IP del VRF que se utilizará para direccionar el VRF y el lado remoto del circuito virtual. La reserva de direcciones IP para esta subred se creará automáticamente.

Para subredes IPv4:

curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/virtual-circuits/{vrf_virtual_circuit_id}" \
-d '{
    "peer_asn": <integer>,
    "subnet": "<subnet>",
    "metal_ip": "<ip_address>",
    "customer_ip": "<ip_address>”,
    "md5": "<string>"
}'

Para subredes IPv6:

curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/virtual-circuits/{vrf_virtual_circuit_id}" \
-d '{
    "peer_asn": <integer>,
    "subnet_ipv6": "<subnet>",
    "metal_ipv6": "<ip_address>",
    "customer_ipv6": "<ip_address>”,
    "md5": "<string>"
}'

Encontrará documentación más detallada en la página VRF para interconexiones.

Eliminación de una conexión virtual Fabric

advertencia

La eliminación de una conexión virtual de Fabric es permanente. Cuando elimine la conexión, todas las VLAN conectadas se desvincularán y se cortará el tráfico de Fabric a sus servidores.

La eliminación de una conexión virtual facturada por Fabric desde el lado Equinix Metal elimina automáticamente la conexión en Fabric. Si la elimina desde el portal de Fabric, también se limpiará automáticamente en el lado Equinix Metal. Se trata de un proceso asíncrono que puede tardar hasta 3 minutos en completarse.

Por favor, asegúrese de detener el tráfico antes de la eliminación, y asegúrese de limpiar todos los recursos asociados a la conexión. Hacer esto antes de eliminar la conexión del portal Metal o Fabric garantiza que la conexión se eliminará por completo y se detendrán los cargos de facturación.

Console

En la lista de conexiones de la página Interconnections, haga clic en el nombre de la conexión virtual Fabric que desee eliminar.

Haga clic en Eliminar interconexión para eliminar definitivamente la conexión virtual Fabric.

CLI

Para eliminar una conexión virtual Fabric, utilice el comando metal interconnections delete. Especifique el UUID de la Conexión Virtual de Fabric con -i o --id. Para saltarse el paso de confirmación, utilice -f o --force.

metal interconnections delete -i <uuid> -f

API

Para eliminar una conexión virtual Fabric desde la API, envíe una solicitud DELETE al punto final /connections/{connection_id}, especificando el ID del puerto en la ruta.

curl -X DELETE -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/connections/{id}

El envío de la solicitud eliminará la conexión de forma permanente.