API - IBM Cloud Direct Link on Classic への接続

Classic の IBM Cloud™ Direct Link を使用して接続を確立し、IBX コロケーション資産を IBM Cloud リソースに接続します。

IBMアカウントIDの確認

IBM Cloudコンソールにログインし、［管理］>［_アカウント］を_選択して、IBMアカウントIDを確認します。

Fabric API の前提条件

認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。認証。OAuth APIを呼び出して認証情報を検証および認証する方法については、「API認証」を参照してください。
Aサイド情報を決定します。Get All Ports APIリクエストを使用して、Equinix Fabricポート情報を取得します。
Zサイドの都市圏の拠点を選択します。［すべての都市圏を取得］APIリクエストを使用して、Equinix Fabricが利用可能なすべての都市圏を検索し、接続先の場所を決定します。
サービスプロファイルを特定します。特定のサービスプロファイルを検索するには、[サービスプロファイルの取得（Retrieve Service Profiles API）]リクエストを使用します。または、[サービスプロファイルの取得（Get Service Profiles API）]リクエストを使用して、接続先のプロフィール

DOT1QポートからClassic上のIBM Cloud Direct Linkへの接続

Dot1QポートからClassicのIBM Cloud Direct Linkへの接続を作成するには、エンドポイントにリクエストを/fabric/v4/connections送信します。POSTリクエストの本文で接続の構成の詳細を指定します。

	POST/ファブリック/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": "Global",
            "value": "false"
        }
    ],
    "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"
            },
            "sellerRegion": "us-west-1"
        }
    },
    "additionalInfo": [
        {
            "key": "ASN",
            "value": "12345"
        },
        {
            "key": "Global",
            "value": "false"
        }
    ],
    "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ポートからClassicのIBM Cloud Direct Linkへの接続

ClassicのQinQポートからIBM Cloud Direct Linkへの接続を作成するには、エンドポイントにリクエストを/fabric/v4/connections送信します。POSTリクエストの本文で接続の構成の詳細を指定します。

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": "Global",
            "value": "false"
        }
    ],
    "notifications": [
        {
            "type": "ALL",
            "emails": [
                "test@equinix.com",
                "test2@equinix.com"
            ]
        }
    ]
}'

接続ステータスの監視

接続ステータスを監視するリクエストをfabric/v4/connections/{connectionId}エンドポイントに送信します。GET

`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ポートからClassic上のIBM Cloud Direct Linkへの接続​

QINQポートからClassicのIBM Cloud Direct Linkへの接続​

接続ステータスの監視​

接続を受け入れる​