Skip to content
Start here

Get Event

client.MagicTransit.Connectors.Events.Get(ctx, connectorID, eventT, eventN, query) (*ConnectorEventGetResponse, error)
GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/events/{event_t}.{event_n}

Get Event

Security
API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
Accepted Permissions (at least one required)
Magic WAN WriteMagic WAN Read
ParametersExpand Collapse
connectorID string
eventT float64
eventN float64
query ConnectorEventGetParams
AccountID param.Field[string]

Account identifier

maxLength32
ReturnsExpand Collapse
type ConnectorEventGetResponse struct{…}

Recorded Event

E ConnectorEventGetResponseE
One of the following:
type ConnectorEventGetResponseEInit struct{…}
K ConnectorEventGetResponseEInitK

Initialized process

type ConnectorEventGetResponseELeave struct{…}
K ConnectorEventGetResponseELeaveK

Stopped process

type ConnectorEventGetResponseEStartAttestation struct{…}
K ConnectorEventGetResponseEStartAttestationK

Started attestation

type ConnectorEventGetResponseEFinishAttestationSuccess struct{…}
K ConnectorEventGetResponseEFinishAttestationSuccessK

Finished attestation

type ConnectorEventGetResponseEFinishAttestationFailure struct{…}
K ConnectorEventGetResponseEFinishAttestationFailureK

Failed attestation

type ConnectorEventGetResponseEStartRotateCryptKey struct{…}
K ConnectorEventGetResponseEStartRotateCryptKeyK

Started crypt key rotation

type ConnectorEventGetResponseEFinishRotateCryptKeySuccess struct{…}
K ConnectorEventGetResponseEFinishRotateCryptKeySuccessK

Finished crypt key rotation

type ConnectorEventGetResponseEFinishRotateCryptKeyFailure struct{…}
K ConnectorEventGetResponseEFinishRotateCryptKeyFailureK

Failed crypt key rotation

type ConnectorEventGetResponseEStartRotatePki struct{…}
K ConnectorEventGetResponseEStartRotatePkiK

Started PKI rotation

type ConnectorEventGetResponseEFinishRotatePkiSuccess struct{…}
K ConnectorEventGetResponseEFinishRotatePkiSuccessK

Finished PKI rotation

type ConnectorEventGetResponseEFinishRotatePkiFailure struct{…}
K ConnectorEventGetResponseEFinishRotatePkiFailureK

Failed PKI rotation

type ConnectorEventGetResponseEStartUpgrade struct{…}
K ConnectorEventGetResponseEStartUpgradeK

Started upgrade

URL string

Location of upgrade bundle

type ConnectorEventGetResponseEFinishUpgradeSuccess struct{…}
K ConnectorEventGetResponseEFinishUpgradeSuccessK

Finished upgrade

type ConnectorEventGetResponseEFinishUpgradeFailure struct{…}
K ConnectorEventGetResponseEFinishUpgradeFailureK

Failed upgrade

type ConnectorEventGetResponseEReconcile struct{…}
K ConnectorEventGetResponseEReconcileK

Reconciled

type ConnectorEventGetResponseEConfigureCloudflaredTunnel struct{…}
K ConnectorEventGetResponseEConfigureCloudflaredTunnelK

Configured Cloudflared tunnel

type ConnectorEventGetResponseERekeyInstallBoth struct{…}
K ConnectorEventGetResponseERekeyInstallBothK

Installed initial inbound and outbound keys

TunnelID string

Tunnel identifier

type ConnectorEventGetResponseERekeyStart struct{…}
K ConnectorEventGetResponseERekeyStartK

Installed new inbound key, kept old outbound

TunnelID string

Tunnel identifier

type ConnectorEventGetResponseERekeyAdvance struct{…}
K ConnectorEventGetResponseERekeyAdvanceK

Confirmed traffic on new inbound key, swapped outbound to new

TunnelID string

Tunnel identifier

type ConnectorEventGetResponseERekeyComplete struct{…}
K ConnectorEventGetResponseERekeyCompleteK

Deleted old keys

TunnelID string

Tunnel identifier

type ConnectorEventGetResponseERekeyReset struct{…}
K ConnectorEventGetResponseERekeyResetK

Deleted all keys after receiving an unexpected key

TunnelID string

Tunnel identifier

N float64

Sequence number, used to order events with the same timestamp

T float64

Time the Event was recorded (seconds since the Unix epoch)

V stringOptional

Version

Get Event

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/cloudflare-go"
  "github.com/stainless-sdks/cloudflare-go/magic_transit"
  "github.com/stainless-sdks/cloudflare-go/option"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  event, err := client.MagicTransit.Connectors.Events.Get(
    context.TODO(),
    "connector_id",
    0.000000,
    0.000000,
    magic_transit.ConnectorEventGetParams{
      AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", event.E)
}
{
  "result": {
    "e": {
      "k": "Init"
    },
    "n": 0,
    "t": 0,
    "v": "v"
  },
  "success": true,
  "errors": [
    {
      "code": 0,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 0,
      "message": "message"
    }
  ]
}
Returns Examples
{
  "result": {
    "e": {
      "k": "Init"
    },
    "n": 0,
    "t": 0,
    "v": "v"
  },
  "success": true,
  "errors": [
    {
      "code": 0,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 0,
      "message": "message"
    }
  ]
}