Skip to content


Subversion checkout URL

You can clone with
Download ZIP
OpenStack Java SDK

Merge pull request #188 from jannle/master

Add Hypervisor and Service class support for Nova
latest commit fd1475c337
@woorea authored
Failed to load latest commit information.
ceilometer-client Fix warnings in method declarations that use an unparameterized OpenS…
ceilometer-model [maven-release-plugin] prepare for next development iteration
cinder-client Merge branch 'schedulerStatsApi'
cinder-model Merge branch 'schedulerStatsApi'
glance-client [maven-release-plugin] prepare for next development iteration
glance-model glance: ignore unknown image properties
heat-client Remove obsolete list resources functions
heat-model inital implementation of resources
keystone-client fixed type in flavor vcpus, hdd
keystone-model added getter setters
nova-client Remove the server group part in
nova-model Add Service and Hypervisor class support to Nova
openstack-client-connectors Deserialize an empty json string to a null object
openstack-client jersey 2.6 + keystone v3 + nova missing utility methods for server ac…
openstack-console [maven-release-plugin] prepare for next development iteration
openstack-examples jersey 2.6 + keystone v3 + nova missing utility methods for server ac…
quantum-client neutron: Allow Network update
quantum-model neutron: Support ml2 port bindings
swift-client Fix warnings in method declarations that use an unparameterized OpenS…
swift-model [maven-release-plugin] prepare for next development iteration
.gitignore gitignore: intellij idea directory and files
.travis.yml added travis and oss sonatype parent
LICENSE.txt misc: add the apache license v2 file
README.textile java: complete the migration to com.woorea added travis and oss sonatype parent
pom.xml cinder: introduce client and model


OpenStack Java SDK v2.0


You can continue using the latest source from v1.x essex branch


groupId artifactId version
com.woorea keystone-client 3.0.0-SNAPSHOT
com.woorea nova-client 3.0.0-SNAPSHOT
com.woorea glance-client 3.0.0-SNAPSHOT
com.woorea swift-client 3.0.0-SNAPSHOT

Maven Repositories

Available artifacts

OpenStack Identity Service

OpenStack Keystone Model

OpenStack Keystone Client

KeystoneClient keystone = new KeystoneClient(KEYSTONE_AUTH_URL);
Authentication authentication = new Authentication();
PasswordCredentials passwordCredentials = new PasswordCredentials();

//access with unscoped token
Access access = keystone.execute(new Authenticate(authentication));

//use the token in the following requests

Tenants tenants = keystone.execute(new ListTenants());

//try to exchange token using the first tenant
if(tenants.getList().size() > 0) {
	authentication = new Authentication();
	Token token = new Token();
	access = keystone.execute(new Authenticate(authentication));

OpenStack Compute Service

OpenStack Nova Model

OpenStack Nova Client

NovaClient novaClient = new NovaClient(KeystoneUtils.findEndpointURL(access.getServiceCatalog(), "compute", null, "public"), access.getToken().getId());
Servers servers = novaClient.execute(ServersCore.listServers());
for(Server server : servers) {

OpenStack Image Store Service

OpenStack Glance Model

OpenStack Glance Client

OpenStack Object Store Service

OpenStack Swift Model

OpenStack Swift Client

OpenStack Ceilometer Service

MongoDB Installation

OpenStack Ceilometer Service uses MongoDB as storage.

Ceilometer Compute Agent Installation

OpenStack Ceilometer Compute Agent

This artefact should be installed on each compute node

mvn clean compile assembly:assembly
Properties can be configured in /etc/ceilometer/
java -jar ceilometer-compute-agent-jar-with-dependencies.jar 

Ceilometer Collector Installation

OpenStack Ceilometer Collector

mvn clean compile assembly:assembly
Properties can be configured in /etc/ceilometer/
java -jar ceilometer-collector.jar 

OpenStack Ceilometer API Installation

OpenStack Ceilometer API

mvn clean compile assembly:assembly
Properties can be configured in /etc/ceilometer/
java -jar ceilometer-api.jar 

OpenStack Ceilometer Client


This software is licensed under the Apache 2 license, quoted below.

Copyright 2012 Luis Gervaso and OpenStack Java SDK

Licensed under the Apache License, Version 2.0 (the "License"); you may not
use this file except in compliance with the License. You may obtain a copy of
the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations under
the License.
Something went wrong with that request. Please try again.