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

A側サービストークンを作成し、エクイニクスFabricポートの使用を許可することで、ユーザーや顧客がクラウドプロバイダーやネットワークプロバイダー、その他のエクイニクスFabric接続先に接続できるようになります。Aサイドポートの所有者であるお客様は、Aサイドトークンを利用するユーザーや顧客によってプロビジョニングされた仮想接続に対して課金されます。
プロバイダ、再販業者、通信事業者、サービスプロバイダからA-sideサービス・トークンを共有されている場合は、Redeeming an A-side Service-tokenを参照してください。
サービス・トークンを作成するには、以下のものが必要です:
- エクイニクスのFabricアカウントで、次の役割 のいずれかを持っていること:ファブリックマネージャー」、「ファブリック接続マネージャー」、「ファブリックサービスプロバイダー」、「ファブリックサービスプロファイルマネージャー」、または「エンドカスタマーファブリックマネージャー」。
- サービス・トークンを作成するポートへのアクセス許可。
- APIを使用する場合は、クライアントIDとクライアントシークレットをアクセストークンと交換して認証します。詳細はAPI認証を参照してください。
Aサイド・トークン・オプション
接続設定 :
-
VLAN - ポートのタイプに応じて、接続に必要なカプセル化とVLAN情報を提供する必要があります。Dot1q ポートを使用している場合は、VLAN ID を指定します。QinQ ポートを使用している場合は、VLAN S タグと C タグを指定します。
-
最大帯域幅 - 接続の最大帯域幅を指定します。ユーザーまたは顧客は、帯域幅の上限まで接続速度を設定できます。
-
Allow Remote Connections - ポートへのリモート接続を許可するかどうかを指定します。リモート接続を許可すると、ユーザーまたは顧客は、ポートとは異なるメトロで終端する接続を作成できます。リモート接続を許可しない場合、接続先はポート と同じメトロに限定されます。
サービス・トークンの設定 :
-
有効期限 - サービス・トークンに有効期限を設定する必要があります。顧客またはユーザーは、有効期限内にトークンを使用して接続を作成する必要があります。トークンの有効期限が切れると、接続に使用できなくなるため、新しいトークンを作成する必要があります。
-
サービス・トークンの受信者 - サービス・トークンを最大12人の受信者に電子メールで送信します。トークンは1回限り使用でき、受信者のうち1人だけがトークンを使用できます。
サービス・トークンの作成
- Portal
- API
A側サービス・トークンを作成する:
-
カスタマーポータル > _Fabric Dashboard_にサインインします。
-
Service Tokens_ メニューから、Create Service Token を選択します。

サービス・トークン・タイプ
-
Service Token Type_セクションで、A-side Service Token を選択します。
-
A-side Asset_セクションで、_Port_が自動的に選択されます。

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

次へ をクリックしてください。
接続設定
接続設定
-
ポートのVLAN情報を入力します。
-
ポートからの接続の最大帯域幅を選択します。
-
リモート接続を許可するには、Allow Remote Connections チェックボックスをオンにします。

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

-
このサービス・トークンを受け取るユーザーのメールアドレスを入力してください。このトークンはどの受信者も1回しか使用できません。

次へ をクリックしてください。
レビュー
Service Token Type_、Connection Settings、_Service Token Settings_の各セクションでサービス・トークン情報を確認します。情報を変更する必要がある場合は、[戻る] をクリックします。
:::info重要 A側サービス・トークンを作成し、それをユーザーまたは顧客と共有すると、ユーザーはサービス・トークンで定義されたポートから接続を作成する完全な許可を得られます。A側トークンの作成者であり、ポートの所有者であるお客様は、ユーザーまたは顧客によって行われた接続に対して課金されます。 :::
サービス・トークンの情報が正しければ、Create Service Token をクリックします。

A サイドのサービス トークンを作成するには、/fabric/v4/serviceTokens エンドポイントに POST リクエストを送信します。リクエストの本文に、サービス トークンの設定、接続設定、およびポートの詳細をプロバイダとして指定します。
サービス・トークンの設定
expirationDateTime- Specify the expiration date for your service token in ISO 8601 datetime format. The expiration must be within the next 90 days.notifications- Specify up to 12 recipients of the service token in thenotificationsobject. Setnotifications.typeasNOTIFICATIONand enter the emails innotifications.emails.
接続設定
allowRemoteConnection- SettingallowRemoteConnectiontotrueallows your user or customer to create connections from your port to destinations in different Metros. Setting tofalselimits connections to destinations in the same Metro as the port.bandwidthLimit- Use thebandwidthLimitparameter to set the maximum bandwidth for a connection created using this service token.
ポート選択
- aSide.accessPointSelectors
オブジェクトにアクセスを許可するポートを指定します。accessPointSelectors.typeに Coloを設定します。port.uuidにポートを指定します。 - ポートのカプセル化と VLAN の詳細を指定するには、
linkProtocolオブジェクトを使用します。
サンプル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>"
]
}
]
}'
fabric/v4/serviceTokensエンドポイントは、テスト用に[dryRun`クエリパラメータ](../../equinix-api/testing/testing-in-production-dry-run.md)をサポートしています。
サービス・トークンのステータス
サービス・トークンを作成すると、そのステータスを確認することができます。ステータスが Inactive の場合、そのサービストークンはまだ利用されていません。ステータスがActiveの場合、そのサービストークンは既に利用されています。
ステータスがExpiredの場合、サービストークンはユーザーまたは顧客によって引き換えられることなく有効期限に達しています。
- Portal
- API
サービストークンのステータスを確認するには、エクイニクススタマーポータル にサインインし、[Service Token Inventory] (service-token-inventory.md) にアクセスしてください。

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