Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.GameLift.ListBuilds

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Retrieves build resources for all builds associated with the AWS account in use. You can limit results to builds that are in a specific status by using the Status parameter. Use the pagination parameters to retrieve results in a set of sequential pages.

Build resources are not listed in any particular order.

Learn more

Upload a Custom Server Build

Related actions

This operation returns paginated results.

Synopsis

data ListBuilds = ListBuilds' {
- status :: Maybe BuildStatus
- nextToken :: Maybe Text
- limit :: Maybe Natural
}
newListBuilds :: ListBuilds
listBuilds_status :: Lens' ListBuilds (Maybe BuildStatus)
listBuilds_nextToken :: Lens' ListBuilds (Maybe Text)
listBuilds_limit :: Lens' ListBuilds (Maybe Natural)
data ListBuildsResponse = ListBuildsResponse' {
- builds :: Maybe [Build]
- nextToken :: Maybe Text
- httpStatus :: Int
}
newListBuildsResponse :: Int -> ListBuildsResponse
listBuildsResponse_builds :: Lens' ListBuildsResponse (Maybe [Build])
listBuildsResponse_nextToken :: Lens' ListBuildsResponse (Maybe Text)
listBuildsResponse_httpStatus :: Lens' ListBuildsResponse Int

Creating a Request

data ListBuilds Source #

Represents the input for a request operation.

See: newListBuilds smart constructor.

Constructors

ListBuilds'

Fields

status :: Maybe BuildStatus
Build status to filter results by. To retrieve all builds, leave this parameter empty.
Possible build statuses include the following:
- INITIALIZED -- A new build has been defined, but no files have been uploaded. You cannot create fleets for builds that are in this status. When a build is successfully created, the build status is set to this value.
- READY -- The game build has been successfully uploaded. You can now create new fleets for this build.
- FAILED -- The game build upload failed. You cannot create new fleets for this build.
nextToken :: Maybe Text
A token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this operation. To start at the beginning of the result set, do not specify a value.
limit :: Maybe Natural
The maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.

Instances

Instances details

Eq ListBuilds Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Methods (==) :: ListBuilds -> ListBuilds -> Bool # (/=) :: ListBuilds -> ListBuilds -> Bool #
Read ListBuilds Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Methods readsPrec :: Int -> ReadS ListBuilds # readList :: ReadS [ListBuilds] # readPrec :: ReadPrec ListBuilds # readListPrec :: ReadPrec [ListBuilds] #
Show ListBuilds Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Methods showsPrec :: Int -> ListBuilds -> ShowS # show :: ListBuilds -> String # showList :: [ListBuilds] -> ShowS #
Generic ListBuilds Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Associated Types type Rep ListBuilds :: Type -> Type # Methods from :: ListBuilds -> Rep ListBuilds x # to :: Rep ListBuilds x -> ListBuilds #
NFData ListBuilds Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Methods rnf :: ListBuilds -> () #
Hashable ListBuilds Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Methods hashWithSalt :: Int -> ListBuilds -> Int # hash :: ListBuilds -> Int #
ToJSON ListBuilds Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Methods toJSON :: ListBuilds -> Value # toEncoding :: ListBuilds -> Encoding # toJSONList :: [ListBuilds] -> Value # toEncodingList :: [ListBuilds] -> Encoding #
AWSPager ListBuilds Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Methods page :: ListBuilds -> AWSResponse ListBuilds -> Maybe ListBuilds #
AWSRequest ListBuilds Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Associated Types type AWSResponse ListBuilds # Methods request :: ListBuilds -> Request ListBuilds # response :: MonadResource m => Logger -> Service -> Proxy ListBuilds -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse ListBuilds))) #
ToHeaders ListBuilds Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Methods toHeaders :: ListBuilds -> [Header] #
ToPath ListBuilds Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Methods toPath :: ListBuilds -> ByteString #
ToQuery ListBuilds Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Methods toQuery :: ListBuilds -> QueryString #
type Rep ListBuilds Source #
Instance details Defined in Amazonka.GameLift.ListBuilds type Rep ListBuilds = D1 ('MetaData "ListBuilds" "Amazonka.GameLift.ListBuilds" "libZSservicesZSamazonka-gameliftZSamazonka-gamelift" 'False) (C1 ('MetaCons "ListBuilds'" 'PrefixI 'True) (S1 ('MetaSel ('Just "status") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe BuildStatus)) :: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "limit") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)))))
type AWSResponse ListBuilds Source #
Instance details Defined in Amazonka.GameLift.ListBuilds type AWSResponse ListBuilds = ListBuildsResponse

newListBuilds :: ListBuilds Source #

Create a value of ListBuilds with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:status:ListBuilds', listBuilds_status - Build status to filter results by. To retrieve all builds, leave this parameter empty.

Possible build statuses include the following:

INITIALIZED -- A new build has been defined, but no files have been uploaded. You cannot create fleets for builds that are in this status. When a build is successfully created, the build status is set to this value.
READY -- The game build has been successfully uploaded. You can now create new fleets for this build.
FAILED -- The game build upload failed. You cannot create new fleets for this build.

$sel:nextToken:ListBuilds', listBuilds_nextToken - A token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this operation. To start at the beginning of the result set, do not specify a value.

$sel:limit:ListBuilds', listBuilds_limit - The maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.

Request Lenses

listBuilds_status :: Lens' ListBuilds (Maybe BuildStatus) Source #

Build status to filter results by. To retrieve all builds, leave this parameter empty.

Possible build statuses include the following:

INITIALIZED -- A new build has been defined, but no files have been uploaded. You cannot create fleets for builds that are in this status. When a build is successfully created, the build status is set to this value.
READY -- The game build has been successfully uploaded. You can now create new fleets for this build.
FAILED -- The game build upload failed. You cannot create new fleets for this build.

listBuilds_nextToken :: Lens' ListBuilds (Maybe Text) Source #

A token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this operation. To start at the beginning of the result set, do not specify a value.

listBuilds_limit :: Lens' ListBuilds (Maybe Natural) Source #

The maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.

Destructuring the Response

data ListBuildsResponse Source #

Represents the returned data in response to a request operation.

See: newListBuildsResponse smart constructor.

Constructors

ListBuildsResponse'
Fields builds :: Maybe [Build] A collection of build resources that match the request. nextToken :: Maybe Text A token that indicates where to resume retrieving results on the next call to this operation. If no token is returned, these results represent the end of the list. httpStatus :: Int The response's http status code.

Instances

Instances details

Eq ListBuildsResponse Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Methods (==) :: ListBuildsResponse -> ListBuildsResponse -> Bool # (/=) :: ListBuildsResponse -> ListBuildsResponse -> Bool #
Read ListBuildsResponse Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Methods readsPrec :: Int -> ReadS ListBuildsResponse # readList :: ReadS [ListBuildsResponse] # readPrec :: ReadPrec ListBuildsResponse # readListPrec :: ReadPrec [ListBuildsResponse] #
Show ListBuildsResponse Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Methods showsPrec :: Int -> ListBuildsResponse -> ShowS # show :: ListBuildsResponse -> String # showList :: [ListBuildsResponse] -> ShowS #
Generic ListBuildsResponse Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Associated Types type Rep ListBuildsResponse :: Type -> Type # Methods from :: ListBuildsResponse -> Rep ListBuildsResponse x # to :: Rep ListBuildsResponse x -> ListBuildsResponse #
NFData ListBuildsResponse Source #
Instance details Defined in Amazonka.GameLift.ListBuilds Methods rnf :: ListBuildsResponse -> () #
type Rep ListBuildsResponse Source #
Instance details Defined in Amazonka.GameLift.ListBuilds type Rep ListBuildsResponse = D1 ('MetaData "ListBuildsResponse" "Amazonka.GameLift.ListBuilds" "libZSservicesZSamazonka-gameliftZSamazonka-gamelift" 'False) (C1 ('MetaCons "ListBuildsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "builds") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Build])) :: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newListBuildsResponse Source #

Arguments

:: Int	`$sel:httpStatus:ListBuildsResponse'`
-> ListBuildsResponse

Create a value of ListBuildsResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:builds:ListBuildsResponse', listBuildsResponse_builds - A collection of build resources that match the request.

$sel:nextToken:ListBuilds', listBuildsResponse_nextToken - A token that indicates where to resume retrieving results on the next call to this operation. If no token is returned, these results represent the end of the list.

$sel:httpStatus:ListBuildsResponse', listBuildsResponse_httpStatus - The response's http status code.

Response Lenses

listBuildsResponse_builds :: Lens' ListBuildsResponse (Maybe [Build]) Source #

A collection of build resources that match the request.

listBuildsResponse_nextToken :: Lens' ListBuildsResponse (Maybe Text) Source #

A token that indicates where to resume retrieving results on the next call to this operation. If no token is returned, these results represent the end of the list.

listBuildsResponse_httpStatus :: Lens' ListBuildsResponse Int Source #

The response's http status code.