Configure this functionality by using the following:

endpoint_url - shared AWSconfig file setting

AWS_ENDPOINT_URL - environment variable

aws.endpointUrl - JVM system property: Java/Kotlin only

When specified directly within a profile or as an environment variable, this setting specifies the endpoint that is used for all service requests. This endpoint is overridden by any configured service-specific endpoint.

You can also use this setting within aservices section of a shared AWSconfig file to set a custom endpoint for a specific service. For a list of all service identifier keys to use for subsections within theservices section, seeIdentifiers for service-specific endpoints.

Default value:none

Valid values: A URL including the scheme and host for the endpoint. The URL can optionally contain a path component that contains one or more path segments.

AWS_ENDPOINT_URL_<SERVICE> - environment variable

aws.endpointUrl<ServiceName> - JVM system property: Java/Kotlin only

AWS_ENDPOINT_URL_<SERVICE>, where<SERVICE> is the AWS service identifier, sets a custom endpoint for a specific service. For a list of all service-specific environment variables, seeIdentifiers for service-specific endpoints.

This service-specific endpoint overrides any global endpoint set inAWS_ENDPOINT_URL.

Default value:none

Valid values: A URL including the scheme and host for the endpoint. The URL can optionally contain a path component that contains one or more path segments.

ignore_configured_endpoint_urls - shared AWSconfig file setting

AWS_IGNORE_CONFIGURED_ENDPOINT_URLS - environment variable

aws.ignoreConfiguredEndpointUrls - JVM system property: Java/Kotlin only

This setting is used to ignore all custom endpoints configurations.

Note that any explicit endpoint set in the code or on a service client itself is used regardless of this setting. For example, including the--endpoint-url command line parameter with an AWS CLI command or passing an endpoint URL into a client constructor will always take effect.

Default value:false

Valid values:

• true – The SDK or tool does not read any custom configuration options from the sharedconfig file or from environment variables for setting an endpoint URL.

• false – The SDK or tool uses any available user-provided endpoints from the sharedconfig file or from environment variables.

• endpoint_url specified directly within aprofile makes that endpoint the global endpoint.

• endpoint_url nested under a service identifier key within aservices section makes that endpoint apply to requests made only to that service. For details on defining aservices section in your sharedconfig file, seeFormat of the config file.

1. Any explicit setting set in the code or on a service client itself takes precedence over anything else.

   • For the AWS CLI, this is the value provided by the--endpoint-url command line parameter. For an SDK, explicit assignments can take the form of a parameter that you set when you instantiate an AWS service client or configuration object.

2. The value provided by a service-specific environment variable such asAWS_ENDPOINT_URL_DYNAMODB.

3. The value provided by theAWS_ENDPOINT_URL global endpoint environment variable.

4. The value provided by theendpoint_url setting nested under a service identifier key within aservices section of the sharedconfig file.

5. The value provided by theendpoint_url setting specified directly within aprofile of the sharedconfig file.

6. Any default endpoint URL for the respective AWS service is used last.