本文へスキップ

Fabric上のサービスプロバイダーに接続する

IBXコロケーション資産とサービスプロファイルの接続を確立します。

前提条件​

  1. Authenticate - OAuth2認証のためのユーザー認証情報、クライアントID、クライアントシークレットを送信します。OAuth APIを呼び出して認証情報を検証および認証する方法については、API Authenticationを参照してください。

  2. A 側のポート情報を決定します。 Get All Ports エンドポイントを使用して、関連するポート情報を取得します。

  3. サイドメトロの場所を選択します。Get All Metrosエンドポイントを使用して、Equinix Fabricが利用可能なすべてのメトロを検索し、接続先を決定します。

  4. サービスプロバイダのサービスプロファイル情報を確認します。特定のサービスプロファイルを検索するには、Retrieve Service Profilesエンドポイントを使用するか、利用可能なすべてのサービスプロファイルを一覧表示するには、Get Service Profilesエンドポイントを使用して、接続するプロファイルを特定します。

DOT1Q ポートからサービスプロバイダへの接続の作成​

DOT1Q ポートからサービスプロバイダへの接続を作成するには、/fabric/v4/connections エンドポイントに POST リクエストを送信します。リクエストの本文に、接続の設定の詳細を指定します。

POST /fabric/v4/connections
MethodPOST
Endpoint/fabric/v4/connections
HeadersAuthorization, Content-Type
Path ParametersNot applicable
Query ParametersNot applicable
Body Parameterstype, name, order, redundancy, bandwidth, aSide, zSide, notifications

接続を作成せずに本番環境でこのリクエストを安全に検証するには、［本番環境でのテスト（APIドライラン）］（../../equinix-api/testing/testing-in-production-dry-run.md）を参照してください。

サンプル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": {  
        "group": "b767f685-41b0-1b07-6de0-320a5c00abdd",  
        "priority": "SECONDARY"  
    },  
    "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"  
            }  
        }  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "test@equinix.com",  
                "test@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": "b767f685-41b0-1b07-6de0-320a5c00abdd",  
    "priority": "SECONDARY"  
},  
"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/serviceProfiles/a867f685-41b0-1b07-6de0-320a5c00abdd",  
            "type": "L2_Profile",  
            "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"  
        },  
        "location": {  
            "href": "https://api.equinix.com/v4/metros/SV",  
            "metrocode": "SV",  
            "region": "AMER"  
        }  
    }  
},  
"notifications": [  
    {  
        "type": "ALL",  
        "emails": [  
            "test@equinix.com",  
            "test2@equinix.com"  
        ]  
    }  
],  
"operation": {  
    "equinixStatus": "PENDING_APPROVAL",  
    "providerStatus": "NOT_AVAILABLE"  
},  
"changeLog": {  
    "createdDateTime": "2021-07-15T19:30:29.526Z"  
}  
}

レスポンスペイロードには、リクエストボディで定義された設定パラメータが含まれます。使用可能なパラメータの一覧とその説明については、API リファレンス を参照してください。

QINQ ポートからサービスプロバイダへの接続の作成​

QINQ ポートからサービスプロバイダへの接続を作成するには、/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,  
    "redundancy": {  
        "group": "b767f685-41b0-1b07-6de0-320a5c00abdd",  
        "priority": "SECONDARY"  
    },  
    "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"  
            }  
        }  
    },  
    "notifications": [  
        {  
            "type": "ALL",  
            "emails": [  
                "test@equinix.com",  
                "test@equinix.com"  
            ]  
        }  
    ]  
}'

リクエストボディに含まれるパラメータは、この例に特有のものです。パラメーターの全リストとその説明については、APIリファレンスを参照してください。

接続の監視​

接続ステータスを監視するには、Get Specified Connection エンドポイントを使用します。

equinixStatus parameter valuesproviderStatus parameter valuesDescription
PENDING_APPROVALNOT_AVAILABLEConnection request awaiting approval.
PROVISIONING or REJECTEDNOT_AVAILABLEConnection establishment in progress or the seller has rejected the connection.
PROVISIONEDAVAILABLEConnection established.

このページは役に立ちましたか？