{"type":"model","meta":{"id":"/apps/pubhub/media/000-v7-apis/5b3454a4300b838cc17f7b2cdc0690fdd15058d5/202e6e17-f3af-335e-a547-da4402ccdd8d","info":{"description":"The Instant Tests API operations lets you create and run new instant tests. You will need to be a regular user or have the following permissions:\n * `API Access`\n * `View tests`\n\nThe response does not include the immediate test results. Use the Test Results endpoints to get test results after creating and executing an instant test. You can find the URLs for these endpoints in the _links section of the test definition that is returned when you create the instant test.\n","title":"Instant Tests API","version":"7.0.34"},"security":[{"BearerAuth":[]}],"tags":[{"name":"Instant Tests"},{"name":"Agent to Agent Instant Tests"},{"name":"Agent to Server Instant Tests"},{"name":"DNS Server Instant Tests"},{"name":"DNS Trace Instant Tests"},{"name":"DNSSEC Instant Tests"},{"name":"HTTP Server Instant Tests"},{"name":"HTTP Page Load Instant Tests"},{"name":"Web Transaction Instant Tests"},{"name":"API Instant Tests"},{"name":"FTP Server Instant Tests"},{"name":"SIP Server Instant Tests"},{"name":"Voice Instant Tests"}],"externalDocs":{"description":"Find out more about Instant Tests.","url":"https://docs.thousandeyes.com/product-documentation/internet-and-wan-monitoring/tests/working-with-instant-tests"},"openapi":"3.0.1","servers":[{"description":"ThousandEyes API production URL","url":"https://api.thousandeyes.com/v7"}],"securitySchemes":{"BearerAuth":{"description":"Bearer authentication token","scheme":"bearer","type":"http"}}},"spec":{"properties":{"authType":{"default":"none","description":"HTTP authentication type.","enum":["none","basic","ntlm","kerberos","oauth"],"example":"none","type":"string","$$ref":"#/components/schemas/TestAuthType"},"agentInterfaces":{"properties":{"ipAddress":{"description":"IP address of the agent interface.","example":"192.1.1.0","type":"string"},"agentId":{"description":"The agent ID of the enterprise agent for the test.","example":"2954","type":"string"}},"type":"object","$$ref":"#/components/schemas/AgentInterfaces"},"bandwidthMeasurements":{"description":"Set to `true` to enable bandwidth measurements, only applies to Enterprise agents assigned to the test.","example":true,"type":"boolean"},"clientCertificate":{"description":"String representation (containing newline characters) of client certificate, the private key must be placed first, then the certificate.","example":"-----BEGIN PRIVATE KEY-----\nMIICUTCCAfugAwIBAgIBADANBgkqhkiG9w0BAQQFADBXMQswCQYDVQQGEwJDTjEL\n-----END PRIVATE KEY-----\n-----BEGIN CERTIFICATE-----\nMIICUTCCAfugAwIBAgIBADANBgkqhkiG9w0BAQQFADBXMQswCQYDVQQGEwJDTjEL\n-----END CERTIFICATE-----\n","type":"string"},"contentRegex":{"description":"Content regex, this field does not require escaping.","example":"(regex)+","type":"string"},"customHeaders":{"example":{"root":{"header1":"value1"},"domains":{"domain1.com":{"header2":"value2"}},"all":{"header3":"value3"}},"properties":{"root":{"additionalProperties":{"type":"string"},"description":"Use these HTTP headers for root server request.","type":"object"},"domains":{"additionalProperties":{"additionalProperties":{"type":"string"},"type":"object"},"description":"Use these HTTP headers for the specified domains.","type":"object"},"all":{"additionalProperties":{"type":"string"},"description":"Use these HTTP headers for all domains.","type":"object"}},"type":"object","$$ref":"#/components/schemas/TestCustomHeaders"},"desiredStatusCode":{"default":"default","description":"Specify the HTTP status code value that indicates a successful response. The default value accepts any 2xx or 3xx status code.","example":"200","type":"string"},"downloadLimit":{"description":"Specifies maximum number of bytes to download from the target object.","example":2048,"type":"integer"},"dnsOverride":{"description":"IP address to use for DNS override.","example":"8.8.8.8","format":"ipv4","type":"string"},"httpTargetTime":{"description":"Target time for HTTP server completion, specified in milliseconds.","example":100,"maximum":5000,"minimum":100,"type":"integer"},"httpTimeLimit":{"default":5,"description":"HTTP time limit in seconds.","example":5,"maximum":60,"minimum":5,"type":"integer"},"httpVersion":{"default":2,"description":"HTTP protocol version. Set to '2' to prefer HTTP/2, or '1' to use only HTTP/1.1.","example":2,"maximum":2,"minimum":1,"type":"integer"},"includeHeaders":{"default":true,"description":"Set to `true` to capture response headers for objects loaded by the test.","example":true,"type":"boolean"},"mtuMeasurements":{"description":"Set `true` to measure MTU sizes on network from agents to the target.","example":false,"type":"boolean"},"networkMeasurements":{"default":true,"description":"Enable or disable network measurements. Set to true to enable or false to disable network measurements.","example":true,"type":"boolean"},"numPathTraces":{"default":3,"description":"Number of path traces executed by the agent.","example":3,"maximum":10,"minimum":1,"type":"integer"},"oAuth":{"description":"Use this only if you want to use OAuth as the authentication mechanism.","example":{"configId":"123321123","testUrl":"https://api.thousandeyes.com/v7/status","requestMethod":"get","postBody":"client_id: ************","headers":"Authorization: Basic ************","authType":"none","username":"user123","password":"*******"},"properties":{"configId":{"description":"The ID of the OAuth configuration.","type":"string"},"testUrl":{"description":"Target for the test.","example":"www.thousandeyes.com","type":"string"},"requestMethod":{"description":"HTTP request method.","enum":["get","post","put","delete","patch","options","trace"],"example":"get","type":"string","$$ref":"#/components/schemas/RequestMethod"},"postBody":{"description":"Enter the OAuth body for the HTTP POST request in this field when using OAuth as the authentication mechanism. No special escaping is required. If content is provided in the post body, the `requestMethod` is automatically set to POST.","type":"string"},"headers":{"description":"Request headers used for OAuth.","type":"string"},"authType":{"default":"none","description":"HTTP authentication type.","enum":["none","basic","ntlm","kerberos","oauth"],"example":"none","type":"string","$$ref":"#/components/schemas/TestAuthType"},"username":{"description":"OAuth username","type":"string"},"password":{"description":"OAuth password","type":"string"}},"type":"object","$$ref":"#/components/schemas/OAuth"},"password":{"description":"Password for Basic/NTLM authentication.","example":"password","type":"string","writeOnly":true},"pathTraceMode":{"default":"classic","description":"Select `inSession` to perform the path trace within a TCP session.","enum":["classic","in-session"],"example":"classic","type":"string","$$ref":"#/components/schemas/TestPathTraceMode"},"probeMode":{"default":"auto","description":"Probe mode used by network test, only valid when the protocol is set to TCP.","enum":["auto","sack","syn"],"example":"auto","type":"string","$$ref":"#/components/schemas/TestProbeMode"},"protocol":{"default":"tcp","description":"Protocol used by dependent network tests (end-to-end, path trace, PMTUD).","enum":["tcp","icmp","udp"],"example":"tcp","type":"string","$$ref":"#/components/schemas/TestProtocol"},"sslVersion":{"description":"Reflects the verbose SSL protocol version used by a test.","example":"Auto","readOnly":true,"type":"string"},"sslVersionId":{"default":"0","description":"SSL version options:\n\n* Use '0' for automatic selection.\n* Use '3' for SSLv3.\n* Use '4' for TLS v1.0.\n* Use '5' for TLS v1.1.\n* Use '6' for TLS v1.2.\n","enum":["0","3","4","5","6"],"example":"0","type":"string","$$ref":"#/components/schemas/TestSslVersionId"},"url":{"description":"Target for the test.","example":"www.thousandeyes.com","type":"string"},"useNtlm":{"description":"Set to true to use NTLM, false to use Basic Authentication. Requires username and password to be set.","example":false,"type":"boolean"},"userAgent":{"description":"User-agent string to be provided during the test.","example":"curl","type":"string"},"username":{"description":"Username for Basic/NTLM authentication.","example":"username","type":"string"},"verifyCertificate":{"default":false,"description":"Ignore or acknowledge certificate errors. Set to false to ignore certificate errors.","example":false,"type":"boolean"},"allowUnsafeLegacyRenegotiation":{"default":true,"description":"Allows TLS renegotiation with servers not supporting RFC 5746. Default Set to true to allow unsafe legacy renegotiation.","example":true,"type":"boolean"},"followRedirects":{"default":true,"description":"To disable following HTTP/301 or HTTP/302 redirect directives, set this parameter to `false`.","example":true,"type":"boolean"},"fixedPacketRate":{"description":"Sets packets rate sent to measure the network in packets per second.","example":50,"maximum":100,"minimum":0,"type":"integer"},"overrideAgentProxy":{"default":false,"description":"Flag indicating if a proxy other than the default should be used. To override the default proxy for agents, set to `true` and specify a value for `overrideProxyId`.","example":false,"type":"boolean"},"overrideProxyId":{"description":"ID of the proxy to be used if the default proxy is overridden.","example":"281474976710706","type":"string"},"collectProxyNetworkData":{"default":false,"description":"Indicates whether network data to the proxy should be collected.","example":false,"type":"boolean"}},"type":"object","$$ref":"#/components/schemas/HttpServerBaseProperties","title":"HttpServerBaseProperties"}}