1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87
|
package retry_test
import (
"context"
"fmt"
"log"
"time"
"github.com/aws/aws-sdk-go-v2/aws"
"github.com/aws/aws-sdk-go-v2/aws/retry"
config "github.com/aws/aws-sdk-go-v2/aws/retry/internal/mock"
s3 "github.com/aws/aws-sdk-go-v2/aws/retry/internal/mock"
types "github.com/aws/aws-sdk-go-v2/aws/retry/internal/mock"
)
func Example_overrideForAllClients() {
cfg, err := config.LoadDefaultConfig(context.TODO(), config.WithRetryer(func() aws.Retryer {
// Generally you will always want to return new instance of a Retryer. This will avoid a global rate limit
// bucket being shared between across all service clients.
return retry.AddWithMaxBackoffDelay(retry.NewStandard(), time.Second*5)
}))
if err != nil {
log.Fatal(err)
return
}
client := s3.NewFromConfig(cfg)
_ = client
}
func Example_overrideForSpecificClient() {
cfg, err := config.LoadDefaultConfig(context.TODO())
if err != nil {
log.Fatal(err)
return
}
client := s3.NewFromConfig(cfg, func(options *s3.Options) {
options.Retryer = retry.AddWithMaxBackoffDelay(options.Retryer, time.Second*5)
})
_ = client
}
func Example_overrideSpecificOperation() {
cfg, err := config.LoadDefaultConfig(context.TODO())
if err != nil {
log.Fatal(err)
return
}
client := s3.NewFromConfig(cfg)
// Wrap the default client retryer with an additional retryable error code for this specific
// operation invocation
_, err = client.GetObject(context.Background(), &s3.GetObjectInput{
Bucket: aws.String("my-bucket"),
Key: aws.String("my-key"),
}, func(options *s3.Options) {
options.Retryer = retry.AddWithErrorCodes(options.Retryer, (*types.NoSuchBucketException)(nil).ErrorCode())
})
if err != nil {
log.Fatal(err)
return
}
}
func ExampleAddWithErrorCodes() {
// Wrap a standard retyer and add the types.NoSuchBucketException Amazon S3 error code as retryable
custom := retry.AddWithErrorCodes(retry.NewStandard(), (*types.NoSuchBucketException)(nil).ErrorCode())
fmt.Println(custom.IsErrorRetryable(&types.NoSuchBucketException{}))
// Output: true
}
func ExampleAddWithMaxAttempts() {
// Wrap a standard retyer and set the max attempts to 5
custom := retry.AddWithMaxAttempts(retry.NewStandard(), 5)
fmt.Println(custom.MaxAttempts())
// Output: 5
}
func ExampleAddWithMaxBackoffDelay() {
// Wrap a standard retyer and add tthe NoSuchBucket API error code to the list of retryables
custom := retry.AddWithMaxBackoffDelay(retry.NewStandard(), time.Second*5)
_ = custom
}
|