api_client.go 34 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171
  1. // Code generated by smithy-go-codegen DO NOT EDIT.
  2. package sts
  3. import (
  4. "context"
  5. "errors"
  6. "fmt"
  7. "github.com/aws/aws-sdk-go-v2/aws"
  8. "github.com/aws/aws-sdk-go-v2/aws/defaults"
  9. awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware"
  10. "github.com/aws/aws-sdk-go-v2/aws/protocol/query"
  11. "github.com/aws/aws-sdk-go-v2/aws/retry"
  12. "github.com/aws/aws-sdk-go-v2/aws/signer/v4"
  13. awshttp "github.com/aws/aws-sdk-go-v2/aws/transport/http"
  14. internalauth "github.com/aws/aws-sdk-go-v2/internal/auth"
  15. internalauthsmithy "github.com/aws/aws-sdk-go-v2/internal/auth/smithy"
  16. internalConfig "github.com/aws/aws-sdk-go-v2/internal/configsources"
  17. internalmiddleware "github.com/aws/aws-sdk-go-v2/internal/middleware"
  18. acceptencodingcust "github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding"
  19. presignedurlcust "github.com/aws/aws-sdk-go-v2/service/internal/presigned-url"
  20. smithy "github.com/aws/smithy-go"
  21. smithyauth "github.com/aws/smithy-go/auth"
  22. smithydocument "github.com/aws/smithy-go/document"
  23. "github.com/aws/smithy-go/logging"
  24. "github.com/aws/smithy-go/metrics"
  25. "github.com/aws/smithy-go/middleware"
  26. "github.com/aws/smithy-go/tracing"
  27. smithyhttp "github.com/aws/smithy-go/transport/http"
  28. "net"
  29. "net/http"
  30. "sync/atomic"
  31. "time"
  32. )
  33. const ServiceID = "STS"
  34. const ServiceAPIVersion = "2011-06-15"
  35. type operationMetrics struct {
  36. Duration metrics.Float64Histogram
  37. SerializeDuration metrics.Float64Histogram
  38. ResolveIdentityDuration metrics.Float64Histogram
  39. ResolveEndpointDuration metrics.Float64Histogram
  40. SignRequestDuration metrics.Float64Histogram
  41. DeserializeDuration metrics.Float64Histogram
  42. }
  43. func (m *operationMetrics) histogramFor(name string) metrics.Float64Histogram {
  44. switch name {
  45. case "client.call.duration":
  46. return m.Duration
  47. case "client.call.serialization_duration":
  48. return m.SerializeDuration
  49. case "client.call.resolve_identity_duration":
  50. return m.ResolveIdentityDuration
  51. case "client.call.resolve_endpoint_duration":
  52. return m.ResolveEndpointDuration
  53. case "client.call.signing_duration":
  54. return m.SignRequestDuration
  55. case "client.call.deserialization_duration":
  56. return m.DeserializeDuration
  57. default:
  58. panic("unrecognized operation metric")
  59. }
  60. }
  61. func timeOperationMetric[T any](
  62. ctx context.Context, metric string, fn func() (T, error),
  63. opts ...metrics.RecordMetricOption,
  64. ) (T, error) {
  65. instr := getOperationMetrics(ctx).histogramFor(metric)
  66. opts = append([]metrics.RecordMetricOption{withOperationMetadata(ctx)}, opts...)
  67. start := time.Now()
  68. v, err := fn()
  69. end := time.Now()
  70. elapsed := end.Sub(start)
  71. instr.Record(ctx, float64(elapsed)/1e9, opts...)
  72. return v, err
  73. }
  74. func startMetricTimer(ctx context.Context, metric string, opts ...metrics.RecordMetricOption) func() {
  75. instr := getOperationMetrics(ctx).histogramFor(metric)
  76. opts = append([]metrics.RecordMetricOption{withOperationMetadata(ctx)}, opts...)
  77. var ended bool
  78. start := time.Now()
  79. return func() {
  80. if ended {
  81. return
  82. }
  83. ended = true
  84. end := time.Now()
  85. elapsed := end.Sub(start)
  86. instr.Record(ctx, float64(elapsed)/1e9, opts...)
  87. }
  88. }
  89. func withOperationMetadata(ctx context.Context) metrics.RecordMetricOption {
  90. return func(o *metrics.RecordMetricOptions) {
  91. o.Properties.Set("rpc.service", middleware.GetServiceID(ctx))
  92. o.Properties.Set("rpc.method", middleware.GetOperationName(ctx))
  93. }
  94. }
  95. type operationMetricsKey struct{}
  96. func withOperationMetrics(parent context.Context, mp metrics.MeterProvider) (context.Context, error) {
  97. meter := mp.Meter("github.com/aws/aws-sdk-go-v2/service/sts")
  98. om := &operationMetrics{}
  99. var err error
  100. om.Duration, err = operationMetricTimer(meter, "client.call.duration",
  101. "Overall call duration (including retries and time to send or receive request and response body)")
  102. if err != nil {
  103. return nil, err
  104. }
  105. om.SerializeDuration, err = operationMetricTimer(meter, "client.call.serialization_duration",
  106. "The time it takes to serialize a message body")
  107. if err != nil {
  108. return nil, err
  109. }
  110. om.ResolveIdentityDuration, err = operationMetricTimer(meter, "client.call.auth.resolve_identity_duration",
  111. "The time taken to acquire an identity (AWS credentials, bearer token, etc) from an Identity Provider")
  112. if err != nil {
  113. return nil, err
  114. }
  115. om.ResolveEndpointDuration, err = operationMetricTimer(meter, "client.call.resolve_endpoint_duration",
  116. "The time it takes to resolve an endpoint (endpoint resolver, not DNS) for the request")
  117. if err != nil {
  118. return nil, err
  119. }
  120. om.SignRequestDuration, err = operationMetricTimer(meter, "client.call.auth.signing_duration",
  121. "The time it takes to sign a request")
  122. if err != nil {
  123. return nil, err
  124. }
  125. om.DeserializeDuration, err = operationMetricTimer(meter, "client.call.deserialization_duration",
  126. "The time it takes to deserialize a message body")
  127. if err != nil {
  128. return nil, err
  129. }
  130. return context.WithValue(parent, operationMetricsKey{}, om), nil
  131. }
  132. func operationMetricTimer(m metrics.Meter, name, desc string) (metrics.Float64Histogram, error) {
  133. return m.Float64Histogram(name, func(o *metrics.InstrumentOptions) {
  134. o.UnitLabel = "s"
  135. o.Description = desc
  136. })
  137. }
  138. func getOperationMetrics(ctx context.Context) *operationMetrics {
  139. return ctx.Value(operationMetricsKey{}).(*operationMetrics)
  140. }
  141. func operationTracer(p tracing.TracerProvider) tracing.Tracer {
  142. return p.Tracer("github.com/aws/aws-sdk-go-v2/service/sts")
  143. }
  144. // Client provides the API client to make operations call for AWS Security Token
  145. // Service.
  146. type Client struct {
  147. options Options
  148. // Difference between the time reported by the server and the client
  149. timeOffset *atomic.Int64
  150. }
  151. // New returns an initialized Client based on the functional options. Provide
  152. // additional functional options to further configure the behavior of the client,
  153. // such as changing the client's endpoint or adding custom middleware behavior.
  154. func New(options Options, optFns ...func(*Options)) *Client {
  155. options = options.Copy()
  156. resolveDefaultLogger(&options)
  157. setResolvedDefaultsMode(&options)
  158. resolveRetryer(&options)
  159. resolveHTTPClient(&options)
  160. resolveHTTPSignerV4(&options)
  161. resolveEndpointResolverV2(&options)
  162. resolveTracerProvider(&options)
  163. resolveMeterProvider(&options)
  164. resolveAuthSchemeResolver(&options)
  165. for _, fn := range optFns {
  166. fn(&options)
  167. }
  168. finalizeRetryMaxAttempts(&options)
  169. ignoreAnonymousAuth(&options)
  170. wrapWithAnonymousAuth(&options)
  171. resolveAuthSchemes(&options)
  172. client := &Client{
  173. options: options,
  174. }
  175. initializeTimeOffsetResolver(client)
  176. return client
  177. }
  178. // Options returns a copy of the client configuration.
  179. //
  180. // Callers SHOULD NOT perform mutations on any inner structures within client
  181. // config. Config overrides should instead be made on a per-operation basis through
  182. // functional options.
  183. func (c *Client) Options() Options {
  184. return c.options.Copy()
  185. }
  186. func (c *Client) invokeOperation(
  187. ctx context.Context, opID string, params interface{}, optFns []func(*Options), stackFns ...func(*middleware.Stack, Options) error,
  188. ) (
  189. result interface{}, metadata middleware.Metadata, err error,
  190. ) {
  191. ctx = middleware.ClearStackValues(ctx)
  192. ctx = middleware.WithServiceID(ctx, ServiceID)
  193. ctx = middleware.WithOperationName(ctx, opID)
  194. stack := middleware.NewStack(opID, smithyhttp.NewStackRequest)
  195. options := c.options.Copy()
  196. for _, fn := range optFns {
  197. fn(&options)
  198. }
  199. finalizeOperationRetryMaxAttempts(&options, *c)
  200. finalizeClientEndpointResolverOptions(&options)
  201. for _, fn := range stackFns {
  202. if err := fn(stack, options); err != nil {
  203. return nil, metadata, err
  204. }
  205. }
  206. for _, fn := range options.APIOptions {
  207. if err := fn(stack); err != nil {
  208. return nil, metadata, err
  209. }
  210. }
  211. ctx, err = withOperationMetrics(ctx, options.MeterProvider)
  212. if err != nil {
  213. return nil, metadata, err
  214. }
  215. tracer := operationTracer(options.TracerProvider)
  216. spanName := fmt.Sprintf("%s.%s", ServiceID, opID)
  217. ctx = tracing.WithOperationTracer(ctx, tracer)
  218. ctx, span := tracer.StartSpan(ctx, spanName, func(o *tracing.SpanOptions) {
  219. o.Kind = tracing.SpanKindClient
  220. o.Properties.Set("rpc.system", "aws-api")
  221. o.Properties.Set("rpc.method", opID)
  222. o.Properties.Set("rpc.service", ServiceID)
  223. })
  224. endTimer := startMetricTimer(ctx, "client.call.duration")
  225. defer endTimer()
  226. defer span.End()
  227. handler := smithyhttp.NewClientHandlerWithOptions(options.HTTPClient, func(o *smithyhttp.ClientHandler) {
  228. o.Meter = options.MeterProvider.Meter("github.com/aws/aws-sdk-go-v2/service/sts")
  229. })
  230. decorated := middleware.DecorateHandler(handler, stack)
  231. result, metadata, err = decorated.Handle(ctx, params)
  232. if err != nil {
  233. span.SetProperty("exception.type", fmt.Sprintf("%T", err))
  234. span.SetProperty("exception.message", err.Error())
  235. var aerr smithy.APIError
  236. if errors.As(err, &aerr) {
  237. span.SetProperty("api.error_code", aerr.ErrorCode())
  238. span.SetProperty("api.error_message", aerr.ErrorMessage())
  239. span.SetProperty("api.error_fault", aerr.ErrorFault().String())
  240. }
  241. err = &smithy.OperationError{
  242. ServiceID: ServiceID,
  243. OperationName: opID,
  244. Err: err,
  245. }
  246. }
  247. span.SetProperty("error", err != nil)
  248. if err == nil {
  249. span.SetStatus(tracing.SpanStatusOK)
  250. } else {
  251. span.SetStatus(tracing.SpanStatusError)
  252. }
  253. return result, metadata, err
  254. }
  255. type operationInputKey struct{}
  256. func setOperationInput(ctx context.Context, input interface{}) context.Context {
  257. return middleware.WithStackValue(ctx, operationInputKey{}, input)
  258. }
  259. func getOperationInput(ctx context.Context) interface{} {
  260. return middleware.GetStackValue(ctx, operationInputKey{})
  261. }
  262. type setOperationInputMiddleware struct {
  263. }
  264. func (*setOperationInputMiddleware) ID() string {
  265. return "setOperationInput"
  266. }
  267. func (m *setOperationInputMiddleware) HandleSerialize(ctx context.Context, in middleware.SerializeInput, next middleware.SerializeHandler) (
  268. out middleware.SerializeOutput, metadata middleware.Metadata, err error,
  269. ) {
  270. ctx = setOperationInput(ctx, in.Parameters)
  271. return next.HandleSerialize(ctx, in)
  272. }
  273. func addProtocolFinalizerMiddlewares(stack *middleware.Stack, options Options, operation string) error {
  274. if err := stack.Finalize.Add(&resolveAuthSchemeMiddleware{operation: operation, options: options}, middleware.Before); err != nil {
  275. return fmt.Errorf("add ResolveAuthScheme: %w", err)
  276. }
  277. if err := stack.Finalize.Insert(&getIdentityMiddleware{options: options}, "ResolveAuthScheme", middleware.After); err != nil {
  278. return fmt.Errorf("add GetIdentity: %v", err)
  279. }
  280. if err := stack.Finalize.Insert(&resolveEndpointV2Middleware{options: options}, "GetIdentity", middleware.After); err != nil {
  281. return fmt.Errorf("add ResolveEndpointV2: %v", err)
  282. }
  283. if err := stack.Finalize.Insert(&signRequestMiddleware{options: options}, "ResolveEndpointV2", middleware.After); err != nil {
  284. return fmt.Errorf("add Signing: %w", err)
  285. }
  286. return nil
  287. }
  288. func resolveAuthSchemeResolver(options *Options) {
  289. if options.AuthSchemeResolver == nil {
  290. options.AuthSchemeResolver = &defaultAuthSchemeResolver{}
  291. }
  292. }
  293. func resolveAuthSchemes(options *Options) {
  294. if options.AuthSchemes == nil {
  295. options.AuthSchemes = []smithyhttp.AuthScheme{
  296. internalauth.NewHTTPAuthScheme("aws.auth#sigv4", &internalauthsmithy.V4SignerAdapter{
  297. Signer: options.HTTPSignerV4,
  298. Logger: options.Logger,
  299. LogSigning: options.ClientLogMode.IsSigning(),
  300. }),
  301. }
  302. }
  303. }
  304. type noSmithyDocumentSerde = smithydocument.NoSerde
  305. type legacyEndpointContextSetter struct {
  306. LegacyResolver EndpointResolver
  307. }
  308. func (*legacyEndpointContextSetter) ID() string {
  309. return "legacyEndpointContextSetter"
  310. }
  311. func (m *legacyEndpointContextSetter) HandleInitialize(ctx context.Context, in middleware.InitializeInput, next middleware.InitializeHandler) (
  312. out middleware.InitializeOutput, metadata middleware.Metadata, err error,
  313. ) {
  314. if m.LegacyResolver != nil {
  315. ctx = awsmiddleware.SetRequiresLegacyEndpoints(ctx, true)
  316. }
  317. return next.HandleInitialize(ctx, in)
  318. }
  319. func addlegacyEndpointContextSetter(stack *middleware.Stack, o Options) error {
  320. return stack.Initialize.Add(&legacyEndpointContextSetter{
  321. LegacyResolver: o.EndpointResolver,
  322. }, middleware.Before)
  323. }
  324. func resolveDefaultLogger(o *Options) {
  325. if o.Logger != nil {
  326. return
  327. }
  328. o.Logger = logging.Nop{}
  329. }
  330. func addSetLoggerMiddleware(stack *middleware.Stack, o Options) error {
  331. return middleware.AddSetLoggerMiddleware(stack, o.Logger)
  332. }
  333. func setResolvedDefaultsMode(o *Options) {
  334. if len(o.resolvedDefaultsMode) > 0 {
  335. return
  336. }
  337. var mode aws.DefaultsMode
  338. mode.SetFromString(string(o.DefaultsMode))
  339. if mode == aws.DefaultsModeAuto {
  340. mode = defaults.ResolveDefaultsModeAuto(o.Region, o.RuntimeEnvironment)
  341. }
  342. o.resolvedDefaultsMode = mode
  343. }
  344. // NewFromConfig returns a new client from the provided config.
  345. func NewFromConfig(cfg aws.Config, optFns ...func(*Options)) *Client {
  346. opts := Options{
  347. Region: cfg.Region,
  348. DefaultsMode: cfg.DefaultsMode,
  349. RuntimeEnvironment: cfg.RuntimeEnvironment,
  350. HTTPClient: cfg.HTTPClient,
  351. Credentials: cfg.Credentials,
  352. APIOptions: cfg.APIOptions,
  353. Logger: cfg.Logger,
  354. ClientLogMode: cfg.ClientLogMode,
  355. AppID: cfg.AppID,
  356. AuthSchemePreference: cfg.AuthSchemePreference,
  357. }
  358. resolveAWSRetryerProvider(cfg, &opts)
  359. resolveAWSRetryMaxAttempts(cfg, &opts)
  360. resolveAWSRetryMode(cfg, &opts)
  361. resolveAWSEndpointResolver(cfg, &opts)
  362. resolveInterceptors(cfg, &opts)
  363. resolveUseDualStackEndpoint(cfg, &opts)
  364. resolveUseFIPSEndpoint(cfg, &opts)
  365. resolveBaseEndpoint(cfg, &opts)
  366. return New(opts, func(o *Options) {
  367. for _, opt := range cfg.ServiceOptions {
  368. opt(ServiceID, o)
  369. }
  370. for _, opt := range optFns {
  371. opt(o)
  372. }
  373. })
  374. }
  375. func resolveHTTPClient(o *Options) {
  376. var buildable *awshttp.BuildableClient
  377. if o.HTTPClient != nil {
  378. var ok bool
  379. buildable, ok = o.HTTPClient.(*awshttp.BuildableClient)
  380. if !ok {
  381. return
  382. }
  383. } else {
  384. buildable = awshttp.NewBuildableClient()
  385. }
  386. modeConfig, err := defaults.GetModeConfiguration(o.resolvedDefaultsMode)
  387. if err == nil {
  388. buildable = buildable.WithDialerOptions(func(dialer *net.Dialer) {
  389. if dialerTimeout, ok := modeConfig.GetConnectTimeout(); ok {
  390. dialer.Timeout = dialerTimeout
  391. }
  392. })
  393. buildable = buildable.WithTransportOptions(func(transport *http.Transport) {
  394. if tlsHandshakeTimeout, ok := modeConfig.GetTLSNegotiationTimeout(); ok {
  395. transport.TLSHandshakeTimeout = tlsHandshakeTimeout
  396. }
  397. })
  398. }
  399. o.HTTPClient = buildable
  400. }
  401. func resolveRetryer(o *Options) {
  402. if o.Retryer != nil {
  403. return
  404. }
  405. if len(o.RetryMode) == 0 {
  406. modeConfig, err := defaults.GetModeConfiguration(o.resolvedDefaultsMode)
  407. if err == nil {
  408. o.RetryMode = modeConfig.RetryMode
  409. }
  410. }
  411. if len(o.RetryMode) == 0 {
  412. o.RetryMode = aws.RetryModeStandard
  413. }
  414. var standardOptions []func(*retry.StandardOptions)
  415. if v := o.RetryMaxAttempts; v != 0 {
  416. standardOptions = append(standardOptions, func(so *retry.StandardOptions) {
  417. so.MaxAttempts = v
  418. })
  419. }
  420. switch o.RetryMode {
  421. case aws.RetryModeAdaptive:
  422. var adaptiveOptions []func(*retry.AdaptiveModeOptions)
  423. if len(standardOptions) != 0 {
  424. adaptiveOptions = append(adaptiveOptions, func(ao *retry.AdaptiveModeOptions) {
  425. ao.StandardOptions = append(ao.StandardOptions, standardOptions...)
  426. })
  427. }
  428. o.Retryer = retry.NewAdaptiveMode(adaptiveOptions...)
  429. default:
  430. o.Retryer = retry.NewStandard(standardOptions...)
  431. }
  432. }
  433. func resolveAWSRetryerProvider(cfg aws.Config, o *Options) {
  434. if cfg.Retryer == nil {
  435. return
  436. }
  437. o.Retryer = cfg.Retryer()
  438. }
  439. func resolveAWSRetryMode(cfg aws.Config, o *Options) {
  440. if len(cfg.RetryMode) == 0 {
  441. return
  442. }
  443. o.RetryMode = cfg.RetryMode
  444. }
  445. func resolveAWSRetryMaxAttempts(cfg aws.Config, o *Options) {
  446. if cfg.RetryMaxAttempts == 0 {
  447. return
  448. }
  449. o.RetryMaxAttempts = cfg.RetryMaxAttempts
  450. }
  451. func finalizeRetryMaxAttempts(o *Options) {
  452. if o.RetryMaxAttempts == 0 {
  453. return
  454. }
  455. o.Retryer = retry.AddWithMaxAttempts(o.Retryer, o.RetryMaxAttempts)
  456. }
  457. func finalizeOperationRetryMaxAttempts(o *Options, client Client) {
  458. if v := o.RetryMaxAttempts; v == 0 || v == client.options.RetryMaxAttempts {
  459. return
  460. }
  461. o.Retryer = retry.AddWithMaxAttempts(o.Retryer, o.RetryMaxAttempts)
  462. }
  463. func resolveAWSEndpointResolver(cfg aws.Config, o *Options) {
  464. if cfg.EndpointResolver == nil && cfg.EndpointResolverWithOptions == nil {
  465. return
  466. }
  467. o.EndpointResolver = withEndpointResolver(cfg.EndpointResolver, cfg.EndpointResolverWithOptions)
  468. }
  469. func resolveInterceptors(cfg aws.Config, o *Options) {
  470. o.Interceptors = cfg.Interceptors.Copy()
  471. }
  472. func addClientUserAgent(stack *middleware.Stack, options Options) error {
  473. ua, err := getOrAddRequestUserAgent(stack)
  474. if err != nil {
  475. return err
  476. }
  477. ua.AddSDKAgentKeyValue(awsmiddleware.APIMetadata, "sts", goModuleVersion)
  478. if len(options.AppID) > 0 {
  479. ua.AddSDKAgentKey(awsmiddleware.ApplicationIdentifier, options.AppID)
  480. }
  481. return nil
  482. }
  483. func getOrAddRequestUserAgent(stack *middleware.Stack) (*awsmiddleware.RequestUserAgent, error) {
  484. id := (*awsmiddleware.RequestUserAgent)(nil).ID()
  485. mw, ok := stack.Build.Get(id)
  486. if !ok {
  487. mw = awsmiddleware.NewRequestUserAgent()
  488. if err := stack.Build.Add(mw, middleware.After); err != nil {
  489. return nil, err
  490. }
  491. }
  492. ua, ok := mw.(*awsmiddleware.RequestUserAgent)
  493. if !ok {
  494. return nil, fmt.Errorf("%T for %s middleware did not match expected type", mw, id)
  495. }
  496. return ua, nil
  497. }
  498. type HTTPSignerV4 interface {
  499. SignHTTP(ctx context.Context, credentials aws.Credentials, r *http.Request, payloadHash string, service string, region string, signingTime time.Time, optFns ...func(*v4.SignerOptions)) error
  500. }
  501. func resolveHTTPSignerV4(o *Options) {
  502. if o.HTTPSignerV4 != nil {
  503. return
  504. }
  505. o.HTTPSignerV4 = newDefaultV4Signer(*o)
  506. }
  507. func newDefaultV4Signer(o Options) *v4.Signer {
  508. return v4.NewSigner(func(so *v4.SignerOptions) {
  509. so.Logger = o.Logger
  510. so.LogSigning = o.ClientLogMode.IsSigning()
  511. })
  512. }
  513. func addClientRequestID(stack *middleware.Stack) error {
  514. return stack.Build.Add(&awsmiddleware.ClientRequestID{}, middleware.After)
  515. }
  516. func addComputeContentLength(stack *middleware.Stack) error {
  517. return stack.Build.Add(&smithyhttp.ComputeContentLength{}, middleware.After)
  518. }
  519. func addRawResponseToMetadata(stack *middleware.Stack) error {
  520. return stack.Deserialize.Add(&awsmiddleware.AddRawResponse{}, middleware.Before)
  521. }
  522. func addRecordResponseTiming(stack *middleware.Stack) error {
  523. return stack.Deserialize.Add(&awsmiddleware.RecordResponseTiming{}, middleware.After)
  524. }
  525. func addSpanRetryLoop(stack *middleware.Stack, options Options) error {
  526. return stack.Finalize.Insert(&spanRetryLoop{options: options}, "Retry", middleware.Before)
  527. }
  528. type spanRetryLoop struct {
  529. options Options
  530. }
  531. func (*spanRetryLoop) ID() string {
  532. return "spanRetryLoop"
  533. }
  534. func (m *spanRetryLoop) HandleFinalize(
  535. ctx context.Context, in middleware.FinalizeInput, next middleware.FinalizeHandler,
  536. ) (
  537. middleware.FinalizeOutput, middleware.Metadata, error,
  538. ) {
  539. tracer := operationTracer(m.options.TracerProvider)
  540. ctx, span := tracer.StartSpan(ctx, "RetryLoop")
  541. defer span.End()
  542. return next.HandleFinalize(ctx, in)
  543. }
  544. func addStreamingEventsPayload(stack *middleware.Stack) error {
  545. return stack.Finalize.Add(&v4.StreamingEventsPayload{}, middleware.Before)
  546. }
  547. func addUnsignedPayload(stack *middleware.Stack) error {
  548. return stack.Finalize.Insert(&v4.UnsignedPayload{}, "ResolveEndpointV2", middleware.After)
  549. }
  550. func addComputePayloadSHA256(stack *middleware.Stack) error {
  551. return stack.Finalize.Insert(&v4.ComputePayloadSHA256{}, "ResolveEndpointV2", middleware.After)
  552. }
  553. func addContentSHA256Header(stack *middleware.Stack) error {
  554. return stack.Finalize.Insert(&v4.ContentSHA256Header{}, (*v4.ComputePayloadSHA256)(nil).ID(), middleware.After)
  555. }
  556. func addIsWaiterUserAgent(o *Options) {
  557. o.APIOptions = append(o.APIOptions, func(stack *middleware.Stack) error {
  558. ua, err := getOrAddRequestUserAgent(stack)
  559. if err != nil {
  560. return err
  561. }
  562. ua.AddUserAgentFeature(awsmiddleware.UserAgentFeatureWaiter)
  563. return nil
  564. })
  565. }
  566. func addIsPaginatorUserAgent(o *Options) {
  567. o.APIOptions = append(o.APIOptions, func(stack *middleware.Stack) error {
  568. ua, err := getOrAddRequestUserAgent(stack)
  569. if err != nil {
  570. return err
  571. }
  572. ua.AddUserAgentFeature(awsmiddleware.UserAgentFeaturePaginator)
  573. return nil
  574. })
  575. }
  576. func addRetry(stack *middleware.Stack, o Options) error {
  577. attempt := retry.NewAttemptMiddleware(o.Retryer, smithyhttp.RequestCloner, func(m *retry.Attempt) {
  578. m.LogAttempts = o.ClientLogMode.IsRetries()
  579. m.OperationMeter = o.MeterProvider.Meter("github.com/aws/aws-sdk-go-v2/service/sts")
  580. })
  581. if err := stack.Finalize.Insert(attempt, "ResolveAuthScheme", middleware.Before); err != nil {
  582. return err
  583. }
  584. if err := stack.Finalize.Insert(&retry.MetricsHeader{}, attempt.ID(), middleware.After); err != nil {
  585. return err
  586. }
  587. return nil
  588. }
  589. // resolves dual-stack endpoint configuration
  590. func resolveUseDualStackEndpoint(cfg aws.Config, o *Options) error {
  591. if len(cfg.ConfigSources) == 0 {
  592. return nil
  593. }
  594. value, found, err := internalConfig.ResolveUseDualStackEndpoint(context.Background(), cfg.ConfigSources)
  595. if err != nil {
  596. return err
  597. }
  598. if found {
  599. o.EndpointOptions.UseDualStackEndpoint = value
  600. }
  601. return nil
  602. }
  603. // resolves FIPS endpoint configuration
  604. func resolveUseFIPSEndpoint(cfg aws.Config, o *Options) error {
  605. if len(cfg.ConfigSources) == 0 {
  606. return nil
  607. }
  608. value, found, err := internalConfig.ResolveUseFIPSEndpoint(context.Background(), cfg.ConfigSources)
  609. if err != nil {
  610. return err
  611. }
  612. if found {
  613. o.EndpointOptions.UseFIPSEndpoint = value
  614. }
  615. return nil
  616. }
  617. func resolveAccountID(identity smithyauth.Identity, mode aws.AccountIDEndpointMode) *string {
  618. if mode == aws.AccountIDEndpointModeDisabled {
  619. return nil
  620. }
  621. if ca, ok := identity.(*internalauthsmithy.CredentialsAdapter); ok && ca.Credentials.AccountID != "" {
  622. return aws.String(ca.Credentials.AccountID)
  623. }
  624. return nil
  625. }
  626. func addTimeOffsetBuild(stack *middleware.Stack, c *Client) error {
  627. mw := internalmiddleware.AddTimeOffsetMiddleware{Offset: c.timeOffset}
  628. if err := stack.Build.Add(&mw, middleware.After); err != nil {
  629. return err
  630. }
  631. return stack.Deserialize.Insert(&mw, "RecordResponseTiming", middleware.Before)
  632. }
  633. func initializeTimeOffsetResolver(c *Client) {
  634. c.timeOffset = new(atomic.Int64)
  635. }
  636. func addUserAgentRetryMode(stack *middleware.Stack, options Options) error {
  637. ua, err := getOrAddRequestUserAgent(stack)
  638. if err != nil {
  639. return err
  640. }
  641. switch options.Retryer.(type) {
  642. case *retry.Standard:
  643. ua.AddUserAgentFeature(awsmiddleware.UserAgentFeatureRetryModeStandard)
  644. case *retry.AdaptiveMode:
  645. ua.AddUserAgentFeature(awsmiddleware.UserAgentFeatureRetryModeAdaptive)
  646. }
  647. return nil
  648. }
  649. type setCredentialSourceMiddleware struct {
  650. ua *awsmiddleware.RequestUserAgent
  651. options Options
  652. }
  653. func (m setCredentialSourceMiddleware) ID() string { return "SetCredentialSourceMiddleware" }
  654. func (m setCredentialSourceMiddleware) HandleBuild(ctx context.Context, in middleware.BuildInput, next middleware.BuildHandler) (
  655. out middleware.BuildOutput, metadata middleware.Metadata, err error,
  656. ) {
  657. asProviderSource, ok := m.options.Credentials.(aws.CredentialProviderSource)
  658. if !ok {
  659. return next.HandleBuild(ctx, in)
  660. }
  661. providerSources := asProviderSource.ProviderSources()
  662. for _, source := range providerSources {
  663. m.ua.AddCredentialsSource(source)
  664. }
  665. return next.HandleBuild(ctx, in)
  666. }
  667. func addCredentialSource(stack *middleware.Stack, options Options) error {
  668. ua, err := getOrAddRequestUserAgent(stack)
  669. if err != nil {
  670. return err
  671. }
  672. mw := setCredentialSourceMiddleware{ua: ua, options: options}
  673. return stack.Build.Insert(&mw, "UserAgent", middleware.Before)
  674. }
  675. func resolveTracerProvider(options *Options) {
  676. if options.TracerProvider == nil {
  677. options.TracerProvider = &tracing.NopTracerProvider{}
  678. }
  679. }
  680. func resolveMeterProvider(options *Options) {
  681. if options.MeterProvider == nil {
  682. options.MeterProvider = metrics.NopMeterProvider{}
  683. }
  684. }
  685. func addRecursionDetection(stack *middleware.Stack) error {
  686. return stack.Build.Add(&awsmiddleware.RecursionDetection{}, middleware.After)
  687. }
  688. func addRequestIDRetrieverMiddleware(stack *middleware.Stack) error {
  689. return stack.Deserialize.Insert(&awsmiddleware.RequestIDRetriever{}, "OperationDeserializer", middleware.Before)
  690. }
  691. func addResponseErrorMiddleware(stack *middleware.Stack) error {
  692. return stack.Deserialize.Insert(&awshttp.ResponseErrorWrapper{}, "RequestIDRetriever", middleware.Before)
  693. }
  694. // HTTPPresignerV4 represents presigner interface used by presign url client
  695. type HTTPPresignerV4 interface {
  696. PresignHTTP(
  697. ctx context.Context, credentials aws.Credentials, r *http.Request,
  698. payloadHash string, service string, region string, signingTime time.Time,
  699. optFns ...func(*v4.SignerOptions),
  700. ) (url string, signedHeader http.Header, err error)
  701. }
  702. // PresignOptions represents the presign client options
  703. type PresignOptions struct {
  704. // ClientOptions are list of functional options to mutate client options used by
  705. // the presign client.
  706. ClientOptions []func(*Options)
  707. // Presigner is the presigner used by the presign url client
  708. Presigner HTTPPresignerV4
  709. }
  710. func (o PresignOptions) copy() PresignOptions {
  711. clientOptions := make([]func(*Options), len(o.ClientOptions))
  712. copy(clientOptions, o.ClientOptions)
  713. o.ClientOptions = clientOptions
  714. return o
  715. }
  716. // WithPresignClientFromClientOptions is a helper utility to retrieve a function
  717. // that takes PresignOption as input
  718. func WithPresignClientFromClientOptions(optFns ...func(*Options)) func(*PresignOptions) {
  719. return withPresignClientFromClientOptions(optFns).options
  720. }
  721. type withPresignClientFromClientOptions []func(*Options)
  722. func (w withPresignClientFromClientOptions) options(o *PresignOptions) {
  723. o.ClientOptions = append(o.ClientOptions, w...)
  724. }
  725. // PresignClient represents the presign url client
  726. type PresignClient struct {
  727. client *Client
  728. options PresignOptions
  729. }
  730. // NewPresignClient generates a presign client using provided API Client and
  731. // presign options
  732. func NewPresignClient(c *Client, optFns ...func(*PresignOptions)) *PresignClient {
  733. var options PresignOptions
  734. for _, fn := range optFns {
  735. fn(&options)
  736. }
  737. if len(options.ClientOptions) != 0 {
  738. c = New(c.options, options.ClientOptions...)
  739. }
  740. if options.Presigner == nil {
  741. options.Presigner = newDefaultV4Signer(c.options)
  742. }
  743. return &PresignClient{
  744. client: c,
  745. options: options,
  746. }
  747. }
  748. func withNopHTTPClientAPIOption(o *Options) {
  749. o.HTTPClient = smithyhttp.NopClient{}
  750. }
  751. type presignContextPolyfillMiddleware struct {
  752. }
  753. func (*presignContextPolyfillMiddleware) ID() string {
  754. return "presignContextPolyfill"
  755. }
  756. func (m *presignContextPolyfillMiddleware) HandleFinalize(ctx context.Context, in middleware.FinalizeInput, next middleware.FinalizeHandler) (
  757. out middleware.FinalizeOutput, metadata middleware.Metadata, err error,
  758. ) {
  759. rscheme := getResolvedAuthScheme(ctx)
  760. if rscheme == nil {
  761. return out, metadata, fmt.Errorf("no resolved auth scheme")
  762. }
  763. schemeID := rscheme.Scheme.SchemeID()
  764. if schemeID == "aws.auth#sigv4" || schemeID == "com.amazonaws.s3#sigv4express" {
  765. if sn, ok := smithyhttp.GetSigV4SigningName(&rscheme.SignerProperties); ok {
  766. ctx = awsmiddleware.SetSigningName(ctx, sn)
  767. }
  768. if sr, ok := smithyhttp.GetSigV4SigningRegion(&rscheme.SignerProperties); ok {
  769. ctx = awsmiddleware.SetSigningRegion(ctx, sr)
  770. }
  771. } else if schemeID == "aws.auth#sigv4a" {
  772. if sn, ok := smithyhttp.GetSigV4ASigningName(&rscheme.SignerProperties); ok {
  773. ctx = awsmiddleware.SetSigningName(ctx, sn)
  774. }
  775. if sr, ok := smithyhttp.GetSigV4ASigningRegions(&rscheme.SignerProperties); ok {
  776. ctx = awsmiddleware.SetSigningRegion(ctx, sr[0])
  777. }
  778. }
  779. return next.HandleFinalize(ctx, in)
  780. }
  781. type presignConverter PresignOptions
  782. func (c presignConverter) convertToPresignMiddleware(stack *middleware.Stack, options Options) (err error) {
  783. if _, ok := stack.Finalize.Get((*acceptencodingcust.DisableGzip)(nil).ID()); ok {
  784. stack.Finalize.Remove((*acceptencodingcust.DisableGzip)(nil).ID())
  785. }
  786. if _, ok := stack.Finalize.Get((*retry.Attempt)(nil).ID()); ok {
  787. stack.Finalize.Remove((*retry.Attempt)(nil).ID())
  788. }
  789. if _, ok := stack.Finalize.Get((*retry.MetricsHeader)(nil).ID()); ok {
  790. stack.Finalize.Remove((*retry.MetricsHeader)(nil).ID())
  791. }
  792. stack.Deserialize.Clear()
  793. stack.Build.Remove((*awsmiddleware.ClientRequestID)(nil).ID())
  794. stack.Build.Remove("UserAgent")
  795. if err := stack.Finalize.Insert(&presignContextPolyfillMiddleware{}, "Signing", middleware.Before); err != nil {
  796. return err
  797. }
  798. pmw := v4.NewPresignHTTPRequestMiddleware(v4.PresignHTTPRequestMiddlewareOptions{
  799. CredentialsProvider: options.Credentials,
  800. Presigner: c.Presigner,
  801. LogSigning: options.ClientLogMode.IsSigning(),
  802. })
  803. if _, err := stack.Finalize.Swap("Signing", pmw); err != nil {
  804. return err
  805. }
  806. if err = smithyhttp.AddNoPayloadDefaultContentTypeRemover(stack); err != nil {
  807. return err
  808. }
  809. // convert request to a GET request
  810. err = query.AddAsGetRequestMiddleware(stack)
  811. if err != nil {
  812. return err
  813. }
  814. err = presignedurlcust.AddAsIsPresigningMiddleware(stack)
  815. if err != nil {
  816. return err
  817. }
  818. return nil
  819. }
  820. func addRequestResponseLogging(stack *middleware.Stack, o Options) error {
  821. return stack.Deserialize.Add(&smithyhttp.RequestResponseLogger{
  822. LogRequest: o.ClientLogMode.IsRequest(),
  823. LogRequestWithBody: o.ClientLogMode.IsRequestWithBody(),
  824. LogResponse: o.ClientLogMode.IsResponse(),
  825. LogResponseWithBody: o.ClientLogMode.IsResponseWithBody(),
  826. }, middleware.After)
  827. }
  828. type disableHTTPSMiddleware struct {
  829. DisableHTTPS bool
  830. }
  831. func (*disableHTTPSMiddleware) ID() string {
  832. return "disableHTTPS"
  833. }
  834. func (m *disableHTTPSMiddleware) HandleFinalize(ctx context.Context, in middleware.FinalizeInput, next middleware.FinalizeHandler) (
  835. out middleware.FinalizeOutput, metadata middleware.Metadata, err error,
  836. ) {
  837. req, ok := in.Request.(*smithyhttp.Request)
  838. if !ok {
  839. return out, metadata, fmt.Errorf("unknown transport type %T", in.Request)
  840. }
  841. if m.DisableHTTPS && !smithyhttp.GetHostnameImmutable(ctx) {
  842. req.URL.Scheme = "http"
  843. }
  844. return next.HandleFinalize(ctx, in)
  845. }
  846. func addDisableHTTPSMiddleware(stack *middleware.Stack, o Options) error {
  847. return stack.Finalize.Insert(&disableHTTPSMiddleware{
  848. DisableHTTPS: o.EndpointOptions.DisableHTTPS,
  849. }, "ResolveEndpointV2", middleware.After)
  850. }
  851. func addInterceptBeforeRetryLoop(stack *middleware.Stack, opts Options) error {
  852. return stack.Finalize.Insert(&smithyhttp.InterceptBeforeRetryLoop{
  853. Interceptors: opts.Interceptors.BeforeRetryLoop,
  854. }, "Retry", middleware.Before)
  855. }
  856. func addInterceptAttempt(stack *middleware.Stack, opts Options) error {
  857. return stack.Finalize.Insert(&smithyhttp.InterceptAttempt{
  858. BeforeAttempt: opts.Interceptors.BeforeAttempt,
  859. AfterAttempt: opts.Interceptors.AfterAttempt,
  860. }, "Retry", middleware.After)
  861. }
  862. func addInterceptExecution(stack *middleware.Stack, opts Options) error {
  863. return stack.Initialize.Add(&smithyhttp.InterceptExecution{
  864. BeforeExecution: opts.Interceptors.BeforeExecution,
  865. AfterExecution: opts.Interceptors.AfterExecution,
  866. }, middleware.Before)
  867. }
  868. func addInterceptBeforeSerialization(stack *middleware.Stack, opts Options) error {
  869. return stack.Serialize.Insert(&smithyhttp.InterceptBeforeSerialization{
  870. Interceptors: opts.Interceptors.BeforeSerialization,
  871. }, "OperationSerializer", middleware.Before)
  872. }
  873. func addInterceptAfterSerialization(stack *middleware.Stack, opts Options) error {
  874. return stack.Serialize.Insert(&smithyhttp.InterceptAfterSerialization{
  875. Interceptors: opts.Interceptors.AfterSerialization,
  876. }, "OperationSerializer", middleware.After)
  877. }
  878. func addInterceptBeforeSigning(stack *middleware.Stack, opts Options) error {
  879. return stack.Finalize.Insert(&smithyhttp.InterceptBeforeSigning{
  880. Interceptors: opts.Interceptors.BeforeSigning,
  881. }, "Signing", middleware.Before)
  882. }
  883. func addInterceptAfterSigning(stack *middleware.Stack, opts Options) error {
  884. return stack.Finalize.Insert(&smithyhttp.InterceptAfterSigning{
  885. Interceptors: opts.Interceptors.AfterSigning,
  886. }, "Signing", middleware.After)
  887. }
  888. func addInterceptTransmit(stack *middleware.Stack, opts Options) error {
  889. return stack.Deserialize.Add(&smithyhttp.InterceptTransmit{
  890. BeforeTransmit: opts.Interceptors.BeforeTransmit,
  891. AfterTransmit: opts.Interceptors.AfterTransmit,
  892. }, middleware.After)
  893. }
  894. func addInterceptBeforeDeserialization(stack *middleware.Stack, opts Options) error {
  895. return stack.Deserialize.Insert(&smithyhttp.InterceptBeforeDeserialization{
  896. Interceptors: opts.Interceptors.BeforeDeserialization,
  897. }, "OperationDeserializer", middleware.After) // (deserialize stack is called in reverse)
  898. }
  899. func addInterceptAfterDeserialization(stack *middleware.Stack, opts Options) error {
  900. return stack.Deserialize.Insert(&smithyhttp.InterceptAfterDeserialization{
  901. Interceptors: opts.Interceptors.AfterDeserialization,
  902. }, "OperationDeserializer", middleware.Before)
  903. }
  904. type spanInitializeStart struct {
  905. }
  906. func (*spanInitializeStart) ID() string {
  907. return "spanInitializeStart"
  908. }
  909. func (m *spanInitializeStart) HandleInitialize(
  910. ctx context.Context, in middleware.InitializeInput, next middleware.InitializeHandler,
  911. ) (
  912. middleware.InitializeOutput, middleware.Metadata, error,
  913. ) {
  914. ctx, _ = tracing.StartSpan(ctx, "Initialize")
  915. return next.HandleInitialize(ctx, in)
  916. }
  917. type spanInitializeEnd struct {
  918. }
  919. func (*spanInitializeEnd) ID() string {
  920. return "spanInitializeEnd"
  921. }
  922. func (m *spanInitializeEnd) HandleInitialize(
  923. ctx context.Context, in middleware.InitializeInput, next middleware.InitializeHandler,
  924. ) (
  925. middleware.InitializeOutput, middleware.Metadata, error,
  926. ) {
  927. ctx, span := tracing.PopSpan(ctx)
  928. span.End()
  929. return next.HandleInitialize(ctx, in)
  930. }
  931. type spanBuildRequestStart struct {
  932. }
  933. func (*spanBuildRequestStart) ID() string {
  934. return "spanBuildRequestStart"
  935. }
  936. func (m *spanBuildRequestStart) HandleSerialize(
  937. ctx context.Context, in middleware.SerializeInput, next middleware.SerializeHandler,
  938. ) (
  939. middleware.SerializeOutput, middleware.Metadata, error,
  940. ) {
  941. ctx, _ = tracing.StartSpan(ctx, "BuildRequest")
  942. return next.HandleSerialize(ctx, in)
  943. }
  944. type spanBuildRequestEnd struct {
  945. }
  946. func (*spanBuildRequestEnd) ID() string {
  947. return "spanBuildRequestEnd"
  948. }
  949. func (m *spanBuildRequestEnd) HandleBuild(
  950. ctx context.Context, in middleware.BuildInput, next middleware.BuildHandler,
  951. ) (
  952. middleware.BuildOutput, middleware.Metadata, error,
  953. ) {
  954. ctx, span := tracing.PopSpan(ctx)
  955. span.End()
  956. return next.HandleBuild(ctx, in)
  957. }
  958. func addSpanInitializeStart(stack *middleware.Stack) error {
  959. return stack.Initialize.Add(&spanInitializeStart{}, middleware.Before)
  960. }
  961. func addSpanInitializeEnd(stack *middleware.Stack) error {
  962. return stack.Initialize.Add(&spanInitializeEnd{}, middleware.After)
  963. }
  964. func addSpanBuildRequestStart(stack *middleware.Stack) error {
  965. return stack.Serialize.Add(&spanBuildRequestStart{}, middleware.Before)
  966. }
  967. func addSpanBuildRequestEnd(stack *middleware.Stack) error {
  968. return stack.Build.Add(&spanBuildRequestEnd{}, middleware.After)
  969. }