メインコンテンツにスキップ

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

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

前提条件​

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

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

  3. Zサイドの都市圏の拠点を選択します。「全ての都市圏を取得」エンドポイントを使用して、Equinix Fabricが利用可能な全ての都市圏を検索し、接続先の場所を特定します。

  4. サービスプロバイダのサービスプロファイル情報を特定します。[サービスプロファイルの取得]エンドポイントを使用して特定のサービスプロファイルを検索するか、[サービスプロファイルの一覧表示]エンドポイントを使用して、利用可能なすべてのサービスプロファイルを一覧表示し、接続先のプロファイルを特定します。

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

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

POST /fabric/v4/connections
方法POST
エンドポイント/fabric/v4/connections
ヘッダーAuthorization、Content-Type
パスパラメータ該当なし
クエリーパラメータ該当なし
ボディパラメータtype``name、、order、、redundancy、bandwidth``aSide、zSide、notifications

接続を作成せずに本番環境でこのリクエストを安全に検証するには、「本番環境でのテスト（APIドライラン）」を参照してください。

サンプル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リファレンスを参照してください。

接続の監視​

指定された接続の取得エンドポイントを使用して、接続ステータスを監視します。

**equinixStatus**パラメータ値**providerStatus**パラメータ値説明
PENDING_APPROVALNOT_AVAILABLE接続申請は承認待ち。
PROVISIONINGまたは REJECTEDNOT_AVAILABLE接続確立中、または売り手が接続を拒否した。
PROVISIONEDAVAILABLE接続が確立されました。

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