Ir para o conteúdo principal

Eventos

A Equinix fornece dados de eventos no Portal do Cliente e no Equinix API para os seguintes ativos:

  • Portas - eventos do ciclo de vida e eventos up/down.
  • Fabric Cloud Routers - eventos de ciclo de vida, status da sessão BGP, estado de agregação de rotas e eventos de estado do filtro de rotas.
  • Serviços de tempo de precisão - eventos do ciclo de vida
  • Conexões virtuais - Os dados de eventos de provisionamento/desprovisionamento estão disponíveis para conexões em que uma porta ou roteador de cloud é o A-Side. Os dados do evento de falha NÃO estão disponíveis para conexões Porta para ETree ou roteador de cloud para conexões de dispositivo virtual.
  • Tokens de serviço - eventos do ciclo de vida.
  • Perfis de empresas - atributos de perfil, tags e eventos do ciclo de vida.

Além disso, os eventos estão disponíveis no nível do Projeto e da Organização.

  • Projetos - Os dados de eventos do projeto incluem eventos de estado do ciclo de vida para todos os ativos no projeto. Qualquer alteração de status no seu ativo, incluindo provisionamento, desprovisionamento e falhas, resulta no envio de um evento. Os eventos de ciclo de vida estão disponíveis no nível do projeto para todos os ativos acima, bem como:

    • Acesso à Internet - eventos de ciclo de vida, eventos de bloco IP e eventos ASN.
    • Network Edge - eventos de ciclo de vida, lista de controle de acesso (ACL), atributo do dispositivo, reinicialização e eventos de grupo de links de dispositivos (DLG).
    • Perfil de serviço - eventos do ciclo de vida.

  • Eventos da organização - Esses eventos são do gerenciador de acesso e do gerenciador de recursos para informar os administradores da organização sobre eventos de mudança que acontecem na organização, como adicionar ou remover funções de usuários.

observação

Você também pode transmitir dados de eventos para coletores de dados de terceiros que suportam uma variedade maior de tipos de eventos e ativos. Consulte a seçãoDados de eventos de streaming.

Visualizar eventos de ativos específicos​

Você pode visualizar ou recuperar dados de eventos para ativos específicos no Portal do Cliente ou no Equinix API. Para acessar os dados do evento de um ativo, você deve ter uma função que conceda read permissões para esse ativo.

Portas​

  1. Faça login no Portal do Cliente e navegue até o Inventário de Portas .

  2. Selecione uma porta na lista.

  3. Na página de detalhes da porta, clique em Eventos.

    Captura de tela da guia Eventos de uma porta

Roteadores de cloud​

  1. Faça login no Portal do Cliente e navegue até o Inventário do Cloud Router .

  2. Selecione um roteador de cloud na lista.

  3. Na página de detalhes do roteador de cloud, clique em Eventos.

    Captura de tela da guia Eventos de um roteador

Conexões​

Os dados do evento estão disponíveis para Conexões Virtuais, onde uma porta ou roteador de cloud é o A-Side.

  1. Faça login no Portal do Cliente e navegue até seu Inventário de Conexões .

  2. Selecione uma conexão na lista

  3. Na página Detalhes da Conexão , clique em Eventos.

    Captura de tela da guia Eventos de uma conexão

Precision Time​

  1. Faça login no Portal do Cliente e navegue até seu Inventário de Tempo de Precisão .

  2. Selecione um serviço Precision Time na lista.

  3. Na página de detalhes do serviço, clique em Eventos.

Tokens de serviço​

Para ver os eventos de um token de serviço, envie uma GET solicitação ao /fabric/v4/{asset}/{assetId}/cloudeventsterminal. No caminho:

  • Especifique o asset como serviceTokens.
  • Especifique o assetID como o UUID do token de serviço.

Use os parâmetros opcionais fromDateTime e toDateTime de consulta para restringir os resultados a um período específico.

Exemplo de solicitação cURL:

curl -X GET 'https://api.equinix.com/fabric/v4/serviceTokens/<asset_id>/cloudevents?fromDateTime=<date_time>&toDateTime=<date_time>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Perfis da empresa​

Para ver os eventos de um Perfil da empresa, envie uma GET solicitação para o /fabric/v4/{asset}/{assetId}/cloudevents terminal. No caminho:

  • Especifique o asset como companyProfiles.
  • Especifique o assetID como o UUID do perfil da empresa.

Use os parâmetros opcionais fromDateTime e toDateTime de consulta para restringir os resultados a um período específico.

Exemplo de solicitação cURL:

curl -X GET 'https://api.equinix.com/fabric/v4/companyProfiles/<asset_id>/cloudevents?fromDateTime=<date_time>&toDateTime=<date_time>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Visualizar eventos do projeto​

Os dados de eventos do projeto incluem eventos suportados para todos os ativos no projeto, incluindo:

  • Portas
  • Roteadores de cloud
  • Conexões
  • Serviços de tempo de precisão
  • Perfis da empresa
  • Tokens de serviço
  • Dispositivos virtuais
  • Serviços de acesso à Internet
  • Perfis de serviço

Para ver os eventos de um projeto, envie uma GET solicitação para o /fabric/v4/{asset}/{assetId}/cloudevents terminal. No caminho:

  • Especifique o asset como projects.
  • Especifique o assetID como o UUID do projeto.

Use os parâmetros opcionais fromDateTime e toDateTime de consulta para restringir os resultados a um período específico.

Exemplo de solicitação cURL:

curl -X GET 'https://api.equinix.com/fabric/v4/projects/<asset_id>/cloudevents?fromDateTime=<date_time>&toDateTime=<date_time>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Visualizar eventos da organização​

Para ver os eventos de uma organização, envie uma GET solicitação para o /fabric/v4/{asset}/{assetId}/cloudevents terminal. No caminho:

  • Especifique o asset como organizations.
  • Especifique o assetID como o UUID da organização.

Use os parâmetros opcionais fromDateTime e toDateTime de consulta para restringir os resultados a um período específico.

Exemplo de solicitação cURL:

curl -X GET 'https://api.equinix.com/fabric/v4/organizations/<asset_id>/cloudevents?fromDateTime=<date_time>&toDateTime=<date_time>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Pesquisar Eventos​

O Equinix API permite pesquisar dados de eventos que correspondam a critérios especificados. Atualmente, os tipos de ativos suportados para chamadas de eventos de cloud são portas, conexões, roteadores, mercados estratégicos, organizações, projetos, dispositivos virtuais e perfis da empresa.

Para pesquisar um ativo nos eventos de nuvem, envie uma POST solicitação para o /fabric/v4/cloudevents/search terminal. Especifique seus critérios de pesquisa no corpo da solicitação. Além disso, o POST /fabric/v4/cloudevents/search endpoint requer que o sujeito tenha um UUID de recurso de primeiro nível obrigatório.

Exemplo de solicitação cURL:

curl -X POST 'https://api.equinix.com/fabric/v4/cloudevents/search' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer $TOKEN' \
-d '{
    "filter": {
        "and": [
            {
                "property": "/type",
                "operator": "IN",
                "values": [
                    "equinix.network_edge.device.*"
                ]
            },
            {
                "property": "/subject",
                "operator": "IN",
                "values": [
                    "/ne/v1/devices/903bb0ad-65cd-422c-94d3-a506cce0a36a*"
                ]
            },
            {
                "property": "/time",
                "operator": "BETWEEN",
                "values": [
                    "2025-08-15T17:31:00.000Z",
                    "2025-08-25T17:31:00.000Z"
                ]
            }
        ]
    },
    "pagination": {
        "offset": 0,
        "limit": 20
    }
}'

Uma lista completa de parâmetros pesquisáveis está disponível na Referência do API .

Obter detalhes do evento​

Para obter os detalhes de um evento de Cloud especificado, envie uma GET solicitação ao /fabric/v4/cloudevents/<cloudEventId>terminal.

Exemplo de solicitação cURL:

curl -X GET 'https://api.equinix.com/fabric/v4/cloudevents/<cloudEventId>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Dados de eventos de streaming​

O Equinix oferece suporte ao streaming de dados de eventos para uma plataforma de coleta de dados. Para configurar a coleta de dados:

Para obter uma lista de eventos disponíveis, consulte a lista de eventos suportados . Cada tipo de evento tem um esquema definido e todos os nossos esquemas de dados de eventos e tipos de dados são publicados no /equinix/equinix-cloudeventsrepositório GitHub.

Esta página foi útil?