Instant test

POST https://{{base_url}}/v6/instant/{{testType}}

Instant test

Creates and runs a new Instant test in ThousandEyes, based on properties provided in the POST data. In order to create and run an Instant test, the user attempting the creation must be a Regular user or have the following permissions: * API Access * View tests

Optional (Querystring) Parameters

• aid={aid} optional and requires the user to be assigned to the target account group, specifies the account group context of the request, obtained from the /account-groups endpoint. Specifying this parameter without the user being assigned to the target account will result in an error response. See Account group context for more information

Request

• {testType} corresponds to any of the following options:

  • agent-to-agent
  • agent-to-server
  • http-server
  • page-load
  • transactions
  • web-transactions
  • ftp-server
  • dns-trace
  • dns-server
  • dns-dnssec
  • dnsp-domain
  • dnsp-server
  • sip-server
  • voice (RTP Stream) Note: bgp tests are currently not supported

• Request body should contain fields to be set during creation. See the Test Metadata page for fields available during test creation. The following fields are accepted but will be ignored by the Instant test API:

  • interval
  • subinterval
  • alertsEnabled
  • alertRules
  • bgpMeasurements
  • bgpMonitors

Request Body

{"agents"=>[{"agentId"=>55521}], "testName"=>"Postman - developer.cisco.com", "server"=>"developer.cisco.com"}

HEADERS