サイドサービストークンの作成
Zサイドサービストークンは、Equinix Fabric上の別の顧客があなたとの接続を確立できるようにする一意のキーです。
次のアセットタイプのZサイドトークンを作成できます。
- ファブリックポート(EVPL、EPLタイプの両方)
- Network Edge仮想デバイス
- マルチポイントネットワーク- LAN、E-Tree、E-Access。
Zサイドのサービストークンが作成され、別の顧客と共有されると、そのトークンを引き換えて、接続先として事前に定義されたアセットとの接続を作成できます。

Zサイドトークンを引き換えるお客様(元のAサイドアセットの所有者)は、仮想接続を作成すると、その仮想接続に対して請求されます。Zサイドサービストークンを使用すると、異なるプロジェクトにアセットを持つ自社組織内の別のユーザーが、プロジェクト内のアセットに接続できるようにすることもできます。
Zサイドサービストークンの引き換えについて詳しくは、「Zサイドサービストークンの引き換え」を参照してください。
前提条件
サービス・トークンを作成する前に、以下のものが必要です:
- カスタマーポータルアカウント。
- 既存のポート、仮想デバイス、またはマルチポイントネットワーク。
- サービストークンを作成したいアセットへのアクセス権限。
- Portal
- API
-
カスタマーポータルにサインインし、_Fabricダッシュボード_に移動します。
-
_[サービストークン]_メニューから[サービストークンの作成]を選択します。

-
_[サービストークンタイプ]_セクションで、[Zサイドサービストークン]を選択します。

Zサイドトークンを作成するアセットタイプを選択します。ポート、仮想デバイス、またはマルチポイントネットワーク。
-
認証 - OAuth2用のユーザー認証情報、クライアントID、クライアントシークレットを送信します。 認証。OAuth APIを呼び出して認証情報を検証および認証する方法については、「API認証」を参照してください。
-
Zサイドのアセット情報を決定します。
-
ポートを使用している場合は、エンドポイントにリクエストを
/fabric/v4/ports送信してください。GETポートUUID、ポートタイプ、リンクプロトコルタイプ(Dot1QまたはQinQ)が必要です。 -
仮想デバイスを使用している場合は、エンドポイントにリクエストを
/ne/v1/devices送信します。GETデバイスのUUIDが必要です。デバイスの詳細を取得するためのリクエストを/ne/v1/devices/{device_id}エンドポイントに送信します。GET接続には、デバイスで使用可能なインターフェースを選択できます。指定しない場合、接続は次に使用可能なインターフェースに自動的に割り当てられます。 -
マルチポイントネットワークを使用している場合は、エンドポイントにリクエストを
/fabric/v4/networks/{networkId}送信してください。GETネットワークのタイプとUUIDが必要です。
-
ポートのサービストークンを作成
- Portal
- API
-
_[Zサイドアセット]_ドロップダウンで、[ポート]を選択します。
-
[+ポートを選択]をクリックし、リストからサービストークンの特定のポートを選択します。[ポートを選択]をクリックします。

-
[次へ]をクリックします。
-
_[接続設定]_で、
- Zサイドアセットの接続のVLAN IDを入力します。
- トークンユーザーが利用できるようにする帯域を選択します。_[別の帯域を追加]を_クリックして、カスタム帯域幅オプションを作成します。
- リモート接続を許可するかどうかを選択します。トークンユーザーがZサイドアセットの拠点とは異なる都市圏から接続できるようにするには、「_リモート接続を許可する」を_チェックしますBOX。

-
_サービストークン設定_で:
- サービストークンの有効期限を入力します。トークンはこの日付までに引き換える必要があります。そうでない場合、有効期限が切れます。最大の日付範囲は90日です。
- サービストークンの使用を許可されているユーザーのメールアドレスを入力します。最大12人の受信者を入力できます。トークンは、受信者のいずれかが1回のみ使用できます。

-
[次へ]をクリックします。
-
[レビュー]ページで、[_サービストークンタイプ]_パネルと[_サービストークン設定]_パネルの情報を確認します。

準備ができたら、[サービストークンを作成]をクリックします。
ポートのZサイドサービストークンを作成するには、エンドポイントにリクエストを/fabric/v4/serviceTokens送信します。POST接続設定、ポートの詳細、サービストークンの設定をリクエストの本文に入力します。
-
オブジェクトで、
connection以下を指定します。- 基盤となるポートに基づく接続タイプ:
EVPL_VCまたは。EPL_VC - このトークンを使用してリモート接続を作成できるかどうか。
- 接続に許可されている帯域幅。
- このトークンで、接続にカスタム帯域幅を使用できるかどうかを指定します。
- 基盤となるポートに基づく接続タイプ:
-
オブジェクトで、
zSide以下を指定します。typeAS。COLO- ポートのUUID。
- ポートのリンクプロトコルタイプと適切なVLAN情報。
-
フィールドを使用して、
expirationDateTimeトークンの有効期限が切れる日時をISO 8601形式で指定します。 -
オブジェクトで、
notificationsトークン受信者のメールアドレスを指定します。
cURLリクエストのサンプル:
curl -X POST 'https://api.equinix.com/fabric/v4/serviceTokens'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer <token>'
-d '{
"type": "VC_TOKEN",
"name": "<service_token_name>",
"description": "<service_token_description>",
"connection": {
"type": "EVPL_VC",
"allowRemoteConnection": <boolean>,
"allowCustomBandwidth": <boolean>,
"supportedBandwidths": [
<bandwidth_speed>,
<bandwidth_speed>,
<bandwidth_speed>
],
"zSide": {
"accessPointSelectors": [
{
"type": "COLO",
"port": {
"uuid": "<port_uuid>"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": "<vlan_ID>"
}
}
]
}
},
"expirationDateTime": "<expiration_date>",
"notifications": [
{
"type": "NOTIFICATION",
"emails": [
"<email_address>"
]
}
]
}'
仮想デバイスのサービストークンを作成
- Portal
- API
-
_[Zサイドアセット]_ドロップダウンで、[仮想デバイス]を選択します。
-
仮想デバイスの種類を選択してください:
- シングルデバイス - シングルインスタンスの仮想デバイス。
- 冗長デバイス-冗長仮想デバイスのペア。重要:冗長デバイスへの冗長接続を作成するには、冗長ペアのデバイスごとに個別のサービストークンを作成する必要があります。
- クラスタ - クラスタ化された仮想デバイス。
-
[+仮想デバイスを選択]をクリックし、リストから仮想デバイスインスタンスを選択します。[仮想デバイスを選択]をクリックします。

-
[次へ]をクリックします。
-
_[接続設定]_で、
- 接続に使用するインターフェイスを設定します。次に使用可能なインターフェースを使用するか、特定のインターフェースを選択するかを選択します。
- トークンユーザーが利用できるようにする帯域を選択します。_[別の帯域を追加]を_クリックして、カスタム帯域幅オプションを作成します。
- リモート接続を許可するかどうかを選択します。トークンユーザーがZサイドアセットの拠点とは異なる都市圏から接続できるようにするには、「_リモート接続を許可する」を_チェックしますBOX。

-
_サービストークン設定_で:
- サービストークンの有効期限を入力します。トークンはこの日付までに引き換える必要があります。そうでない場合、有効期限が切れます。最大の日付範囲は90日です。
- サービストークンの使用を許可されているユーザーのメールアドレスを入力します。最大12人の受信者を入力できます。トークンは、受信者のいずれかが1回のみ使用できます。

-
[次へ]をクリックします。
-
[レビュー]ページで、[_サービストークンタイプ]_パネルと[_サービストークン設定]_パネルの情報を確認します。

準備ができたら、[サービストークンを作成]をクリックします。
仮想デバイスのZサイドサービストークンを作成するには、エンドポイントにリクエストを/fabric/v4/serviceTokens送信します。POSTリクエストの本文に、接続設定、仮想デバイスの詳細、サービストークンの設定を入力します。
-
オブジェクトで、
connection以下を指定します。- このトークンを使用してリモート接続を作成できるかどうか。
- 接続に許可されている帯域幅。
- このトークンで、接続にカスタム帯域幅を使用できるかどうかを指定します。
-
オブジェクトで、
zSide以下を指定します。typeAS。VD- 仮想デバイスのUUID。
- サービストークンの接続に使用するインターフェース。オブジェクトが省略された場合、
interfaceデバイス上で次に使用可能なインターフェースが接続に使用されます。
-
フィールドを使用して、
expirationDateTimeトークンの有効期限が切れる日時をISO 8601形式で指定します。 -
オブジェクトで、
notificationsトークン受信者のメールアドレスを指定します。
cURLリクエストのサンプル:
curl -X POST 'https://api.equinix.com/fabric/v4/serviceTokens'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer <token>'
-d '{
"type": "VC_TOKEN",
"name": "<service_token_name>",
"description": "<service_token_description>",
"connection": {
"type": "EVPL_VC",
"allowRemoteConnection": <boolean>,
"allowCustomBandwidth": <boolean>,
"supportedBandwidths": [
<bandwidth_speed>,
<bandwidth_speed>,
<bandwidth_speed>
],
"zSide": {
"accessPointSelectors": [
{
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "<virtual_device_uuid>"
},
"interface": {
"type": "NETWORK",
"id": <interface_id>
}
}
]
}
},
"expirationDateTime": "<expiration_date>",
"notifications": [
{
"type": "NOTIFICATION",
"emails": [
"<email_address>"
]
}
]
}'
マルチポイントネットワークのサービストークンを作成
- Portal
- API
-
_[Zサイドアセット]_ドロップダウンで、[マルチポイントネットワーク]を選択します。
-
[+ネットワークを選択]をクリックし、リストからマルチポイントネットワークを選択します。[ネットワークを選択]をクリックします。

-
[次へ]をクリックします。
-
_[接続設定]_で、
- E-Treeサービストークンから作成された接続は、デフォルトでリーフになります。ネットワークの所有者として、サービストークンが引き換えられ、接続がプロビジョニングされたら、接続の役割をルートに編集できます。
- トークンユーザーが利用できるようにする帯域を選択します。_[別の帯域を追加]を_クリックして、カスタム帯域幅オプションを作成します。

-
_サービストークン設定_で:
- サービストークンの有効期限を入力します。トークンはこの日付までに引き換える必要があります。そうでない場合、有効期限が切れます。最大の日付範囲は90日です。
- サービストークンの使用を許可されているユーザーのメールアドレスを入力します。最大12人の受信者を入力できます。トークンは、受信者のいずれかが1回のみ使用できます。

-
[次へ]をクリックします。
-
[レビュー]ページで、[_サービストークンタイプ]_パネルと[_サービストークン設定]_パネルの情報を確認します。

準備ができたら、[サービストークンを作成]をクリックします。
マルチポイントネットワーク用のZサイドサービストークンを作成するには、エンドポイントにリクエストを/fabric/v4/serviceTokens送信します。POST接続設定、ネットワークの詳細、サービストークンの設定をリクエストの本文に入力します。
-
オブジェクトで、
connection以下を指定します。EPLAN_VC``EVPTREE_VCネットワーク構成に応じて、接続タイプは、EVPLAN_VC、、またはです。EPTREE_VC- このトークンを使用してリモート接続を作成できるかどうか。
- 接続に許可されている帯域幅。
- このトークンで、接続にカスタム帯域幅を使用できるかどうかを指定します。
-
オブジェクト内
zSide:- としてを指定します。
type``NETWORK - ネットワークタイプを
EVPLAN、、EPLANEVPTREE、、またはで指定します。EPTREE - ネットワークのUUIDを入力してください。
- としてを指定します。
-
フィールドを使用して、
expirationDateTimeトークンの有効期限が切れる日時をISO 8601形式で指定します。 -
オブジェクトで、
notificationsトークン受信者のメールアドレスを指定します。
cURLリクエストのサンプル:
curl -X POST 'https://api.equinix.com/fabric/v4/serviceTokens'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer <token>'
-d '{
"type": "VC_TOKEN",
"name": "<service_token_name>",
"description": "<service_token_description>",
"connection": {
"type": "EVPLAN_VC",
"allowRemoteConnection": <boolean>,
"supportedBandwidths": [
<bandwidth_speed>,
<bandwidth_speed>,
<bandwidth_speed>
],
"zSide": {
"accessPointSelectors": [
{
"type": "NETWORK",
"network": {
"type": "EVPLAN",
"uuid": "<network_uuid>"
}
}
]
}
},
"expirationDateTime": "<token_expiration_date>",
"notifications": [
{
"type": "NOTIFICATION",
"emails": [
"<email_address>"
]
}
]
}'
サービス・トークンのステータス
サービストークンを作成したら、他のお客様が引き換えたかどうかなど、そのステータスを確認できます。ステータスがの場合、Inactiveサービストークンはまだ引き換えられていません。ステータスがの場合、Activeサービストークンは引き換えられました。
Zサイドトークンを使用した接続の作成者は、接続に対して請求されます。
ステータスがの場合、Expiredサービストークンは引き換えられずに有効期限に達しています。
- Portal
- API
サービストークンのステータスを確認するには、カスタマーポータルにサインインし、サービストークンインベントリに移動します

サービストークンのステータスを確認するには、エンドポイントにリクエストを/fabric/v4/serviceTokens送信します。GET応答には、サービストークンのリストとフィールドのステータスが含まれます。state
サンプルcURLリクエスト:
curl -X GET 'https://api.equinix.com/fabric/v4/serviceTokens'
-H 'Authorization: Bearer <token>'
サービストークンの管理の詳細については、サービストークンインベントリページを参照してください。