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

#include <client_aws_config.h>

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

client_aws_config &	set_access_key (const std::string &access_key)
	Sets the access key to access AWS. More...

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

client_aws_config &	set_secret_key (const std::string &secret_key)
	Sets the secret key to access AWS. More...

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

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

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

client_aws_config &	set_host_header (const std::string &host_header)
	Sets the host header; the address where the EC2 API can be found. More...

client_aws_config &	set_enabled (bool enabled)
	Enables or disables the aws join mechanism. More...

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

client_aws_config &	set_security_group_name (const std::string &security_group_name)
	Sets the security group name. More...

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

client_aws_config &	set_tag_key (const std::string &tag_key)
	Sets the tag key. More...

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

client_aws_config &	set_tag_value (const std::string &tag_value)
	Sets the tag value. More...

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

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

client_aws_config &	set_iam_role (const std::string &iam_role)
	Sets the tag value. More...

bool	is_inside_aws () 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...

client_aws_config &	set_inside_aws (bool inside_aws)
	Set to true if client is inside aws environment Default value is false. More...

Detailed Description

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

The client_aws_config 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

◆ get_access_key()

const std::string & hazelcast::client::config::client_aws_config::get_access_key ( ) 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: #set_access_key(std::string)

◆ get_host_header()

const std::string & hazelcast::client::config::client_aws_config::get_host_header ( ) 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

◆ get_iam_role()

const std::string & hazelcast::client::config::client_aws_config::get_iam_role ( ) const

Gets the iamRole name.

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

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

◆ get_region()

const std::string & hazelcast::client::config::client_aws_config::get_region ( ) 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)

◆ get_secret_key()

const std::string & hazelcast::client::config::client_aws_config::get_secret_key ( ) const

Gets the secret key to access AWS.

Returns empty string if no access key is configured.

Returns: the secret key.

See also: #set_secret_key(std::string)

◆ get_security_group_name()

const std::string & hazelcast::client::config::client_aws_config::get_security_group_name ( ) 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

◆ get_tag_key()

const std::string & hazelcast::client::config::client_aws_config::get_tag_key ( ) const

Gets the tag key.

If nothing is specified, empty string is returned.

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

◆ get_tag_value()

const std::string & hazelcast::client::config::client_aws_config::get_tag_value ( ) const

Gets the tag value.

If nothing is specified, empty string is returned.

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

◆ is_enabled()

bool hazelcast::client::config::client_aws_config::is_enabled ( ) const

Checks if the aws join mechanism is enabled.

Returns: true if enabled, false otherwise.

◆ is_inside_aws()

bool hazelcast::client::config::client_aws_config::is_inside_aws ( ) 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.

◆ set_access_key()

client_aws_config & hazelcast::client::config::client_aws_config::set_access_key ( const std::string & access_key )

Sets the access key to access AWS.

Parameters

accessKey the access key to access AWS

Returns: the updated client_aws_config.

Exceptions

illegal_argument if accessKey is empty.

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

◆ set_enabled()

client_aws_config & hazelcast::client::config::client_aws_config::set_enabled ( bool enabled )

Enables or disables the aws join mechanism.

Parameters

enabled true if enabled, false otherwise.

Returns: the updated client_aws_config.

◆ set_host_header()

client_aws_config & hazelcast::client::config::client_aws_config::set_host_header ( const std::string & host_header )

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 client_aws_config

Exceptions

illegal_argument if hostHeader is an empty string.

◆ set_iam_role()

client_aws_config & hazelcast::client::config::client_aws_config::set_iam_role ( const std::string & iam_role )

Sets the tag value.

See the filtering section above for more information.

Parameters

iamRole the IAM Role name.

Returns: the updated client_aws_config.

See also: #getIamRole()

◆ set_inside_aws()

client_aws_config & hazelcast::client::config::client_aws_config::set_inside_aws ( bool inside_aws )

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

Parameters

insideAws isInsideAws

◆ set_region()

client_aws_config & hazelcast::client::config::client_aws_config::set_region ( 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 client_aws_config

Exceptions

illegal_argument if region is empty.

◆ set_secret_key()

client_aws_config & hazelcast::client::config::client_aws_config::set_secret_key ( const std::string & secret_key )

Sets the secret key to access AWS.

Parameters

secretKey the secret key to access AWS

Returns: the updated client_aws_config.

Exceptions

illegal_argument if secretKey is empty.

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

◆ set_security_group_name()

client_aws_config & hazelcast::client::config::client_aws_config::set_security_group_name ( const std::string & security_group_name )

Sets the security group name.

See the filtering section above for more information.

Parameters

securityGroupName the security group name.

Returns: the updated client_aws_config.

See also: #getSecurityGroupName()

◆ set_tag_key()

client_aws_config & hazelcast::client::config::client_aws_config::set_tag_key ( const std::string & tag_key )

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 client_aws_config.

See also: #set_tag_key(std::string)

◆ set_tag_value()

client_aws_config & hazelcast::client::config::client_aws_config::set_tag_value ( const std::string & tag_value )

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 client_aws_config.

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

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

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

Public Member Functions

Detailed Description

Filtering

Member Function Documentation

◆ get_access_key()

◆ get_host_header()

◆ get_iam_role()

◆ get_region()

◆ get_secret_key()

◆ get_security_group_name()

◆ get_tag_key()

◆ get_tag_value()

◆ is_enabled()

◆ is_inside_aws()

◆ set_access_key()

◆ set_enabled()

◆ set_host_header()

◆ set_iam_role()

◆ set_inside_aws()

◆ set_region()

◆ set_secret_key()

◆ set_security_group_name()

◆ set_tag_key()

◆ set_tag_value()