@@ -70,6 +70,10 @@ func GetUseFIPSEndpoint(options ...interface{}) (value FIPSEndpointState, found
70
70
// The SDK will automatically resolve these endpoints per API client using an
71
71
// internal endpoint resolvers. If you'd like to provide custom endpoint
72
72
// resolving behavior you can implement the EndpointResolver interface.
73
+ //
74
+ // Deprecated: This structure was used with the global [EndpointResolver]
75
+ // interface, which has been deprecated in favor of service-specific endpoint
76
+ // resolution. See the deprecation docs on that interface for more information.
73
77
type Endpoint struct {
74
78
// The base URL endpoint the SDK API clients will use to make API calls to.
75
79
// The SDK will suffix URI path and query elements to this endpoint.
@@ -124,6 +128,8 @@ type Endpoint struct {
124
128
}
125
129
126
130
// EndpointSource is the endpoint source type.
131
+ //
132
+ // Deprecated: The global [Endpoint] structure is deprecated.
127
133
type EndpointSource int
128
134
129
135
const (
@@ -161,19 +167,25 @@ func (e *EndpointNotFoundError) Unwrap() error {
161
167
// API clients will fallback to attempting to resolve the endpoint using its
162
168
// internal default endpoint resolver.
163
169
//
164
- // Deprecated: See EndpointResolverWithOptions
170
+ // Deprecated: The global endpoint resolution interface is deprecated. The API
171
+ // for endpoint resolution is now unique to each service and is set via the
172
+ // EndpointResolverV2 field on service client options. Setting a value for
173
+ // EndpointResolver on aws.Config or service client options will prevent you
174
+ // from using any endpoint-related service features released after the
175
+ // introduction of EndpointResolverV2. You may also encounter broken or
176
+ // unexpected behavior when using the old global interface with services that
177
+ // use many endpoint-related customizations such as S3.
165
178
type EndpointResolver interface {
166
179
ResolveEndpoint (service , region string ) (Endpoint , error )
167
180
}
168
181
169
182
// EndpointResolverFunc wraps a function to satisfy the EndpointResolver interface.
170
183
//
171
- // Deprecated: See EndpointResolverWithOptionsFunc
184
+ // Deprecated: The global endpoint resolution interface is deprecated. See
185
+ // deprecation docs on [EndpointResolver].
172
186
type EndpointResolverFunc func (service , region string ) (Endpoint , error )
173
187
174
188
// ResolveEndpoint calls the wrapped function and returns the results.
175
- //
176
- // Deprecated: See EndpointResolverWithOptions.ResolveEndpoint
177
189
func (e EndpointResolverFunc ) ResolveEndpoint (service , region string ) (Endpoint , error ) {
178
190
return e (service , region )
179
191
}
@@ -184,11 +196,17 @@ func (e EndpointResolverFunc) ResolveEndpoint(service, region string) (Endpoint,
184
196
// available. If the EndpointResolverWithOptions returns an EndpointNotFoundError error,
185
197
// API clients will fallback to attempting to resolve the endpoint using its
186
198
// internal default endpoint resolver.
199
+ //
200
+ // Deprecated: The global endpoint resolution interface is deprecated. See
201
+ // deprecation docs on [EndpointResolver].
187
202
type EndpointResolverWithOptions interface {
188
203
ResolveEndpoint (service , region string , options ... interface {}) (Endpoint , error )
189
204
}
190
205
191
206
// EndpointResolverWithOptionsFunc wraps a function to satisfy the EndpointResolverWithOptions interface.
207
+ //
208
+ // Deprecated: The global endpoint resolution interface is deprecated. See
209
+ // deprecation docs on [EndpointResolver].
192
210
type EndpointResolverWithOptionsFunc func (service , region string , options ... interface {}) (Endpoint , error )
193
211
194
212
// ResolveEndpoint calls the wrapped function and returns the results.
0 commit comments