Gestão de Ativos
Para visualizar ou transmitir dados, métricas e eventos de um recurso, primeiro você precisa vinculá-lo a um fluxo. Os seguintes recursos são suportados:
- Portas - uso de largura de banda do fluxo, métricas de erros e pacotes descartados, eventos de atividade/inatividade e eventos de ciclo de vida.
- Conexões - uso de largura de banda do fluxo, métricas de pacotes descartados, eventos de atividade/inatividade e eventos de ciclo de vida.
- Roteadores Fabric Cloud - transmitem eventos de estado BGP, eventos de uso de cota de rota e eventos de ciclo de vida.
- Dispositivos Virtuais de Borda de Rede - transmitem eventos de Lista de Controle de Acesso (ACL), atributos de dispositivo, reinicialização e Grupo de Links de Dispositivo.
- Metrôs - métricas de latência de streaming em metrôs.
- Projetos - Para visualizar todos os eventos do seu projeto, incluindo eventos de mudança de estado e eventos de ciclo de vida dos ativos do seu projeto, anexe um projeto ao seu fluxo. Para obter mais informações sobre Projetos, consulte Gerenciando Projetos.
- Organizações - Para visualizar eventos da organização, incluindo eventos do ciclo de vida de projetos e eventos de gerenciamento de identidade e acesso, como atribuições de função, anexe uma organização ao seu fluxo. Para obter mais informações sobre organizações, consulte Gerenciando Organizações.
- Perfis de Empresas - transmita atributos, tags e eventos do ciclo de vida do perfil.
Para obter mais informações, consulte as páginas Métricas e Eventos.
Pré-requisitos
-
Para associar recursos (portas, conexões, etc.) a um fluxo, o usuário precisa ter pelo menos a função de "Visualizador" nesse recurso.
-
Para associar projetos a um fluxo de eventos de provisionamento de ciclo de vida, o usuário precisa ter a função de "Administrador de Projetos".
-
Para vincular organizações a um fluxo para atribuição de funções, login de usuários e eventos de gerenciamento de recursos, o usuário precisa ter a função de "Administrador da Organização".
-
Se você estiver usando a API, envie suas credenciais de usuário, ID do cliente e segredo do cliente para autenticação OAuth2. Consulte Autenticação da API para obter mais informações sobre como autenticar suas solicitações à API da Equinix.
Anexando ativos no portal
-
Faça login no [Portal do Cliente > Painel de Controle do Fabric.
-
No menu Observabilidade, selecione Fluxos de Dados.

-
Clique no Nome do fluxo ao qual deseja adicionar recursos.
-
No menu suspenso Ações, selecione Adicionar recursos.

-
Utilize o menu Diretório de Arquivos para filtrar os tipos de recursos disponíveis.
-
Selecione o(s) recurso(s) específico(s) que deseja adicionar ao fluxo. Os recursos adicionados enviam dados de eventos e, se desejar enviar também métricas, ative a opção Habilitar métricas. Depois de selecionar os recursos desejados, clique em Revisar.

-
Revise a lista de ativos a serem anexados ao fluxo.

-
Clique em Enviar.
Anexando ativos na API
Para associar uma porta a um fluxo, envie uma solicitação PUT para o endpoint /fabric/v4/streams/{streamId}/{asset}/{assetId}.
Consulte os exemplos abaixo para anexar um ativo a um fluxo para os ativos suportados.
Portos
Exemplo de solicitação 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
}'
Exemplo de resposta:
{
"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"
}
Conexões
Exemplo de solicitação 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
}'
Exemplo de resposta:
{
"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"
}
Roteadores de nuvem de tecido
Exemplo de solicitação 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
}'
Exemplo de resposta:
{
"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"
}
Dispositivos Virtuais Network Edge
Exemplo de solicitação 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
}'
Exemplo de resposta:
{
"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"
}
Metrôs
Exemplo de solicitação 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
}'
Exemplo de resposta:
{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4/metros/SV",
"uuid": "SV",
"type": "XF_METRO",
"metricsEnabled": true,
"attachmentStatus": "ATTACHED"
}
Projetos
Exemplo de solicitação 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
}'
Exemplo de resposta:
{
"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"
}
Organizações
Exemplo de solicitação 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
}'
Exemplo de resposta:
{
"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"
}
Perfis de empresas
Exemplo de solicitação 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
}'
Exemplo de resposta:
{
"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"
}
Visualizando ativos anexados
- Portal
- API
Para visualizar a lista de recursos que você adicionou a um fluxo, selecione o fluxo correspondente no seu Inventário de Fluxos de Dados.
Na página Detalhes do Stream, clique em Recursos para visualizar a Lista de Recursos.

Para obter detalhes e status de um recurso anexado, envie uma solicitação GET para o endpoint fabric/v4/streams/{streamId}/{asset}/{assetId}.
Exemplo de solicitação 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>'
Exemplo de resposta:
{
"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"
}
Excluindo um anexo de ativo
- Portal
- API
Para excluir um recurso de um fluxo, selecione o fluxo no seu Inventário de Fluxos de Dados. Na página Detalhes do Fluxo, clique em Recursos para visualizar a Lista de Recursos.
No menu de opções do recurso, clique em Excluir recurso.

Para excluir um anexo de recurso, envie uma solicitação DELETE para o endpoint fabric/v4/streams/{streamId}/{asset}/{assetId}.
Exemplo de solicitação 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>'
Exemplo de resposta:
{
"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"
}