Sandboxgebeurtenissen

Sandboxgebeurtenissen bieden een doorzoekbare tijdlijn van belangrijke bewerkingen in de levenscyclus van een sandbox. Je kunt gebeurtenissen gebruiken voor probleemoplossing, auditing, gebruiksanalyse en afstemming van facturering.

Sandboxgebeurtenissen opvragen

Gebruik de events API om sandboxgebeurtenissen voor je account weer te geven. Je kunt gebeurtenissen filteren op sandbox, template, gebeurtenistype, status en tijdsbereik.

Gebeurtenissen opvragen met de SDK’s

import { Sandbox } from 'novita-sandbox'

const result = await Sandbox.getEvents({
  sandboxID: 'iq721h44siv24wmyrh5oc',
  events: ['create', 'pause', 'resume', 'connect', 'timeout', 'delete'],
  limit: 10,
  offset: 0,
})

console.log('Events:', result.items)

if (result.hasMore) {
  const nextPage = await Sandbox.getEvents({
    sandboxID: 'iq721h44siv24wmyrh5oc',
    limit: 10,
    offset: 10,
  })

  console.log('Next page:', nextPage.items)
}

from novita_sandbox.core import Sandbox

result = Sandbox.get_events(
    sandbox_id="iq721h44siv24wmyrh5oc",
    events=["create", "pause", "resume", "connect", "timeout", "delete"],
    limit=10,
    offset=0,
)

print("Events:", result.items)

if result.has_more:
    next_page = Sandbox.get_events(
        sandbox_id="iq721h44siv24wmyrh5oc",
        limit=10,
        offset=10,
    )

    print("Next page:", next_page.items)

Gebeurtenissen opvragen voor een sandboxinstantie

Als je al een sandboxinstantie hebt, gebruik dan de events-methode op instantieniveau om gebeurtenissen voor die sandbox op te vragen.

import { Sandbox } from 'novita-sandbox'

const sandbox = await Sandbox.create()
const result = await sandbox.getEvents({
  events: ['create', 'pause', 'resume', 'connect', 'timeout', 'delete'],
  limit: 10,
})

console.log(result.items)

from novita_sandbox.core import Sandbox

sandbox = Sandbox.create()
result = sandbox.get_events(
    events=["create", "pause", "resume", "connect", "timeout", "delete"],
    limit=10,
)

print(result.items)

Gebeurtenissen filteren

Gebruik queryparameters om de gebeurtenistijdlijn te verfijnen.

Optie	Type	Vereist	Standaard / Limiet	Beschrijving
`startTime`	`int64`	Nee	Standaard `endTime - 30 days`	Begintijd van de query als een Unix-tijdstempel in seconden. Het bereik is inclusief.
`endTime`	`int64`	Nee	Standaard de huidige tijd	Eindtijd van de query als een Unix-tijdstempel in seconden. Moet groter zijn dan `startTime`.
`sandboxID`	`string`	Nee	-	Filter op sandbox-ID. Gedeeltelijke overeenkomsten worden ondersteund.
`templateID`	`string`	Nee	-	Filter op template-ID. Gedeeltelijke overeenkomsten worden ondersteund.
`events`	`string`	Nee	Standaard de set met sleutelgebeurtenissen	Door komma’s gescheiden gebeurtenistypen. De huidige set met sleutelgebeurtenissen is `create`, `pause`, `resume`, `connect`, `timeout` en `delete`.
`state`	`string`	Nee	-	Filter op gebeurtenisstatus, zoals `success` of een foutstatus.
`orderAsc`	`bool`	Nee	`false`	Sorteer gebeurtenissen op `recordAt` in oplopende volgorde. Standaard worden gebeurtenissen in aflopende volgorde geretourneerd.
`offset`	`int32`	Nee	Standaard `0`, minimum `0`	Aantal gebeurtenissen dat moet worden overgeslagen.
`limit`	`int32`	Nee	Standaard `10`, minimum `1`, maximum `100`	Maximumaantal gebeurtenissen dat moet worden geretourneerd.

Tijdvelden gebruiken Unix-tijdstempels in seconden. Geef geen tijdstempels in milliseconden door.Het maximale tijdsbereik voor een query is 60 dagen. Voor langere tijdlijnen splits je verzoeken op in meerdere kleinere tijdsbereiken.

Paginering

Gebeurtenissen gebruiken paginering op basis van offset. Begin met offset: 0; als hasMore true is, vraag dan de volgende pagina op met offset + limit. De maximale limit is 100.

Responsvelden

De events-respons bevat een items-array en pagineringsmetadata.

Veld	Beschrijving
`items`	Lijst met sandboxgebeurtenissen die overeenkomen met de query.
`total`	Totaalaantal gebeurtenissen dat overeenkomt met de query, vóór paginering.
`hasMore`	Of er meer gebeurtenissen beschikbaar zijn na de huidige pagina.

Elk item in items heeft de volgende velden.

Veld	Beschrijving
`eventID`	Unieke gebeurtenis-ID.
`recordAt`	Registratietijd van de gebeurtenis als een Unix-tijdstempel in seconden.
`templateID`	Template-ID die door de sandbox wordt gebruikt.
`templateName`	Templatenaam die door de sandbox wordt gebruikt.
`sandboxID`	Sandbox-ID.
`eventName`	Gebeurtenistype, zoals `create`, `pause`, `resume`, `connect`, `timeout` of `delete`.
`state`	Gebeurtenisstatus.
`errorMsg`	Foutmelding wanneer de gebeurtenis is mislukt of een uitzondering is opgetreden. Meestal leeg wanneer er geen fout is.
`statusCode`	HTTP-statuscode die aan de bewerking is gekoppeld, indien beschikbaar.

Voorbeeldrespons

{
  "items": [
    {
      "eventID": "evt_123",
      "recordAt": 1766650000,
      "templateID": "tmpl_abc",
      "templateName": "ubuntu-base",
      "sandboxID": "i3vrzzatkxojecvfuesnz",
      "eventName": "create",
      "state": "success",
      "errorMsg": "",
      "statusCode": 200
    }
  ],
  "total": 1,
  "hasMore": false
}

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources