API - 连接到 IBM Cloud 直接 Link 2.0

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

识别您的 IBM 帐户 ID

登录到IBM Cloud控制台，然后选择“管理>账户”以找到您的IBM账户ID。

Fabric API 先决条件

身份验证 - 提交您的 OAuth2 用户凭据、客户端 ID 和客户端密钥验证。有关如何致电OAuth API以验证和验证您的凭据的说明，请参阅API验证。
确定A侧信息。以下任一项：
- 使用获取所有端口API请求检索您的Equinix Fabric端口信息。
或
- 确定您的Network Edge设备信息。您需要一个已配置且具有注册许可证的Equinix虚拟设备/冗余设备/集群。拨打获取虚拟设备或获取虚拟设备 {uuid}，以检查可用的虚拟设备和集群。您可以在设备上选择任何可用接口进行连接。但是，如果您未指定接口，Equinix将选择接口。
选择Z侧都会区位置。使用获取所有都会区API请求查找Equinix Fabric可用的所有都会区并确定目标位置。
确定服务配置文件。使用检索服务配置文件API请求搜索特定的服务配置文件，或使用获取服务配置文件API请求列出所有可用的服务配置文件并确定你想联系的个人资料。

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

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

	发布/fabric/v4/connections
方法	`POST`
端点	`/fabric/v4/connections`
标题	`Authorization`，`Content-Type`
路径参数	不适用
查询参数	不适用
身体参数	`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 直接 Link 2.0

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

	发布/fabric/v4/connections
方法	`POST`
端点	`/fabric/v4/connections`
标题	`Authorization`，`Content-Type`
路径参数	不适用
查询参数	不适用
身体参数	`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 直接 Link 2.0

要创建从Network Edge设备到IBM Cloud Direct Link 2.0的连接, 请向端点发送POST请求/fabric/v4/connections。在请求正文中指定连接的配置详情。

	发布/fabric/v4/connections
方法	`POST`
端点	`/fabric/v4/connections`
标题	`Authorization`，`Content-Type`
路径参数	不适用
查询参数	不适用
身体参数	`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参考手册。

监控连接状态

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

`equinixStatus`属性值	`providerStatus`属性值	IBM直接链接状态	描述
`PROVISIONING`	`PROVISIONING`	-	连接请求尚未发送给 IBM。
`PENDING_PROVIDER_VLAN`	`PENDING_APPROVAL`	创建待批准	连接等待批准。
`PROVISIONED`	`PROVISIONING / PROVISIONED`	正在创建	连接正在建立中。
`PROVISIONED`	`PROVISIONED`	已配置	连接已建立。

接受连接

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

识别您的 IBM 帐户 ID​

Fabric API 先决条件​

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

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

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

监控连接状态​

接受连接​

识别您的 IBM 帐户 ID

Fabric API 先决条件

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

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

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

监控连接状态

接受连接