software.amazon.awssdk.profiles

Class ProfileFile

java.lang.Object

software.amazon.awssdk.profiles.ProfileFile

public final class ProfileFile
extends Object

Provides programmatic access to the contents of an AWS configuration profile file. AWS configuration profiles allow you to share multiple sets of AWS security credentials between different tools such as the AWS SDK for Java and the AWS CLI.

For more information on setting up AWS configuration profiles, see: http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html

A profile file can be created with builder() and merged with other profiles files with aggregator(). By default, the SDK will use the defaultProfileFile() when that behavior hasn't been explicitly overridden.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ProfileFile.Aggregator A mechanism for merging multiple ProfileFiles together into a single file.
static interface	ProfileFile.Builder A builder for a ProfileFile.
static class	ProfileFile.Type The supported types of profile files.

Method Summary

Modifier and Type	Method and Description
static ProfileFile.Aggregator	aggregator() Create a builder that can merge multiple ProfileFiles together.
static ProfileFile.Builder	builder() Create a builder for a ProfileFile.
static ProfileFile	defaultProfileFile() Get the default profile file, using the credentials file from "~/.aws/credentials", the config file from "~/.aws/config" and the "default" profile.
boolean	equals(Object o)
int	hashCode()
Optional<Profile>	profile(String profileName) Retrieve the profile from this file with the given name.
Map<String,Profile>	profiles() Retrieve an unmodifiable collection including all of the profiles in this file.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

builder

public static ProfileFile.Builder builder()

Create a builder for a ProfileFile.

aggregator

public static ProfileFile.Aggregator aggregator()

Create a builder that can merge multiple ProfileFiles together.

defaultProfileFile

public static ProfileFile defaultProfileFile()

Get the default profile file, using the credentials file from "~/.aws/credentials", the config file from "~/.aws/config" and the "default" profile. This default behavior can be customized using the ProfileFileSystemSetting.AWS_SHARED_CREDENTIALS_FILE, ProfileFileSystemSetting.AWS_CONFIG_FILE and ProfileFileSystemSetting.AWS_PROFILE settings or by specifying a different profile file and profile name

profile

public Optional<Profile> profile(String profileName)

Retrieve the profile from this file with the given name.

Parameters:

profileName - The name of the profile that should be retrieved from this file.

Returns:

The profile, if available.

profiles

public Map<String,Profile> profiles()

Retrieve an unmodifiable collection including all of the profiles in this file.

Returns:

An unmodifiable collection of the profiles in this file, keyed by profile name.

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object