1// Code generated by smithy-go-codegen DO NOT EDIT.
2
3package gamelift
4
5import (
6	"context"
7	awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware"
8	"github.com/aws/aws-sdk-go-v2/aws/signer/v4"
9	"github.com/aws/aws-sdk-go-v2/service/gamelift/types"
10	"github.com/aws/smithy-go/middleware"
11	smithyhttp "github.com/aws/smithy-go/transport/http"
12)
13
14// Retrieves a fresh set of credentials for use when uploading a new set of game
15// build files to Amazon GameLift's Amazon S3. This is done as part of the build
16// creation process; see CreateBuild. To request new credentials, specify the build
17// ID as returned with an initial CreateBuild request. If successful, a new set of
18// credentials are returned, along with the S3 storage location associated with the
19// build ID. Learn more  Create a Build with Files in S3
20// (https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-create-build)
21// Related operations
22//
23// * CreateBuild
24//
25// * ListBuilds
26//
27// * DescribeBuild
28//
29// *
30// UpdateBuild
31//
32// * DeleteBuild
33func (c *Client) RequestUploadCredentials(ctx context.Context, params *RequestUploadCredentialsInput, optFns ...func(*Options)) (*RequestUploadCredentialsOutput, error) {
34	if params == nil {
35		params = &RequestUploadCredentialsInput{}
36	}
37
38	result, metadata, err := c.invokeOperation(ctx, "RequestUploadCredentials", params, optFns, addOperationRequestUploadCredentialsMiddlewares)
39	if err != nil {
40		return nil, err
41	}
42
43	out := result.(*RequestUploadCredentialsOutput)
44	out.ResultMetadata = metadata
45	return out, nil
46}
47
48// Represents the input for a request operation.
49type RequestUploadCredentialsInput struct {
50
51	// A unique identifier for a build to get credentials for. You can use either the
52	// build ID or ARN value.
53	//
54	// This member is required.
55	BuildId *string
56}
57
58// Represents the returned data in response to a request operation.
59type RequestUploadCredentialsOutput struct {
60
61	// Amazon S3 path and key, identifying where the game build files are stored.
62	StorageLocation *types.S3Location
63
64	// AWS credentials required when uploading a game build to the storage location.
65	// These credentials have a limited lifespan and are valid only for the build they
66	// were issued for.
67	UploadCredentials *types.AwsCredentials
68
69	// Metadata pertaining to the operation's result.
70	ResultMetadata middleware.Metadata
71}
72
73func addOperationRequestUploadCredentialsMiddlewares(stack *middleware.Stack, options Options) (err error) {
74	err = stack.Serialize.Add(&awsAwsjson11_serializeOpRequestUploadCredentials{}, middleware.After)
75	if err != nil {
76		return err
77	}
78	err = stack.Deserialize.Add(&awsAwsjson11_deserializeOpRequestUploadCredentials{}, middleware.After)
79	if err != nil {
80		return err
81	}
82	if err = addSetLoggerMiddleware(stack, options); err != nil {
83		return err
84	}
85	if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil {
86		return err
87	}
88	if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil {
89		return err
90	}
91	if err = addResolveEndpointMiddleware(stack, options); err != nil {
92		return err
93	}
94	if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil {
95		return err
96	}
97	if err = addRetryMiddlewares(stack, options); err != nil {
98		return err
99	}
100	if err = addHTTPSignerV4Middleware(stack, options); err != nil {
101		return err
102	}
103	if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil {
104		return err
105	}
106	if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil {
107		return err
108	}
109	if err = addClientUserAgent(stack); err != nil {
110		return err
111	}
112	if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil {
113		return err
114	}
115	if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil {
116		return err
117	}
118	if err = addOpRequestUploadCredentialsValidationMiddleware(stack); err != nil {
119		return err
120	}
121	if err = stack.Initialize.Add(newServiceMetadataMiddleware_opRequestUploadCredentials(options.Region), middleware.Before); err != nil {
122		return err
123	}
124	if err = addRequestIDRetrieverMiddleware(stack); err != nil {
125		return err
126	}
127	if err = addResponseErrorMiddleware(stack); err != nil {
128		return err
129	}
130	if err = addRequestResponseLogging(stack, options); err != nil {
131		return err
132	}
133	return nil
134}
135
136func newServiceMetadataMiddleware_opRequestUploadCredentials(region string) *awsmiddleware.RegisterServiceMetadata {
137	return &awsmiddleware.RegisterServiceMetadata{
138		Region:        region,
139		ServiceID:     ServiceID,
140		SigningName:   "gamelift",
141		OperationName: "RequestUploadCredentials",
142	}
143}
144