管理流

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

1. 创建流

2. 订阅 Stream。

3. 将资产附加到流。

4. （可选）创建警报规则，以根据指标和事件数据定义触发通知或操作的具体条件。

限制条件

流具有以下限制：

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

先决条件

• 要创建流，您必须拥有“Fabric Stream Subscription Manager”（STREAM_SUBSCRIPTION PERMISSION CREATE AND READ）角色。请联系您的公司管理员或 IAM 管理员以管理访问权限和角色。

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

创建流

Portal

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

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

   

3. 在“数据流详情”中，为您的数据流命名。您还可以选择添加描述。“项目 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. 从“可观测性”菜单中，选择“数据流”。

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

点击_直播流名称_即可查看其_直播流详情_页面，其中包含您的直播流描述和_活动日志_。

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

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

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

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

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