ストリームを管理する

ストリームは、Stream Management APIを介して作成される論理エンティティである。同じサブスクリプションセットを共有するアセットからテレメトリデータを整理できる。

1. ストリームを作成する

2. ストリームを購読する。

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

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

制限

ストリームには次の制限がある。

• プロジェクトごとに5つのストリームに制限がある。
• ストリームに添付できる組織は1つのみ。
• ストリームに添付できるProjectアセットは5つのみ。
• ストリームごとに最大3つのサブスクリプションを作成できる。各サブスクリプションは異なるシンク用でなければならない。
• ストリームごとに50のアセットを添付できる。
• ストリームごとに最大50のメトリックアラートルールを作成できる。

プロビジョニング

• ストリームを作成するには、( stream_subscription permission create and read )ロールが必要である。Fabric Stream Subscription Manager会社の管理者またはIAM管理者に連絡して、アクセスとロールを管理する。

• OAuth2認証のためのユーザー資格情報、クライアントID、およびクライアントシークレットを送信する。Equinix APIへのリクエストを認証する方法については、API認証を参照。

ストリームを作成する

Portal

1. ［カスタマーポータル］>［Fabricダッシュボード］にログインします。

2. [Observability]メニューから[*Data Streams]を選択する。

   

3. _Data Stream Details_で、ストリームに名前を付ける。必要に応じて、説明を追加する。_Project ID_には、現在のプロジェクトIDが自動的に入力される。コンテキストスイッチャー_を使用してプロジェクトを変更する。

   

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ダッシュボード］にログインします。

2. [Observability]メニューから[*Data Streams]を選択する。

テーブルには、データストリーム、そのステータス、ストリームにあるサブスクリプションの数、およびストリームに追加したリソースの数がリストされる。

ストリーム名_をクリックして、ストリームの説明と_アクティビティログ_を含む_ストリーム詳細_ページを表示する。

_Subscriptions_tabにはこのストリームへのサブスクリプションのサブスクリプションリストが含まれ、_Resources_tabにはこのストリームに追加されたリソースのリソースリストが含まれる。

API

Streamの詳細を取得するには、エンドポイントにリクエストを/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}送信する。
DELETEcURLリクエストの例：

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>'