Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . gamelift ]

request-upload-credentials

Description

Retrieves a fresh set of credentials for use when uploading a new set of game build files to Amazon GameLift's Amazon S3. This is done as part of the build creation process; see create-build .

To request new credentials, specify the build ID as returned with an initial create-build request. If successful, a new set of credentials are returned, along with the S3 storage location associated with the build ID.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  request-upload-credentials
--build-id <value>
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--build-id (string)

Unique identifier for a build to get credentials for.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Output

UploadCredentials -> (structure)

AWS credentials required when uploading a game build to the storage location. These credentials have a limited lifespan and are valid only for the build they were issued for.

AccessKeyId -> (string)

Temporary key allowing access to the Amazon GameLift S3 account.

SecretAccessKey -> (string)

Temporary secret key allowing access to the Amazon GameLift S3 account.

SessionToken -> (string)

Token used to associate a specific build ID with the files uploaded using these credentials.

StorageLocation -> (structure)

Amazon S3 path and key, identifying where the game build files are stored.

Bucket -> (string)

Amazon S3 bucket identifier. This is the name of your S3 bucket.

Key -> (string)

Name of the zip file containing your build files.

RoleArn -> (string)

Amazon Resource Name (ARN ) for the access role that allows Amazon GameLift to access your S3 bucket.