Saltar al contenido principal

Conectar el dispositivo Network Edge al puerto remoto

Establezca una conexión sin etiquetar entre su dispositivo virtual Network Edge y un puerto remoto de Fabric utilizando 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 de API para obtener instrucciones sobre cómo llamar a OAuth API para validar y autenticar sus credenciales.

  2. Determine su información de A-Side. Recupere la información de sus dispositivos Network Edge con los dispositivos 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 no especifica una.

  3. Recupere la información de sus puertos de Equinix Fabric con la solicitudGet All Ports API.

Conexión a un puerto remoto no etiquetado​

Para crear una conexión desde un dispositivo Network Edge a un puerto remoto con tráfico sin etiquetar, envíe una POST solicitud al /fabric/v4/connections punto final. Especifique los detalles de configuración de su conexión en el cuerpo de la solicitud.

nota

Solo se puede crear una única conexión sin etiquetar desde un dispositivo virtual Network Edge a un puerto remoto.

PUBLICAR /fabric/v4/Connections
MétodoPOST
Punto final/fabric/v4/connections
EncabezadosAuthorization, Content-Type
Parámetros de la rutaNo aplicable
Parámetros de consultaNo aplicable
Parámetros corporalestype, name, order bandwidth, , , aSide``zSide, project, , 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",
    "bandwidth": 100,
    "redundancy": {
        "priority": "PRIMARY"
    },
    "name": "ConnectionName-1",
    "order": {
        "purchaseOrderNumber": "1-3232923"
    },
    "aSide": {
        "accessPoint": {
            "type": "VD",
            "virtualDevice": {
                "type": "EDGE",
                "uuid": "fd5342f3-d067-4683-a24f-be952279630b"
            },
            "interface": {
                "type": "NETWORK",
                "id": 45645
            }
        }
    },
    "zSide": {
        "accessPoint": {
            "type": "COLO",
            "port": {
                "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
            },
            "linkProtocol": {
                "type": "UNTAGGED"
            }
        }
    },
    "project": {
        "projectId": 567
    },
    "notifications": [
        {
            "type": "ALL",
            "emails": [
                "test@equinix.com",
                "test1@equinix.com"
            ]
        }
    ]
}'

Los parámetros incluidos en el cuerpo de la solicitud son específicos de este ejemplo. Para obtener una lista completa de parámetros y sus descripciones, consulte la referencia de API .

Conexión a un puerto remoto DOT1Q​

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

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",
    "bandwidth": 1000,
    "name": "vd to COLO",
    "aSide": {
    "accessPoint": {
        "type": "VD",
        "virtualDevice": {
        "type": "EDGE",
        "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
        },
        "interface": {
        "type": "NETWORK",
        "id": 45645
        }
    }
    },
    "zSide": {
    "accessPoint": {
        "type": "COLO",
        "port": {
        "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
        },
        "linkProtocol": {
        "type": "DOT1Q",
        "vlanTag": 300
        }
    }
    },
    "order": {
    "purchaseOrderNumber": "1-129105284100"
    },
    "notifications": [
    {
        "type": "ALL",
        "emails": [
        "test@equinix.com",
        "test1@equinix.com"
        ]
    }
    ]
}'

Respuesta de muestra:

{
    "type": "EVPL_VC",
    "href": "https://api.equinix.com/fabric/v4/connections/c193c1c4-2c7e-472d-8c91-0283bc3b5a71",
    "uuid": "c193c1c4-2c7e-472d-8c91-0283bc3b5a71",
    "name": "ConnectionName-1",
    "state": "PROVISIONING",
    "operation": {
        "providerStatus": "NOT_AVAILABLE",
        "equinixStatus": "PROVISIONING"
    },
    "order": {
        "purchaseOrderNumber": "1-3232923"
    },
    "project": {
        "projectId": 567
    },
    "notifications": [
        {
            "type": "ALL",
            "emails": [
                "testqq@equinix.com"
            ]
        }
    ],
    "account": {
        "accountNumber": 270217,
        "orgId": 92287,
        "globalOrgId": "0016u000003JZ53AAG"
    },
    "changeLog": {
        "createdBy": "eqxnfvuser",
        "createdDateTime": "2022-03-22T23:14:23.546Z"
    },
    "bandwidth": 100,
    "redundancy": {
        "group": "79a0e626-55fe-4fe1-89a5-4d7ca52214db",
        "priority": "PRIMARY"
    },
    "isRemote": true,
    "direction": "INTERNAL",
    "aSide": {
        "accessPoint": {
            "interface": {
                "uuid": "bf8a606b-32b2-4a53-a450-6eabd7d9ccab",
                "id": 45645,
                "type": "CLOUD"
            },
            "type": "VD",
            "account": {
                "accountNumber": 270217,
                "orgId": 92287,
                "organizationName": "eqx-nfv",
                "globalOrgId": "0016u000003JZ53AAG"
            },
            "location": {
                "href": "https://api.equinix.com/fabric/v4/metros/DC",
                "region": "AMER",
                "metroName": "Ashburn",
                "metroCode": "DC"
            },
            "virtualDevice": {
                "href": "https://api.equinix.com/ne/v1/devices/fd5342f3-d067-4683-a24f-be952279630b",
                "uuid": "fd5342f3-d067-4683-a24f-be952279630b",
                "name": "ha-json",
                "type": "EDGE"
            }
        }
    },
    "zSide": {
        "accessPoint": {
            "type": "COLO",
            "account": {
                "accountNumber": 270224,
                "orgId": 92287,
                "organizationName": "eqx-nfv",
                "globalOrgId": "0016u000003JZ53AAG"
            },
            "location": {
                "href": "https://api.equinix.com/fabric/v4/metros/SY",
                "region": "APAC",
                "metroName": "Sydney",
                "metroCode": "SY"
            },
            "port": {
                "href": "https://api.equinix.com/fabric/v4/ports/c791f8cb-5d73-d730-8ce0-306a5c00a4ee",
                "uuid": "c791f8cb-5d73-d730-8ce0-306a5c00a4ee",
                "name": "eqx-nfv-SY1-L-Dot1q-BO-PRI-10G-JN-1147"
            },
            "linkProtocol": {
                "type": "DOT1Q"
            }
        }
    },
    "additionalInfo": []
}

La carga útil de respuesta incluye parámetros de configuración definidos en el cuerpo de la solicitud. Para obtener una lista completa de los posibles parámetros y sus descripciones, consulte la Referencia de API .

Conexión a un puerto remoto QinQ​

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

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",
    "bandwidth": 1000,
    "name": "vd to COLO",
    "aSide": {
    "accessPoint": {
        "type": "VD",
        "virtualDevice": {
        "type": "EDGE",
        "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
        },
        "interface": {
        "type": "NETWORK",
        "id": 45645
        }
    }
    },
    "zSide": {
    "accessPoint": {
        "type": "COLO",
        "port": {
        "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
        },
        "linkProtocol": {
        "type": "QINQ",
        "vlanSTag": 300,
        "vlanCTag": 400
        }
    }
    },
    "order": {
    "purchaseOrderNumber": "1-129105284100"
    },
    "notifications": [
    {
        "type": "ALL",
        "emails": [
        "test@equinix.com",
        "test1@equinix.com"
        ]
    }
    ]
}
'

Supervisión de su conexión​

Utilice el punto finalGet Connection APIespecificado para supervisar el estado de la conexión.

¿Le ha resultado útil esta página?