# 流管理 数据流是通过数据流管理API创建的逻辑实体。它允许您从共享同一组订阅的资产组织遥测数据。 1. 创建流 2. 订阅 Stream。 3. 将资产附加到流。 4. (*可选*)创建告警规则,根据指标和事件数据定义触发通知或操作的特定条件。 ## 局限性[​](#局限性 "直接链接至局限性") 流具有以下限制: * 每个项目最多有 5 个流。 * 一个流只能附加一个组织。 * 您只能将 5 个项目资产附加到 Stream。 * 每个数据流最多可创建3个订阅。每个订阅都必须针对不同的接收器。 * 每个流可以附加 50 个资产。 * 每个流最多可以创建 50 条指标警报规则。 ## 先决条件[​](#先决条件 "直接链接至先决条件") * 要创建流,您必须具有`Fabric Stream Subscription Manager`(STREAM\_SUBSCRIPTION)权限。请联系贵公司管理员或IAM管理员以[管理访问权限和角色](https://docs.equinix.com/zh-Hans/iam/user-management/iam-users-access-roles.md)。 * 提交您的用户凭据,客户端ID和客户端机密以进行OAuth2验证。有关如何向Equinix API验证请求的更多信息,请参阅[API验证](https://docs.equinix.com/zh-Hans/equinix-api/api-authentication.md)。 ## 创建流[​](#创建流 "直接链接至创建流") * Portal * API 1. 登录[客户门户网站](https://portal.equinix.com/fabric)> *Fabric控制面板*。 2. 从“*可观测性*”菜单中,选择**数据流**。 ![观察性下拉菜单屏幕截图](https://docs.equinix.com/zh-Hans/assets/images/observability-drop-down-7b9fce28b7a44d07b365263f69b94cc2.png) 3. 在\_“数据流详情\_”中,为您的数据流命名。添加描述(可选)。\_项目ID\_将使用您当前的项目ID自动填充。使用[*上下文切换器*](https://docs.equinix.com/zh-Hans/iam/resources/projects-manage.md#switching-between-projects)更改项目。 ![创建数据流对话框屏幕截图](https://docs.equinix.com/zh-Hans/assets/images/create-data-stream-details-4913afe9c74ee7b82d0daac704bee370.png) 4. 单击**创建数据流**。 向端点发送`POST`创建数据流的请求[`/fabric/v4/streams`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/streams/createstreams.md)。 cURL 请求示例: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "TELEMETRY_STREAM", "name": "splunk1", "description": "subscription 1", "project": { "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": ""     },     "enabled": true,     "state": "PROVISIONING",     "assetsCount": 0,     "streamSubscriptionsCount": 0,     "changelog": {         "createdBy": "testuser",         "createdDateTime": "2024-08-12T21:14:17.689103902Z"     } } ``` ## 查看您的流[​](#查看您的流 "直接链接至查看您的流") * Portal * API 1. 登录[客户门户网站](https://portal.equinix.com/fabric)> *Fabric控制面板*。 2. 从“*可观测性*”菜单中,选择**数据流**。 该表列出了您的数据流、其状态、流的订阅数以及您添加到流的资源数。 ![数据流列表屏幕截图](https://docs.equinix.com/zh-Hans/assets/images/data-streams-list-e7dd7de22e5da8c72b6e4b630a02019b.png) 点击\_数据流名称\_以查看其“*数据流详情*”页面,其中包含您的数据流描述和\_活动日志\_。 ![流详情屏幕截图](https://docs.equinix.com/zh-Hans/assets/images/data-stream-details-69ab0be48e11475c4dd90a2cc454e18a.png) “*订阅*”选项卡包含订阅此流的[订阅列表](https://docs.equinix.com/zh-Hans/observability/streaming-data/api-managing-subscriptions.md#viewing-your-subscriptions),“*资源*”选项卡包含添加到此流的[资源](https://docs.equinix.com/zh-Hans/observability/streaming-data/api-managing-assets.md#viewing-attached-assets)的“[资源列表](https://docs.equinix.com/zh-Hans/observability/streaming-data/api-managing-assets.md#viewing-attached-assets)”。 要获取数据流的详细信息,请向端点发送`GET`请求[`/fabric/v4/streams/{stream_id}`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/streams/getstreambyuuid.md)。 cURL 请求示例: ``` curl -X 'GET' 'https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' ``` 示例回答: ``` {     "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": ""     },     "enabled": true,     "state": "PROVISIONED",     "changelog": {         "createdBy": "testuser",         "createdDateTime": "2024-08-12T21:14:17.689104Z"     } } ``` ## 删除流[​](#删除流 "直接链接至删除流") * Portal * API 要删除数据流,请单击\_数据流名称\_以查看其“*数据流\_\_详情*”页面。在“*操作*”下拉菜单中,单击**删除数据流**。 ![删除数据流屏幕截图](https://docs.equinix.com/zh-Hans/assets/images/data-stream-delete-c157ff5cb09d94e17a01d0bda6db7f4c.png) 在确认BOX中,单击**是,删除**。 要删除数据流,请向端点发送`DELETE`请求[`/fabric/v4/streams/{stream_id}`](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4/streams/deletestreambyuuid.md)。 cURL 请求示例: ``` curl -X 'DELETE' 'https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' ```