github.com/aavshr/aws-sdk-go@v1.41.3/service/s3control/service.go (about) 1 // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT. 2 3 package s3control 4 5 import ( 6 "github.com/aavshr/aws-sdk-go/aws" 7 "github.com/aavshr/aws-sdk-go/aws/client" 8 "github.com/aavshr/aws-sdk-go/aws/client/metadata" 9 "github.com/aavshr/aws-sdk-go/aws/request" 10 "github.com/aavshr/aws-sdk-go/aws/signer/v4" 11 "github.com/aavshr/aws-sdk-go/private/protocol/restxml" 12 ) 13 14 // S3Control provides the API operation methods for making requests to 15 // AWS S3 Control. See this package's package overview docs 16 // for details on the service. 17 // 18 // S3Control methods are safe to use concurrently. It is not safe to 19 // modify mutate any of the struct's properties though. 20 type S3Control struct { 21 *client.Client 22 } 23 24 // Used for custom client initialization logic 25 var initClient func(*client.Client) 26 27 // Used for custom request initialization logic 28 var initRequest func(*request.Request) 29 30 // Service information constants 31 const ( 32 ServiceName = "S3 Control" // Name of service. 33 EndpointsID = "s3-control" // ID to lookup a service endpoint with. 34 ServiceID = "S3 Control" // ServiceID is a unique identifier of a specific service. 35 ) 36 37 // New creates a new instance of the S3Control client with a session. 38 // If additional configuration is needed for the client instance use the optional 39 // aws.Config parameter to add your extra config. 40 // 41 // Example: 42 // mySession := session.Must(session.NewSession()) 43 // 44 // // Create a S3Control client from just a session. 45 // svc := s3control.New(mySession) 46 // 47 // // Create a S3Control client with additional configuration 48 // svc := s3control.New(mySession, aws.NewConfig().WithRegion("us-west-2")) 49 func New(p client.ConfigProvider, cfgs ...*aws.Config) *S3Control { 50 c := p.ClientConfig(EndpointsID, cfgs...) 51 if c.SigningNameDerived || len(c.SigningName) == 0 { 52 c.SigningName = "s3" 53 } 54 return newClient(*c.Config, c.Handlers, c.PartitionID, c.Endpoint, c.SigningRegion, c.SigningName) 55 } 56 57 // newClient creates, initializes and returns a new service client instance. 58 func newClient(cfg aws.Config, handlers request.Handlers, partitionID, endpoint, signingRegion, signingName string) *S3Control { 59 svc := &S3Control{ 60 Client: client.New( 61 cfg, 62 metadata.ClientInfo{ 63 ServiceName: ServiceName, 64 ServiceID: ServiceID, 65 SigningName: signingName, 66 SigningRegion: signingRegion, 67 PartitionID: partitionID, 68 Endpoint: endpoint, 69 APIVersion: "2018-08-20", 70 }, 71 handlers, 72 ), 73 } 74 75 // Handlers 76 svc.Handlers.Sign.PushBackNamed(v4.BuildNamedHandler(v4.SignRequestHandler.Name, func(s *v4.Signer) { 77 s.DisableURIPathEscaping = true 78 })) 79 svc.Handlers.Build.PushBackNamed(restxml.BuildHandler) 80 svc.Handlers.Unmarshal.PushBackNamed(restxml.UnmarshalHandler) 81 svc.Handlers.UnmarshalMeta.PushBackNamed(restxml.UnmarshalMetaHandler) 82 svc.Handlers.UnmarshalError.PushBackNamed(restxml.UnmarshalErrorHandler) 83 84 // Run custom client initialization if present 85 if initClient != nil { 86 initClient(svc.Client) 87 } 88 89 return svc 90 } 91 92 // newRequest creates a new request for a S3Control operation and runs any 93 // custom request initialization. 94 func (c *S3Control) newRequest(op *request.Operation, params, data interface{}) *request.Request { 95 req := c.NewRequest(op, params, data) 96 97 // Run custom request initialization if present 98 if initRequest != nil { 99 initRequest(req) 100 } 101 102 return req 103 }