アセットの管理
アセットからデータ、メトリクス、およびイベントを表示またはストリーミングするには、まずアセットをストリームにアタッチする必要がある。 サポートされているアセット:
- ポート-ストリーム帯域幅の使用状況、エラーおよびドロップされたパケットメトリック、アップ/ダウンイベント、ライフサイクルイベント。
- 接続-ストリーム帯域幅の使用状況、ドロップされたパケットメトリック、アップ/ダウンイベント、ライフサイクルイベント。
- Fabric Cloud Routers-ストリームBGP状態イベント、ルートクォータ使用イベント、およびライフサイクルイベント。
- ネットワークエッジ仮想デバイス-アクセスコントロールリスト、デバイス属性、再起動、およびデバイスリンクグループイベントをストリームする。
- メトロ-ストリームメトロ遅延メトリック。
- プロジェクト-プロジェクト内のアセットの状態変更イベントやライフサイクルイベントなど、プロジェクトのすべてのイベントを表示するには、プロジェクトをストリームに添付する。プロジェクトの詳細については、『プロジェクトの管理』を参照。
- 組織-プロジェクトのライフサイクルイベント、IDおよびアクセス管理イベント(ロール割り当てなど)を含む組織イベントを表示するには、組織をストリームに添付する。組織の詳細については、『組織の管理』を参照。
- Company Profiles-ストリームプロファイル属性、タグ、およびライフサイクルイベント。
プロビジョニング
-
アセット(ポート、接続など)をストリームに添付するには、ユーザーは少なくともそのアセットのロールを持っている必要がある。
Viewer -
ライフサイクルプロビジョニングイベントのストリームにプロジェクトを添付するには、ユーザーがロールを持っている必要がある。
Project Admin -
ロール割り当て、ユーザーログイン、およびリソース管理イベントのために組織をストリームに添付するには、ユーザーがロールを持っている必要がある。
Org Adminロール割り当てのために組織をストリームに添付するには、ユーザーがロールを持っている必要がある。Org Admin -
APIを使用している場合は、OAuth2認証のためにユーザー資格情報、クライアントID、およびクライアントシークレットを送信する。Equinix APIへのリクエストを認証する方法については、API認証を参照。
Portalでアセットを添付する
-
[カスタマーポータル]>[Fabricダッシュボード]にログインします。
-
[Observability]メニューから[*Data Streams]を選択する。

-
リソースを追加する_ストリーム名_をクリックする。
-
[Actions]ドロップダウンメニューから[*Add Resources]を選択する。

-
_File Directory_メニューを使用して'使用可能なリソースタイプをフィルタする
-
ストリームに追加する特定のリソースを選択する。追加されたリソースはイベントデータを送信し、メトリクスも送信したい場合はtoggle_Enable Metrics_。目的のリソースを選択したら、[*Review]をクリックする。

-
ストリームに添付するアセットのリストを確認する。

-
「送信」をクリックします。
APIでアセットを添付する
ストリームにポートを接続するには、エンドポイントにリクエストを/fabric/v4/streams/{streamId}/{asset}/{assetId}送信する。PUT
サポートされているアセットのストリームにアセットを添付するには、以下の例を参照する。
ポート
cURLリクエストの例:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/ports/<portId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"metricsEnabled": true
}'
応答の例:
{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/ports/dee885d7-a845-4873-8774-f83012e7a",
"uuid": "dee885d7-a845-4873-8774-f83012e7a",
"type": "XF_PORT",
"metricsEnabled": true,
"attachmentStatus": "ATTACHING"
}
接続
cURLリクエストの例:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/connections/<connectionId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"metricsEnabled": true
}'
応答の例:
{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/connections/dee885d7-a845-4873-8774-f83012e7a",
"uuid": "dee885d7-a845-4873-8774-f83012e7a",
"type": "IP_VC",
"metricsEnabled": true,
"attachmentStatus": "ATTACHING"
}
Fabric Cloud Router
cURLリクエストの例:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/routers/<routerId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"metricsEnabled": false
}'
応答の例:
{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/routers/dee885d7-a845-4873-8774-f83012e7a",
"uuid": "dee885d7-a845-4873-8774-f83012e7a",
"type": "XF_ROUTER",
"metricsEnabled": false,
"attachmentStatus": "ATTACHED"
}
Network Edge仮想デバイス
cURLリクエストの例:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/networkEdgeDevices/<networkEdgeDeviceId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"metricsEnabled": false
}'
応答の例:
{
"href": "https://api.equinix.com/fabric/v4/streams/41372e9-79c9-4ef8-b77a-8b8176c2098b4/networkEdgeDevices/e78f71ef-d82d-4fab-947b-7c95d153e362",
"uuid": "e78f71ef-d82d-4fab-947b-7c95d153e362",
"type": "VD",
"metricsEnabled": false,
"attachmentStatus": "ATTACHED"
}
都市圏
cURLリクエストの例:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/metros/<metroCode>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"metricsEnabled": true
}'
応答の例:
{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/metros/SV",
"uuid": "SV",
"type": "XF_METRO",
"metricsEnabled": true,
"attachmentStatus": "ATTACHED"
}
プロジェクト
cURLリクエストの例:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/projects/<projectId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"includes": ["*"],
"metricsEnabled": true
}'
応答の例:
{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/projects/dee885d7-a845-4873-8774-f83012e7a",
"uuid": "dee885d7-a845-4873-8774-f83012e7a",
"type": "PROJECT",
"metricsEnabled": true ,
"attachmentStatus": "ATTACHED"
}
組織
cURLリクエストの例:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/organizations/<organizationId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"includes": ["*"],
"metricsEnabled": true
}'
応答の例:
{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/organizations/dee885d7-a845-4873-8774-f83012e7a",
"uuid": "dee885d7-a845-4873-8774-f83012e7a",
"type": "ORGANIZATION",
"metricsEnabled": true,
"attachmentStatus": "ATTACHED"
}
会社概要
cURLリクエストの例:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/companyProfiles/<companyProfileId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"metricsEnabled": false
}'
応答の例:
{
"href": "https://api.equinix.com/fabric/v4/streams/41372e9-79c9-4ef8-b77a-8b8176c2098b4/companyProfiles/12345918-3333-2222-1111-12345ae12345",
"uuid": "12345918-3333-2222-1111-12345ae12345",
"type": "COMPANY_PROFILE",
"metricsEnabled": false,
"attachmentStatus": "ATTACHED"
}
添付されたアセットの表示
- Portal
- API
ストリームに追加したリソースのリストを表示するには、your_Data Streams Inventory_からストリームを選択する。
[Stream Details]ページで[*Resources]をクリックして、[Resource List]を表示する。

アセットの添付ファイルの詳細とステータスを取得するには、エンドポイントにリクエストをfabric/v4/streams/{streamId}/{asset}/{assetId}送信する。GET
cURLリクエストの例:
curl -X 'GET' 'https://api.equinix.com/fabric/v4/streams/657400f8-d360-11e9-bb65-2a2ae2dbcce5/ports/757400f8-d360-11e9-bb65-2a2ae2dbcce6' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <Bearer Token>'
応答の例:
{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/ports/dee885d7-a845-4873-8774-f83012e7a",
"uuid": "dee885d7-a845-4873-8774-f83012e7a",
"metricsEnabled": true,
"attachmentStatus": "ATTACHED"
}
アセットの添付ファイルを削除する
- Portal
- API
ストリームからリソースを削除するには、your_Data Streams Inventory_からストリームを選択する。[Stream Details]ページで[*Resources]をクリックして、[Resource List]を表示する。
リソースのオプションメニューからリソースの削除をクリックする。

アセット添付ファイルを削除するには、エンドポイントにリクエストをfabric/v4/streams/{streamId}/{asset}/{assetId}送信する。DELETE
cURLリクエストの例:
curl -X 'DELETE' 'https://api.equinix.com/fabric/v4/streams/657400f8-d360-11e9-bb65-2a2ae2dbcce5/ports/757400f8-d360-11e9-bb65-2a2ae2dbcce6' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'
応答の例:
{
"href": "https://api.equinix.com/fabric/v4/stream/241372e9-79c9-4ef8-b77a-8b8176c2098b4/ports/dee885d7-a845-4873-8774-f83012e7a",
"uuid": "dee885d7-a845-4873-8774-f83012e7a",
"metricsEnabled": true,
"attachmentStatus": "DETACHING"
}