The ClientAwsConfig contains the configuration for client to connect to nodes in aws environment. More...

#include <ClientAwsConfig.h>

Public Member Functions
const std::string &	getAccessKey () const
	Gets the access key to access AWS. More...

ClientAwsConfig &	setAccessKey (const std::string &accessKey)
	Sets the access key to access AWS. More...

const std::string &	getSecretKey () const
	Gets the secret key to access AWS. More...

ClientAwsConfig &	setSecretKey (const std::string &secretKey)
	Sets the secret key to access AWS. More...

const std::string &	getRegion () const
	Gets the region where the EC2 instances running the Hazelcast members will be running. More...

ClientAwsConfig &	setRegion (const std::string &region)
	Sets the region where the EC2 instances running the Hazelcast members will be running. More...

const std::string &	getHostHeader () const
	Gets the host header; the address where the EC2 API can be found. More...

ClientAwsConfig &	setHostHeader (const std::string &hostHeader)
	Sets the host header; the address where the EC2 API can be found. More...

ClientAwsConfig &	setEnabled (bool enabled)
	Enables or disables the aws join mechanism. More...

bool	isEnabled () const
	Checks if the aws join mechanism is enabled. More...

ClientAwsConfig &	setSecurityGroupName (const std::string &securityGroupName)
	Sets the security group name. More...

const std::string &	getSecurityGroupName () const
	Gets the security group name. More...

ClientAwsConfig &	setTagKey (const std::string &tagKey)
	Sets the tag key. More...

const std::string &	getTagKey () const
	Gets the tag key. More...

ClientAwsConfig &	setTagValue (const std::string &tagValue)
	Sets the tag value. More...

const std::string &	getTagValue () const
	Gets the tag value. More...

const std::string &	getIamRole () const
	Gets the iamRole name. More...

ClientAwsConfig &	setIamRole (const std::string &iamRole)
	Sets the tag value. More...

bool	isInsideAws () const
	If client is inside aws, it will use private ip addresses directly, otherwise it will convert private ip addresses to public addresses internally by calling AWS API. More...

ClientAwsConfig &	setInsideAws (bool insideAws)
	Set to true if client is inside aws environment Default value is false. More...

Detailed Description

The ClientAwsConfig contains the configuration for client to connect to nodes in aws environment.

The ClientAwsConfig contains the configuration for AWS join mechanism.

what happens behind the scenes is that data about the running AWS instances in a specific region are downloaded using the accesskey/secretkey and are potential Hazelcast members.

Filtering

There are 2 mechanisms for filtering out AWS instances and these mechanisms can be combined (AND).

If a securityGroup is configured, only instances within that security group are selected.
If a tag key/value is set, only instances with that tag key/value will be selected.

Member Function Documentation

const std::string & hazelcast::client::config::ClientAwsConfig::getAccessKey ( ) const

Gets the access key to access AWS.

Returns empty string if no access key is configured.

Returns: the access key to access AWS

See also: #setAccessKey(std::string)

const std::string & hazelcast::client::config::ClientAwsConfig::getHostHeader ( ) const

Gets the host header; the address where the EC2 API can be found.

Returns: the host header; the address where the EC2 API can be found

const std::string & hazelcast::client::config::ClientAwsConfig::getIamRole ( ) const

Gets the iamRole name.

Returns: the iamRole. empty string if nothing is returned.

See also: #setIamRole(std::string) (int32_t)

const std::string & hazelcast::client::config::ClientAwsConfig::getRegion ( ) const

Gets the region where the EC2 instances running the Hazelcast members will be running.

Returns: the region where the EC2 instances running the Hazelcast members will be running

See also: #setRegion(std::string)

const std::string & hazelcast::client::config::ClientAwsConfig::getSecretKey ( ) const

Gets the secret key to access AWS.

Returns empty string if no access key is configured.

Returns: the secret key.

See also: #setSecretKey(std::string)

const std::string & hazelcast::client::config::ClientAwsConfig::getSecurityGroupName ( ) const

Gets the security group name.

If nothing has been configured, empty string is returned.

Returns: the security group name; empty string if nothing has been configured

const std::string & hazelcast::client::config::ClientAwsConfig::getTagKey ( ) const

Gets the tag key.

If nothing is specified, empty string is returned.

Returns: the tag key. empty string if nothing is returned.

const std::string & hazelcast::client::config::ClientAwsConfig::getTagValue ( ) const

Gets the tag value.

If nothing is specified, empty string is returned.

Returns: the tag value. empty string if nothing is returned.

bool hazelcast::client::config::ClientAwsConfig::isEnabled ( ) const

Checks if the aws join mechanism is enabled.

Returns: true if enabled, false otherwise.

bool hazelcast::client::config::ClientAwsConfig::isInsideAws ( ) const

If client is inside aws, it will use private ip addresses directly, otherwise it will convert private ip addresses to public addresses internally by calling AWS API.

Returns: bool true if client is inside aws environment.

ClientAwsConfig & hazelcast::client::config::ClientAwsConfig::setAccessKey ( const std::string & accessKey )

Sets the access key to access AWS.

Parameters

accessKey the access key to access AWS

Returns: the updated ClientAwsConfig.

Exceptions

IllegalArgumentException if accessKey is empty.

See also: getAccessKey(); #setSecretKey(std::string)

ClientAwsConfig & hazelcast::client::config::ClientAwsConfig::setEnabled ( bool enabled )

Enables or disables the aws join mechanism.

Parameters

enabled true if enabled, false otherwise.

Returns: the updated ClientAwsConfig.

ClientAwsConfig & hazelcast::client::config::ClientAwsConfig::setHostHeader ( const std::string & hostHeader )

Sets the host header; the address where the EC2 API can be found.

Parameters

hostHeader the new host header; the address where the EC2 API can be found

Returns: the updated ClientAwsConfig

Exceptions

IllegalArgumentException if hostHeader is an empty string.

ClientAwsConfig & hazelcast::client::config::ClientAwsConfig::setIamRole ( const std::string & iamRole )

Sets the tag value.

See the filtering section above for more information.

Parameters

iamRole the IAM Role name.

Returns: the updated ClientAwsConfig.

See also: getIamRole()

ClientAwsConfig & hazelcast::client::config::ClientAwsConfig::setInsideAws ( bool insideAws )

Set to true if client is inside aws environment Default value is false.

Parameters

insideAws isInsideAws

ClientAwsConfig & hazelcast::client::config::ClientAwsConfig::setRegion ( const std::string & region )

Sets the region where the EC2 instances running the Hazelcast members will be running.

Parameters

region the region where the EC2 instances running the Hazelcast members will be running

Returns: the updated ClientAwsConfig

Exceptions

IllegalArgumentException if region is empty.

ClientAwsConfig & hazelcast::client::config::ClientAwsConfig::setSecretKey ( const std::string & secretKey )

Sets the secret key to access AWS.

Parameters

secretKey the secret key to access AWS

Returns: the updated ClientAwsConfig.

Exceptions

IllegalArgumentException if secretKey is empty.

See also: getSecretKey(); #setAccessKey(std::string)

ClientAwsConfig & hazelcast::client::config::ClientAwsConfig::setSecurityGroupName ( const std::string & securityGroupName )

Sets the security group name.

See the filtering section above for more information.

Parameters

securityGroupName the security group name.

Returns: the updated ClientAwsConfig.

See also: getSecurityGroupName()

ClientAwsConfig & hazelcast::client::config::ClientAwsConfig::setTagKey ( const std::string & tagKey )

Sets the tag key.

See the filtering section above for more information.

Parameters

tagKey the tag key. See the filtering section above for more information.

Returns: the updated ClientAwsConfig.

See also: #setTagKey(std::string)

ClientAwsConfig & hazelcast::client::config::ClientAwsConfig::setTagValue ( const std::string & tagValue )

Sets the tag value.

See the filtering section above for more information.

Parameters

tagValue the tag value. See the filtering section above for more information.

Returns: the updated ClientAwsConfig.

See also: #setTagKey(std::string); getTagValue()

The documentation for this class was generated from the following files:

hazelcast/include/hazelcast/client/config/ClientAwsConfig.h
hazelcast/src/hazelcast/client/config/ClientAwsConfig.cpp

Public Member Functions

Detailed Description

Filtering

Member Function Documentation