software.amazon.awssdk.regions.servicemetadata

Class EnhancedS3ServiceMetadata

java.lang.Object

software.amazon.awssdk.regions.servicemetadata.EnhancedS3ServiceMetadata

All Implemented Interfaces:

ServiceMetadata

public final class EnhancedS3ServiceMetadata
extends Object
implements ServiceMetadata

Decorator metadata class for S3 to allow customers to opt in to using the regional S3 us-east-1 endpoint instead of the legacy s3.amazonaws.com when specifying the us-east-1 region.

Constructor Summary

Constructors

Constructor and Description
EnhancedS3ServiceMetadata()

Method Summary

Modifier and Type	Method and Description
URI	endpointFor(Region region) Retrieve the AWS endpoint that should be used for this service in the provided region.
ServiceMetadata	reconfigure(ServiceMetadataConfiguration configuration) Reconfigure this service metadata using the provided ServiceMetadataConfiguration.
List<Region>	regions() Retrieve the list of regions this service is currently available in.
List<ServicePartitionMetadata>	servicePartitions() Retrieve the service-specific partition configuration of each partition in which this service is currently available.
Region	signingRegion(Region region) Retrieve the region that should be used for message signing when communicating with this service in the provided region.

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.regions.ServiceMetadata

computeEndpoint, of, reconfigure

Constructor Detail

EnhancedS3ServiceMetadata

public EnhancedS3ServiceMetadata()

Method Detail

endpointFor

public URI endpointFor(Region region)

Description copied from interface: ServiceMetadata

Retrieve the AWS endpoint that should be used for this service in the provided region.

Specified by:

endpointFor in interface ServiceMetadata

Parameters:

region - The region that should be used to load the service endpoint.

Returns:

The region-specific endpoint for this service.

signingRegion

public Region signingRegion(Region region)

Description copied from interface: ServiceMetadata

Retrieve the region that should be used for message signing when communicating with this service in the provided region. For most services, this will match the provided region, but it may differ for unusual services or when using a region that does not correspond to a physical location, like Region.AWS_GLOBAL.

Specified by:

signingRegion in interface ServiceMetadata

Parameters:

region - The region from which the signing region should be derived.

Returns:

The region that should be used for signing messages when communicating with this service in the requested region.

regions

public List<Region> regions()

Description copied from interface: ServiceMetadata

Retrieve the list of regions this service is currently available in.

Specified by:

regions in interface ServiceMetadata

Returns:

The list of regions this service is currently available in.

servicePartitions

public List<ServicePartitionMetadata> servicePartitions()

Description copied from interface: ServiceMetadata

Retrieve the service-specific partition configuration of each partition in which this service is currently available.

Specified by:

servicePartitions in interface ServiceMetadata

Returns:

The list of service-specific service metadata for each partition in which this service is available.

reconfigure

public ServiceMetadata reconfigure(ServiceMetadataConfiguration configuration)

Description copied from interface: ServiceMetadata

Reconfigure this service metadata using the provided ServiceMetadataConfiguration. This is useful, because some service metadata instances refer to external configuration that might wish to be modified, like a ProfileFile.

Specified by:

reconfigure in interface ServiceMetadata