{"type":"model","meta":{"id":"/apps/pubhub/media/000-v7-apis/5b3454a4300b838cc17f7b2cdc0690fdd15058d5/78f45443-a63d-31b5-a066-5ca5d2bfbb18","info":{"description":"This API supports listing, creating, editing, and deleting Cloud and Enterprise Agent (CEA) based tests.\n","title":"Tests API","version":"7.0.34"},"security":[{"BearerAuth":[]}],"tags":[{"description":"Get all tests","name":"Tests"},{"description":"Agent to Server test management operations","name":"Agent to Server Tests"},{"description":"Agent to Agent test management operations","name":"Agent to Agent Tests"},{"description":"BGP test management operations","name":"BGP Tests"},{"description":"DNS Server test management operations","name":"DNS Server Tests"},{"description":"DNS Trace test management operations","name":"DNS Trace Tests"},{"description":"DNSSEC test management operations","name":"DNSSEC Tests"},{"description":"HTTP Server test management operations","name":"HTTP Server Tests"},{"description":"Page Load test management operations","name":"Page Load Tests"},{"description":"Web Transactions test management operations","name":"Web Transaction Tests"},{"description":"API test management operations","name":"API Tests"},{"description":"FTP Server test management operations","name":"FTP Server Tests"},{"description":"SIP Server test management operations","name":"SIP Server Tests"},{"description":"Voice test management operations","name":"Voice Tests"},{"name":"Path Visualization Interface Groups"}],"externalDocs":{"description":"Find out more about Cloud and Enterprise Agent-Based Tests","url":"https://docs.thousandeyes.com/product-documentation/internet-and-wan-monitoring/tests#cloud-and-enterprise-agent-based-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"}}