aws

Documentation

Overview

Package aws provides fundamental Wire providers for Amazon Web Services (AWS).

Index

• Variables
• func ConfigCredentials(cfg *aws.Config) *credentials.Credentials
• func ConfigFromURLParams(q url.Values) (*aws.Config, error)
• func NewDefaultSession() (*session.Session, error)
• func SessionConfig(sess *session.Session) *aws.Config
• type ConfigOverrider
  • func (co ConfigOverrider) ClientConfig(serviceName string, cfgs ...*aws.Config) client.Config

Variables

var DefaultSession = wire.NewSet(
	SessionConfig,
	ConfigCredentials,
	NewDefaultSession,
	wire.Bind(new(client.ConfigProvider), new(*session.Session)),
)

DefaultSession is a Wire provider set that provides a *session.Session using the default options.

Functions

func ConfigCredentials

func ConfigCredentials(cfg *aws.Config) *credentials.Credentials

ConfigCredentials returns cfg.Credentials.

func ConfigFromURLParams

func ConfigFromURLParams(q url.Values) (*aws.Config, error)

ConfigFromURLParams returns an aws.Config initialized based on the URL parameters in q. It is intended to be used by URLOpeners for AWS services. https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config

It returns an error if q contains any unknown query parameters; callers should remove any query parameters they know about from q before calling ConfigFromURLParams.

The following query options are supported:

• region: The AWS region for requests; sets aws.Config.Region.
• endpoint: The endpoint URL (hostname only or fully qualified URI); sets aws.Config.Endpoint.
• disableSSL: A value of "true" disables SSL when sending requests; sets aws.Config.DisableSSL.
• s3ForcePathStyle: A value of "true" forces the request to use path-style addressing; sets aws.Config.S3ForcePathStyle.

func NewDefaultSession

func NewDefaultSession() (*session.Session, error)

NewDefaultSession returns a *session.Session using the default options.

func SessionConfig

func SessionConfig(sess *session.Session) *aws.Config

SessionConfig returns sess.Config.

Types

type ConfigOverrider

type ConfigOverrider struct {
	Base    client.ConfigProvider
	Configs []*aws.Config
}

ConfigOverrider implements client.ConfigProvider by overlaying a list of configurations over a base configuration provider.

func (ConfigOverrider) ClientConfig

func (co ConfigOverrider) ClientConfig(serviceName string, cfgs ...*aws.Config) client.Config

ClientConfig calls the base provider's ClientConfig method with co.Configs followed by the arguments given to ClientConfig.