Package software.amazon.awssdk.imds.internal

Class DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder

java.lang.Object

software.amazon.awssdk.imds.internal.DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder

All Implemented Interfaces:

Ec2MetadataAsyncClient.Builder, Ec2MetadataClientBuilder<Ec2MetadataAsyncClient.Builder,Ec2MetadataAsyncClient>, Buildable, SdkBuilder<Ec2MetadataClientBuilder<Ec2MetadataAsyncClient.Builder,Ec2MetadataAsyncClient>,Ec2MetadataAsyncClient>

Enclosing class:

DefaultEc2MetadataAsyncClient

protected static final class DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder
extends Object
implements Ec2MetadataAsyncClient.Builder

Method Summary

Modifier and Type	Method	Description
Ec2MetadataAsyncClient	build()
DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder	endpoint(URI endpoint)	Define the endpoint of IMDS.
DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder	endpointMode(EndpointMode endpointMode)	Define the endpoint mode of IMDS.
URI	getEndpoint()
EndpointMode	getEndpointMode()
Ec2MetadataRetryPolicy	getRetryPolicy()
Duration	getTokenTtl()
DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder	httpClient(SdkAsyncHttpClient httpClient)	Define the http client used by the Ec2 Metadata client.
Ec2MetadataAsyncClient.Builder	httpClient(SdkAsyncHttpClient.Builder<?> builder)	An http client builder used to retrieve an instance of an SdkAsyncHttpClient.
DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder	retryPolicy(Consumer<Ec2MetadataRetryPolicy.Builder> builderConsumer)	Define the retry policy which includes the number of retry attempts for any failed request.
DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder	retryPolicy(Ec2MetadataRetryPolicy retryPolicy)	Define the retry policy which includes the number of retry attempts for any failed request.
DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder	scheduledExecutorService(ScheduledExecutorService scheduledExecutorService)	Define the ScheduledExecutorService used to schedule asynchronous retry attempts.
DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder	tokenTtl(Duration tokenTtl)	Define the Time to live (TTL) of the token.

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder

applyMutation

Method Details

retryPolicy

public DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder retryPolicy(Ec2MetadataRetryPolicy retryPolicy)

Description copied from interface: Ec2MetadataClientBuilder

Define the retry policy which includes the number of retry attempts for any failed request.

If not specified, defaults to 3 retry attempts and a BackoffStrategy.defaultStrategy() backoff strategy} that uses RetryMode.STANDARD. Can be also specified by using the Ec2MetadataClientBuilder.retryPolicy(Consumer) method. if any of the retryPolicy methods are called multiple times, only the last invocation will be considered.

Specified by:

retryPolicy in interface Ec2MetadataClientBuilder<Ec2MetadataAsyncClient.Builder,Ec2MetadataAsyncClient>

Parameters:

retryPolicy - The retry policy which includes the number of retry attempts for any failed request.

Returns:

a reference to this builder

retryPolicy

public DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder retryPolicy(Consumer<Ec2MetadataRetryPolicy.Builder> builderConsumer)

Description copied from interface: Ec2MetadataClientBuilder

Define the retry policy which includes the number of retry attempts for any failed request. Can be used instead of Ec2MetadataClientBuilder.retryPolicy(Ec2MetadataRetryPolicy) to use a "fluent consumer" syntax. User should not manually build the builder in the consumer.

If not specified, defaults to 3 retry attempts and a BackoffStrategy.defaultStrategy() backoff strategy} that uses RetryMode.STANDARD. Can be also specified by using the Ec2MetadataClientBuilder.retryPolicy(Ec2MetadataRetryPolicy) method. if any of the retryPolicy methods are called multiple times, only the last invocation will be considered.

Specified by:

retryPolicy in interface Ec2MetadataClientBuilder<Ec2MetadataAsyncClient.Builder,Ec2MetadataAsyncClient>

Parameters:

builderConsumer - the consumer

Returns:

a reference to this builder

endpoint

public DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder endpoint(URI endpoint)

Description copied from interface: Ec2MetadataClientBuilder

Define the endpoint of IMDS.

If not specified, the IMDS client will attempt to automatically resolve the endpoint value.

Specified by:

endpoint in interface Ec2MetadataClientBuilder<Ec2MetadataAsyncClient.Builder,Ec2MetadataAsyncClient>

Parameters:

endpoint - The endpoint of IMDS.

Returns:

a reference to this builder

tokenTtl

public DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder tokenTtl(Duration tokenTtl)

Description copied from interface: Ec2MetadataClientBuilder

Define the Time to live (TTL) of the token. The token represents a logical session. The TTL specifies the length of time that the token is valid and, therefore, the duration of the session. Defaults to 21,600 seconds (6 hours) if not specified.

Specified by:

tokenTtl in interface Ec2MetadataClientBuilder<Ec2MetadataAsyncClient.Builder,Ec2MetadataAsyncClient>

Parameters:

tokenTtl - The Time to live (TTL) of the token.

Returns:

a reference to this builder

endpointMode

public DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder endpointMode(EndpointMode endpointMode)

Description copied from interface: Ec2MetadataClientBuilder

Define the endpoint mode of IMDS. Supported values include IPv4 and IPv6. Used to determine the endpoint of the IMDS Client only if Ec2MetadataClientBuilder.endpoint(URI) is not specified. Only one of both endpoint or endpoint mode but not both. If both are specified in the Builder, a IllegalArgumentException will be thrown.

If not specified, the IMDS client will attempt to automatically resolve the endpoint mode value.

Specified by:

endpointMode in interface Ec2MetadataClientBuilder<Ec2MetadataAsyncClient.Builder,Ec2MetadataAsyncClient>

Parameters:

endpointMode - The endpoint mode of IMDS. Supported values include IPv4 and IPv6.

Returns:

a reference to this builder

httpClient

public DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder httpClient(SdkAsyncHttpClient httpClient)

Description copied from interface: Ec2MetadataAsyncClient.Builder

Define the http client used by the Ec2 Metadata client. If provided, the Ec2MetadataClient will NOT manage the lifetime if the httpClient and must therefore be closed explicitly by calling the SdkAutoCloseable.close() method on it.

If not specified, the IMDS client will look for a SdkAsyncHttpClient class included in the classpath of the application and creates a new instance of that class, managed by the IMDS Client, that will be closed when the IMDS Client is closed. If no such class can be found, will throw a SdkClientException.

Specified by:

httpClient in interface Ec2MetadataAsyncClient.Builder

Parameters:

httpClient - the http client

Returns:

a reference to this builder

httpClient

public Ec2MetadataAsyncClient.Builder httpClient(SdkAsyncHttpClient.Builder<?> builder)

Description copied from interface: Ec2MetadataAsyncClient.Builder

An http client builder used to retrieve an instance of an SdkAsyncHttpClient. If specified, the Ec2 Metadata Client will use the instance returned by the builder and manage its lifetime by closing the http client once the Ec2 Client itself is closed.

Specified by:

httpClient in interface Ec2MetadataAsyncClient.Builder

Parameters:

builder - the builder to used to retrieve an instance.

Returns:

a reference to this builder

scheduledExecutorService

public DefaultEc2MetadataAsyncClient.Ec2MetadataAsyncBuilder scheduledExecutorService(ScheduledExecutorService scheduledExecutorService)

Description copied from interface: Ec2MetadataAsyncClient.Builder

Define the ScheduledExecutorService used to schedule asynchronous retry attempts. If provided, the Ec2MetadataClient will NOT manage the lifetime if the httpClient and must therefore be closed explicitly by calling the SdkAutoCloseable.close() method on it.

If not specified, defaults to Executors.newScheduledThreadPool(int) with a default value of 3 thread in the pool.

Specified by:

scheduledExecutorService in interface Ec2MetadataAsyncClient.Builder

Parameters:

scheduledExecutorService - the ScheduledExecutorService to use for retry attempt.

Returns:

a reference to this builder

getRetryPolicy

public Ec2MetadataRetryPolicy getRetryPolicy()

getEndpoint

public URI getEndpoint()

getTokenTtl

public Duration getTokenTtl()

getEndpointMode

public EndpointMode getEndpointMode()

build

public Ec2MetadataAsyncClient build()

Specified by:

build in interface Buildable

Specified by:

build in interface SdkBuilder<Ec2MetadataClientBuilder<Ec2MetadataAsyncClient.Builder,Ec2MetadataAsyncClient>,Ec2MetadataAsyncClient>