# サービストークンを使ったFabricへの接続 Zサイドサービストークンを引き換えて、Network EdgeデバイスからFabric上の接続先への接続を確立します。リセラー、通信キャリア、サービスプロバイダ、または他のEquinix Fabricのお客様からZサイドサービストークンを提供されるため、インフラストラクチャやサービスに合わせて作成できます。 接続を作成するときに、仮想デバイスとその接続設定を選択すると、サービストークンが接続の反対側の接続の詳細と構成を提供します。各接続には独自のサービストークンが必要です。冗長仮想デバイスまたはクラスタ仮想デバイスから、2つの個別のサービストークンを使用して接続のペアを作成できます。 > **メモ** > > Network Edge仮想デバイスへの接続の作成を許可する場合は、[Zサイドのサービストークンを作成して共有できます。](https://docs.equinix.com/ja/fabric/service-tokens/create-z-side-token.md) ## 前提条件[​](#前提条件 "への直接リンク前提条件") * Portal * API 1. [Equinix Customer Portal](https://portal.equinix.com/)にサインインし、Network Edgeダッシュボードに移動します。 2. **[接続の作成]を**クリックします。 ![](https://docs.equinix.com/ja/assets/images/service-provider-create-connection-49f02d48309fc652e6b31fbd69a326fd.png) 1. 認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。 認証。OAuth APIを呼び出して認証情報を検証および認証する方法については、「[API認証」を](https://docs.equinix.com/ja/equinix-api/api-authentication.md)参照してください。 2. または[`/ne/v1/devices/{uuid}`](https://docs.equinix.com/ja/api-catalog/network-edgev1/virtual-device/getvirtualdevices)エンドポイントを使用してNetwork Edgeデバイス情報を取得します。[`/ne/v1/devices`](https://docs.equinix.com/ja/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid)冗長デバイスから接続する場合は、プライマリデバイスまたはセカンダリデバイスのUUIDが必要です。クラスタデバイスから接続する場合は、またはのUUIDが必要です。`node0``node1`サービストークンごとに接続できる接続は1つのみです。冗長デバイスまたはクラスタデバイスへの追加接続には、追加のサービストークンが必要です。 3. サービストークンを取得します。 * サードパーティがインフラストラクチャまたはサービスに接続できるようにサービストークンを共有している場合は、共有したサービストークンのUUIDが必要です。 * 自分または組織内の他のユーザーが作成したサービストークンを使用して自身のアセットに接続する場合は、許可された接続設定とともに、エンドポイントからサービストークンのUUIDを取得できます。[`/fabric/v4/serviceTokens`](https://docs.equinix.com/ja/api-catalog/fabricv4/service-tokens/getservicetokens.md) ## 接続の作成[​](#接続の作成 "への直接リンク接続の作成") * Portal * API \_\[接続の作成先:]\_ページで、 1. \_「サービストークンを使用して接続」\_カードで「**サービストークンを入力」を**クリックします。 ![](https://docs.equinix.com/ja/assets/images/service-token-connections-menu-96ae3f5091bbcf89410c63c92be6c66a.png) 2. Zサイドサービストークンを入力します。\_サービストークンの詳細が\_正しいことを確認し、「**サービストークンを引き換える」を**クリックします。 ![](https://docs.equinix.com/ja/assets/images/service-token-redeem-344e66b23c8acb912cc900be97ceb66a.png) 1. **[次へ]を**クリックします。 2. \_\[接続元アセットタイプ]\_ドロップダウンから、\[**仮想デバイス]を**選択します。 3. \_\[接続元]\_セクションで、\[**仮想デバイス]を**クリックします。 4. 場所と仮想デバイスタイプを選択します。 * 単一のデバイスから接続する場合は、単一接続オプションが選択されます。 * 冗長デバイスまたはクラスタデバイスから接続する場合は、冗長接続を作成するオプションがあります。\_冗長接続先\_フィールドに2番目の接続のサービストークンを入力します。 5. 仮想デバイスを選択し、\[**次へ]を**クリックします。 ![](https://docs.equinix.com/ja/assets/images/service-token-virtual-device-fe4db02711276df460318a5122625160.png) 6. \_[接続情報]\_ページで: * 接続名を入力します。冗長接続の場合は、\_プライマリ接続の\_名前を\[\_プライマリ接続情報]\_フィールドに入力し、セカンダリ接続の名前を\[\_セカンダリ接続情報]\_フィールドに入力します。 * \_[インターフェースの選択]\_セクションで、**デバイスで次に使用可能なインターフェースを自動的に選択する**か、**インターフェースを選択する**かを選択します。 * *(任意)* PO (発注)番号を入力します。 * \_接続スピードを\_選択してください。接続速度のオプションは、サービストークンによって事前定義されています。冗長接続を発注する場合は、\_プライマリ接続スピード\_と\_セカンダリ接続\_スピードの両方を選択してください。 * **[次へ]を**クリックします。 ![](https://docs.equinix.com/ja/assets/images/service-token-connection-info-8c09f23678501108dafe7a21853c4e1e.png) 7. *\[レビュー*]ページで、プレビュー、接続の概要、および価格の概要で情報を確認します。*[通知*]セクションで、この接続に関する通知を受信するすべてのユーザーのメールアドレスを追加します。 ![](https://docs.equinix.com/ja/assets/images/service-token-review-41a501edf2fa8a66a48c64e247a04899.png) 8. **[オーダーを送信]を**クリックします。 サービストークンを使用して、仮想デバイスとFabric上の別のネットワーク拠点間の接続を作成するには、エンドポイントにリクエストを[`/fabric/v4/connections`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/createconnection.md)送信します。`POST` オブジェクトでNetwork Edgeデバイスを定義する。`aSide`以下を含みます。 * `accessPoint.type` as `VD` * `virtualDevice.type`AS`EDGE` * `virtualDevice.uuid` デバイスのUUIDとして オブジェクトにサービストークンUUIDを入力します。`zSide`サービストークンは、接続を確立するために必要なその他すべての情報を提供します。 サンプルcURLリクエスト: ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "type": "EVPL_VC", "name": "", "bandwidth": , "aSide": { "accessPoint": { "type": "VD", "virtualDevice": { "type": "EDGE", "uuid": "" }, } }, "zSide": { "serviceToken": { "uuid": "" } }, "notifications": [ { "type": "ALL", "emails": [ "", "" ] } ] }' ``` ## 接続状況の監視[​](#接続状況の監視 "への直接リンク接続状況の監視") * Portal * API [*接続インベントリ*](https://docs.equinix.com/ja/fabric/managing-connections/fabric-new-connections-inventory.md)で新しい接続のステータスを監視できます。 APIエンドポイントを使用して[`/fabric/v4/connections/{connectionId}`](https://docs.equinix.com/ja/api-catalog/fabricv4/connections/getconnectionbyuuid.md)接続ステータスを監視します。