Aサイドサービストークンの作成
サービストークンとは、相互接続アセットへの権限を付与する一意のEquinix Fabricキーです。
Aサイドサービストークンを使用すると、ユーザーまたは顧客はFabricポートからFabric上の他の接続先への接続を作成できます。これにより、AサイドのFabricポートを集約的に使用できるようになり、プロバイダやリセラーが接続ごとの固有の要件を理解したり、認識したりする必要がなくなります。

Aサイドサービストークンを作成して、Equinix Fabricポートの使用を許可し、ユーザーや顧客がクラウドプロバイダ、ネットワークプロバイダ、またはその他のEquinix Fabric接続先に接続できるようにします。Aサイドポートの所有者として、Aサイドトークンを引き換えたユーザーまたは顧客がプロビジョニングした仮想接続に対して請求されます。
Aサイドサービストークンがプロバイダ、リセラー、キャリア、またはサービスプロバイダによって共有されている場合は、「Aサイドトークンの引き換え」を参照してください。
サービス・トークンを作成するには、以下のものが必要です:
- 次のいずれかの役割を持つEquinix Fabricアカウント:
Fabric Manager、Fabric Connection Manager、Fabric Service Provider、、Fabric Service Profile Managerまたはのいずれかです。End Customer Fabric Manager - サービス・トークンを作成するポートへのアクセス許可。
- APIを使用している場合は、アクセストークンのクライアントIDとクライアントシークレットを交換して認証します。詳細については、API認証を参照してください。
Aサイド・トークン・オプション
接続設定:
-
VLAN -ポートのタイプに応じて、接続に必要なカプセル化情報とVLAN情報を提供する必要があります。Dot1Qポートを使用している場合は、VLAN IDを入力してください。QinQポートを使用している場合は、VLANのS-TagとC-Tagを入力してください。
-
最大帯域幅-接続の最大帯域幅を指定します。ユーザーまたは顧客は、帯域幅制限まで接続速度を設定できます。
-
リモート接続を許可-ポートへのリモート接続を許可するかどうかを指定します。リモート接続を許可すると、ユーザーまたは顧客はポートとは異なる都市圏で終端する接続を作成できます。リモート接続を許可しないと、ポートと同じ都市圏の接続先のみに接続が制限されます。
サービストークン設定:
-
有効期限-サービストークンの有効期限を設定する必要があります。お客様またはユーザーは、有効期限が切れる前にトークンを使用して接続を作成する必要があります。トークンの有効期限が切れると、接続の作成に使用できなくなり、新しいトークンを作成する必要があります。
-
サービストークンの受信者-サービストークンを最大12人の受信者にメールで送信します。トークンはシングルユースであり、受信者の1人のみがトークンを使用できます。
サービス・トークンの作成
- Portal
- API
Aサイドサービストークンを作成する:
-
[カスタマーポータル]>[_ファブリックダッシュボード]_にサインインします。
-
_[サービストークン]_メニューから[サービストークンの作成]を選択します。

サービストークンタイプ
-
_[サービストークンタイプ]_セクションで、[Aサイドサービストークン]を選択します。
-
_Aサイドアセット_セクションでは、_ポートが_自動的に選択されます。

-
[+ポートを選択]をクリックし、現在のプロジェクトの対象ポートのリストからポートを選択します。[ポートを選択]をクリックします。

[次へ]をクリックします。
接続設定
_[接続設定]_で、
-
ポートのVLAN情報を入力します。
-
ポートからの接続の最大帯域幅を選択します。
-
リモート接続を許可するには、[_リモート接続を許可する]_チェックBOXをオンにします。

サービストークン設定
_サービストークン設定_で:
-
サービストークンの有効期限を入力または選択します。最大有効期限は90日です。

-
このサービストークンを受け取るユーザーのメールアドレスを入力してください。このトークンは受信者のうちいずれか 1 名のみが 1 回使用できます。

[次へ]をクリックします。
レビュー
「サービストークンタイプ」、「接続設定」、「 _サービストークン設定」の_各セクションでサービストークン情報を確認してください。情報を変更する必要がある場合は、[戻る]をクリックしてください。
:::info重要 Aサイドのサービス・トークンを作成し、ユーザーまたは顧客と共有すると、ユーザーはサービス・トークンで定義されたポートから接続を作成する完全な許可を得られます。Aサイドトークンの作成者であり、ポートの所有者であるお客様は、ユーザーまたは顧客が行った接続に対して請求されます。 :::
サービストークン情報が正しければ、[サービストークンを作成]をクリックします。

Aサイドサービストークンを作成するには、エンドポイントにリクエストを/fabric/v4/serviceTokens送信します。POSTサービストークン設定、接続設定、ポートの詳細をリクエストの本文に入力します。
サービストークン設定
expirationDateTime-サービストークンの有効期限をISO 8601 datetime形式で指定します。有効期限は今後90日以内に設定する必要があります。notifications-オブジェクト内のサービストークンの受信者を最大12人指定します。notificationsにをNOTIFICATION設定notifications.typeし、にメールを入力します。notifications.emails
接続設定
allowRemoteConnection-をにtrue設定すると、allowRemoteConnectionユーザーまたは顧客はポートから異なる都市圏の接続先への接続を作成できます。をに設定すると、falseポートと同じ都市圏の宛先への接続が制限されます。bandwidthLimit-このサービストークンを使用して作成された接続の最大帯域幅を設定するには、パラメータを使用します。bandwidthLimit
ポートの選択
- オブジェクトでアクセスを許可するポートを指定します。
aSide.accessPointSelectorsに設定します。accessPointSelectors.type``COLOでポートを指定します。port.uuid - オブジェクトを使用して、
linkProtocolポートのカプセル化とVLANの詳細を指定します。
サンプルcURLリクエスト:
curl -X POST 'https://api.equinix.com/fabric/v4/serviceTokens'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer <token>'
-d '{
"type": "VC_TOKEN",
"expirationDateTime": "<token_expiration_date>",
"connection": {
"type": "EVPL_VC",
"allowRemoteConnection": <boolean>,
"bandwidthLimit": <bandwidth_value>,
"aSide": {
"accessPointSelectors": [
{
"type": "COLO",
"port": {
"uuid": "<port_uuid>"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": <vlan_id>
}
}
]
}
},
"notifications": [
{
"type": "NOTIFICATION",
"emails": [
"<token_recipient_email>",
"<token_recipient_email>"
]
}
]
}'
サービス・トークンのステータス
サービストークンを作成したら、ユーザーや顧客が引き換えたかどうかなど、そのステータスを確認できます。ステータスがの場合、Inactiveサービストークンはまだ引き換えられていません。ステータスがの場合、Activeサービストークンは引き換えられました。
ステータスがの場合、Expiredサービストークンはユーザーまたは顧客が引き換えることなく、有効期限に達しています。
- Portal
- API
サービストークンのステータスを確認するには、カスタマーポータルにサインインし、サービストークンインベントリに移動します

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