資産の管理

アセットからのデータ、メトリクス、イベントを表示またはストリームするには、まずそれをストリームにアタッチする必要があります。次のアセットがサポートされています：

Ports - ストリーム帯域幅使用量、エラーおよびドロップされたパケット・メトリクス、アップ/ダウン・イベント、ライフサイクル・イベント。
接続 - ストリーム帯域幅使用量、ドロップパケットメトリクス、アップ/ダウンイベント、ライフサイクルイベント。
Fabric Cloud Router - BGP ステートイベント、ルートクォータ使用イベント、ライフサイクルイベントをストリームします。
Network Edge Virtual Devices - アクセス・コントロール・リスト、デバイス属性、リブート、デバイス・リンク・グループのイベントをストリームします。
メトロ - ストリームメトロの遅延メトリクス。
プロジェクト - プロジェクト内のアセットの状態変更イベントやライフサイクルイベントなど、プロジェクトのすべてのイベントを表示するには、ストリームにプロジェクトをアタッチします。プロジェクトの詳細については、プロジェクトの管理を参照してください。
組織 - プロジェクトのライフサイクルイベントや、役割の割り当てなどの Identity & Access Management イベントを含む組織イベントを表示するには、ストリームに組織をアタッチします。組織の詳細については、組織の管理を参照してください。
Company Profiles - プロファイルの属性、タグ、ライフサイクルイベントをストリームします。

詳細については、Metrics および Events のページを参照してください。

前提条件

アセット（ポート、接続など）をストリームにアタッチするには、そのアセットに対して少なくとも Viewer ロールが必要です。
ライフサイクル・プロビジョニング・イベントのストリームにプロジェクトをアタッチするには、ユーザーは Project Admin ロールを持つ必要があります。
役割割り当て、ユーザーログイン、およびリソース管理イベントのために組織をストリームにアタッチするには、ユーザーは Org Admin ロールを持つ必要があります。役割割り当てのために組織をストリームにアタッチするには、ユーザーは Org Admin ロールを持つ必要があります。
APIを使用する場合は、OAuth2認証のためにユーザー認証情報、クライアントID、クライアントシークレットを送信します。Equinix APIへのリクエストを認証する方法については、「API認証」(../../equinix-api/api-authentication.md)を参照してください。

ポータルへの資産の添付

カスタマーポータル > _Fabric Dashboard_にログインします。
Observability_メニューから、Data Streams を選択します。
リソースを追加するストリーム名をクリックします。
Actions_」ドロップダウンメニューから、「Add Resources（リソースの追加）」 を選択します。
利用可能なリソースタイプをフィルタするには、File Directory メニューを使用します。
ストリームに追加するリソースを選択します。追加したリソースはイベントデータを送信し、メトリックスも送信する場合は、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ルーター

サンプル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"
}

ネットワークエッジ仮想デバイス

サンプル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

ストリームに追加したリソースのリストを表示するには、_Data Streams Inventory_からそのストリームを選択します。

ストリームの詳細_ページで、リソース をクリックすると、_リソースリスト_が表示されます。

Resources List Screenshot

アセットの添付ファイルの詳細とステータスを取得するには、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

ストリームからリソースを削除するには、_Data Streams Inventory_からストリームを選択します。ストリームの詳細］ページで［リソース］ をクリックして、［リソースリスト］を表示します。

リソースのオプションメニューから、Delete Resource をクリックします。

Deleting a Resource Screenshot

アセットアタッチメントを削除するには、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"
}

前提条件​

ポータルへの資産の添付​

API へのアセットの添付​

港湾​

コネクション​

Fabric Cloudルーター​

ネットワークエッジ仮想デバイス​

メトロス​

プロジェクト​

組織・団体​

会社概要​

添付資産を表示します。​

資産アタッチメントの削除​

前提条件

ポータルへの資産の添付

API へのアセットの添付

港湾

コネクション

Fabric Cloudルーター

ネットワークエッジ仮想デバイス

メトロス

プロジェクト

組織・団体

会社概要

添付資産を表示します。

資産アタッチメントの削除