Conectar el dispositivo Network Edge a otros proveedores de servicios

Establezca una conexión directa de capa 2 con los proveedores de servicios en la nube desde su dispositivo Network Edge utilizando la Fabric API.

Requisitos previos de la API de Fabric

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

2. Determine la información de su lado A. Recupere la información de sus dispositivos Network Edge utilizando la función Obtener dispositivos virtuales o Obtener dispositivo virtual {uuid}. Puede elegir cualquier interfaz disponible en el dispositivo para su conexión. Sin embargo, Equinix seleccionará una interfaz si usted no especifica ninguna.

3. Elija la ubicación del metro del lado Z. Utilice la solicitud API Get All Metros para encontrar todos los metros en los que Equinix Fabric está disponible y determinar la ubicación de destino.

4. Identifique el perfil de servicio del proveedor de servicios en la nube. Utilice la solicitud API Recuperar perfiles de servicio para buscar un perfil de servicio específico o utilice la solicitud API Obtener perfiles de servicio para obtener una lista de todos los perfiles de servicio disponibles e identifique al proveedor de servicios en la nube al que desea conectarse.

Conectarse a un proveedor de servicios

Para conectar su dispositivo Network Edge a un proveedor de servicios, envíe una solicitud POST al punto final /fabric/v4/connections. Especifique los detalles de configuración de su conexión en el cuerpo de la solicitud.

	POST /fabric/v4/connections
Method	POST
Endpoint	/fabric/v4/connections
Headers	Authorization, Content-Type
Path Parameters	Not applicable
Query Parameters	Not applicable
Body Parameters	type, name, order, bandwidth, aSide, zSide, notifications

Ejemplo de solicitud cURL:

curl -X  
POST 'https://api.equinix.com/fabric/v4/connections'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '{  
    "type": "EVPL_VC",  
    "name": "vd2other-sp-0412a",  
    "bandwidth": 1000,  
    "aSide": {  
        "accessPoint": {  
            "type": "VD",  
            "virtualDevice": {  
                "type": "EDGE",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXX"  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "type": "L2_PROFILE",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX"  
            },  
            "location": {  
                "metroCode": "DC"  
            }  
        }  
    },  
    "project": {  
        "projectId": "16799d66-ef43-445c-ba29-d17522d8a137"  
    },  
    "order": {  
        "purchaseOrderNumber": "1-129105284100"  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "x@gmail.com"  
            ]  
        }  
    ]  
}'

Respuesta de muestra:

{  
    "type": "EVPL_VC",  
    "href": "https://api.equinix.com/fabric/v4/connections/53c89f1a-0be7-44a1-9c03-28059632a72d",  
    "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
    "name": "vd2other-sp-0425a",  
    "operation": {  
        "providerStatus": "PROVISIONING",  
        "equinixStatus": "PROVISIONING"  
    },  
    "order": {  
        "purchaseOrderNumber": "1-129105284100",  
        "billingTier": "Up to 1G"  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "x@gmail.com"  
            ]  
        }  
    ],  
    "changeLog": {  
        "createdBy": "fabricamcrh1",  
        "createdByFullName": "fabric amcrh1",  
        "createdByEmail": "x@gmail.com",  
        "createdDateTime": "2024-04-25T20:40:40.676Z",  
        "updatedBy": "fabricamcrh1",  
        "updatedByFullName": "fabric amcrh1",  
        "updatedByEmail": "x@gmail.com",  
        "updatedDateTime": "2024-04-25T20:40:40.677Z"  
    },  
    "bandwidth": 1000,  
    "redundancy": {  
        "group": "43009a55-87ee-4dff-8ae4-70ccb7c3d4e9",  
        "priority": "PRIMARY"  
    },  
    "aSide": {  
        "accessPoint": {  
            "interface": {  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
                "id": 5,  
                "type": "CLOUD"  
            },  
            "location": {  
                "metroCode": "DC"  
            },  
            "virtualDevice": {  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
                "type": "EDGE"  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "location": {  
                "metroCode": "DC"  
            },  
            "profile": {  
                "href": "https://api.equinix.com/fabric/v4/serviceProfiles/60ef0382-cdaa-44e7-bd36-b803731816b8",  
                "type": "L2_PROFILE",  
                "name": "Other Service Provider",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  
            }  
        }  
    }  
}

Supervisión del estado de la conexión

Utilice el punto final Obtener conexión especificada para supervisar el estado de la conexión.

equinixStatus parameter values	providerStatus attribute values	Description
PROVISIONING	PROVISIONING	Connection request has not been sent to Oracle yet.
PROVISIONED	PROVISIONING	Connection establishment in progress.
PROVISIONED	PROVISIONED	Connection established.