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
-
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.
-
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.
-
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.
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étodo | POST |
| Punto final | /fabric/v4/connections |
| Encabezados | Authorization, Content-Type |
| Parámetros de la ruta | No aplicable |
| Parámetros de consulta | No aplicable |
| Parámetros corporales | type, 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.