API - アリババへの接続

Alibaba Cloudへのレイヤ2の直接接続を確立します。

アリババ・アカウントIDの確認

Alibaba Express Connect Management Consoleにログインし、アカウントIDを確認します。

Fabric API の前提条件

認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。認証を使用します。OAuth APIを呼び出して認証情報を検証および認証する方法については、API認証を参照してください。
A面の情報を決めるどちらか：
- Get All Ports APIリクエストを使用して、Equinix Fabricのポート情報を取得します。
または
- Networkエッジデバイスの情報を確認します。登録済みのエクイニクス仮想デバイス／冗長デバイス／クラスタが必要です。利用可能な仮想デバイスとクラスタを確認するには、Get Virtual Devices または Get Virtual Device {uuid}をコールします。接続には、デバイス上で利用可能な任意のインターフェースを選択できます。ただし、指定がない場合はエクイニクスがインターフェースを選択します。
サイドメトロの場所を選択します。Get All Metros APIリクエストを使用して、Equinix Fabricが利用可能なすべてのメトロを検索し、接続先を決定します。
サービスプロファイルを特定します。特定のサービスプロファイルを検索するには、Retrieve Service Profiles API リクエストを使用するか、利用可能なすべてのサービスプロファイルを一覧表示するには、Get Service Profiles API リクエストを使用します。接続先のプロフィール

DOT1QポートからAlibaba Express Connectへの接続

DOT1QポートからAlibaba Express Connectへの接続を作成するには、/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`, `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,  
    "aSide": {  
        "accessPoint": {  
            "type": "COLO",  
            "port": {  
                "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"  
            },  
            "linkProtocol": {  
                "type": "DOT1Q",  
                "vlanTag": 1001  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "uuid": "4c4b8edf-873b-4c6c-805a-edb2c335bd6c"  
            },  
            "location": {  
                "metroCode": "SV"  
            },  
            "authenticationKey": "xx-xxx-xx",  
            "sellerRegion": "us-west-1"  
        }  
    },  
    "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,  
    "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"  
        }  
    },  
    "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ポートからAlibaba Express Connectへの接続

QINQポートからAlibaba Express Connectへの接続を作成するには、/fabric/v4/connectionsエンドポイントにPOSTリクエストを送信します。リクエストの本文に、接続の設定の詳細を指定します。

サンプル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,  
    "aSide": {  
        "accessPoint": {  
            "type": "COLO",  
            "port": {  
                "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"  
            },  
            "linkProtocol": {  
                "type": "QINQ",  
                "vlanCTag": 1001,  
                "vlanSTag": 1002  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "uuid": "4c4b8edf-873b-4c6c-805a-edb2c335bd6c"  
            },  
            "location": {  
                "metroCode": "SV"  
            },  
            "authenticationKey": "xx-xxx-xx",  
            "sellerRegion": "us-west-1"  
        }  
    },  
    "notifications": {  
        "type": "ALL",  
        "emails": [  
            "test@equinix.com",  
            "test2@equinix.com"  
        ]  
    }  
}'

Network EdgeデバイスからAlibaba Express Connectへの接続

Network EdgeデバイスからAlibaba Express Connectへの接続を作成するには、/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`, `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": "vd2Alibaba-vvv-0425b",  
    "bandwidth": "50",  
    "aSide": {  
        "accessPoint": {  
            "type": "VD",  
            "virtualDevice": {  
                "type": "EDGE",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "type": "SP",  
            "profile": {  
                "type": "L2_PROFILE",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  
            },  
            "location": {  
                "metroCode": "SV"  
            },  
            "authenticationKey": "XXXXXXXXXXXXXXX",  
            "sellerRegion": "us-west-1"  
        }  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "X@gmail.com"  
            ]  
        }  
    ],  
    "project": {  
        "projectId": "16799d66-ef43-445c-ba29-d17522d8a137"  
    }  
}'

{  
    "type": "EVPL_VC",  
    "href": "https://api.equinix.com/fabric/v4/connections/66ed4e8a-584c-4027-9788-748fecb5ce35",  
    "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
    "name": "vd2Alibaba-vvv-0425c",  
    "operation": {  
        "providerStatus": "PROVISIONING",  
        "equinixStatus": "PROVISIONING"  
    },  
    "order": {  
        "billingTier": "Up to 50 MB"  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "X@gmail.com"  
            ]  
        }  
    ],  
    "changeLog": {  
        "createdBy": "fabricamcrh1",  
        "createdByFullName": "fabric amcrh1",  
        "createdByEmail": "X@gmail.com",  
        "createdDateTime": "2024-04-25T20:43:43.199Z",  
        "updatedBy": "fabricamcrh1",  
        "updatedByFullName": "fabric amcrh1",  
        "updatedByEmail": "X@gmail.com",  
        "updatedDateTime": "2024-04-25T20:43:43.199Z"  
    },  
    "bandwidth": 50,  
    "redundancy": {  
        "group": "160e06b5-cd42-4c2c-b674-6dcda54da4d8",  
        "priority": "PRIMARY"  
    },  
    "aSide": {  
        "accessPoint": {  
            "interface": {  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
                "id": 6,  
                "type": "CLOUD"  
            },  
            "location": {  
                "metroCode": "DC"  
            },  
            "virtualDevice": {  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",  
                "type": "EDGE"  
            }  
        }  
    },  
    "zSide": {  
        "accessPoint": {  
            "location": {  
                "metroCode": "SV"  
            },  
            "profile": {  
                "href": "https://api.equinix.com/fabric/v4/serviceProfiles/4c4b8edf-873b-4c6c-805a-edb2c335bd6c",  
                "type": "L2_PROFILE",  
                "name": "Alibaba Cloud Express Connect",  
                "uuid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"  
            },  
            "sellerRegion": "us-west-1",  
            "authenticationKey": "1111111111111"  
        }  
    }  
}  

接続状況の監視

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

`equinixStatus` attribute values	`providerStatus` attribute values	Alibaba Cloud status	Description
`PROVISIONING`	`NOT_AVAILABLE`	-	Connection request has not been sent to Alibaba yet.
`PROVISIONED`	`PENDING_APPROVAL`	Pending creation	The connection awaits for approval.
`PROVISIONED`	`PROVISIONING / PROVISIONED`	Create in progress	Connection establishment in progress.
`PROVISIONED`	`PROVISIONED`	Active	Connection established.

接続の承諾と支払い

Alibaba Express Connect管理コンソールにログインします。
左のメニューから、物理接続 を選択します。
新しく作成したインスタンスを確認し 受け入れと支払い.
仮想ボーダールーター（VBR）インスタンスを作成し、それを connection.

詳細については、請求 - 価格｜Alibaba Cloud ドキュメンテーションセンターを参照してください。

アリババ・アカウントIDの確認​

Fabric API の前提条件​

DOT1QポートからAlibaba Express Connectへの接続​

QINQポートからAlibaba Express Connectへの接続​

Network EdgeデバイスからAlibaba Express Connectへの接続​

接続状況の監視​

接続の承諾と支払い​

アリババ・アカウントIDの確認

Fabric API の前提条件

DOT1QポートからAlibaba Express Connectへの接続

QINQポートからAlibaba Express Connectへの接続

Network EdgeデバイスからAlibaba Express Connectへの接続

接続状況の監視

接続の承諾と支払い