com.amazonaws.internal

Class EC2MetadataClient

java.lang.Object

com.amazonaws.internal.EC2MetadataClient

public class EC2MetadataClient
extends Object

Simple client for accessing the Amazon EC2 Instance Metadata Service.

Field Summary

Fields

Modifier and Type	Field and Description
static String	SECURITY_CREDENTIALS_RESOURCE Default resource path for credentials in the Amazon EC2 Instance Metadata Service.

Constructor Summary

Constructors

Constructor and Description
EC2MetadataClient()

Method Summary

Methods

Modifier and Type	Method and Description
String	getDefaultCredentials() Connects to the Amazon EC2 Instance Metadata Service to retrieve the default credential information (if any).
String	readResource(String resourcePath) Connects to the metadata service to read the specified resource and returns the text contents.

Methods inherited from class java.lang.Object

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

Field Detail

SECURITY_CREDENTIALS_RESOURCE

public static final String SECURITY_CREDENTIALS_RESOURCE

Default resource path for credentials in the Amazon EC2 Instance Metadata Service.

See Also:

Constant Field Values

Constructor Detail

EC2MetadataClient

public EC2MetadataClient()

Method Detail

getDefaultCredentials

public String getDefaultCredentials()
                             throws IOException

Connects to the Amazon EC2 Instance Metadata Service to retrieve the default credential information (if any).

Returns:

The response from the Amazon EC2 Instance Metadata Service, or null if no credential information was available.

Throws:

IOException - If any problems are encountered while connecting to the Amazon EC2 Instance Metadata Service.

readResource

public String readResource(String resourcePath)
                    throws IOException,
                           AmazonClientException

Connects to the metadata service to read the specified resource and returns the text contents.

Parameters:

resourcePath - The resource

Returns:

The text payload returned from the Amazon EC2 Instance Metadata service for the specified resource path.

Throws:

IOException - If any problems were encountered while connecting to metadata service for the requested resource path.

AmazonClientException - If the requested metadata service is not found.