ストリームの管理

ストリームは、ストリーム管理 API によって作成される論理エンティティです。これにより、同じサブスクリプションセットを共有するアセットからのテレメトリデータを整理することができます。

1. ストリームを作成します

2. ストリームを購読してください。

3. ストリームにアセットを添付します。

4. (オプション) メトリクスやイベントデータに基づいて、通知やアクションをトリガーするための特定の条件を定義するアラートルールを作成します。

制限事項

ストリームには以下の制限があります：

• 1つのプロジェクトにつき、ストリームは5つまでです。
• 1つのストリームに添付できる組織は1つだけです。
• 1つのストリームに添付できるプロジェクトアセットは5つまでです。
• 1つのストリームにつき最大3つのサブスクリプションを作成できます。各サブスクリプションは異なるシンク用である必要があります。
• 1ストリームにつき50アセットを添付できます。
• 1つのストリームにつき最大50のメトリクス・アラート・ルールを作成できます。

前提条件

• ストリームを作成するには、Fabric Stream Subscription Manager （STREAM_SUBSCRIPTION PERMISSION CREATE AND READ）ロールが必要です。会社管理者またはIAM管理者に連絡して、アクセスとロールの管理を行ってください。

• OAuth2認証のためのユーザー認証情報、クライアントID、クライアントシークレットを送信します。Equinix APIへのリクエストを認証する方法については、「API認証」(../../equinix-api/api-authentication.md)を参照してください。

ストリームの作成

Portal

1. カスタマーポータル > _Fabric Dashboard_にログインします。

2. Observability_メニューから、Data Streams を選択します。

   

3. データストリームの詳細_］で、ストリームに名前を付けます。オプションで、説明を追加します。プロジェクトID］には、現在のプロジェクトIDが自動入力されます。プロジェクトを変更するには、Context Switcher を使用します。

   

4. データストリームの作成 をクリックします。

API

ストリームを作成するには、/fabric/v4/streams エンドポイントに POST リクエストを送信します。

cURLリクエストのサンプル：

curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams' \  
-H 'Content-Type: application/json' \  
-H 'Authorization: Bearer <Bearer Token>' \  
-d '{  
    "type": "TELEMETRY_STREAM",  
    "name": "splunk1",  
    "description": "subscription 1",  
    "project": {
        "projectId": "<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": "<projectId>"  
    },  
    "enabled": true,  
    "state": "PROVISIONING",  
    "assetsCount": 0,  
    "streamSubscriptionsCount": 0,  
    "changelog": {  
        "createdBy": "testuser",  
        "createdDateTime": "2024-08-12T21:14:17.689103902Z"  
    }  
}

ストリームの表示

Portal

1. カスタマーポータル > _Fabric Dashboard_にログインします。

2. Observability_メニューから、Data Streams を選択します。

この表には、データストリーム、そのステータス、ストリームのサブスクリプション数、およびストリームに追加したリソースの数が一覧表示されます。

ストリームの詳細ページを表示するには、_ストリーム名_をクリックしてください。

Subscriptions_]タブには、このストリームへのサブスクリプションのSubscription Listが含まれ、[Resources]タブには、このストリームに追加されたリソースのResources Listが含まれます。

API

ストリームの詳細を取得するには、/fabric/v4/streams/{stream_id} エンドポイントに 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 <Bearer Token>'

回答例

{  
    "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": "<projectId>"  
    },  
    "enabled": true,  
    "state": "PROVISIONED",  
    "changelog": {  
        "createdBy": "testuser",  
        "createdDateTime": "2024-08-12T21:14:17.689104Z"  
    }  
}

ストリームの削除

Portal

ストリームを削除するには、_ストリーム名_をクリックして、ストリームの詳細_ページを表示します。Actions］ドロップダウンから、［Delete Data Stream ］をクリックします。

確認ボックスで、[はい]、[削除] をクリックします。

API

ストリームを削除するには、/fabric/v4/streams/{stream_id} エンドポイントに 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 <Bearer Token>'