API - Conexión a IBM Cloud Direct Link 2.0

Establezca una conexión con IBM Cloud™ Direct Link 2.0 para conectar sus activos colocados de IBX a sus recursos de IBM Cloud.

Identifique su ID de cuenta IBM

Inicie sesión en la [consola IBM Cloud y seleccione Manage > Account para localizar su ID de cuenta IBM.

Requisitos previos de Fabric API

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.
Determine la información de su cara A. Cualquiera:
- Recupere la información de los puertos de Equinix Fabric mediante la solicitud API Get All Ports.
O
- 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.
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.
Identifique el perfil de servicio. Utilice la petición API Recuperar perfiles de servicio para buscar un perfil de servicio específico o utilice la petición API Obtener perfiles de servicio para listar todos los perfiles de servicio disponibles e identificar el perfil al que desea conectarse

Conexión a IBM Cloud Direct Link 2.0 desde un puerto DOT1Q

Para crear una conexión desde su puerto DOT1Q a IBM Cloud Direct Link 2.0, 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`, `redundancy`, `aSide`, `zSide`, `additionalInfo`, `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": "Conn-1",  
    "order": {  
        "purchaseOrderNumber": "1-129105284100"  
    },  
    "bandwidth": 1000,  
    "redundancy": {  
        "priority": "PRIMARY"  
    },  
    "aSide": {  
        "accessPoint": {  
            "type": "COLO",  
            "port": {  
                "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"  
            },  
            "linkProtocol": {  
                "type": "DOT1Q",  
                "vlanTag": 1001  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"  
            },  
            "location": {  
                "metroCode": "SV"  
            },  
            "authenticationKey": "xx-xxx-xx",  
            "sellerRegion": "us-west-1"  
        }  
    },  
    "additionalInfo": [  
        {  
            "key": "ASN",  
            "value": "12345"  
        },  
        {  
            "key": "CER IPv4 CIDR",  
            "value": "11.1.1.10/30"  
        },  
        {  
            "key": "IBM IPv4 CIDR",  
            "value": "11.1.1.10/30"  
        }  
    ],  
    "notifications": {  
        "type": "ALL",  
        "emails": [  
            "test@equinix.com",  
            "test2@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:

{  
    "href": "https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62",  
    "type": "EVPL_VC",  
    "uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62",  
    "name": "Conn-1",  
    "state": "PROVISIONING",  
    "order": {  
        "purchaseOrderNumber": "1-129105284100",  
        "billingTier": "Up to 1 Gbps"  
    },  
    "bandwidth": 1000,  
    "redundancy": {  
        "group": "m167f685-41b0-1b07-6de0-320a5c00abeu",  
        "priority": "PRIMARY"  
    },  
    "aSide": {  
        "accessPoint": {  
            "type": "COLO",  
            "port": {  
                "href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",  
                "type": "XF_PORT",  
                "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"  
            },  
            "linkProtocol": {  
                "type": "DOT1Q",  
                "vlanTag": 1001  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "href": "https://api.equinix.com/fabric/v4/services/serviceProfiles/20d32a80-0d61-4333-bc03-707b591ae2f5",  
                "type": "L2_PROFILE",  
                "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"  
            },  
            "location": {  
                "href": "https://api.equinix.com/v4/metros/SV",  
                "metroCode": "SV",  
                "region": "AMER"  
            },  
            "authenticationKey": "xx-xxx-xx",  
            "sellerRegion": "us-west-1"  
        }  
    },  
    "additionalInfo": [  
        {  
            "key": "ASN",  
            "value": "12345"  
        },  
        {  
            "key": "CER IPv4 CIDR",  
            "value": "11.1.1.10/30"  
        },  
        {  
            "key": "IBM IPv4 CIDR",  
            "value": "11.1.1.10/30"  
        }  
    ],  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "test@equinix.com",  
                "test2@equinix.com"  
            ]  
        }  
    ],  
    "operation": {  
        "equinixStatus": "PROVISIONING",  
        "providerStatus": "PROVISIONING"  
    },  
    "changeLog": {  
        "createdDateTime": "2021-07-15T19:30:29.526Z"  
    }  
}

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.

Conexión a IBM Cloud Direct Link 2.0 desde un puerto QINQ

Para crear una conexión desde su puerto QINQ a IBM Cloud Direct Link 2.0, 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`, `redundancy`, `aSide`, `zSide`, `additionalInfo`, `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": "Conn-1",  
    "order": {  
        "purchaseOrderNumber": "1-129105284100"  
    },  
    "bandwidth": 1000,  
    "redundancy": {  
        "priority": "PRIMARY"  
    },  
    "aSide": {  
        "accessPoint": {  
            "type": "COLO",  
            "port": {  
                "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"  
            },  
            "linkProtocol": {  
                "type": "QINQ",  
                "vlanCTag": 1001,  
                "vlanSTag": 1002  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"  
            },  
            "location": {  
                "metroCode": "SV"  
            },  
            "authenticationKey": "xx-xxx-xx",  
            "sellerRegion": "us-west-1"  
        }  
    },  
    "additionalInfo": [  
        {  
            "key": "ASN",  
            "value": "12345"  
        },  
        {  
            "key": "CER IPv4 CIDR",  
            "value": "11.1.1.10/30"  
        },  
        {  
            "key": "IBM IPv4 CIDR",  
            "value": "11.1.1.10/30"  
        }  
    ],  
    "notifications": {  
        "type": "ALL",  
        "emails": [  
            "test@equinix.com",  
            "test2@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.

Conexión a IBM Cloud Direct Link 2.0 desde un dispositivo Network Edge

Para crear una conexión desde su dispositivo Network Edge a IBM Cloud Direct Link 2.0, 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`, `redundancy`, `aSide`, `zSide`, `additionalInfo`, `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": "port2ibm2-vvv-0425f",  
    "bandwidth": "50",  
    "aSide": {  
        "accessPoint": {  
            "type": "VD",  
            "virtualDevice": {  
                "type": "EDGE",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "type": "L2_PROFILE",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  
            },  
            "location": {  
                "metroCode": "SV"  
            },  
            "authenticationKey": "XXXXXXXXXX",  
            "sellerRegion": "San Jose 2"  
        }  
    },  
    "additionalInfo": [  
        {  
            "key": "ASN",  
            "value": 12345  
        },  
        {  
            "key": "BGP_CER_CIDR",  
            "value": "172.16.0.17/30"  
        },  
        {  
            "key": "BGP_IBM_CIDR",  
            "value": "172.16.0.18/30"  
        },  
        {  
            "key": "Global",  
            "value": false  
        }  
    ],  
    "project": {  
        "projectId": "16799d66-ef43-445c-ba29-d17522d8a137"  
    },  
    "order": {  
        "purchaseOrderNumber": "1-129105284100"  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "x@gmail.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": "EVPL_VC",  
    "href": "https://api.equinix.com/fabric/v4/connections/0175e136-8be7-4b04-8d57-c33c20555501",  
    "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
    "name": "port2ibm2-vvv-0425f",  
    "operation": {  
        "providerStatus": "PROVISIONING",  
        "equinixStatus": "PROVISIONING"  
    },  
    "order": {  
        "purchaseOrderNumber": "1-129105284100",  
        "billingTier": "Up to 50 MB"  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "x@gmail.com"  
            ]  
        }  
    ],  
    "changeLog": {  
        "createdBy": "fabricamcrh1",  
        "createdByFullName": "XXXXX XXXXXX",  
        "createdByEmail": "x@gmail.com",  
        "createdDateTime": "2024-04-25T20:41:37.805Z",  
        "updatedBy": "fabricamcrh1",  
        "updatedByFullName": "XXXXXX XXXXXX",  
        "updatedByEmail": "x@gmail.com",  
        "updatedDateTime": "2024-04-25T20:41:37.805Z"  
    },  
    "bandwidth": 50,  
    "redundancy": {  
        "group": "d1f11356-91ca-4550-8488-ba434a771e09",  
        "priority": "PRIMARY"  
    },  
    "aSide": {  
        "accessPoint": {  
            "interface": {  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
                "id": 8,  
                "type": "CLOUD"  
            },  
            "location": {  
                "metroCode": "DC"  
            },  
            "virtualDevice": {  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
                "type": "EDGE"  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "location": {  
                "metroCode": "SV"  
            },  
            "profile": {  
                "href": "https://api.equinix.com/fabric/v4/serviceProfiles/e092ed47-63d2-4f4a-87a0-82e3b08eefe5",  
                "type": "L2_PROFILE",  
                "name": "IBM Cloud Direct Link 2",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  
            },  
            "sellerRegion": "San Jose 2",  
            "authenticationKey": "XXXXXXXXXXXXXXXXXXX"  
        }  
    }  
}

Supervisión del estado de la conexión

Envíe una solicitud GET al punto final fabric/v4/connections/{connectionId} para supervisar el estado de la conexión.

`equinixStatus`attribute values	`providerStatus`attribute values	IBM Direct Link status	Description
`PROVISIONING`	`PROVISIONING`	-	Connection request has not been sent to IBM yet.
`PENDING_PROVIDER_VLAN`	`PENDING_APPROVAL`	Create approval pending	The connection awaits for approval.
`PROVISIONED`	`PROVISIONING / PROVISIONED`	Create in progress	Connection establishment in progress.
`PROVISIONED`	`PROVISIONED`	Provisioned	Connection established.

Aceptar la conexión

Inicie sesión en la [consola IBM Cloud y navegue hasta la [página IBM Cloud Direct Link Exchange para revisar y aceptar la conexión pendiente.

Identifique su ID de cuenta IBM​

Requisitos previos de Fabric API​

Conexión a IBM Cloud Direct Link 2.0 desde un puerto DOT1Q​

Conexión a IBM Cloud Direct Link 2.0 desde un puerto QINQ​

Conexión a IBM Cloud Direct Link 2.0 desde un dispositivo Network Edge​

Supervisión del estado de la conexión​

Aceptar la conexión​

Identifique su ID de cuenta IBM

Requisitos previos de Fabric API

Conexión a IBM Cloud Direct Link 2.0 desde un puerto DOT1Q

Conexión a IBM Cloud Direct Link 2.0 desde un puerto QINQ

Conexión a IBM Cloud Direct Link 2.0 desde un dispositivo Network Edge

Supervisión del estado de la conexión

Aceptar la conexión