org.apache.hadoop.fs.s3a

Class TemporaryAWSCredentialsProvider

java.lang.Object

org.apache.hadoop.fs.s3a.auth.AbstractAWSCredentialProvider

org.apache.hadoop.fs.s3a.auth.AbstractSessionCredentialsProvider

org.apache.hadoop.fs.s3a.TemporaryAWSCredentialsProvider

All Implemented Interfaces:

com.amazonaws.auth.AWSCredentialsProvider

@InterfaceAudience.Public
 @InterfaceStability.Stable
public class TemporaryAWSCredentialsProvider
extends AbstractSessionCredentialsProvider

Support session credentials for authenticating with AWS. Please note that users may reference this class name from configuration property fs.s3a.aws.credentials.provider. Therefore, changing the class name would be a backward-incompatible change. This credential provider must not fail in creation because that will break a chain of credential providers.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.hadoop.fs.s3a.auth.AbstractSessionCredentialsProvider

AbstractSessionCredentialsProvider.NoCredentials

Field Summary

Fields

Modifier and Type	Field and Description
static String	COMPONENT
static String	NAME

Constructor Summary

Constructors

Constructor and Description
TemporaryAWSCredentialsProvider(org.apache.hadoop.conf.Configuration conf) Construct from just a configuration.
TemporaryAWSCredentialsProvider(URI uri, org.apache.hadoop.conf.Configuration conf) Constructor: the URI will be null if the provider is inited unbonded to a filesystem.

Method Summary

Modifier and Type	Method and Description
protected com.amazonaws.auth.AWSCredentials	createCredentials(org.apache.hadoop.conf.Configuration config) The credentials here must include a session token, else this operation will raise an exception.

Methods inherited from class org.apache.hadoop.fs.s3a.auth.AbstractSessionCredentialsProvider

getCredentials, getInitializationException, hasCredentials, init, isInitialized, toString

Methods inherited from class org.apache.hadoop.fs.s3a.auth.AbstractAWSCredentialProvider

getConf, getUri, refresh

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

NAME

public static final String NAME

See Also:

Constant Field Values

COMPONENT

public static final String COMPONENT

See Also:

Constant Field Values

Constructor Detail

TemporaryAWSCredentialsProvider

public TemporaryAWSCredentialsProvider(org.apache.hadoop.conf.Configuration conf)
                                throws IOException

Construct from just a configuration.

Parameters:

conf - configuration.

Throws:

IOException - on any failure to load the credentials.

TemporaryAWSCredentialsProvider

public TemporaryAWSCredentialsProvider(@Nullable
                                       URI uri,
                                       org.apache.hadoop.conf.Configuration conf)
                                throws IOException

Constructor: the URI will be null if the provider is inited unbonded to a filesystem.

Parameters:

uri - binding to a filesystem URI.

conf - configuration.

Throws:

IOException - on any failure to load the credentials.

Method Detail

createCredentials

protected com.amazonaws.auth.AWSCredentials createCredentials(org.apache.hadoop.conf.Configuration config)
                                                       throws IOException

The credentials here must include a session token, else this operation will raise an exception.

Specified by:

createCredentials in class AbstractSessionCredentialsProvider

Parameters:

config - the configuration

Returns:

temporary credentials.

Throws:

IOException - on any failure to load the credentials.

NoAuthWithAWSException - validation failure

NoAwsCredentialsException - the credentials are actually empty.