thousandeyes-sdk-python/thousandeyes-sdk-test-results/README.md
2024-07-08 12:38:36 +00:00

214 lines
12 KiB
Markdown

# thousandeyes-sdk-test-results
Get test result metrics for Cloud and Enterprise Agent tests.
This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
- API version: 7.0.8
- Generator version: 7.6.0
- Build package: com.thousandeyes.api.codegen.ThousandeyesPythonGenerator
## Requirements.
Python 3.8+
## Installation & Usage
### pip install
If the python package is hosted on a repository, you can install directly using:
```sh
pip install -e git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git#egg=thousandeyes-sdk-test-results\&subdirectory=thousandeyes-sdk-test-results
```
(you may need to run `pip` with root permission: `sudo pip install -e git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git#egg=thousandeyes-sdk-test-results\&subdirectory=thousandeyes-sdk-test-results`)
Then import the package:
```python
import thousandeyes_sdk.test_results
```
### Setuptools
Install via [Setuptools](http://pypi.python.org/pypi/setuptools).
```sh
python setup.py install --user
```
(or `sudo python setup.py install` to install the package for all users)
Then import the package:
```python
import thousandeyes_sdk.test_results
```
### Tests
Execute `pytest` to run the tests.
## Getting Started
Please follow the [installation procedure](#installation--usage) and then run the following:
```python
import thousandeyes_sdk.core
import thousandeyes_sdk.test_results
from thousandeyes_sdk.core.exceptions import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://api.thousandeyes.com
# See configuration.py for a list of all supported configuration parameters.
configuration = thousandeyes_sdk.core.Configuration(
host = "https://api.thousandeyes.com"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure Bearer authorization: BearerAuth
configuration = thousandeyes_sdk.core.Configuration(
access_token = os.environ["BEARER_TOKEN"]
)
# Enter a context with an instance of the API client
with thousandeyes_sdk.core.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = thousandeyes_sdk.test_results.APITestMetricsApi(api_client)
test_id = '202701' # str | Test ID
agent_id = '11' # str | Agent ID
round_id = '1384309800' # str | Round ID
aid = '1234' # str | A unique identifier associated with your account group. You can retrieve your `AccountGroupId` from the `/account-groups` endpoint. Note that you must be assigned to the target account group. Specifying this parameter without being assigned to the target account group will result in an error response. (optional)
try:
# Get API test results by agent and round
api_response = api_instance.get_test_api_agent_round_results(test_id, agent_id, round_id, aid=aid)
print("The response of APITestMetricsApi->get_test_api_agent_round_results:\n")
pprint(api_response)
except ApiException as e:
print("Exception when calling APITestMetricsApi->get_test_api_agent_round_results: %s\n" % e)
```
## Documentation for API Endpoints
All URIs are relative to *https://api.thousandeyes.com*
Class | Method | HTTP request | Description
------------ | ------------- | ------------- | -------------
*APITestMetricsApi* | [**get_test_api_agent_round_results**](docs/APITestMetricsApi.md#get_test_api_agent_round_results) | **GET** /v7/test-results/{testId}/api/agent/{agentId}/round/{roundId} | Get API test results by agent and round
*APITestMetricsApi* | [**get_test_api_results**](docs/APITestMetricsApi.md#get_test_api_results) | **GET** /v7/test-results/{testId}/api | Get API test results
*DNSSECTestMetricsApi* | [**get_test_dns_sec_results**](docs/DNSSECTestMetricsApi.md#get_test_dns_sec_results) | **GET** /v7/test-results/{testId}/dnssec | Get DNSSEC test results
*DNSServerTestMetricsApi* | [**get_test_dns_server_result**](docs/DNSServerTestMetricsApi.md#get_test_dns_server_result) | **GET** /v7/test-results/{testId}/dns-server/{serverId} | Get DNS server test results by server
*DNSServerTestMetricsApi* | [**get_test_dns_servers_results**](docs/DNSServerTestMetricsApi.md#get_test_dns_servers_results) | **GET** /v7/test-results/{testId}/dns-server | Get DNS server test results
*DNSTraceTestMetricsApi* | [**get_test_dns_trace_results**](docs/DNSTraceTestMetricsApi.md#get_test_dns_trace_results) | **GET** /v7/test-results/{testId}/dns-trace | Get DNS trace test results
*NetworkBGPTestMetricsApi* | [**get_test_bgp_results**](docs/NetworkBGPTestMetricsApi.md#get_test_bgp_results) | **GET** /v7/test-results/{testId}/bgp | Get BGP test results
*NetworkBGPTestMetricsApi* | [**get_test_bgp_routes_prefix_round_results**](docs/NetworkBGPTestMetricsApi.md#get_test_bgp_routes_prefix_round_results) | **GET** /v7/test-results/{testId}/bgp/routes/prefix/{prefixId}/round/{roundId} | Get BGP route test results by prefix
*NetworkTestMetricsApi* | [**get_test_network_results**](docs/NetworkTestMetricsApi.md#get_test_network_results) | **GET** /v7/test-results/{testId}/network | Get network test results
*NetworkTestMetricsApi* | [**get_test_path_vis_agent_round_results**](docs/NetworkTestMetricsApi.md#get_test_path_vis_agent_round_results) | **GET** /v7/test-results/{testId}/path-vis/agent/{agentId}/round/{roundId} | Get path visualization test results by agent and round
*NetworkTestMetricsApi* | [**get_test_path_vis_results**](docs/NetworkTestMetricsApi.md#get_test_path_vis_results) | **GET** /v7/test-results/{testId}/path-vis | Get path visualization network test results
*VoiceRTPServerTestMetricsApi* | [**get_test_rtp_server_results**](docs/VoiceRTPServerTestMetricsApi.md#get_test_rtp_server_results) | **GET** /v7/test-results/{testId}/rtp-server | Retrieve RTP server test metrics
*VoiceSIPServerTestMetricsApi* | [**get_test_sip_server_results**](docs/VoiceSIPServerTestMetricsApi.md#get_test_sip_server_results) | **GET** /v7/test-results/{testId}/sip-server | Get SIP server test results
*WebFTPServerTestMetricsApi* | [**get_test_ftp_server_results**](docs/WebFTPServerTestMetricsApi.md#get_test_ftp_server_results) | **GET** /v7/test-results/{testId}/ftp-server | Get FTP server test results
*WebHTTPServerTestMetricsApi* | [**get_test_http_server_results**](docs/WebHTTPServerTestMetricsApi.md#get_test_http_server_results) | **GET** /v7/test-results/{testId}/http-server | Get HTTP server test results
*WebPageLoadTestMetricsApi* | [**get_test_page_load_agent_round_results**](docs/WebPageLoadTestMetricsApi.md#get_test_page_load_agent_round_results) | **GET** /v7/test-results/{testId}/page-load/agent/{agentId}/round/{roundId} | Get page load server test results by agent and round
*WebPageLoadTestMetricsApi* | [**get_test_page_load_results**](docs/WebPageLoadTestMetricsApi.md#get_test_page_load_results) | **GET** /v7/test-results/{testId}/page-load | Get page load server test results
*WebTransactionsTestMetricsApi* | [**get_test_web_transaction_agent_round_page_results**](docs/WebTransactionsTestMetricsApi.md#get_test_web_transaction_agent_round_page_results) | **GET** /v7/test-results/{testId}/web-transactions/agent/{agentId}/round/{roundId}/page/{pageId} | Get detailed web transactions test result by agent, round, and page
*WebTransactionsTestMetricsApi* | [**get_test_web_transaction_agent_round_results**](docs/WebTransactionsTestMetricsApi.md#get_test_web_transaction_agent_round_results) | **GET** /v7/test-results/{testId}/web-transactions/agent/{agentId}/round/{roundId} | Get web transactions test results by agent and round
*WebTransactionsTestMetricsApi* | [**get_test_web_transaction_results**](docs/WebTransactionsTestMetricsApi.md#get_test_web_transaction_results) | **GET** /v7/test-results/{testId}/web-transactions | Get web transactions test results
## Documentation For Models
- [Agent](docs/Agent.md)
- [ApiDetailTestResult](docs/ApiDetailTestResult.md)
- [ApiDetailTestResults](docs/ApiDetailTestResults.md)
- [ApiRequestDetail](docs/ApiRequestDetail.md)
- [ApiRequestDetailAssertion](docs/ApiRequestDetailAssertion.md)
- [ApiTestResult](docs/ApiTestResult.md)
- [ApiTestResults](docs/ApiTestResults.md)
- [AppLinks](docs/AppLinks.md)
- [BgpBasicTestResult](docs/BgpBasicTestResult.md)
- [BgpHop](docs/BgpHop.md)
- [BgpTestResult](docs/BgpTestResult.md)
- [BgpTestResults](docs/BgpTestResults.md)
- [BgpTestRouteInformationResult](docs/BgpTestRouteInformationResult.md)
- [BgpTestRouteInformationResults](docs/BgpTestRouteInformationResults.md)
- [DnsServerTestResult](docs/DnsServerTestResult.md)
- [DnsServerTestResults](docs/DnsServerTestResults.md)
- [DnsTraceTestResult](docs/DnsTraceTestResult.md)
- [DnsTraceTestResults](docs/DnsTraceTestResults.md)
- [DnssecTestResult](docs/DnssecTestResult.md)
- [DnssecTestResults](docs/DnssecTestResults.md)
- [EpochTimeWindow](docs/EpochTimeWindow.md)
- [Error](docs/Error.md)
- [Expand](docs/Expand.md)
- [FtpServerTestResult](docs/FtpServerTestResult.md)
- [FtpServerTestResults](docs/FtpServerTestResults.md)
- [HttpTestResult](docs/HttpTestResult.md)
- [HttpTestResultHeaders](docs/HttpTestResultHeaders.md)
- [HttpTestResults](docs/HttpTestResults.md)
- [Link](docs/Link.md)
- [Marker](docs/Marker.md)
- [Monitor](docs/Monitor.md)
- [NetworkTestResult](docs/NetworkTestResult.md)
- [NetworkTestResults](docs/NetworkTestResults.md)
- [Page](docs/Page.md)
- [PageLoadDetailTestResult](docs/PageLoadDetailTestResult.md)
- [PageLoadDetailTestResults](docs/PageLoadDetailTestResults.md)
- [PageLoadTestResult](docs/PageLoadTestResult.md)
- [PageLoadTestResults](docs/PageLoadTestResults.md)
- [PaginationLinks](docs/PaginationLinks.md)
- [PathVisBaseTestResult](docs/PathVisBaseTestResult.md)
- [PathVisDetailTestResult](docs/PathVisDetailTestResult.md)
- [PathVisDetailTestResults](docs/PathVisDetailTestResults.md)
- [PathVisDirection](docs/PathVisDirection.md)
- [PathVisEndpoint](docs/PathVisEndpoint.md)
- [PathVisHop](docs/PathVisHop.md)
- [PathVisRoute](docs/PathVisRoute.md)
- [PathVisTestResult](docs/PathVisTestResult.md)
- [PathVisTestResults](docs/PathVisTestResults.md)
- [RtpStreamTestResult](docs/RtpStreamTestResult.md)
- [RtpStreamTestResults](docs/RtpStreamTestResults.md)
- [SelfLinks](docs/SelfLinks.md)
- [SimpleTest](docs/SimpleTest.md)
- [SipServerErrorType](docs/SipServerErrorType.md)
- [SipServerTestResult](docs/SipServerTestResult.md)
- [SipServerTestResults](docs/SipServerTestResults.md)
- [SslCert](docs/SslCert.md)
- [TestDirection](docs/TestDirection.md)
- [TestInterval](docs/TestInterval.md)
- [TestLinks](docs/TestLinks.md)
- [TestResult](docs/TestResult.md)
- [TestResultAppLinks](docs/TestResultAppLinks.md)
- [TestSelfLink](docs/TestSelfLink.md)
- [TestType](docs/TestType.md)
- [UnauthorizedError](docs/UnauthorizedError.md)
- [ValidationError](docs/ValidationError.md)
- [ValidationErrorItem](docs/ValidationErrorItem.md)
- [WebTransactionDetailTestResult](docs/WebTransactionDetailTestResult.md)
- [WebTransactionDetailTestResults](docs/WebTransactionDetailTestResults.md)
- [WebTransactionPageDetailTestResult](docs/WebTransactionPageDetailTestResult.md)
- [WebTransactionPageDetailTestResults](docs/WebTransactionPageDetailTestResults.md)
- [WebTransactionTestResult](docs/WebTransactionTestResult.md)
- [WebTransactionTestResults](docs/WebTransactionTestResults.md)
<a id="documentation-for-authorization"></a>
## Documentation For Authorization
Authentication schemes defined for the API:
<a id="BearerAuth"></a>
### BearerAuth
- **Type**: Bearer authentication
## Author