org.openstack4j.openstack.client

Class OSClientBuilder.ClientV3

java.lang.Object

org.openstack4j.openstack.client.OSClientBuilder<OSClient,IOSClientBuilder.V3>

org.openstack4j.openstack.client.OSClientBuilder.ClientV3

All Implemented Interfaces:

IOSClientBuilder<OSClient,IOSClientBuilder.V3>, IOSClientBuilder.V3

Enclosing class:

OSClientBuilder<R,T extends IOSClientBuilder<R,T>>

public static class OSClientBuilder.ClientV3
extends OSClientBuilder<OSClient,IOSClientBuilder.V3>
implements IOSClientBuilder.V3

Nested Class Summary

Nested classes/interfaces inherited from class org.openstack4j.openstack.client.OSClientBuilder

OSClientBuilder.ClientV2, OSClientBuilder.ClientV3

Nested classes/interfaces inherited from interface org.openstack4j.api.client.IOSClientBuilder

IOSClientBuilder.V2, IOSClientBuilder.V3

Constructor Summary

Constructors

Constructor and Description
ClientV3()

Method Summary

Modifier and Type	Method and Description
OSClient	authenticate() Attempts to connect, authenticated and obtain an authorization access entity which contains a token, service catalog and endpoints from the controller.
OSClientBuilder.ClientV3	credentials(String user, String password, Identifier domain) The authentication credentials and default scoped domain
OSClientBuilder.ClientV3	domainId(String domainId) DEPRECATED: Please use IOSClientBuilder.V3.credentials(String, String, Identifier) Authenticates against the specified domain identifier
OSClientBuilder.ClientV3	domainName(String domainName) DEPRECATED: Please use {@link #credentials(String, String, Identifier) Authenticates against the specified domain name
OSClientBuilder.ClientV3	scopeToDomain(Identifier domain) Scopes the token to a domain level
OSClientBuilder.ClientV3	scopeToProject(Identifier project, Identifier domain) Scopes the token to a project level
OSClientBuilder.ClientV3	scopeToTrust(String id) Scopes the token to a specific trust
OSClientBuilder.ClientV3	token(String tokenId) A token object.

Methods inherited from class org.openstack4j.openstack.client.OSClientBuilder

credentials, endpoint, perspective, useNonStrictSSLClient, withConfig

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.openstack4j.api.client.IOSClientBuilder

credentials, endpoint, perspective, useNonStrictSSLClient, withConfig

Constructor Detail

ClientV3

public ClientV3()

Method Detail

domainName

public OSClientBuilder.ClientV3 domainName(String domainName)

Description copied from interface: IOSClientBuilder.V3

DEPRECATED: Please use {@link #credentials(String, String, Identifier) Authenticates against the specified domain name

Specified by:

domainName in interface IOSClientBuilder.V3

Parameters:

domainName - the domain name to authenticate against

Returns:

V3

domainId

public OSClientBuilder.ClientV3 domainId(String domainId)

Description copied from interface: IOSClientBuilder.V3

DEPRECATED: Please use IOSClientBuilder.V3.credentials(String, String, Identifier) Authenticates against the specified domain identifier

Specified by:

domainId in interface IOSClientBuilder.V3

Parameters:

domainId - the domain identifier to authenticate against

Returns:

OSFactoryBuilderV3

credentials

public OSClientBuilder.ClientV3 credentials(String user,
                                            String password,
                                            Identifier domain)

Description copied from interface: IOSClientBuilder.V3

The authentication credentials and default scoped domain

Specified by:

credentials in interface IOSClientBuilder.V3

Parameters:

user - the user to authenticate with

password - the password to authenticate with

domain - the domain if using "default scoped"

Returns:

self for method chaining

token

public OSClientBuilder.ClientV3 token(String tokenId)

Description copied from interface: IOSClientBuilder.V3

A token object. With token authentication, the id uniquely identifies the token. This method is typically used in combination with a request to change authorization scope

Specified by:

token in interface IOSClientBuilder.V3

Parameters:

tokenId - the token identifier

Returns:

OSFactoryBuilderV3

authenticate

public OSClient authenticate()
                      throws AuthenticationException

Description copied from interface: IOSClientBuilder

Attempts to connect, authenticated and obtain an authorization access entity which contains a token, service catalog and endpoints from the controller. As a result a client will be returned encapsulating the authorized access and corresponding API access

Specified by:

authenticate in interface IOSClientBuilder<OSClient,IOSClientBuilder.V3>

Returns:

the authenticated client

Throws:

AuthenticationException - if the credentials or default tenant is invalid

scopeToProject

public OSClientBuilder.ClientV3 scopeToProject(Identifier project,
                                               Identifier domain)

Description copied from interface: IOSClientBuilder.V3

Scopes the token to a project level

Specified by:

scopeToProject in interface IOSClientBuilder.V3

Parameters:

project - the project ID or Name value

domain - the domain ID or Name value

Returns:

OSFactoryBuilderV3

scopeToDomain

public OSClientBuilder.ClientV3 scopeToDomain(Identifier domain)

Description copied from interface: IOSClientBuilder.V3

Scopes the token to a domain level

Specified by:

scopeToDomain in interface IOSClientBuilder.V3

Parameters:

domain - the domain ID or Name value

Returns:

OSFactoryBuilderV3

scopeToTrust

public OSClientBuilder.ClientV3 scopeToTrust(String id)

Description copied from interface: IOSClientBuilder.V3

Scopes the token to a specific trust

Specified by:

scopeToTrust in interface IOSClientBuilder.V3

Parameters:

id - the trust id

Returns:

OSFactoryBuilderV3