123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494 |
- // Code generated by smithy-go-codegen DO NOT EDIT.
- package cloudwatchlogs
- import (
- "context"
- cryptorand "crypto/rand"
- "fmt"
- "github.com/aws/aws-sdk-go-v2/aws"
- "github.com/aws/aws-sdk-go-v2/aws/defaults"
- awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware"
- "github.com/aws/aws-sdk-go-v2/aws/retry"
- "github.com/aws/aws-sdk-go-v2/aws/signer/v4"
- awshttp "github.com/aws/aws-sdk-go-v2/aws/transport/http"
- internalauth "github.com/aws/aws-sdk-go-v2/internal/auth"
- internalauthsmithy "github.com/aws/aws-sdk-go-v2/internal/auth/smithy"
- internalConfig "github.com/aws/aws-sdk-go-v2/internal/configsources"
- smithy "github.com/aws/smithy-go"
- smithydocument "github.com/aws/smithy-go/document"
- "github.com/aws/smithy-go/logging"
- "github.com/aws/smithy-go/middleware"
- smithyrand "github.com/aws/smithy-go/rand"
- smithyhttp "github.com/aws/smithy-go/transport/http"
- "net"
- "net/http"
- "time"
- )
- const ServiceID = "CloudWatch Logs"
- const ServiceAPIVersion = "2014-03-28"
- // Client provides the API client to make operations call for Amazon CloudWatch
- // Logs.
- type Client struct {
- options Options
- }
- // New returns an initialized Client based on the functional options. Provide
- // additional functional options to further configure the behavior of the client,
- // such as changing the client's endpoint or adding custom middleware behavior.
- func New(options Options, optFns ...func(*Options)) *Client {
- options = options.Copy()
- resolveDefaultLogger(&options)
- setResolvedDefaultsMode(&options)
- resolveRetryer(&options)
- resolveHTTPClient(&options)
- resolveHTTPSignerV4(&options)
- resolveIdempotencyTokenProvider(&options)
- resolveEndpointResolverV2(&options)
- resolveAuthSchemeResolver(&options)
- for _, fn := range optFns {
- fn(&options)
- }
- finalizeRetryMaxAttempts(&options)
- ignoreAnonymousAuth(&options)
- wrapWithAnonymousAuth(&options)
- resolveAuthSchemes(&options)
- client := &Client{
- options: options,
- }
- return client
- }
- // Options returns a copy of the client configuration.
- //
- // Callers SHOULD NOT perform mutations on any inner structures within client
- // config. Config overrides should instead be made on a per-operation basis through
- // functional options.
- func (c *Client) Options() Options {
- return c.options.Copy()
- }
- func (c *Client) invokeOperation(ctx context.Context, opID string, params interface{}, optFns []func(*Options), stackFns ...func(*middleware.Stack, Options) error) (result interface{}, metadata middleware.Metadata, err error) {
- ctx = middleware.ClearStackValues(ctx)
- stack := middleware.NewStack(opID, smithyhttp.NewStackRequest)
- options := c.options.Copy()
- for _, fn := range optFns {
- fn(&options)
- }
- setSafeEventStreamClientLogMode(&options, opID)
- finalizeOperationRetryMaxAttempts(&options, *c)
- finalizeClientEndpointResolverOptions(&options)
- for _, fn := range stackFns {
- if err := fn(stack, options); err != nil {
- return nil, metadata, err
- }
- }
- for _, fn := range options.APIOptions {
- if err := fn(stack); err != nil {
- return nil, metadata, err
- }
- }
- handler := middleware.DecorateHandler(smithyhttp.NewClientHandler(options.HTTPClient), stack)
- result, metadata, err = handler.Handle(ctx, params)
- if err != nil {
- err = &smithy.OperationError{
- ServiceID: ServiceID,
- OperationName: opID,
- Err: err,
- }
- }
- return result, metadata, err
- }
- type operationInputKey struct{}
- func setOperationInput(ctx context.Context, input interface{}) context.Context {
- return middleware.WithStackValue(ctx, operationInputKey{}, input)
- }
- func getOperationInput(ctx context.Context) interface{} {
- return middleware.GetStackValue(ctx, operationInputKey{})
- }
- type setOperationInputMiddleware struct {
- }
- func (*setOperationInputMiddleware) ID() string {
- return "setOperationInput"
- }
- func (m *setOperationInputMiddleware) HandleSerialize(ctx context.Context, in middleware.SerializeInput, next middleware.SerializeHandler) (
- out middleware.SerializeOutput, metadata middleware.Metadata, err error,
- ) {
- ctx = setOperationInput(ctx, in.Parameters)
- return next.HandleSerialize(ctx, in)
- }
- func addProtocolFinalizerMiddlewares(stack *middleware.Stack, options Options, operation string) error {
- if err := stack.Finalize.Add(&resolveAuthSchemeMiddleware{operation: operation, options: options}, middleware.Before); err != nil {
- return fmt.Errorf("add ResolveAuthScheme: %w", err)
- }
- if err := stack.Finalize.Insert(&getIdentityMiddleware{options: options}, "ResolveAuthScheme", middleware.After); err != nil {
- return fmt.Errorf("add GetIdentity: %v", err)
- }
- if err := stack.Finalize.Insert(&resolveEndpointV2Middleware{options: options}, "GetIdentity", middleware.After); err != nil {
- return fmt.Errorf("add ResolveEndpointV2: %v", err)
- }
- if err := stack.Finalize.Insert(&signRequestMiddleware{}, "ResolveEndpointV2", middleware.After); err != nil {
- return fmt.Errorf("add Signing: %w", err)
- }
- return nil
- }
- func resolveAuthSchemeResolver(options *Options) {
- if options.AuthSchemeResolver == nil {
- options.AuthSchemeResolver = &defaultAuthSchemeResolver{}
- }
- }
- func resolveAuthSchemes(options *Options) {
- if options.AuthSchemes == nil {
- options.AuthSchemes = []smithyhttp.AuthScheme{
- internalauth.NewHTTPAuthScheme("aws.auth#sigv4", &internalauthsmithy.V4SignerAdapter{
- Signer: options.HTTPSignerV4,
- Logger: options.Logger,
- LogSigning: options.ClientLogMode.IsSigning(),
- }),
- }
- }
- }
- type noSmithyDocumentSerde = smithydocument.NoSerde
- type legacyEndpointContextSetter struct {
- LegacyResolver EndpointResolver
- }
- func (*legacyEndpointContextSetter) ID() string {
- return "legacyEndpointContextSetter"
- }
- func (m *legacyEndpointContextSetter) HandleInitialize(ctx context.Context, in middleware.InitializeInput, next middleware.InitializeHandler) (
- out middleware.InitializeOutput, metadata middleware.Metadata, err error,
- ) {
- if m.LegacyResolver != nil {
- ctx = awsmiddleware.SetRequiresLegacyEndpoints(ctx, true)
- }
- return next.HandleInitialize(ctx, in)
- }
- func addlegacyEndpointContextSetter(stack *middleware.Stack, o Options) error {
- return stack.Initialize.Add(&legacyEndpointContextSetter{
- LegacyResolver: o.EndpointResolver,
- }, middleware.Before)
- }
- func resolveDefaultLogger(o *Options) {
- if o.Logger != nil {
- return
- }
- o.Logger = logging.Nop{}
- }
- func addSetLoggerMiddleware(stack *middleware.Stack, o Options) error {
- return middleware.AddSetLoggerMiddleware(stack, o.Logger)
- }
- func setResolvedDefaultsMode(o *Options) {
- if len(o.resolvedDefaultsMode) > 0 {
- return
- }
- var mode aws.DefaultsMode
- mode.SetFromString(string(o.DefaultsMode))
- if mode == aws.DefaultsModeAuto {
- mode = defaults.ResolveDefaultsModeAuto(o.Region, o.RuntimeEnvironment)
- }
- o.resolvedDefaultsMode = mode
- }
- // NewFromConfig returns a new client from the provided config.
- func NewFromConfig(cfg aws.Config, optFns ...func(*Options)) *Client {
- opts := Options{
- Region: cfg.Region,
- DefaultsMode: cfg.DefaultsMode,
- RuntimeEnvironment: cfg.RuntimeEnvironment,
- HTTPClient: cfg.HTTPClient,
- Credentials: cfg.Credentials,
- APIOptions: cfg.APIOptions,
- Logger: cfg.Logger,
- ClientLogMode: cfg.ClientLogMode,
- AppID: cfg.AppID,
- }
- resolveAWSRetryerProvider(cfg, &opts)
- resolveAWSRetryMaxAttempts(cfg, &opts)
- resolveAWSRetryMode(cfg, &opts)
- resolveAWSEndpointResolver(cfg, &opts)
- resolveUseDualStackEndpoint(cfg, &opts)
- resolveUseFIPSEndpoint(cfg, &opts)
- resolveBaseEndpoint(cfg, &opts)
- return New(opts, optFns...)
- }
- func resolveHTTPClient(o *Options) {
- var buildable *awshttp.BuildableClient
- if o.HTTPClient != nil {
- var ok bool
- buildable, ok = o.HTTPClient.(*awshttp.BuildableClient)
- if !ok {
- return
- }
- } else {
- buildable = awshttp.NewBuildableClient()
- }
- modeConfig, err := defaults.GetModeConfiguration(o.resolvedDefaultsMode)
- if err == nil {
- buildable = buildable.WithDialerOptions(func(dialer *net.Dialer) {
- if dialerTimeout, ok := modeConfig.GetConnectTimeout(); ok {
- dialer.Timeout = dialerTimeout
- }
- })
- buildable = buildable.WithTransportOptions(func(transport *http.Transport) {
- if tlsHandshakeTimeout, ok := modeConfig.GetTLSNegotiationTimeout(); ok {
- transport.TLSHandshakeTimeout = tlsHandshakeTimeout
- }
- })
- }
- o.HTTPClient = buildable
- }
- func resolveRetryer(o *Options) {
- if o.Retryer != nil {
- return
- }
- if len(o.RetryMode) == 0 {
- modeConfig, err := defaults.GetModeConfiguration(o.resolvedDefaultsMode)
- if err == nil {
- o.RetryMode = modeConfig.RetryMode
- }
- }
- if len(o.RetryMode) == 0 {
- o.RetryMode = aws.RetryModeStandard
- }
- var standardOptions []func(*retry.StandardOptions)
- if v := o.RetryMaxAttempts; v != 0 {
- standardOptions = append(standardOptions, func(so *retry.StandardOptions) {
- so.MaxAttempts = v
- })
- }
- switch o.RetryMode {
- case aws.RetryModeAdaptive:
- var adaptiveOptions []func(*retry.AdaptiveModeOptions)
- if len(standardOptions) != 0 {
- adaptiveOptions = append(adaptiveOptions, func(ao *retry.AdaptiveModeOptions) {
- ao.StandardOptions = append(ao.StandardOptions, standardOptions...)
- })
- }
- o.Retryer = retry.NewAdaptiveMode(adaptiveOptions...)
- default:
- o.Retryer = retry.NewStandard(standardOptions...)
- }
- }
- func resolveAWSRetryerProvider(cfg aws.Config, o *Options) {
- if cfg.Retryer == nil {
- return
- }
- o.Retryer = cfg.Retryer()
- }
- func resolveAWSRetryMode(cfg aws.Config, o *Options) {
- if len(cfg.RetryMode) == 0 {
- return
- }
- o.RetryMode = cfg.RetryMode
- }
- func resolveAWSRetryMaxAttempts(cfg aws.Config, o *Options) {
- if cfg.RetryMaxAttempts == 0 {
- return
- }
- o.RetryMaxAttempts = cfg.RetryMaxAttempts
- }
- func finalizeRetryMaxAttempts(o *Options) {
- if o.RetryMaxAttempts == 0 {
- return
- }
- o.Retryer = retry.AddWithMaxAttempts(o.Retryer, o.RetryMaxAttempts)
- }
- func finalizeOperationRetryMaxAttempts(o *Options, client Client) {
- if v := o.RetryMaxAttempts; v == 0 || v == client.options.RetryMaxAttempts {
- return
- }
- o.Retryer = retry.AddWithMaxAttempts(o.Retryer, o.RetryMaxAttempts)
- }
- func resolveAWSEndpointResolver(cfg aws.Config, o *Options) {
- if cfg.EndpointResolver == nil && cfg.EndpointResolverWithOptions == nil {
- return
- }
- o.EndpointResolver = withEndpointResolver(cfg.EndpointResolver, cfg.EndpointResolverWithOptions)
- }
- func addClientUserAgent(stack *middleware.Stack, options Options) error {
- if err := awsmiddleware.AddSDKAgentKeyValue(awsmiddleware.APIMetadata, "cloudwatchlogs", goModuleVersion)(stack); err != nil {
- return err
- }
- if len(options.AppID) > 0 {
- return awsmiddleware.AddSDKAgentKey(awsmiddleware.ApplicationIdentifier, options.AppID)(stack)
- }
- return nil
- }
- type HTTPSignerV4 interface {
- SignHTTP(ctx context.Context, credentials aws.Credentials, r *http.Request, payloadHash string, service string, region string, signingTime time.Time, optFns ...func(*v4.SignerOptions)) error
- }
- func resolveHTTPSignerV4(o *Options) {
- if o.HTTPSignerV4 != nil {
- return
- }
- o.HTTPSignerV4 = newDefaultV4Signer(*o)
- }
- func newDefaultV4Signer(o Options) *v4.Signer {
- return v4.NewSigner(func(so *v4.SignerOptions) {
- so.Logger = o.Logger
- so.LogSigning = o.ClientLogMode.IsSigning()
- })
- }
- func resolveIdempotencyTokenProvider(o *Options) {
- if o.IdempotencyTokenProvider != nil {
- return
- }
- o.IdempotencyTokenProvider = smithyrand.NewUUIDIdempotencyToken(cryptorand.Reader)
- }
- func addRetryMiddlewares(stack *middleware.Stack, o Options) error {
- mo := retry.AddRetryMiddlewaresOptions{
- Retryer: o.Retryer,
- LogRetryAttempts: o.ClientLogMode.IsRetries(),
- }
- return retry.AddRetryMiddlewares(stack, mo)
- }
- // resolves dual-stack endpoint configuration
- func resolveUseDualStackEndpoint(cfg aws.Config, o *Options) error {
- if len(cfg.ConfigSources) == 0 {
- return nil
- }
- value, found, err := internalConfig.ResolveUseDualStackEndpoint(context.Background(), cfg.ConfigSources)
- if err != nil {
- return err
- }
- if found {
- o.EndpointOptions.UseDualStackEndpoint = value
- }
- return nil
- }
- // resolves FIPS endpoint configuration
- func resolveUseFIPSEndpoint(cfg aws.Config, o *Options) error {
- if len(cfg.ConfigSources) == 0 {
- return nil
- }
- value, found, err := internalConfig.ResolveUseFIPSEndpoint(context.Background(), cfg.ConfigSources)
- if err != nil {
- return err
- }
- if found {
- o.EndpointOptions.UseFIPSEndpoint = value
- }
- return nil
- }
- // IdempotencyTokenProvider interface for providing idempotency token
- type IdempotencyTokenProvider interface {
- GetIdempotencyToken() (string, error)
- }
- func addRequestIDRetrieverMiddleware(stack *middleware.Stack) error {
- return awsmiddleware.AddRequestIDRetrieverMiddleware(stack)
- }
- func addResponseErrorMiddleware(stack *middleware.Stack) error {
- return awshttp.AddResponseErrorMiddleware(stack)
- }
- func addRequestResponseLogging(stack *middleware.Stack, o Options) error {
- return stack.Deserialize.Add(&smithyhttp.RequestResponseLogger{
- LogRequest: o.ClientLogMode.IsRequest(),
- LogRequestWithBody: o.ClientLogMode.IsRequestWithBody(),
- LogResponse: o.ClientLogMode.IsResponse(),
- LogResponseWithBody: o.ClientLogMode.IsResponseWithBody(),
- }, middleware.After)
- }
- type disableHTTPSMiddleware struct {
- DisableHTTPS bool
- }
- func (*disableHTTPSMiddleware) ID() string {
- return "disableHTTPS"
- }
- func (m *disableHTTPSMiddleware) HandleFinalize(ctx context.Context, in middleware.FinalizeInput, next middleware.FinalizeHandler) (
- out middleware.FinalizeOutput, metadata middleware.Metadata, err error,
- ) {
- req, ok := in.Request.(*smithyhttp.Request)
- if !ok {
- return out, metadata, fmt.Errorf("unknown transport type %T", in.Request)
- }
- if m.DisableHTTPS && !smithyhttp.GetHostnameImmutable(ctx) {
- req.URL.Scheme = "http"
- }
- return next.HandleFinalize(ctx, in)
- }
- func addDisableHTTPSMiddleware(stack *middleware.Stack, o Options) error {
- return stack.Finalize.Insert(&disableHTTPSMiddleware{
- DisableHTTPS: o.EndpointOptions.DisableHTTPS,
- }, "ResolveEndpointV2", middleware.After)
- }
|