Tutum API Client in Java

Welcome to Tutum API Client written in Java. Created a simple and meaningful wrapper methods for Tutum RESTful APIs.

Getting Started

Tutum API Client library per version project dependencies:

• For v1: maps to branch master
  • Maven dependency

  <dependency>
            <groupId>com.pennassurancesoftware.tutum</groupId>
            <artifactId>tutum-api-client</artifactId>
            <version>1.00.00</version>
        </dependency>

  • Grails dependency

  compile 'com.pennassurancesoftware.tutum:tutum-api-client:1.00.00'

  • Groovy Grape

  @Grapes( 
  

@Grab(group='com.pennassurancesoftware.tutum', module='tutum-api-client', version='1.00.00') ) * Scala SBT

libraryDependencies += "com.pennassurancesoftware.tutum" % "tutum-api-client" % "1.00.00"

---

Samples

• Creating a Tutum Client in three simple ways!

// Way one, just pass on authToken
Tutum apiClient = new TutumClient(authToken);

// Way two, pass on version number & authToken
Tutum apiClient = new TutumClient("v1", authToken);

// Way three, pass on version number, authToken & httpClient
// Go ahead and customize httpClient attributes for requirements
HttpClient httpclient = new DefaultHttpClient();  
Tutum apiClient = new TutumClient("v1", authToken, httpClient);

• Let's invoke the method(s) as per need via apiClient

// Fetching all the available services from control panel 
Services services = apiClient.getServices();

// Fetching all the available containers
Containers containers = apiClient.getContainers();

// Create a new Node Cluster
final NodeCluster create = new NodeCluster();
create.setName( "junit3" );
create.setRegion( "/api/v1/region/digitalocean/nyc3/" );
create.setNodeType( "/api/v1/nodetype/digitalocean/512mb/" );
create.setTargetNumNodes( 1 );
create.setProvider( "digitalocean" );
final NodeCluster created = apiClient.createNodeCluster( create );

Reporting Issues

Tutum API Client uses GitHub’s integrated issue tracking system to record bugs and feature requests. If you want to raise an issue, please follow the recommendations bellow:

• Before you log a bug, please search the issue tracker to see if someone has already reported the problem. If the issue doesn’t already exist, create a new issue.
• Please provide as much information as possible with the issue report, we like to know the version of Tutum API Client that you are using.
• If you need to paste code, or include a stack trace use Markdown ``` escapes before and after your text.

Author

Jerome Bridge - jeromebridge@pennassurancesoftware.com

License

The Tutum API Client is released under MIT License.