Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion administrative/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Administrative API

- API version: 7.0.75
- API version: 7.0.76

Manage users, accounts, and account groups in the ThousandEyes platform using the Administrative API.
This API provides the following operations to manage your organization:
Expand Down
2 changes: 1 addition & 1 deletion agents/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Agents API

- API version: 7.0.75
- API version: 7.0.76


## Overview
Expand Down
2 changes: 1 addition & 1 deletion alerts/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Alerts API

- API version: 7.0.75
- API version: 7.0.76

You can manage the following alert functionalities on the ThousandEyes platform using the Alerts API:

Expand Down
2 changes: 1 addition & 1 deletion bgp-monitors/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

BGP Monitors API

- API version: 7.0.75
- API version: 7.0.76


Retrieve information about BGP monitors available to your ThousandEyes account. ThousandEyes ingests BGP routing data from dozens of global BGP collectors and automatically integrates that visibility as a configurable layer under service, network, and path visualization layers.
Expand Down
23 changes: 23 additions & 0 deletions connectors/.openapi-generator-ignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# OpenAPI Generator Ignore
# Generated by openapi-generator https://github.com/openapitools/openapi-generator

# Use this file to prevent files from being overwritten by the generator.
# The patterns follow closely to .gitignore or .dockerignore.

# As an example, the C# client generator defines ApiClient.cs.
# You can make changes and tell OpenAPI Generator to ignore just this file by uncommenting the following line:
#ApiClient.cs

# You can match any string of characters against a directory, file or extension with a single asterisk (*):
#foo/*/qux
# The above matches foo/bar/qux and foo/baz/qux, but not foo/bar/baz/qux

# You can recursively match patterns against a directory, file or extension with a double asterisk (**):
#foo/**/qux
# This matches foo/bar/qux, foo/baz/qux, and foo/bar/baz/qux

# You can also negate patterns with an exclamation (!).
# For example, you can ignore all files in a docs folder with the file extension .md:
#docs/*.md
# Then explicitly reverse the ignore rule for a single file:
#!docs/README.md
36 changes: 36 additions & 0 deletions connectors/.openapi-generator/FILES
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
.openapi-generator-ignore
README.md
api/openapi.yaml
build.gradle
docs/GenericConnectorsApi.md
docs/OperationConnectorsApi.md
docs/WebhookOperationsApi.md
src/main/java/com/thousandeyes/sdk/connectors/GenericConnectorsApi.java
src/main/java/com/thousandeyes/sdk/connectors/OperationConnectorsApi.java
src/main/java/com/thousandeyes/sdk/connectors/WebhookOperationsApi.java
src/main/java/com/thousandeyes/sdk/connectors/model/Assignments.java
src/main/java/com/thousandeyes/sdk/connectors/model/AuthenticationType.java
src/main/java/com/thousandeyes/sdk/connectors/model/BasicAuthentication.java
src/main/java/com/thousandeyes/sdk/connectors/model/BearerTokenAuthentication.java
src/main/java/com/thousandeyes/sdk/connectors/model/ConnectorType.java
src/main/java/com/thousandeyes/sdk/connectors/model/Error.java
src/main/java/com/thousandeyes/sdk/connectors/model/GenericConnector.java
src/main/java/com/thousandeyes/sdk/connectors/model/GenericConnectorAuth.java
src/main/java/com/thousandeyes/sdk/connectors/model/GenericConnectors.java
src/main/java/com/thousandeyes/sdk/connectors/model/Header.java
src/main/java/com/thousandeyes/sdk/connectors/model/Link.java
src/main/java/com/thousandeyes/sdk/connectors/model/OauthClientCredentialsAuthentication.java
src/main/java/com/thousandeyes/sdk/connectors/model/OauthCodeAuthentication.java
src/main/java/com/thousandeyes/sdk/connectors/model/OperationCategory.java
src/main/java/com/thousandeyes/sdk/connectors/model/OperationStatus.java
src/main/java/com/thousandeyes/sdk/connectors/model/OperationType.java
src/main/java/com/thousandeyes/sdk/connectors/model/OtherTokenAuthentication.java
src/main/java/com/thousandeyes/sdk/connectors/model/SelfLinks.java
src/main/java/com/thousandeyes/sdk/connectors/model/UnauthorizedError.java
src/main/java/com/thousandeyes/sdk/connectors/model/ValidationError.java
src/main/java/com/thousandeyes/sdk/connectors/model/ValidationErrorItem.java
src/main/java/com/thousandeyes/sdk/connectors/model/WebhookOperation.java
src/main/java/com/thousandeyes/sdk/connectors/model/WebhookOperations.java
src/test/java/com/thousandeyes/sdk/connectors/GenericConnectorsApiTest.java
src/test/java/com/thousandeyes/sdk/connectors/OperationConnectorsApiTest.java
src/test/java/com/thousandeyes/sdk/connectors/WebhookOperationsApiTest.java
1 change: 1 addition & 0 deletions connectors/.openapi-generator/VERSION
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
7.6.0
176 changes: 176 additions & 0 deletions connectors/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,176 @@
# connectors

Integrations API

- API version: 7.0.76

Manage connectors and operations.


*Automatically generated by the [OpenAPI Generator](https://openapi-generator.tech)*

## Requirements

Building the API client library requires:

1. Java 11+
2. Maven/Gradle

## Installation

To install the API client library to your local Maven repository, simply execute:

```shell
mvn clean install
```

To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:

```shell
mvn clean deploy
```

Refer to the [OSSRH Guide](http://central.sonatype.org/pages/ossrh-guide.html) for more information.

### Maven users

Add this dependency to your project's POM:

```xml
<dependencies>
<dependency>
<groupId>com.thousandeyes.sdk</groupId>
<artifactId>connectors</artifactId>
<version>version</version>
</dependency>
<dependency>
<groupId>com.thousandeyes.sdk</groupId>
<artifactId>client</artifactId>
<version>version</version>
</dependency>

<!-- Example only, you can use your own client implementation -->
<dependency>
<groupId>com.thousandeyes.sdk</groupId>
<artifactId>client-native</artifactId>
<version>version</version>
</dependency>
</dependencies>

```

### Gradle users

Add this dependency to your project's build file:

```groovy
implementation "com.thousandeyes.sdk:client:<version>"
implementation "com.thousandeyes.sdk:client-native:<version>" #Example only, you can use your own client implementation
implementation "com.thousandeyes.sdk:connectors:<version>"
```

### Others

At first generate the JAR by executing:

```shell
mvn clean package
```

Then manually install the following JARs:

- `target/connectors-version.jar`
- `target/lib/*.jar`

## Getting Started

Please follow the [installation](#installation) instruction and execute the following Java code:

```java

import com.thousandeyes.sdk.*;
import com.thousandeyes.sdk.client.*;
import com.thousandeyes.sdk.connectors.model.*;
import com.thousandeyes.sdk.connectors.GenericConnectorsApi;

public class GenericConnectorsApiExample {

public static void main(String[] args) {
// Configure clients using the `defaultClient` object, such as
// overriding the host and port, timeout, etc. In this example we are using the NativeApiClient
// but you can use your own client implementation
ApiClient defaultClient = NativeApiClient
.builder()
.baseUri("https://api.thousandeyes.com/v7")
.bearerToken("<bearer-token>")
.build();

GenericConnectorsApi apiInstance = new GenericConnectorsApi(defaultClient);
GenericConnector genericConnector = new GenericConnector(); // GenericConnector |
BigDecimal aid = new BigDecimal("123456"); // BigDecimal | Account ID
try {
GenericConnector result = apiInstance.createGenericConnector(genericConnector, aid);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling GenericConnectorsApi#createGenericConnector");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}

```

## Documentation for API Endpoints

All URIs are relative to *https://api.thousandeyes.com/v7*

Class | Method | HTTP request | Description
------------ | ------------- | ------------- | -------------
*GenericConnectorsApi* | [**createGenericConnector**](docs/GenericConnectorsApi.md#createGenericConnector) | **POST** /connectors/generic | Create connector
*GenericConnectorsApi* | [**createGenericConnectorWithHttpInfo**](docs/GenericConnectorsApi.md#createGenericConnectorWithHttpInfo) | **POST** /connectors/generic | Create connector
*GenericConnectorsApi* | [**deleteGenericConnector**](docs/GenericConnectorsApi.md#deleteGenericConnector) | **DELETE** /connectors/generic/{id} | Delete connector
*GenericConnectorsApi* | [**deleteGenericConnectorWithHttpInfo**](docs/GenericConnectorsApi.md#deleteGenericConnectorWithHttpInfo) | **DELETE** /connectors/generic/{id} | Delete connector
*GenericConnectorsApi* | [**getGenericConnector**](docs/GenericConnectorsApi.md#getGenericConnector) | **GET** /connectors/generic/{id} | Retrieve connector
*GenericConnectorsApi* | [**getGenericConnectorWithHttpInfo**](docs/GenericConnectorsApi.md#getGenericConnectorWithHttpInfo) | **GET** /connectors/generic/{id} | Retrieve connector
*GenericConnectorsApi* | [**getGenericConnectors**](docs/GenericConnectorsApi.md#getGenericConnectors) | **GET** /connectors/generic | List connectors
*GenericConnectorsApi* | [**getGenericConnectorsWithHttpInfo**](docs/GenericConnectorsApi.md#getGenericConnectorsWithHttpInfo) | **GET** /connectors/generic | List connectors
*GenericConnectorsApi* | [**listGenericConnectorOperations**](docs/GenericConnectorsApi.md#listGenericConnectorOperations) | **GET** /connectors/generic/{id}/operations | List operation IDs assigned to a connector
*GenericConnectorsApi* | [**listGenericConnectorOperationsWithHttpInfo**](docs/GenericConnectorsApi.md#listGenericConnectorOperationsWithHttpInfo) | **GET** /connectors/generic/{id}/operations | List operation IDs assigned to a connector
*GenericConnectorsApi* | [**setGenericConnectorOperations**](docs/GenericConnectorsApi.md#setGenericConnectorOperations) | **PUT** /connectors/generic/{id}/operations | Assign operations to a connector
*GenericConnectorsApi* | [**setGenericConnectorOperationsWithHttpInfo**](docs/GenericConnectorsApi.md#setGenericConnectorOperationsWithHttpInfo) | **PUT** /connectors/generic/{id}/operations | Assign operations to a connector
*GenericConnectorsApi* | [**updateGenericConnector**](docs/GenericConnectorsApi.md#updateGenericConnector) | **PUT** /connectors/generic/{id} | Update connector
*GenericConnectorsApi* | [**updateGenericConnectorWithHttpInfo**](docs/GenericConnectorsApi.md#updateGenericConnectorWithHttpInfo) | **PUT** /connectors/generic/{id} | Update connector
*OperationConnectorsApi* | [**getOperationConnectors**](docs/OperationConnectorsApi.md#getOperationConnectors) | **GET** /operations/{type}/{id}/connectors | Retrieve connectors assigned to an operation
*OperationConnectorsApi* | [**getOperationConnectorsWithHttpInfo**](docs/OperationConnectorsApi.md#getOperationConnectorsWithHttpInfo) | **GET** /operations/{type}/{id}/connectors | Retrieve connectors assigned to an operation
*OperationConnectorsApi* | [**setOperationConnectors**](docs/OperationConnectorsApi.md#setOperationConnectors) | **PUT** /operations/{type}/{id}/connectors | Assign connectors to an operation
*OperationConnectorsApi* | [**setOperationConnectorsWithHttpInfo**](docs/OperationConnectorsApi.md#setOperationConnectorsWithHttpInfo) | **PUT** /operations/{type}/{id}/connectors | Assign connectors to an operation
*WebhookOperationsApi* | [**createWebhookOperation**](docs/WebhookOperationsApi.md#createWebhookOperation) | **POST** /operations/webhooks | Create webhook operation
*WebhookOperationsApi* | [**createWebhookOperationWithHttpInfo**](docs/WebhookOperationsApi.md#createWebhookOperationWithHttpInfo) | **POST** /operations/webhooks | Create webhook operation
*WebhookOperationsApi* | [**deleteWebhookOperation**](docs/WebhookOperationsApi.md#deleteWebhookOperation) | **DELETE** /operations/webhooks/{id} | Delete webhook operation
*WebhookOperationsApi* | [**deleteWebhookOperationWithHttpInfo**](docs/WebhookOperationsApi.md#deleteWebhookOperationWithHttpInfo) | **DELETE** /operations/webhooks/{id} | Delete webhook operation
*WebhookOperationsApi* | [**getWebhookOperation**](docs/WebhookOperationsApi.md#getWebhookOperation) | **GET** /operations/webhooks/{id} | Retrieve webhook operation
*WebhookOperationsApi* | [**getWebhookOperationWithHttpInfo**](docs/WebhookOperationsApi.md#getWebhookOperationWithHttpInfo) | **GET** /operations/webhooks/{id} | Retrieve webhook operation
*WebhookOperationsApi* | [**getWebhookOperations**](docs/WebhookOperationsApi.md#getWebhookOperations) | **GET** /operations/webhooks | List webhook operations
*WebhookOperationsApi* | [**getWebhookOperationsWithHttpInfo**](docs/WebhookOperationsApi.md#getWebhookOperationsWithHttpInfo) | **GET** /operations/webhooks | List webhook operations
*WebhookOperationsApi* | [**updateWebhookOperation**](docs/WebhookOperationsApi.md#updateWebhookOperation) | **PUT** /operations/webhooks/{id} | Update webhook operation
*WebhookOperationsApi* | [**updateWebhookOperationWithHttpInfo**](docs/WebhookOperationsApi.md#updateWebhookOperationWithHttpInfo) | **PUT** /operations/webhooks/{id} | Update webhook operation


<a id="documentation-for-authorization"></a>
## Documentation for Authorization

Endpoints do not require authorization.


## Recommendation

It's recommended to create an instance of `ApiClient` per thread in a multithreaded environment to avoid any potential issues.
However, the instances of the api clients created from the `ApiClient` are thread-safe and can be re-used.

## Author



1 change: 1 addition & 0 deletions connectors/api/openapi.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@

41 changes: 41 additions & 0 deletions connectors/build.gradle
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
ext {
jakartaAnnotationVersion = "2.1.1"
wiremockVersion = "3.9.1"
Comment on lines +1 to +3
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Include connectors module in the Gradle project graph

This commit introduces a complete connectors subproject, but the root settings.gradle still does not include 'connectors', so Gradle will not compile, test, or publish any of this new SDK module from normal root tasks (for example build/publish in CI). As a result, the new API client code is effectively unreachable to consumers despite being generated here.

Useful? React with 👍 / 👎.

}

repositories {
mavenCentral()
}

dependencies {
implementation project(":configuration")
implementation project(":client")
implementation "com.fasterxml.jackson.core:jackson-core:$jacksonVersion"
implementation "com.fasterxml.jackson.core:jackson-annotations:$jacksonVersion"
implementation "com.fasterxml.jackson.core:jackson-databind:$jacksonVersion"
implementation "com.fasterxml.jackson.datatype:jackson-datatype-jsr310:$jacksonVersion"
implementation "com.google.code.findbugs:jsr305:$googleJsr305Version"
implementation "jakarta.annotation:jakarta.annotation-api:$jakartaAnnotationVersion"
implementation "org.openapitools:jackson-databind-nullable:$jacksonDatabindNullableVersion"
implementation "org.apache.commons:commons-lang3:$apacheCommonsLang3"

testImplementation "org.junit.jupiter:junit-jupiter:$junitVersion"
testImplementation "org.wiremock:wiremock:$wiremockVersion"
testImplementation project(":client-native")

testRuntimeOnly "org.junit.platform:junit-platform-launcher"
}

test {
// Enable JUnit 5 (Gradle 4.6+).
useJUnitPlatform()

// Always run tests, even when nothing changed.
dependsOn 'cleanTest'

// Show test results.
testLogging {
events "passed", "skipped", "failed"
}

}
Loading
Loading