http

package
v1.30.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 10, 2024 License: Apache-2.0 Imports: 15 Imported by: 537

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	// Default connection pool options
	DefaultHTTPTransportMaxIdleConns        = 100
	DefaultHTTPTransportMaxIdleConnsPerHost = 10

	// Default connection timeouts
	DefaultHTTPTransportIdleConnTimeout       = 90 * time.Second
	DefaultHTTPTransportTLSHandleshakeTimeout = 10 * time.Second
	DefaultHTTPTransportExpectContinueTimeout = 1 * time.Second

	// Default to TLS 1.2 for all HTTPS requests.
	DefaultHTTPTransportTLSMinVersion uint16 = tls.VersionTLS12
)

Defaults for the HTTPTransportBuilder.

View Source
var (
	DefaultDialConnectTimeout   = 30 * time.Second
	DefaultDialKeepAliveTimeout = 30 * time.Second
)

Timeouts for net.Dialer's network connection.

Functions

func AddResponseErrorMiddleware

func AddResponseErrorMiddleware(stack *middleware.Stack) error

AddResponseErrorMiddleware adds response error wrapper middleware

func AddResponseReadTimeoutMiddleware added in v0.27.0

func AddResponseReadTimeoutMiddleware(stack *middleware.Stack, duration time.Duration) error

AddResponseReadTimeoutMiddleware adds a middleware to the stack that wraps the response body so that a read that takes too long will return an error.

func RemoveContentTypeHeader added in v0.31.0

func RemoveContentTypeHeader(stack *middleware.Stack) error

RemoveContentTypeHeader removes content-type header if content length is unset or equal to zero.

Types

type BuildableClient added in v0.30.0

type BuildableClient struct {
	// contains filtered or unexported fields
}

BuildableClient provides a HTTPClient implementation with options to create copies of the HTTPClient when additional configuration is provided.

The client's methods will not share the http.Transport value between copies of the BuildableClient. Only exported member values of the Transport and optional Dialer will be copied between copies of BuildableClient.

func NewBuildableClient added in v0.30.0

func NewBuildableClient() *BuildableClient

NewBuildableClient returns an initialized client for invoking HTTP requests.

func (*BuildableClient) Do added in v0.30.0

func (b *BuildableClient) Do(req *http.Request) (*http.Response, error)

Do implements the HTTPClient interface's Do method to invoke a HTTP request, and receive the response. Uses the BuildableClient's current configuration to invoke the http.Request.

If connection pooling is enabled (aka HTTP KeepAlive) the client will only share pooled connections with its own instance. Copies of the BuildableClient will have their own connection pools.

Redirect (3xx) responses will not be followed, the HTTP response received will returned instead.

func (*BuildableClient) Freeze added in v1.13.0

func (b *BuildableClient) Freeze() aws.HTTPClient

Freeze returns a frozen aws.HTTPClient implementation that is no longer a BuildableClient. Use this to prevent the SDK from applying DefaultMode configuration values to a buildable client.

func (*BuildableClient) GetDialer added in v0.30.0

func (b *BuildableClient) GetDialer() *net.Dialer

GetDialer returns a copy of the client's network dialer.

func (*BuildableClient) GetTimeout added in v0.30.0

func (b *BuildableClient) GetTimeout() time.Duration

GetTimeout returns a copy of the client's timeout to cancel requests with.

func (*BuildableClient) GetTransport added in v0.30.0

func (b *BuildableClient) GetTransport() *http.Transport

GetTransport returns a copy of the client's HTTP Transport.

func (*BuildableClient) WithDialerOptions added in v0.30.0

func (b *BuildableClient) WithDialerOptions(opts ...func(*net.Dialer)) *BuildableClient

WithDialerOptions copies the BuildableClient and returns it with the net.Dialer options applied. Will set the client's http.Transport DialContext member.

func (*BuildableClient) WithTimeout added in v0.30.0

func (b *BuildableClient) WithTimeout(timeout time.Duration) *BuildableClient

WithTimeout Sets the timeout used by the client for all requests.

func (*BuildableClient) WithTransportOptions added in v0.30.0

func (b *BuildableClient) WithTransportOptions(opts ...func(*http.Transport)) *BuildableClient

WithTransportOptions copies the BuildableClient and returns it with the http.Transport options applied.

If a non (*http.Transport) was set as the round tripper, the round tripper will be replaced with a default Transport value before invoking the option functions.

type ResponseError

type ResponseError struct {
	*smithyhttp.ResponseError

	// RequestID associated with response error
	RequestID string
}

ResponseError provides the HTTP centric error type wrapping the underlying error with the HTTP response value and the deserialized RequestID.

func (*ResponseError) As

func (e *ResponseError) As(target interface{}) bool

As populates target and returns true if the type of target is a error type that the ResponseError embeds, (e.g.AWS HTTP ResponseError)

func (*ResponseError) Error

func (e *ResponseError) Error() string

Error returns the formatted error

func (*ResponseError) ServiceRequestID

func (e *ResponseError) ServiceRequestID() string

ServiceRequestID returns the request id associated with Response Error

type ResponseErrorWrapper added in v1.25.2

type ResponseErrorWrapper struct {
}

ResponseErrorWrapper wraps operation errors with ResponseError.

func (*ResponseErrorWrapper) HandleDeserialize added in v1.25.2

HandleDeserialize wraps the stack error with smithyhttp.ResponseError.

func (*ResponseErrorWrapper) ID added in v1.25.2

func (m *ResponseErrorWrapper) ID() string

ID returns the middleware identifier

type ResponseTimeoutError added in v0.27.0

type ResponseTimeoutError struct {
	TimeoutDur time.Duration
}

ResponseTimeoutError is an error when the reads from the response are delayed longer than the timeout the read was configured for.

func (*ResponseTimeoutError) Error added in v0.27.0

func (e *ResponseTimeoutError) Error() string

func (*ResponseTimeoutError) Timeout added in v0.27.0

func (*ResponseTimeoutError) Timeout() bool

Timeout returns that the error is was caused by a timeout, and can be retried.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL