管理流

流是通过流管理API创建的逻辑实体。它允许您从共享同一组订阅的资产中组织遥测数据。

1. 创建流

2. 订阅流媒体。

3. 将资源附加到数据流。

4. (Optional)创建警报规则，根据指标和事件数据定义触发通知或操作的特定条件。

限制

流有以下限制：

• 每个项目最多有5个流。
• 您只能将一个组织附加到流。
• 您只能将5个项目资产附加到数据流。
• 每个流最多可以创建3个订阅。每个订阅必须用于不同的接收器。
• 您可以为每个数据流附加50个资产。
• 每个流最多可以创建50个指标警报规则。

前提条件

• 要创建流，您必须具有Fabric Stream Subscription Manager(stream_subscription权限创建和读取)角色。请与您的公司管理员或IAM管理员联系以管理访问和角色。

• 提交您的用户凭据，客户端ID和客户端机密以进行OAuth2身份验证。有关如何验证对Equinix API的请求的详细信息，请参阅API身份验证。

创建流

Portal

1. 登录客户门户>Fabric Dashboard。

2. 从_Observability_菜单中，选择数据流。

   

3. 在_数据流详细信息_中，为您的流命名。(可选)添加说明。_Project ID_将自动填充您当前的项目ID。使用上下文切换器更改项目。

   

4. 单击创建数据流。

API

向端点发送POST请求/fabric/v4/streams以创建流。

卷曲请求示例：

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_菜单中，选择数据流。

该表列出了您的数据流，数据流的状态，数据流的订阅数量以及您向数据流添加的资源数量。

单击_流名称_以查看其_流详情_页面，其中包含流的描述和_活动日志_。

_Subscriptions_选项卡包含订阅此流的订阅列表，_Resources_选项卡包含添加到此流的资源的资源列表。

API

要获取流的详细信息, 请向端点发送GET请求/fabric/v4/streams/{stream_id}。

卷曲请求示例：

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

要删除流，请单击_Stream Name_以查看其_Stream Details_页面。从_Actions_下拉列表中，单击删除数据流。

在确认框中，单击是，删除。

API

要删除流，请向端点发送DELETE请求/fabric/v4/streams/{stream_id}。 卷曲请求示例：

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