サービストークンを使ったFabricへの接続
Zサイドサービストークンを引き換えて、Network EdgeデバイスからFabric上の接続先への接続を確立します。リセラー、通信キャリア、サービスプロバイダ、または他のEquinix Fabricのお客様からZサイドサービストークンを提供されるため、インフラストラクチャやサービスに合わせて作成できます。
接続を作成するときに、仮想デバイスとその接続設定を選択すると、サービストークンが接続の反対側の接続の詳細と構成を提供します。各接続には独自のサービストークンが必要です。冗長仮想デバイスまたはクラスタ仮想デバイスから、2つの個別のサービストークンを使用して接続のペアを作成できます。
Network Edge仮想デバイスへの接続の作成を許可する場合は、Zサイドのサービストークンを作成して共有できます。
前提条件
- Portal
- API
-
Equinix Customer Portalにサインインし、Network Edgeダッシュボードに移動します。
-
[接続の作成]をクリックします。

-
認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。 認証。OAuth APIを呼び出して認証情報を検証および認証する方法については、「API認証」を参照してください。
-
または
/ne/v1/devices/{uuid}エンドポイントを使用してNetwork Edgeデバイス情報を取得します。/ne/v1/devices冗長デバイスから接続する場合は、プライマリデバイスまたはセカンダリデバイスのUUIDが必要です。クラスタデバイスから接続する場合は、またはのUUIDが必要です。node0``node1サービストークンごとに接続できる接続は1つのみです。冗長デバイスまたはクラスタデバイスへの追加接続には、追加のサービストークンが必要です。 -
サービストークンを取得します。
-
サードパーティがインフラストラクチャまたはサービスに接続できるようにサービストークンを共有している場合は、共有したサービストークンのUUIDが必要です。
-
自分または組織内の他のユーザーが作成したサービストークンを使用して自身のアセットに接続する場合は、許可された接続設定とともに、エンドポイントからサービストークンのUUIDを取得できます。
/fabric/v4/serviceTokens
-
接続の作成
- Portal
- API
_[接続の作成先:]_ページで、
-
_「サービストークンを使用して接続」_カードで「サービストークンを入力」をクリックします。

-
Zサイドサービストークンを入力します。_サービストークンの詳細が_正しいことを確認し、「サービストークンを引き換える」をクリックします。

-
[次へ]をクリックします。
-
_[接続元アセットタイプ]_ドロップダウンから、[仮想デバイス]を選択します。
-
_[接続元]_セクションで、[仮想デバイス]をクリックします。
-
場所と仮想デバイスタイプを選択します。
- 単一のデバイスから接続する場合は、単一接続オプションが選択されます。
- 冗長デバイスまたはクラスタデバイスから接続する場合は、冗長接続を作成するオプションがあります。_冗長接続先_フィールドに2番目の接続のサービストークンを入力します。
-
仮想デバイスを選択し、[次へ]をクリックします。

-
_[接続情報]_ページで:
-
接続名を入力します。冗長接続の場合は、_プライマリ接続の_名前を[_プライマリ接続情報]_フィールドに入力し、セカンダリ接続の名前を[_セカンダリ接続情報]_フィールドに入力します。
-
_[インターフェースの選択]_セクションで、デバイスで次に使用可能なインターフェースを自動的に選択するか、インターフェースを選択するかを選択します。
-
(任意) PO (発注)番号を入力します。
-
_接続スピードを_選択してください。接続速度のオプションは、サービストークンによって事前定義されています。冗長接続を発注する場合は、_プライマリ接続スピード_と_セカンダリ接続_スピードの両方を選択してください。
-
[次へ]をクリックします。

-
-
[レビュー]ページで、プレビュー、接続の概要、および価格の概要で情報を確認します。[通知]セクションで、この接続に関する通知を受信するすべてのユーザーのメールアドレスを追加します。

-
[オーダーを送信]をクリックします。
サービストークンを使用して、仮想デバイスとFabric上の別のネットワーク拠点間の接続を作成するには、エンドポイントにリクエストを/fabric/v4/connections送信します。POST
オブジェクトでNetwork Edgeデバイスを定義する。aSide以下を含みます。
accessPoint.typeasVDvirtualDevice.typeASEDGEvirtualDevice.uuidデバイスのUUIDとして
オブジェクトにサービストークンUUIDを入力します。zSideサービストークンは、接続を確立するために必要なその他すべての情報を提供します。
サンプル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": "<connection_name>",
"bandwidth": <connection_speed>,
"aSide": {
"accessPoint": {
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "<virtual_device_uuid>"
},
}
},
"zSide": {
"serviceToken": {
"uuid": "<service_token_uuid>"
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"<contact_email>",
"<contact_email>"
]
}
]
}'
接続状況の監視
- Portal
- API
接続インベントリで新しい接続のステータスを監視できます。
APIエンドポイントを使用して/fabric/v4/connections/{connectionId}接続ステータスを監視します。