ApplicationBuild

All application build endpoints

Get The build provisioning storage types for storing application build file

get
Authorizations
PRIVATE-TOKENstringRequired
Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

ID of the build provisioning storage type

descriptionstringRead-onlyRequired

Description of the build provisioning storage type

get
/v3/applicationBuild/storage/types

Get all your application builds

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringOptional

Example header and default range: RANGED-DATA:start=0,results=25

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

Application build ID

namestringRequired

The name of the application build

applicationIdstring · nullableRequired

The ID of the application. May be null if buildProvisioningStorageType is LegacyFTP

hostCapacityTemplateIdstringOptional

The ID of the host capacity template

typeinteger · integerRead-onlyRequired

The application build, list of types can be found in: GET /application/type

executablestringRequired

The executable name including the path originating from the root directory of the software structure

startupParametersstringOptional

The startup parameters required for an executable

instanceDoesReadyCallbackinteger · integerOptional

Set to 1 if a deployed application instance will inform the platform it's done with initializing and is ready to accept players. Defaults to 0 if not set, which means an instance's status will go directly to ONLINE (4) after starting

installIdinteger · integerOptionalDeprecated

ID of the application install (legacy FTP, will be removed, may not be updated)

osIdinteger · integerRequired

ID of the operating system, list of operating systems can be found in: GET /v3/operatingsystem

stopMethodinteger · integer · nullableOptional

The stop method that will be used on restart or destroy of an application instance. The default is taken from the value of GET /v3/application/stopMethod - any value submitted here overrides that Application default

stopTimeoutinteger · integer · nullableOptional

The timeout that will be used on restart or destroy of an application instance. The default is taken from the value of Application.stopTimeout - any value submitted here overrides that Application default

createdAtinteger · integerRead-onlyRequired

When the application build was created (unix timestamp)

buildProvisioningStorageTypeinteger · integerOptional

Type of storage being used GET /v3/buildProvisioning/storage/registration/types. Default: 0

runAsRootinteger · integerRequired

Controls whether to run this build as root or as a non-privileged user. Warning: This currently only works for builds deployed onto a Linux operating system. Windows builds will always run as administrator

  • 0: run as non-privileged user
  • 1: run as root user (default)
get
/v3/applicationBuild

Create a new application build

post
Authorizations
PRIVATE-TOKENstringRequired
Body
idstringRead-onlyRequired

Application build ID

namestringRequired

The name of the application build

applicationIdstring · nullableRequired

The ID of the application. May be null if buildProvisioningStorageType is LegacyFTP

hostCapacityTemplateIdstringOptional

The ID of the host capacity template

typeinteger · integerRead-onlyRequired

The application build, list of types can be found in: GET /application/type

executablestringRequired

The executable name including the path originating from the root directory of the software structure

startupParametersstringOptional

The startup parameters required for an executable

instanceDoesReadyCallbackinteger · integerOptional

Set to 1 if a deployed application instance will inform the platform it's done with initializing and is ready to accept players. Defaults to 0 if not set, which means an instance's status will go directly to ONLINE (4) after starting

installIdinteger · integerOptionalDeprecated

ID of the application install (legacy FTP, will be removed, may not be updated)

osIdinteger · integerRequired

ID of the operating system, list of operating systems can be found in: GET /v3/operatingsystem

stopMethodinteger · integer · nullableOptional

The stop method that will be used on restart or destroy of an application instance. The default is taken from the value of GET /v3/application/stopMethod - any value submitted here overrides that Application default

stopTimeoutinteger · integer · nullableOptional

The timeout that will be used on restart or destroy of an application instance. The default is taken from the value of Application.stopTimeout - any value submitted here overrides that Application default

createdAtinteger · integerRead-onlyRequired

When the application build was created (unix timestamp)

buildProvisioningStorageTypeinteger · integerOptional

Type of storage being used GET /v3/buildProvisioning/storage/registration/types. Default: 0

runAsRootinteger · integerRequired

Controls whether to run this build as root or as a non-privileged user. Warning: This currently only works for builds deployed onto a Linux operating system. Windows builds will always run as administrator

  • 0: run as non-privileged user
  • 1: run as root user (default)
Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

Application build ID

namestringRequired

The name of the application build

applicationIdstring · nullableRequired

The ID of the application. May be null if buildProvisioningStorageType is LegacyFTP

hostCapacityTemplateIdstringOptional

The ID of the host capacity template

typeinteger · integerRead-onlyRequired

The application build, list of types can be found in: GET /application/type

executablestringRequired

The executable name including the path originating from the root directory of the software structure

startupParametersstringOptional

The startup parameters required for an executable

instanceDoesReadyCallbackinteger · integerOptional

Set to 1 if a deployed application instance will inform the platform it's done with initializing and is ready to accept players. Defaults to 0 if not set, which means an instance's status will go directly to ONLINE (4) after starting

installIdinteger · integerOptionalDeprecated

ID of the application install (legacy FTP, will be removed, may not be updated)

osIdinteger · integerRequired

ID of the operating system, list of operating systems can be found in: GET /v3/operatingsystem

stopMethodinteger · integer · nullableOptional

The stop method that will be used on restart or destroy of an application instance. The default is taken from the value of GET /v3/application/stopMethod - any value submitted here overrides that Application default

stopTimeoutinteger · integer · nullableOptional

The timeout that will be used on restart or destroy of an application instance. The default is taken from the value of Application.stopTimeout - any value submitted here overrides that Application default

createdAtinteger · integerRead-onlyRequired

When the application build was created (unix timestamp)

buildProvisioningStorageTypeinteger · integerOptional

Type of storage being used GET /v3/buildProvisioning/storage/registration/types. Default: 0

runAsRootinteger · integerRequired

Controls whether to run this build as root or as a non-privileged user. Warning: This currently only works for builds deployed onto a Linux operating system. Windows builds will always run as administrator

  • 0: run as non-privileged user
  • 1: run as root user (default)
post
/v3/applicationBuild

Get a specific application build

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
applicationBuildIdstringRequired

The Id of the application build

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

Application build ID

namestringRequired

The name of the application build

applicationIdstring · nullableRequired

The ID of the application. May be null if buildProvisioningStorageType is LegacyFTP

hostCapacityTemplateIdstringOptional

The ID of the host capacity template

typeinteger · integerRead-onlyRequired

The application build, list of types can be found in: GET /application/type

executablestringRequired

The executable name including the path originating from the root directory of the software structure

startupParametersstringOptional

The startup parameters required for an executable

instanceDoesReadyCallbackinteger · integerOptional

Set to 1 if a deployed application instance will inform the platform it's done with initializing and is ready to accept players. Defaults to 0 if not set, which means an instance's status will go directly to ONLINE (4) after starting

installIdinteger · integerOptionalDeprecated

ID of the application install (legacy FTP, will be removed, may not be updated)

osIdinteger · integerRequired

ID of the operating system, list of operating systems can be found in: GET /v3/operatingsystem

stopMethodinteger · integer · nullableOptional

The stop method that will be used on restart or destroy of an application instance. The default is taken from the value of GET /v3/application/stopMethod - any value submitted here overrides that Application default

stopTimeoutinteger · integer · nullableOptional

The timeout that will be used on restart or destroy of an application instance. The default is taken from the value of Application.stopTimeout - any value submitted here overrides that Application default

createdAtinteger · integerRead-onlyRequired

When the application build was created (unix timestamp)

buildProvisioningStorageTypeinteger · integerOptional

Type of storage being used GET /v3/buildProvisioning/storage/registration/types. Default: 0

runAsRootinteger · integerRequired

Controls whether to run this build as root or as a non-privileged user. Warning: This currently only works for builds deployed onto a Linux operating system. Windows builds will always run as administrator

  • 0: run as non-privileged user
  • 1: run as root user (default)
get
/v3/applicationBuild/{applicationBuildId}

Update the given application build

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
applicationBuildIdstringRequired

The Id of the application build

Body
idstringRead-onlyRequired

Application build ID

namestringRequired

The name of the application build

applicationIdstring · nullableRequired

The ID of the application. May be null if buildProvisioningStorageType is LegacyFTP

hostCapacityTemplateIdstringOptional

The ID of the host capacity template

typeinteger · integerRead-onlyRequired

The application build, list of types can be found in: GET /application/type

executablestringRequired

The executable name including the path originating from the root directory of the software structure

startupParametersstringOptional

The startup parameters required for an executable

instanceDoesReadyCallbackinteger · integerOptional

Set to 1 if a deployed application instance will inform the platform it's done with initializing and is ready to accept players. Defaults to 0 if not set, which means an instance's status will go directly to ONLINE (4) after starting

installIdinteger · integerOptionalDeprecated

ID of the application install (legacy FTP, will be removed, may not be updated)

osIdinteger · integerRequired

ID of the operating system, list of operating systems can be found in: GET /v3/operatingsystem

stopMethodinteger · integer · nullableOptional

The stop method that will be used on restart or destroy of an application instance. The default is taken from the value of GET /v3/application/stopMethod - any value submitted here overrides that Application default

stopTimeoutinteger · integer · nullableOptional

The timeout that will be used on restart or destroy of an application instance. The default is taken from the value of Application.stopTimeout - any value submitted here overrides that Application default

createdAtinteger · integerRead-onlyRequired

When the application build was created (unix timestamp)

buildProvisioningStorageTypeinteger · integerOptional

Type of storage being used GET /v3/buildProvisioning/storage/registration/types. Default: 0

runAsRootinteger · integerRequired

Controls whether to run this build as root or as a non-privileged user. Warning: This currently only works for builds deployed onto a Linux operating system. Windows builds will always run as administrator

  • 0: run as non-privileged user
  • 1: run as root user (default)
Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

Application build ID

namestringRequired

The name of the application build

applicationIdstring · nullableRequired

The ID of the application. May be null if buildProvisioningStorageType is LegacyFTP

hostCapacityTemplateIdstringOptional

The ID of the host capacity template

typeinteger · integerRead-onlyRequired

The application build, list of types can be found in: GET /application/type

executablestringRequired

The executable name including the path originating from the root directory of the software structure

startupParametersstringOptional

The startup parameters required for an executable

instanceDoesReadyCallbackinteger · integerOptional

Set to 1 if a deployed application instance will inform the platform it's done with initializing and is ready to accept players. Defaults to 0 if not set, which means an instance's status will go directly to ONLINE (4) after starting

installIdinteger · integerOptionalDeprecated

ID of the application install (legacy FTP, will be removed, may not be updated)

osIdinteger · integerRequired

ID of the operating system, list of operating systems can be found in: GET /v3/operatingsystem

stopMethodinteger · integer · nullableOptional

The stop method that will be used on restart or destroy of an application instance. The default is taken from the value of GET /v3/application/stopMethod - any value submitted here overrides that Application default

stopTimeoutinteger · integer · nullableOptional

The timeout that will be used on restart or destroy of an application instance. The default is taken from the value of Application.stopTimeout - any value submitted here overrides that Application default

createdAtinteger · integerRead-onlyRequired

When the application build was created (unix timestamp)

buildProvisioningStorageTypeinteger · integerOptional

Type of storage being used GET /v3/buildProvisioning/storage/registration/types. Default: 0

runAsRootinteger · integerRequired

Controls whether to run this build as root or as a non-privileged user. Warning: This currently only works for builds deployed onto a Linux operating system. Windows builds will always run as administrator

  • 0: run as non-privileged user
  • 1: run as root user (default)
put
/v3/applicationBuild/{applicationBuildId}

Delete given application build

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
applicationBuildIdstringRequired

The Id of the application build

Responses
delete
/v3/applicationBuild/{applicationBuildId}

No content

Get a list of deployment environments for a given application build Id

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
applicationBuildIdstringRequired

The ID of the application build

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

Deployment environment ID

namestringRequired

The public name of your deployment environment

createdAtinteger · integerRead-onlyRequired

UnixTimestamp

get
/v3/applicationBuild/{applicationBuildId}/deploymentEnvironment

Get a list of fleets for a given application build Id

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
applicationBuildIdstringRequired

The ID of the application build

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

Fleet ID

namestringRequired

The name of the fleet

deploymentEnvironmentIdstringRequired

Deployment environment ID to which the fleet is assigned

deploymentProfileIdstringOptional

The DeploymentProfileTemplate's ID, used for scaling, that is attached to this Fleet

gameDeploymentTemplateIdstringOptional

The GameDeploymentTemplate's ID that is attached to this Fleet

utilityDeploymentTemplateIdstringOptional

The UtilityDeploymentTemplate's ID that is attached to this Fleet

dependencyDeploymentTemplateIdstringOptional

The DependencyDeploymentTemplate's ID that is attached to this Fleet

hostCapacityTemplateIdstringOptional

The HostCapacityTemplate's ID that is attached to this Fleet

operationalStatusinteger · integerRead-onlyRequired

0: Manual, 1: Automatic deployment enabled, 2: Automatic scaling enabled (implies automatic deployment)

isGameLiftbooleanRequired

When it is active it cannot be disabled anymore

get
/v3/applicationBuild/{applicationBuildId}/fleet

Get a list of deployment templates for a given application build Id

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
applicationBuildIdstringRequired

The ID of the application build

Responses
chevron-right
200

OK

application/json
or
or
get
/v3/applicationBuild/{applicationBuildId}/deploymentTemplate

Get all the properties for the given applicationBuildId

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
applicationBuildIdstringRequired

The Id of the application build

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The application build property ID

propertyTypeinteger · integerRead-onlyRequired

The application build property type. For a list of application property types see GET /v3/application/property/type

propertyKeystringRead-onlyRequired

The application build property key. Only hyphens (-), underscores (_), lowercase characters and numbers are allowed. Keys must start with a lowercase character

propertyValuestringRequired

The application build property value

get
/v3/applicationBuild/{applicationBuildId}/property

Get given property for the given application build Id

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
applicationBuildIdstringRequired

The Id of the application build

propertyIdstringRequired

The Id of the application build property

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The application build property ID

propertyTypeinteger · integerRead-onlyRequired

The application build property type. For a list of application property types see GET /v3/application/property/type

propertyKeystringRead-onlyRequired

The application build property key. Only hyphens (-), underscores (_), lowercase characters and numbers are allowed. Keys must start with a lowercase character

propertyValuestringRequired

The application build property value

get
/v3/applicationBuild/{applicationBuildId}/property/{propertyId}

Update given property for given application build

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
applicationBuildIdstringRequired

The Id of the application build

propertyIdstringRequired

The Id of the application build property to update

Body
idstringRead-onlyRequired

The application build property ID

propertyTypeinteger · integerRead-onlyRequired

The application build property type. For a list of application property types see GET /v3/application/property/type

propertyKeystringRead-onlyRequired

The application build property key. Only hyphens (-), underscores (_), lowercase characters and numbers are allowed. Keys must start with a lowercase character

propertyValuestringRequired

The application build property value

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The application build property ID

propertyTypeinteger · integerRead-onlyRequired

The application build property type. For a list of application property types see GET /v3/application/property/type

propertyKeystringRead-onlyRequired

The application build property key. Only hyphens (-), underscores (_), lowercase characters and numbers are allowed. Keys must start with a lowercase character

propertyValuestringRequired

The application build property value

put
/v3/applicationBuild/{applicationBuildId}/property/{propertyId}

Get all configurations for the given applicationBuildId

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
applicationBuildIdstringRequired

The Id of the application build

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

Application build configuration ID

configPathstringRequired

Configuration file path

configNamestringRequired

Configuration file name

configContentstringRequired

Configuration file contents

createdAtinteger · integerRead-onlyRequired

UnixTimestamp

get
/v3/applicationBuild/{applicationBuildId}/configuration

Create a new configuration for the given applicationBuildId

post
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
applicationBuildIdstringRequired

The Id of the application build

Body
idstringRead-onlyRequired

Application build configuration ID

configPathstringRequired

Configuration file path

configNamestringRequired

Configuration file name

configContentstringRequired

Configuration file contents

createdAtinteger · integerRead-onlyRequired

UnixTimestamp

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

Application build configuration ID

configPathstringRequired

Configuration file path

configNamestringRequired

Configuration file name

configContentstringRequired

Configuration file contents

createdAtinteger · integerRead-onlyRequired

UnixTimestamp

post
/v3/applicationBuild/{applicationBuildId}/configuration

Get a specific application build configuration

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
applicationBuildIdstringRequired

The Id of the application build

applicationBuildConfigurationIdstringRequired

The Id of the specific configuration

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

Application build configuration ID

configPathstringRequired

Configuration file path

configNamestringRequired

Configuration file name

configContentstringRequired

Configuration file contents

createdAtinteger · integerRead-onlyRequired

UnixTimestamp

get
/v3/applicationBuild/{applicationBuildId}/configuration/{applicationBuildConfigurationId}

Update an existing configuration for given applicationBuildId

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
applicationBuildIdstringRequired

The Id of the application build

applicationBuildConfigurationIdstringRequired

The Id of the specific configuration

Body
idstringRead-onlyRequired

Application build configuration ID

configPathstringRequired

Configuration file path

configNamestringRequired

Configuration file name

configContentstringRequired

Configuration file contents

createdAtinteger · integerRead-onlyRequired

UnixTimestamp

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

Application build configuration ID

configPathstringRequired

Configuration file path

configNamestringRequired

Configuration file name

configContentstringRequired

Configuration file contents

createdAtinteger · integerRead-onlyRequired

UnixTimestamp

put
/v3/applicationBuild/{applicationBuildId}/configuration/{applicationBuildConfigurationId}

Delete given configuration from given applicationBuildId

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
applicationBuildIdstringRequired

The Id of the application build

applicationBuildConfigurationIdstringRequired

The Id of the specific configuration

Responses
delete
/v3/applicationBuild/{applicationBuildId}/configuration/{applicationBuildConfigurationId}

No content

Last updated

Was this helpful?