# thousandeyes-sdk-dashboards
Manage ThousandEyes Dashboards.
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-dashboards\&subdirectory=thousandeyes-sdk-dashboards
```
(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-dashboards\&subdirectory=thousandeyes-sdk-dashboards`)
Then import the package:
```python
import thousandeyes_sdk.dashboards
```
### 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.dashboards
```
### 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.dashboards
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.dashboards.DashboardSnapshotsApi(api_client)
generate_dashboard_snapshot_request = thousandeyes_sdk.dashboards.GenerateDashboardSnapshotRequest() # GenerateDashboardSnapshotRequest | Request body schema to create a dashboard snapshot.
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:
# Create dashboard snapshot
api_response = api_instance.create_dashboard_snapshot(generate_dashboard_snapshot_request, aid=aid)
print("The response of DashboardSnapshotsApi->create_dashboard_snapshot:\n")
pprint(api_response)
except ApiException as e:
print("Exception when calling DashboardSnapshotsApi->create_dashboard_snapshot: %s\n" % e)
```
## Documentation for API Endpoints
All URIs are relative to *https://api.thousandeyes.com*
Class | Method | HTTP request | Description
------------ | ------------- | ------------- | -------------
*DashboardSnapshotsApi* | [**create_dashboard_snapshot**](docs/DashboardSnapshotsApi.md#create_dashboard_snapshot) | **POST** /v7/dashboard-snapshots | Create dashboard snapshot
*DashboardSnapshotsApi* | [**delete_dashboard_snapshot**](docs/DashboardSnapshotsApi.md#delete_dashboard_snapshot) | **DELETE** /v7/dashboard-snapshots/{snapshotId} | Delete dashboard snapshot
*DashboardSnapshotsApi* | [**get_dashboard_snapshot**](docs/DashboardSnapshotsApi.md#get_dashboard_snapshot) | **GET** /v7/dashboard-snapshots/{snapshotId} | Retrieve dashboard snapshot
*DashboardSnapshotsApi* | [**get_dashboard_snapshot_widget_data**](docs/DashboardSnapshotsApi.md#get_dashboard_snapshot_widget_data) | **GET** /v7/dashboard-snapshots/{snapshotId}/widgets/{widgetId} | Retrieve dashboard snapshot data
*DashboardSnapshotsApi* | [**get_dashboard_snapshots**](docs/DashboardSnapshotsApi.md#get_dashboard_snapshots) | **GET** /v7/dashboard-snapshots | List dashboard snapshots
*DashboardSnapshotsApi* | [**update_dashboard_snapshot_expiration_date**](docs/DashboardSnapshotsApi.md#update_dashboard_snapshot_expiration_date) | **PATCH** /v7/dashboard-snapshots/{snapshotId} | Update snapshot expiration
*DashboardsApi* | [**create_dashboard**](docs/DashboardsApi.md#create_dashboard) | **POST** /v7/dashboards | Create dashboard
*DashboardsApi* | [**delete_dashboard**](docs/DashboardsApi.md#delete_dashboard) | **DELETE** /v7/dashboards/{dashboardId} | Delete dashboard
*DashboardsApi* | [**get_dashboard**](docs/DashboardsApi.md#get_dashboard) | **GET** /v7/dashboards/{dashboardId} | Retrieve dashboard
*DashboardsApi* | [**get_dashboard_widget_data**](docs/DashboardsApi.md#get_dashboard_widget_data) | **GET** /v7/dashboards/{dashboardId}/widgets/{widgetId} | Retrieve dashboard widget data
*DashboardsApi* | [**get_dashboards**](docs/DashboardsApi.md#get_dashboards) | **GET** /v7/dashboards | List dashboards
*DashboardsApi* | [**update_dashboard**](docs/DashboardsApi.md#update_dashboard) | **PUT** /v7/dashboards/{dashboardId} | Update dashboard
*DashboardsFiltersApi* | [**create_dashboard_filter**](docs/DashboardsFiltersApi.md#create_dashboard_filter) | **POST** /v7/dashboards/filters | Create dashboard filter
*DashboardsFiltersApi* | [**delete_dashboard_filter**](docs/DashboardsFiltersApi.md#delete_dashboard_filter) | **DELETE** /v7/dashboards/filters/{id} | Delete dashboard filter
*DashboardsFiltersApi* | [**get_dashboard_filter**](docs/DashboardsFiltersApi.md#get_dashboard_filter) | **GET** /v7/dashboards/filters/{id} | Get dashboard filter
*DashboardsFiltersApi* | [**get_dashboards_filters**](docs/DashboardsFiltersApi.md#get_dashboards_filters) | **GET** /v7/dashboards/filters | List dashboard filters
*DashboardsFiltersApi* | [**update_dashboard_filter**](docs/DashboardsFiltersApi.md#update_dashboard_filter) | **PUT** /v7/dashboards/filters/{id} | Update dashboard filter
## Documentation For Models
- [ActiveWithin](docs/ActiveWithin.md)
- [AgentStatusDatasource](docs/AgentStatusDatasource.md)
- [AlertListAlertType](docs/AlertListAlertType.md)
- [AlertListDatasource](docs/AlertListDatasource.md)
- [ApiAgentLocation](docs/ApiAgentLocation.md)
- [ApiAgentStatusAgent](docs/ApiAgentStatusAgent.md)
- [ApiAgentStatusIpInfo](docs/ApiAgentStatusIpInfo.md)
- [ApiAgentStatusSummary](docs/ApiAgentStatusSummary.md)
- [ApiAgentStatusWidget](docs/ApiAgentStatusWidget.md)
- [ApiAgentWidgetShow](docs/ApiAgentWidgetShow.md)
- [ApiAgentWidgetType](docs/ApiAgentWidgetType.md)
- [ApiAggregateProperty](docs/ApiAggregateProperty.md)
- [ApiAlertListAlert](docs/ApiAlertListAlert.md)
- [ApiAlertListWidget](docs/ApiAlertListWidget.md)
- [ApiBoxAndWhiskersWidget](docs/ApiBoxAndWhiskersWidget.md)
- [ApiColorGridWidget](docs/ApiColorGridWidget.md)
- [ApiContextFilterRequest](docs/ApiContextFilterRequest.md)
- [ApiContextFilterResponse](docs/ApiContextFilterResponse.md)
- [ApiContextFiltersResponse](docs/ApiContextFiltersResponse.md)
- [ApiDashboard](docs/ApiDashboard.md)
- [ApiDashboardAsw](docs/ApiDashboardAsw.md)
- [ApiDashboardFilterUserDetails](docs/ApiDashboardFilterUserDetails.md)
- [ApiDashboardSnapshot](docs/ApiDashboardSnapshot.md)
- [ApiDataPointGroup](docs/ApiDataPointGroup.md)
- [ApiDataSourceFilter](docs/ApiDataSourceFilter.md)
- [ApiDataSourceFilters](docs/ApiDataSourceFilters.md)
- [ApiDefaultTimespan](docs/ApiDefaultTimespan.md)
- [ApiDuration](docs/ApiDuration.md)
- [ApiDurationUnit](docs/ApiDurationUnit.md)
- [ApiGeoMapWidget](docs/ApiGeoMapWidget.md)
- [ApiGraphletPoint](docs/ApiGraphletPoint.md)
- [ApiGroupedBarchartWidget](docs/ApiGroupedBarchartWidget.md)
- [ApiMultiMetricColumn](docs/ApiMultiMetricColumn.md)
- [ApiMultiMetricColumnData](docs/ApiMultiMetricColumnData.md)
- [ApiMultiMetricTableWidget](docs/ApiMultiMetricTableWidget.md)
- [ApiMultiSearchFilterApiTestTableFilterKey](docs/ApiMultiSearchFilterApiTestTableFilterKey.md)
- [ApiNumbersCard](docs/ApiNumbersCard.md)
- [ApiNumbersCardData](docs/ApiNumbersCardData.md)
- [ApiNumbersCardWidget](docs/ApiNumbersCardWidget.md)
- [ApiPieChartWidget](docs/ApiPieChartWidget.md)
- [ApiReportDataComponentLabelMap](docs/ApiReportDataComponentLabelMap.md)
- [ApiReportDataComponentLabelMapEntry](docs/ApiReportDataComponentLabelMapEntry.md)
- [ApiReportSnapshotTimeSpan](docs/ApiReportSnapshotTimeSpan.md)
- [ApiStackedAreaChartWidget](docs/ApiStackedAreaChartWidget.md)
- [ApiStackedBarchartWidget](docs/ApiStackedBarchartWidget.md)
- [ApiTableWidget](docs/ApiTableWidget.md)
- [ApiTestTableData](docs/ApiTestTableData.md)
- [ApiTestTableGraphletsData](docs/ApiTestTableGraphletsData.md)
- [ApiTestTableWidget](docs/ApiTestTableWidget.md)
- [ApiTimeseriesWidget](docs/ApiTimeseriesWidget.md)
- [ApiWidget](docs/ApiWidget.md)
- [ApiWidgetData](docs/ApiWidgetData.md)
- [ApiWidgetDataPoint](docs/ApiWidgetDataPoint.md)
- [ApiWidgetDataResponse](docs/ApiWidgetDataResponse.md)
- [ApiWidgetDataSnapshotResponse](docs/ApiWidgetDataSnapshotResponse.md)
- [ApiWidgetFilterApiTestTableFilterKey](docs/ApiWidgetFilterApiTestTableFilterKey.md)
- [ApiWidgetFixedYScalePrefix](docs/ApiWidgetFixedYScalePrefix.md)
- [ApiWidgetMeasure](docs/ApiWidgetMeasure.md)
- [ApiWidgetSortDirection](docs/ApiWidgetSortDirection.md)
- [ApiWidgetSortProperty](docs/ApiWidgetSortProperty.md)
- [ApiWidgetsDataV2](docs/ApiWidgetsDataV2.md)
- [AppAndSelfLinks](docs/AppAndSelfLinks.md)
- [AswRepeat](docs/AswRepeat.md)
- [AswRepeatUnit](docs/AswRepeatUnit.md)
- [BoxAndWhiskersDatasource](docs/BoxAndWhiskersDatasource.md)
- [ColorGridDatasource](docs/ColorGridDatasource.md)
- [Dashboard](docs/Dashboard.md)
- [DashboardGlobalFilterId](docs/DashboardGlobalFilterId.md)
- [DashboardLinks](docs/DashboardLinks.md)
- [DashboardMetric](docs/DashboardMetric.md)
- [DashboardMetricDirection](docs/DashboardMetricDirection.md)
- [DashboardOrder](docs/DashboardOrder.md)
- [DashboardSnapshotResponse](docs/DashboardSnapshotResponse.md)
- [DashboardSnapshotsPage](docs/DashboardSnapshotsPage.md)
- [DefaultTimespan](docs/DefaultTimespan.md)
- [EnterpriseAgentState](docs/EnterpriseAgentState.md)
- [Error](docs/Error.md)
- [GenerateDashboardSnapshotRequest](docs/GenerateDashboardSnapshotRequest.md)
- [GeoMapDatasource](docs/GeoMapDatasource.md)
- [GroupedBarChartDatasource](docs/GroupedBarChartDatasource.md)
- [LegacyAgentWidgetShow](docs/LegacyAgentWidgetShow.md)
- [LegacyAgentWidgetType](docs/LegacyAgentWidgetType.md)
- [LegacyAlertListAlertType](docs/LegacyAlertListAlertType.md)
- [LegacyApiDashboard](docs/LegacyApiDashboard.md)
- [LegacyDashboardSnapshot](docs/LegacyDashboardSnapshot.md)
- [LegacyDefaultTimespan](docs/LegacyDefaultTimespan.md)
- [LegacyDurationUnit](docs/LegacyDurationUnit.md)
- [LegacyWidgetSortDirection](docs/LegacyWidgetSortDirection.md)
- [LegacyWidgetSortProperty](docs/LegacyWidgetSortProperty.md)
- [Link](docs/Link.md)
- [MetricGroup](docs/MetricGroup.md)
- [MultiMetricsTableDatasource](docs/MultiMetricsTableDatasource.md)
- [NumbersCardDatasource](docs/NumbersCardDatasource.md)
- [PaginationLinks](docs/PaginationLinks.md)
- [PieChartDatasource](docs/PieChartDatasource.md)
- [ScalableWidget](docs/ScalableWidget.md)
- [SelfLinks](docs/SelfLinks.md)
- [StackedAreaChartDatasource](docs/StackedAreaChartDatasource.md)
- [StackedBarChartDatasource](docs/StackedBarChartDatasource.md)
- [TableDatasource](docs/TableDatasource.md)
- [TestTableDatasource](docs/TestTableDatasource.md)
- [TestTableFilterKey](docs/TestTableFilterKey.md)
- [TestTableFilterType](docs/TestTableFilterType.md)
- [TimeseriesDatasource](docs/TimeseriesDatasource.md)
- [UnauthorizedError](docs/UnauthorizedError.md)
- [UpdateSnapshotExpirationDateApiRequest](docs/UpdateSnapshotExpirationDateApiRequest.md)
- [ValidationError](docs/ValidationError.md)
- [ValidationErrorItem](docs/ValidationErrorItem.md)
- [VisualMode](docs/VisualMode.md)
- [Widget](docs/Widget.md)
- [WidgetMeasureType](docs/WidgetMeasureType.md)
- [WidgetType](docs/WidgetType.md)
## Documentation For Authorization
Authentication schemes defined for the API:
### BearerAuth
- **Type**: Bearer authentication
## Author