Ir al contenido principal

Conectarse a una red

Establezca una conexión directa y de baja latencia entre sus redes y sus puertos y dispositivos virtuales.

Requisitos previos​

  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. Obtenga información sobre su red Fabric: envíe una solicitud POST al punto final fabric/v4/networks/search para buscar y recuperar una lista de sus redes disponibles.

  3. Determine la información de su puerto o dispositivo virtual.

    • Recupere la información de sus puertos Equinix Fabric utilizando el punto final Obtener todos los puertos. Para encontrar información de un puerto específico utilice el punto final Obtener puerto especificado.

    • Determine la información de su dispositivo Network Edge. Necesita un dispositivo virtual/dispositivo redundante/clúster Equinix aprovisionado con una licencia registrada. Compruebe sus dispositivos virtuales y clusters disponibles llamando a 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.

Creación de una conexión desde un puerto etiquetado a una red EVPLAN​

Para crear una conexión desde un puerto etiquetado a una red EVPLAN, 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
MethodPOST
Endpoint/fabric/v4/connections
HeadersAuthorization, Content-Type
Path ParametersNot applicable
Query ParametersNot applicable
Body Parameterstype, name, order, bandwidth, aSide, zSide, notifications, redundancy

Para validar de forma segura esta solicitud en producción sin crear una conexión, consulte Pruebas en producción (API Dry Run).

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": "EVPLAN_VC",  
  "name": "MY-EVPLAN-CONNECTION-1",  
  "bandwidth": 1000,  
  "aSide": {  
    "accessPoint": {  
      "type": "COLO",  
      "port": {  
        "uuid": "9127bb72-5f4f-4517-be74-3af7ce612687"  
      },  
      "linkProtocol": {  
        "type": "DOT1Q",  
        "vlanTag": 300  
      }  
    }  
  },  
  "zSide": {  
    "accessPoint": {  
      "type": "NETWORK",  
      "network": {  
        "uuid": "25f8884e-85e3-4eaa-8ea9-a7ad2ca5b3c2"  
      }  
    }  
  },  
  "order": {  
    "purchaseOrderNumber": "1-129105284100"  
  },  
  "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 los parámetros y sus descripciones, consulte la Referencia API.

Respuesta de muestra:

{  
"type": "EVPLAN_VC",  
"href": "https://uat2api.npclouda.equinix.com/fabric/v4/connections/01df5124-eed1-4a30-89bb-240c33d5cd12",  
"uuid": "01df5124-eed1-4a30-89bb-240c33d5cd12",  
"name": "test2",  
"operation": {  
    "providerStatus": "NOT_AVAILABLE",  
    "equinixStatus": "PROVISIONING"  
},  
"order": {  
    "billingTier": "Up to 50 MB"  
},  
"notifications": [  
    {  
    "type": "ALL",  
    "emails": [  
        "1eqxnfvuser1@equinix.com"  
    ]  
    }  
],  
"changeLog": {  
    "createdBy": "eqxnfvuser1",  
    "createdByFullName": "eqxnfvuser eqxnfvuser",  
    "createdByEmail": "1eqxnfvuser1@equinix.com",  
    "createdDateTime": "2023-03-27T18:29:53.117Z",  
    "updatedBy": "eqxnfvuser1",  
    "updatedByFullName": "eqxnfvuser eqxnfvuser",  
    "updatedByEmail": "1eqxnfvuser1@equinix.com",  
    "updatedDateTime": "2023-03-27T18:29:53.117Z"  
},  
"bandwidth": 50,  
"redundancy": {  
    "priority": "PRIMARY",  
    "group": "7a58dd05-f46d-4b1d-a154-2e85c396ea63"  
},  
"aSide": {  
    "accessPoint": {  
    "location": {  
        "metroCode": "DC"  
    },  
    "port": {  
        "type": "XF_PORT",  
        "href": "https://uat2api.npclouda.equinix.com/fabric/v4/ports/e569f0bb-96d5-6d5e-92e0-387a5c00a379",  
        "uuid": "e569f0bb-96d5-6d5e-92e0-387a5c00a379",  
        "name": "eqx-nfv-DC5-L-Dot1q-STD-Pri-1G-JP-2"  
    },  
    "linkProtocol": {  
        "type": "DOT1Q",  
        "vlanTag": 44  
    }  
    }  
},  
"zSide": {  
    "accessPoint": {  
    "network": {  
        "href": "https://uat2api.npclouda.equinix.com/fabric/v4/networks/ecc81fe0-7a96-4e08-94f2-0ab52fae662b",  
        "uuid": "ecc81fe0-7a96-4e08-94f2-0ab52fae662b",  
        "name": "EVPLAN-AMER-1",  
        "platformUuid": "52c6ec8b-4aad-4167-be6d-1972a12d1b83",  
        "state": "ACTIVE",  
        "type": "EVPLAN",  
        "scope": "REGIONAL",  
        "location": {  
        "region": "AMER"  
        }  
    }  
    }  
}  
}

La carga útil de la respuesta incluye los 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 API.

Creación de una conexión desde un puerto no etiquetado a una red EPLAN​

Para crear una conexión desde un puerto no etiquetado a una red EPLAN, 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.

curl -X  
POST 'https://api.equinix.com/fabric/v4/connections'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '  
{  
  "type": "EPLAN_VC",  
  "name": "MY-EPLAN-CONNECTION-1",  
  "bandwidth": 1000,  
  "aSide": {  
    "accessPoint": {  
      "type": "COLO",  
      "port": {  
        "uuid": "9127bb72-5f4f-4517-be74-3af7ce612687"  
      }  
    }  
  },  
  "zSide": {  
    "accessPoint": {  
      "type": "NETWORK",  
      "network": {  
        "uuid": "25f8884e-85e3-4eaa-8ea9-a7ad2ca5b3c2"  
      }  
    }  
  },  
  "order": {  
    "purchaseOrderNumber": "1-129105284100"  
  },  
  "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 los parámetros y sus descripciones, consulte la Referencia API.

Creación de una conexión desde un dispositivo virtual a la red EVPLAN​

Para crear una conexión desde un dispositivo virtual a la red EVPLAN, 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.

curl -X  
POST 'https://api.equinix.com/fabric/v4/connections'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '  
{  
  "type": "EVPLAN_VC",  
  "name": "MY-VD-EVPLAN-CONNECTION-1",  
  "bandwidth": 1000,  
  "aSide": {  
    "accessPoint": {  
      "type": "VD",  
      "virtualDevice": {  
        "type": "EDGE",  
        "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"  
      },  
      "interface": {  
        "type": "NETWORK",  
        "id": 7  
      }  
    }  
  },  
  "zSide": {  
    "accessPoint": {  
      "type": "NETWORK",  
      "network": {  
        "uuid": "25f8884e-85e3-4eaa-8ea9-a7ad2ca5b3c2"  
      }  
    }  
  },  
  "order": {  
    "purchaseOrderNumber": "1-129105284100"  
  },  
  "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 los parámetros y sus descripciones, consulte la Referencia API.

¿Fue útil esta página?