管理资产
要查看或流式传输资产的数据、指标和事件,必须先将其附加到流中。 支持以下资产:
- 端口 - 流带宽使用情况、错误和丢包指标、上/下行事件和生命周期事件。
- 连接 - 流带宽使用情况、丢包指标、上下线事件和生命周期事件。
- Fabric 云路由器 - 流式传输 BGP 状态事件、路由配额使用事件和生命周期事件。
- 网络边缘虚拟设备 - 流式传输访问控制列表、设备属性、重启和设备链路组事件。
- Metros - 流媒体 Metro 延迟指标。
- 项目 - 要查看项目的所有事件,包括项目内资产的状态更改事件和生命周期事件,请将项目附加到您的流。要了解有关项目的更多信息,请参阅管理项目。
- 组织 - 要查看组织事件(包括项目生命周期事件以及身份和访问管理事件,例如角色分配),请将组织附加到您的流。有关组织的更多信息,请参阅管理组织。
- 公司简介 - 流式传输简介属性、标签和生命周期事件。
先决条件
-
要将资源(端口、连接等)附加到流上,用户至少需要拥有该资源的“查看者”角色。
-
要将项目附加到生命周期配置事件的流中,用户需要具有“项目管理员”角色。
-
要将组织关联到某个流以进行角色分配、用户登录和资源管理事件,用户需要拥有“组织管理员”角色。要将组织关联到某个流以进行角色分配,用户需要拥有“组织管理员”角色。
-
如果您使用 API,请提交您的用户凭据、客户端 ID 和客户端密钥以进行 OAuth2 身份验证。有关如何对 Equinix API 请求进行身份验证的更多信息,请参阅API 身份验证。
在门户中附加资产
-
登录客户门户 > Fabric 控制面板。
-
从“可观测性”菜单中,选择“数据流”。

-
点击要添加资源的_流名称_。
-
从“操作”下拉菜单中选择“添加资源”。

-
使用“文件目录”菜单筛选可用资源类型。
-
选择要添加到流中的特定资源。添加的资源会发送事件数据;如果您还想发送指标,请切换“启用指标”选项。选择所需资源后,点击“查看”。

-
查看要附加到流的资产列表。

-
点击提交。
在 API 中附加资产
要将端口连接到流,请向 /fabric/v4/streams/{streamId}/{asset}/{assetId} 端点发送 PUT 请求。
请参阅下面的示例,将资产附加到流以获取支持的资产。
码头
示例 cURL 请求:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/ports/<portId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"metricsEnabled": true
}'
示例响应:
{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/ports/dee885d7-a845-4873-8774-f83012e7a",
"uuid": "dee885d7-a845-4873-8774-f83012e7a",
"type": "XF_PORT",
"metricsEnabled": true,
"attachmentStatus": "ATTACHING"
}
连接
示例 cURL 请求:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/connections/<connectionId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"metricsEnabled": true
}'
示例响应:
{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/connections/dee885d7-a845-4873-8774-f83012e7a",
"uuid": "dee885d7-a845-4873-8774-f83012e7a",
"type": "IP_VC",
"metricsEnabled": true,
"attachmentStatus": "ATTACHING"
}
织物云路由器
示例 cURL 请求:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/routers/<routerId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"metricsEnabled": false
}'
示例响应:
{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/routers/dee885d7-a845-4873-8774-f83012e7a",
"uuid": "dee885d7-a845-4873-8774-f83012e7a",
"type": "XF_ROUTER",
"metricsEnabled": false,
"attachmentStatus": "ATTACHED"
}
网络边缘虚拟设备
示例 cURL 请求:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/networkEdgeDevices/<networkEdgeDeviceId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"metricsEnabled": false
}'
示例响应:
{
"href": "https://api.equinix.com/fabric/v4/streams/41372e9-79c9-4ef8-b77a-8b8176c2098b4/networkEdgeDevices/e78f71ef-d82d-4fab-947b-7c95d153e362",
"uuid": "e78f71ef-d82d-4fab-947b-7c95d153e362",
"type": "VD",
"metricsEnabled": false,
"attachmentStatus": "ATTACHED"
}
大都会
示例 cURL 请求:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/metros/<metroCode>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"metricsEnabled": true
}'
示例响应:
{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/metros/SV",
"uuid": "SV",
"type": "XF_METRO",
"metricsEnabled": true,
"attachmentStatus": "ATTACHED"
}
项目
示例 cURL 请求:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/projects/<projectId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"includes": ["*"],
"metricsEnabled": true
}'
示例响应:
{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/projects/dee885d7-a845-4873-8774-f83012e7a",
"uuid": "dee885d7-a845-4873-8774-f83012e7a",
"type": "PROJECT",
"metricsEnabled": true ,
"attachmentStatus": "ATTACHED"
}
组织机构
示例 cURL 请求:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/organizations/<organizationId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"includes": ["*"],
"metricsEnabled": true
}'
示例响应:
{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/organizations/dee885d7-a845-4873-8774-f83012e7a",
"uuid": "dee885d7-a845-4873-8774-f83012e7a",
"type": "ORGANIZATION",
"metricsEnabled": true,
"attachmentStatus": "ATTACHED"
}
公司简介
示例 cURL 请求:
curl -X 'PUT' 'https://api.equinix.com/fabric/v4/streams/<streamId>/companyProfiles/<companyProfileId>' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"metricsEnabled": false
}'
示例响应:
{
"href": "https://api.equinix.com/fabric/v4/streams/41372e9-79c9-4ef8-b77a-8b8176c2098b4/companyProfiles/12345918-3333-2222-1111-12345ae12345",
"uuid": "12345918-3333-2222-1111-12345ae12345",
"type": "COMPANY_PROFILE",
"metricsEnabled": false,
"attachmentStatus": "ATTACHED"
}
查看附加资产
- Portal
- API
要查看已添加到数据流中的资源列表,请从“数据流清单”中选择该数据流。
在“流详情”页面中,点击“资源”查看“资源列表”。

要获取资产的附件详细信息和状态,请向 fabric/v4/streams/{streamId}/{asset}/{assetId} 端点发送 GET 请求。
示例 cURL 请求:
curl -X 'GET' 'https://api.equinix.com/fabric/v4/streams/657400f8-d360-11e9-bb65-2a2ae2dbcce5/ports/757400f8-d360-11e9-bb65-2a2ae2dbcce6' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <Bearer Token>'
示例响应:
{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/ports/dee885d7-a845-4873-8774-f83012e7a",
"uuid": "dee885d7-a845-4873-8774-f83012e7a",
"metricsEnabled": true,
"attachmentStatus": "ATTACHED"
}
删除资产附件
- Portal
- API
要从数据流中删除资源,请从“数据流清单”中选择该数据流。在“数据流详细信息”页面中,单击“资源”以查看“资源列表”。
从资源的选项菜单中,单击删除资源。

要删除资产附件,请向 fabric/v4/streams/{streamId}/{asset}/{assetId} 端点发送 DELETE 请求。
示例 cURL 请求:
curl -X 'DELETE' 'https://api.equinix.com/fabric/v4/streams/657400f8-d360-11e9-bb65-2a2ae2dbcce5/ports/757400f8-d360-11e9-bb65-2a2ae2dbcce6' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'
示例响应:
{
"href": "https://api.equinix.com/fabric/v4/stream/241372e9-79c9-4ef8-b77a-8b8176c2098b4/ports/dee885d7-a845-4873-8774-f83012e7a",
"uuid": "dee885d7-a845-4873-8774-f83012e7a",
"metricsEnabled": true,
"attachmentStatus": "DETACHING"
}