# ストリームの管理 ストリームは、ストリーム管理APIを介して作成される論理エンティティです。これにより、同じサブスクリプションセットを共有するアセットからのテレメトリデータを整理できます。 1. ストリームを作成します 2. ストリームを購読してください。 3. ストリームにアセットを添付します。 4. (*オプション*)アラートルールを作成して、メトリクスとイベントデータに基づいて通知やアクションをトリガーするための特定の条件を定義します。 ## 制限事項[​](#制限事項 "への直接リンク制限事項") ストリームには以下の制限があります: * 1つのプロジェクトにつき、ストリームは5つまでです。 * 1つのストリームに添付できる組織は1つだけです。 * 1つのストリームに添付できるプロジェクトアセットは5つまでです。 * 1つのストリームにつき最大3つのサブスクリプションを作成できます。各サブスクリプションは、異なるシンク用である必要があります。 * 1ストリームにつき50アセットを添付できます。 * 1つのストリームにつき最大50のメトリクスアラートルールを作成できます。 ## 前提条件[​](#前提条件 "への直接リンク前提条件") * ストリームを作成するには、(STREAM\_SUBSCRIPTION権限の作成および読み取り権限)の役割が必要です。`Fabric Stream Subscription Manager`[アクセスと役割を管理するに](https://docs.equinix.com/ja/iam/user-management/iam-users-access-roles.md)は、会社管理者またはIAM管理者に連絡してください。 * ユーザー認証情報、クライアントID、およびクライアントシークレットを送信してOauth2認証を行います。Equinix APIへのリクエストを認証する方法の詳細については、[API認証を](https://docs.equinix.com/ja/equinix-api/api-authentication.md)参照してください。 ## ストリームの作成[​](#ストリームの作成 "への直接リンクストリームの作成") * Portal * API 1. [\[カスタマーポータル\]](https://portal.equinix.com/fabric)>\[\_ファブリックダッシュボード]\_にログインします。 2. *[可視性*]メニューから[**データストリーム]を**選択します。 ![可視性ドロップダウンメニューのスクリーンショット](https://docs.equinix.com/ja/assets/images/observability-drop-down-7b9fce28b7a44d07b365263f69b94cc2.png) 3. \[\_データストリームの詳細]\_で、ストリームに名前を付けます。必要に応じて、説明を追加します。\_プロジェクトIDには、\_現在のプロジェクトIDが自動的に入力されます。[*コンテキストスイッチャを*](https://docs.equinix.com/ja/iam/resources/projects-manage.md#switching-between-projects)使用してプロジェクトを変更します。 ![「データストリームの作成」ダイアログのスクリーンショット](https://docs.equinix.com/ja/assets/images/create-data-stream-details-4913afe9c74ee7b82d0daac704bee370.png) 4. **[データストリームを作成]を**クリックします。 エンドポイントにリクエストを[`/fabric/v4/streams`](https://docs.equinix.com/ja/api-catalog/fabricv4/streams/createstreams.md)送信して`POST`ストリームを作成します。 cURLリクエストのサンプル: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "TELEMETRY_STREAM", "name": "splunk1", "description": "subscription 1", "project": { "projectId": "" } }' ``` 回答例 ``` {     "uuid": "241372e9-79c9-4ef8-b77a-8b8176c2098b4",     "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4",     "type": "TELEMETRY_STREAM",     "name": "splunk1",     "description": "subscription 1",     "project": {         "projectId": ""     },     "enabled": true,     "state": "PROVISIONING",     "assetsCount": 0,     "streamSubscriptionsCount": 0,     "changelog": {         "createdBy": "testuser",         "createdDateTime": "2024-08-12T21:14:17.689103902Z"     } } ``` ## ストリームの表示[​](#ストリームの表示 "への直接リンクストリームの表示") * Portal * API 1. [\[カスタマーポータル\]](https://portal.equinix.com/fabric)>\[\_ファブリックダッシュボード]\_にログインします。 2. *[可視性*]メニューから[**データストリーム]を**選択します。 この表には、データストリーム、そのステータス、ストリームのサブスクリプション数、およびストリームに追加したリソースの数が一覧表示されます。 ![データストリームリストのスクリーンショット](https://docs.equinix.com/ja/assets/images/data-streams-list-e7dd7de22e5da8c72b6e4b630a02019b.png) \_ストリーム名を\_クリックすると、ストリームの\_詳細\_ページが表示されます。このページには、ストリームの説明と\_アクティビティログが\_含まれています。 ![ストリーム詳細のスクリーンショット](https://docs.equinix.com/ja/assets/images/data-stream-details-69ab0be48e11475c4dd90a2cc454e18a.png) \_\[サブスクリプション]\_タブには、このストリームのサブスクリプションのサブスクリプション[リストが](https://docs.equinix.com/ja/observability/streaming-data/api-managing-subscriptions.md#viewing-your-subscriptions)含まれ、\[\_リソース]\_タブには、このストリームに追加されたリソースの[リソースリストが](https://docs.equinix.com/ja/observability/streaming-data/api-managing-assets.md#viewing-attached-assets)含まれています。 ストリームの詳細を取得するには、エンドポイントにリクエストを[`/fabric/v4/streams/{stream_id}`](https://docs.equinix.com/ja/api-catalog/fabricv4/streams/getstreambyuuid.md)送信します。`GET` サンプルcURLリクエスト: ``` curl -X 'GET' 'https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' ``` 回答例 ``` {     "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4",     "uuid": "241372e9-79c9-4ef8-b77a-8b8176c2098b4",     "type": "STREAM_SUSBSCRIPTION",     "name": "splunk1",     "description": "subscription 1",     "project": {         "projectId": ""     },     "enabled": true,     "state": "PROVISIONED",     "changelog": {         "createdBy": "testuser",         "createdDateTime": "2024-08-12T21:14:17.689104Z"     } } ``` ## ストリームの削除[​](#ストリームの削除 "への直接リンクストリームの削除") * Portal * API ストリームを削除するには、*ストリーム名を\_クリックしてストリームの\_詳細\_ページを表示します。*[アクション]\_ドロップダウンから[**データストリームの削除]を**クリックします。 ![データストリームの削除のスクリーンショット](https://docs.equinix.com/ja/assets/images/data-stream-delete-c157ff5cb09d94e17a01d0bda6db7f4c.png) 確認用BOXで、**はい、削除を**クリックします。 ストリームを削除するには、エンドポイントにリクエストを[`/fabric/v4/streams/{stream_id}`](https://docs.equinix.com/ja/api-catalog/fabricv4/streams/deletestreambyuuid.md)送信します。`DELETE` サンプルcURLリクエスト: ``` curl -X 'DELETE' 'https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' ```