Network.AWS.GameLift.CreateBuild

Creates a new Amazon GameLift build from a set of game server binary files stored in an Amazon Simple Storage Service (Amazon S3) location. To use this API call, create a .zip file containing all of the files for the build and store it in an Amazon S3 bucket under your AWS account. For help on packaging your build files and creating a build, see Uploading Your Game to Amazon GameLift .

Important: Use this API action ONLY if you are storing your game build files in an Amazon S3 bucket. To create a build using files stored locally, use the CLI command @upload-build@ , which uploads the build files from a file location you specify.

To create a new build using CreateBuild , identify the storage location and operating system of your game build. You also have the option of specifying a build name and version. If successful, this action creates a new build record with an unique build ID and in INITIALIZED status. Use the API call DescribeBuild to check the status of your build. A build must be in READY status before it can be used to create fleets to host your game.

Build-related operations include:

• CreateBuild
• ListBuilds
• DescribeBuild
• UpdateBuild
• DeleteBuild

Creating a Request

createBuild :: CreateBuild

Creates a value of CreateBuild with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• cbStorageLocation - Amazon S3 location of the game build files to be uploaded. The S3 bucket must be owned by the same AWS account that you're using to manage Amazon GameLift. It also must in the same region that you want to create a new build in. Before calling CreateBuild with this location, you must allow Amazon GameLift to access your Amazon S3 bucket (see Create a Build with Files in Amazon S3 ).
• cbOperatingSystem - Operating system that the game server binaries are built to run on. This value determines the type of fleet resources that you can use for this build. If your game build contains multiple executables, they all must run on the same operating system.
• cbName - Descriptive label that is associated with a build. Build names do not need to be unique. You can use UpdateBuild to change this value later.
• cbVersion - Version that is associated with this build. Version strings do not need to be unique. You can use UpdateBuild to change this value later.

data CreateBuild

Represents the input for a request action.

See: createBuild smart constructor.

Instances

Eq CreateBuild

Methods

(==) :: CreateBuild -> CreateBuild -> Bool

(/=) :: CreateBuild -> CreateBuild -> Bool

Data CreateBuild

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateBuild -> c CreateBuild

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateBuild

toConstr :: CreateBuild -> Constr

dataTypeOf :: CreateBuild -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateBuild)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateBuild)

gmapT :: (forall b. Data b => b -> b) -> CreateBuild -> CreateBuild

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateBuild -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateBuild -> r

gmapQ :: (forall d. Data d => d -> u) -> CreateBuild -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateBuild -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateBuild -> m CreateBuild

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateBuild -> m CreateBuild

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateBuild -> m CreateBuild

Read CreateBuild

Methods

readsPrec :: Int -> ReadS CreateBuild

readList :: ReadS [CreateBuild]

readPrec :: ReadPrec CreateBuild

readListPrec :: ReadPrec [CreateBuild]

Show CreateBuild

Methods

showsPrec :: Int -> CreateBuild -> ShowS

show :: CreateBuild -> String

showList :: [CreateBuild] -> ShowS

Generic CreateBuild

Associated Types

type Rep CreateBuild :: * -> *

Methods

from :: CreateBuild -> Rep CreateBuild x

to :: Rep CreateBuild x -> CreateBuild

Hashable CreateBuild

Methods

hashWithSalt :: Int -> CreateBuild -> Int

hash :: CreateBuild -> Int

ToJSON CreateBuild

Methods

toJSON :: CreateBuild -> Value

toEncoding :: CreateBuild -> Encoding

toJSONList :: [CreateBuild] -> Value

toEncodingList :: [CreateBuild] -> Encoding

NFData CreateBuild

Methods

rnf :: CreateBuild -> ()

AWSRequest CreateBuild

Associated Types

type Rs CreateBuild :: *

Methods

request :: CreateBuild -> Request CreateBuild

response :: MonadResource m => Logger -> Service -> Proxy * CreateBuild -> ClientResponse -> m (Response CreateBuild)

ToQuery CreateBuild

Methods

toQuery :: CreateBuild -> QueryString

ToPath CreateBuild

Methods

toPath :: CreateBuild -> ByteString

ToHeaders CreateBuild

Methods

toHeaders :: CreateBuild -> [Header]

type Rep CreateBuild

type Rep CreateBuild = D1 (MetaData "CreateBuild" "Network.AWS.GameLift.CreateBuild" "amazonka-gamelift-1.5.0-LWFsf2alHztGD91U7ab8u0" False) (C1 (MetaCons "CreateBuild'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_cbStorageLocation") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe S3Location))) (S1 (MetaSel (Just Symbol "_cbOperatingSystem") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe OperatingSystem)))) ((:*:) (S1 (MetaSel (Just Symbol "_cbName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_cbVersion") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))))))

type Rs CreateBuild

type Rs CreateBuild = CreateBuildResponse

Request Lenses

cbStorageLocation :: Lens' CreateBuild (Maybe S3Location)

Amazon S3 location of the game build files to be uploaded. The S3 bucket must be owned by the same AWS account that you're using to manage Amazon GameLift. It also must in the same region that you want to create a new build in. Before calling CreateBuild with this location, you must allow Amazon GameLift to access your Amazon S3 bucket (see Create a Build with Files in Amazon S3 ).

cbOperatingSystem :: Lens' CreateBuild (Maybe OperatingSystem)

Operating system that the game server binaries are built to run on. This value determines the type of fleet resources that you can use for this build. If your game build contains multiple executables, they all must run on the same operating system.

cbName :: Lens' CreateBuild (Maybe Text)

Descriptive label that is associated with a build. Build names do not need to be unique. You can use UpdateBuild to change this value later.

cbVersion :: Lens' CreateBuild (Maybe Text)

Version that is associated with this build. Version strings do not need to be unique. You can use UpdateBuild to change this value later.

Destructuring the Response

createBuildResponse

Arguments

:: Int

cbrsResponseStatus

-> CreateBuildResponse

Creates a value of CreateBuildResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• cbrsStorageLocation - Amazon S3 location specified in the request.
• cbrsUploadCredentials - This element is not currently in use.
• cbrsBuild - The newly created build record, including a unique build ID and status.
• cbrsResponseStatus - -- | The response status code.

data CreateBuildResponse

Represents the returned data in response to a request action.

See: createBuildResponse smart constructor.

Instances

Eq CreateBuildResponse

Methods

(==) :: CreateBuildResponse -> CreateBuildResponse -> Bool

(/=) :: CreateBuildResponse -> CreateBuildResponse -> Bool

Data CreateBuildResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateBuildResponse -> c CreateBuildResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateBuildResponse

toConstr :: CreateBuildResponse -> Constr

dataTypeOf :: CreateBuildResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateBuildResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateBuildResponse)

gmapT :: (forall b. Data b => b -> b) -> CreateBuildResponse -> CreateBuildResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateBuildResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateBuildResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> CreateBuildResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateBuildResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateBuildResponse -> m CreateBuildResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateBuildResponse -> m CreateBuildResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateBuildResponse -> m CreateBuildResponse

Show CreateBuildResponse

Methods

showsPrec :: Int -> CreateBuildResponse -> ShowS

show :: CreateBuildResponse -> String

showList :: [CreateBuildResponse] -> ShowS

Generic CreateBuildResponse

Associated Types

type Rep CreateBuildResponse :: * -> *

Methods

from :: CreateBuildResponse -> Rep CreateBuildResponse x

to :: Rep CreateBuildResponse x -> CreateBuildResponse

NFData CreateBuildResponse

Methods

rnf :: CreateBuildResponse -> ()

type Rep CreateBuildResponse

type Rep CreateBuildResponse = D1 (MetaData "CreateBuildResponse" "Network.AWS.GameLift.CreateBuild" "amazonka-gamelift-1.5.0-LWFsf2alHztGD91U7ab8u0" False) (C1 (MetaCons "CreateBuildResponse'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_cbrsStorageLocation") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe S3Location))) (S1 (MetaSel (Just Symbol "_cbrsUploadCredentials") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe (Sensitive AWSCredentials))))) ((:*:) (S1 (MetaSel (Just Symbol "_cbrsBuild") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Build))) (S1 (MetaSel (Just Symbol "_cbrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))))

Response Lenses

cbrsStorageLocation :: Lens' CreateBuildResponse (Maybe S3Location)

Amazon S3 location specified in the request.

cbrsUploadCredentials :: Lens' CreateBuildResponse (Maybe AWSCredentials)

This element is not currently in use.

cbrsBuild :: Lens' CreateBuildResponse (Maybe Build)

The newly created build record, including a unique build ID and status.

cbrsResponseStatus :: Lens' CreateBuildResponse Int

• - | The response status code.