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 actions CreateBuild | ListBuilds | DescribeBuild | UpdateBuild |
22// DeleteBuild | All APIs by task
23// (https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets)
24func (c *Client) RequestUploadCredentials(ctx context.Context, params *RequestUploadCredentialsInput, optFns ...func(*Options)) (*RequestUploadCredentialsOutput, error) {
25	if params == nil {
26		params = &RequestUploadCredentialsInput{}
27	}
28
29	result, metadata, err := c.invokeOperation(ctx, "RequestUploadCredentials", params, optFns, addOperationRequestUploadCredentialsMiddlewares)
30	if err != nil {
31		return nil, err
32	}
33
34	out := result.(*RequestUploadCredentialsOutput)
35	out.ResultMetadata = metadata
36	return out, nil
37}
38
39// Represents the input for a request operation.
40type RequestUploadCredentialsInput struct {
41
42	// A unique identifier for the build to get credentials for. You can use either the
43	// build ID or ARN value.
44	//
45	// This member is required.
46	BuildId *string
47}
48
49// Represents the returned data in response to a request operation.
50type RequestUploadCredentialsOutput struct {
51
52	// Amazon S3 path and key, identifying where the game build files are stored.
53	StorageLocation *types.S3Location
54
55	// AWS credentials required when uploading a game build to the storage location.
56	// These credentials have a limited lifespan and are valid only for the build they
57	// were issued for.
58	UploadCredentials *types.AwsCredentials
59
60	// Metadata pertaining to the operation's result.
61	ResultMetadata middleware.Metadata
62}
63
64func addOperationRequestUploadCredentialsMiddlewares(stack *middleware.Stack, options Options) (err error) {
65	err = stack.Serialize.Add(&awsAwsjson11_serializeOpRequestUploadCredentials{}, middleware.After)
66	if err != nil {
67		return err
68	}
69	err = stack.Deserialize.Add(&awsAwsjson11_deserializeOpRequestUploadCredentials{}, middleware.After)
70	if err != nil {
71		return err
72	}
73	if err = addSetLoggerMiddleware(stack, options); err != nil {
74		return err
75	}
76	if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil {
77		return err
78	}
79	if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil {
80		return err
81	}
82	if err = addResolveEndpointMiddleware(stack, options); err != nil {
83		return err
84	}
85	if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil {
86		return err
87	}
88	if err = addRetryMiddlewares(stack, options); err != nil {
89		return err
90	}
91	if err = addHTTPSignerV4Middleware(stack, options); err != nil {
92		return err
93	}
94	if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil {
95		return err
96	}
97	if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil {
98		return err
99	}
100	if err = addClientUserAgent(stack); err != nil {
101		return err
102	}
103	if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil {
104		return err
105	}
106	if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil {
107		return err
108	}
109	if err = addOpRequestUploadCredentialsValidationMiddleware(stack); err != nil {
110		return err
111	}
112	if err = stack.Initialize.Add(newServiceMetadataMiddleware_opRequestUploadCredentials(options.Region), middleware.Before); err != nil {
113		return err
114	}
115	if err = addRequestIDRetrieverMiddleware(stack); err != nil {
116		return err
117	}
118	if err = addResponseErrorMiddleware(stack); err != nil {
119		return err
120	}
121	if err = addRequestResponseLogging(stack, options); err != nil {
122		return err
123	}
124	return nil
125}
126
127func newServiceMetadataMiddleware_opRequestUploadCredentials(region string) *awsmiddleware.RegisterServiceMetadata {
128	return &awsmiddleware.RegisterServiceMetadata{
129		Region:        region,
130		ServiceID:     ServiceID,
131		SigningName:   "gamelift",
132		OperationName: "RequestUploadCredentials",
133	}
134}
135