API - 连接到 IBM Cloud Direct Link 2.0

与 IBM Cloud™ Direct Link 2.0 建立连接，将您的 IBX 共置资产连接到您的 IBM Cloud 资源。

识别您的 IBM 帐户 ID

登录到IBM Cloud 控制台并选择“管理”。 > Account 查找您的 IBM 帐户 ID。

Fabric API 先决条件

身份验证 - 提交您的 OAuth2 用户凭据、客户端 ID 和客户端密钥身份验证。请参阅API身份验证以获取有关如何调用OAuth API来验证和认证您的凭据的说明。
确定您的 A 面信息。您可以：
- 使用 Get All Ports API 请求检索 Equinix Fabric 端口信息。
或者
- 请确定您的网络边缘设备信息。您需要已配置且已注册许可证的 Equinix 虚拟设备/冗余设备/集群。您可以通过调用 Get Virtual Devices 或 Get Virtual Device {uuid} 来查看可用的虚拟设备和集群。您可以选择设备上的任何可用接口进行连接。但是，如果您未指定接口，Equinix 将自动选择一个。
选择 Z 侧地铁站点。使用 Get All Metros API 请求查找所有 Equinix Fabric 可用的地铁站点，并确定目的地位置。
确定服务配置文件。使用检索服务配置文件 API 请求搜索特定服务配置文件，或使用获取服务配置文件 API 请求列出所有可用的服务配置文件，并确定所需的服务配置文件。你想联系的个人资料。

从 DOT1Q 端口连接到 IBM Cloud Direct Link 2.0

要从您的 DOT1Q 端口创建到 IBM Cloud Direct Link 2.0 的连接，请向 /fabric/v4/connections 端点发送 POST 请求。在请求正文中指定连接的配置详细信息。

	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`

示例 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"  
        ]  
    }  
}'

请求正文中包含的参数仅适用于此示例。有关参数及其说明的完整列表，请参阅API 参考。

示例响应：

{  
    "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"  
    }  
}

响应有效负载包含在请求正文中定义的配置参数。有关所有可用参数及其说明的完整列表，请参阅API 参考。

从 QINQ 端口连接到 IBM Cloud Direct Link 2.0

要从您的 QINQ 端口创建到 IBM Cloud Direct Link 2.0 的连接，请向 /fabric/v4/connections 端点发送 POST 请求。在请求正文中指定连接的配置详细信息。

	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`

示例 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"  
        ]  
    }  
}'

请求正文中包含的参数仅适用于此示例。有关参数及其说明的完整列表，请参阅API 参考。

从Network Edge设备连接到 IBM Cloud Direct Link 2.0

要从您的网络边缘设备创建到 IBM Cloud Direct Link 2.0 的连接，请向 /fabric/v4/connections 端点发送 POST 请求。在请求正文中指定连接的配置详细信息。

	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`

示例 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"  
            ]  
        }  
    ]  
}  
'

请求正文中包含的参数仅适用于此示例。有关参数及其说明的完整列表，请参阅API 参考。

示例响应：

{  
    "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"  
        }  
    }  
}

响应有效负载包含在请求正文中定义的配置参数。有关所有可用参数及其说明的完整列表，请参阅API 参考。

监控连接状态

向 fabric/v4/connections/{connectionId} 端点发送 GET 请求以监控连接状态。

`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.

接受连接

登录到 IBM Cloud 控制台并导航到 IBM Cloud Direct Link Exchange 页面以查看并接受待处理的连接。

识别您的 IBM 帐户 ID​

Fabric API 先决条件​

从 DOT1Q 端口连接到 IBM Cloud Direct Link 2.0​

从 QINQ 端口连接到 IBM Cloud Direct Link 2.0​

从Network Edge设备连接到 IBM Cloud Direct Link 2.0​

监控连接状态​

接受连接​

识别您的 IBM 帐户 ID

Fabric API 先决条件

从 DOT1Q 端口连接到 IBM Cloud Direct Link 2.0

从 QINQ 端口连接到 IBM Cloud Direct Link 2.0

从Network Edge设备连接到 IBM Cloud Direct Link 2.0

监控连接状态

接受连接