流管理

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

1. 创建流

2. 订阅 Stream。

3. 将资产附加到流。

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

局限性

流具有以下限制：

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

先决条件

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

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

创建流

Portal

1. 登录客户门户网站> Fabric控制面板。

2. 从“可观测性”菜单中，选择数据流。

   

3. 在_“数据流详情_”中，为您的数据流命名。添加描述(可选)。_项目ID_将使用您当前的项目ID自动填充。使用上下文切换器更改项目。

   

4. 单击创建数据流。

API

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

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. 从“可观测性”菜单中，选择数据流。

该表列出了您的数据流、其状态、流的订阅数以及您添加到流的资源数。

点击_数据流名称_以查看其“数据流详情”页面，其中包含您的数据流描述和_活动日志_。

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

API

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

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

要删除数据流，请单击_数据流名称_以查看其“数据流__详情”页面。在“操作”下拉菜单中，单击删除数据流。

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

API

要删除数据流，请向端点发送DELETE请求/fabric/v4/streams/{stream_id}。 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>'