Fleet
Example header and default range: RANGED-DATA:start=0,results=25
OK
Fleet ID
The name of the fleet
Deployment environment ID to which the fleet is assigned
The DeploymentProfileTemplate's ID, used for scaling, that is attached to this Fleet
The GameDeploymentTemplate's ID that is attached to this Fleet
The UtilityDeploymentTemplate's ID that is attached to this Fleet
The DependencyDeploymentTemplate's ID that is attached to this Fleet
The HostCapacityTemplate's ID that is attached to this Fleet
0: Manual, 1: Automatic deployment enabled, 2: Automatic scaling enabled (implies automatic deployment)
When it is active it cannot be disabled anymore
Invalid credentials
Internal Server Error
Fleet ID
The name of the fleet
Deployment environment ID to which the fleet is assigned
The DeploymentProfileTemplate's ID, used for scaling, that is attached to this Fleet
The GameDeploymentTemplate's ID that is attached to this Fleet
The UtilityDeploymentTemplate's ID that is attached to this Fleet
The DependencyDeploymentTemplate's ID that is attached to this Fleet
The HostCapacityTemplate's ID that is attached to this Fleet
0: Manual, 1: Automatic deployment enabled, 2: Automatic scaling enabled (implies automatic deployment)
When it is active it cannot be disabled anymore
OK
Fleet ID
The name of the fleet
Deployment environment ID to which the fleet is assigned
The DeploymentProfileTemplate's ID, used for scaling, that is attached to this Fleet
The GameDeploymentTemplate's ID that is attached to this Fleet
The UtilityDeploymentTemplate's ID that is attached to this Fleet
The DependencyDeploymentTemplate's ID that is attached to this Fleet
The HostCapacityTemplate's ID that is attached to this Fleet
0: Manual, 1: Automatic deployment enabled, 2: Automatic scaling enabled (implies automatic deployment)
When it is active it cannot be disabled anymore
Invalid credentials
Unprocessable Entity
Internal Server Error
The Id of the fleet
OK
Fleet ID
The name of the fleet
Deployment environment ID to which the fleet is assigned
The DeploymentProfileTemplate's ID, used for scaling, that is attached to this Fleet
The GameDeploymentTemplate's ID that is attached to this Fleet
The UtilityDeploymentTemplate's ID that is attached to this Fleet
The DependencyDeploymentTemplate's ID that is attached to this Fleet
The HostCapacityTemplate's ID that is attached to this Fleet
0: Manual, 1: Automatic deployment enabled, 2: Automatic scaling enabled (implies automatic deployment)
When it is active it cannot be disabled anymore
Invalid credentials
Invalid fleetId
Internal Server Error
The Id of the fleet
Fleet ID
The name of the fleet
Deployment environment ID to which the fleet is assigned
The DeploymentProfileTemplate's ID, used for scaling, that is attached to this Fleet
The GameDeploymentTemplate's ID that is attached to this Fleet
The UtilityDeploymentTemplate's ID that is attached to this Fleet
The DependencyDeploymentTemplate's ID that is attached to this Fleet
The HostCapacityTemplate's ID that is attached to this Fleet
0: Manual, 1: Automatic deployment enabled, 2: Automatic scaling enabled (implies automatic deployment)
When it is active it cannot be disabled anymore
OK
Fleet ID
The name of the fleet
Deployment environment ID to which the fleet is assigned
The DeploymentProfileTemplate's ID, used for scaling, that is attached to this Fleet
The GameDeploymentTemplate's ID that is attached to this Fleet
The UtilityDeploymentTemplate's ID that is attached to this Fleet
The DependencyDeploymentTemplate's ID that is attached to this Fleet
The HostCapacityTemplate's ID that is attached to this Fleet
0: Manual, 1: Automatic deployment enabled, 2: Automatic scaling enabled (implies automatic deployment)
When it is active it cannot be disabled anymore
Invalid credentials
Invalid fleetId
Unprocessable Entity
Internal Server Error
The ID of the fleet
No Content
Invalid credentials
Invalid fleetId
Fleet in use, cannot delete
Internal Server Error
No content
The Id of the fleet
The operational status for the fleet
OK
Fleet ID
The name of the fleet
Deployment environment ID to which the fleet is assigned
The DeploymentProfileTemplate's ID, used for scaling, that is attached to this Fleet
The GameDeploymentTemplate's ID that is attached to this Fleet
The UtilityDeploymentTemplate's ID that is attached to this Fleet
The DependencyDeploymentTemplate's ID that is attached to this Fleet
The HostCapacityTemplate's ID that is attached to this Fleet
0: Manual, 1: Automatic deployment enabled, 2: Automatic scaling enabled (implies automatic deployment)
When it is active it cannot be disabled anymore
Invalid credentials
Invalid fleetId
Unprocessable Entity
Internal Server Error
The Id of the fleet
Example header and default range: RANGED-DATA:start=0,results=25
OK
The ID of this host
The ID of the user who owns this server
The ID of the physical machine
The name of the physical machine
The type of the server:
- 1: Bare metal server
- 2: Flex metal server
- 3: Virtual machine
The name of the project for the host
The name of the server defined by client
Client statement for the host
The host name
0 if this is a bare metal server, 1 if it's a VM. Use serverType instead
Host category. Normally "Dedicated Game Servers" or "Dedicated Servers", but can be "Broken" if the server is in a degraded state
Operating system ID, must be one of GET /v3/operatingsystem
Legacy location ID (not used for ODP)
Datacenter location ID. Points to one of GET /v3/cloud/dcLocation
The instance type of this server, which is one of GET /v3/host/instanceType for a bare metal, or one of
GET /v3/cloud/instanceType for a virtual machine
The fleet ID, if this host has been assigned to a fleet
If 0, the host has not been assigned to a fleet, otherwise, the fleet is assigned to this host and the host can serve application instances for that fleet.
The ID of a new fleet that is to be assigned to this host after performing a bulkReserve operation at POST /v3/fleet/host/bulkReserve
Unix timestamp when fleet assigned to the host
The name of the rack the host is located
The date at which this host became active
The date at which this host will expire
The date at which this host was cancelled
The date at which the contract ends (if applicable)
The contract period in months
The service extend period in months
The cancellation period in months
Purchase order, if one has been supplied via our billing department
The payment term in days (how many days are invoices generated before dateEnd)
The price of this host per month in cents (see currencyId for currency)
The price of traffic overuse in cents (per TB) (see currencyId for currency)
The currency of the pricePerMonth field:
- 0: EURO
- 1: USD
- 9: YEN
The bandwidth billing method for this service:
- 1: unmetered connection
- 2: measured in TB per month
- 3: measured in mbit 95th percentile
The contractual maximum bandwidth usage value. In GB if bandwidthBillingType equals 2, in mbit otherwise
The server manufacturer brand name
The model of the server
Number of CPUs in this host
Percentage of cpu used across all cores
The amount of memory that is used by the host (in megabytes)
The amount of memory that is available on the host (in megabytes)
The amount of free memory that is available on the host (in megabytes)
If the host is reserved for a fleet isReserve set to 1
The service tag of the host
If the host is available for game hosting platform isODP set to 1
ID of Flex Metal order if this is a flex metal server
Status of server auto install if it was started by one. (created / installing / finished / failed)
Whether the host is running or not
The uptime of the host. Read-only. Only provided if the server checked-in recently
Monthly traffic of all incoming and outgoing bandwidth in GB or Mbit depending on host configuration
Whether the host has free incoming traffic or not
The outgoing traffic (Mbit or GB)
The incoming traffic (Mbit or GB)
Invalid credentials
Invalid fleetId
Internal Server Error
Reserve a list of hosts for a specific new fleet. The existing application instances on these servers will be automatically scaled down.
Response header which you can use to fetch the status of the bulk reservation of hosts by using endpoint
GET /v3/fleet/host/bulkReserve/{traceId}/status
Fleet ID
List of host ID's
Stop method type, list of types can be found in: GET /v3/application/stopMethod
Stop method timeout in seconds, default value is 1800 seconds
No Content
Invalid credentials
Unprocessable Entity
Internal Server Error
No content
Progress for the bulk reserve you have done, base on the trace id you received in the header when you have created the bulk reserve
OK
Fleet ID that was assigned to the host prior to bulk reservation.
Fleet ID that will be assigned to the host after completion of bulk reservation.
ID of the host.
When the value is 1 then the host is not changed to the new fleet ID, when value is 0 than the host is changed to the new fleet ID.
Invalid credentials
Not Found
Internal Server Error
The Id of the fleet
Example header and default range: RANGED-DATA:start=0,results=25
OK
The ID of this host
The ID of the user who owns this server
The ID of the physical machine
The name of the physical machine
The type of the server:
- 1: Bare metal server
- 2: Flex metal server
- 3: Virtual machine
The name of the project for the host
The name of the server defined by client
Client statement for the host
The host name
0 if this is a bare metal server, 1 if it's a VM. Use serverType instead
Host category. Normally "Dedicated Game Servers" or "Dedicated Servers", but can be "Broken" if the server is in a degraded state
Operating system ID, must be one of GET /v3/operatingsystem
Legacy location ID (not used for ODP)
Datacenter location ID. Points to one of GET /v3/cloud/dcLocation
The instance type of this server, which is one of GET /v3/host/instanceType for a bare metal, or one of
GET /v3/cloud/instanceType for a virtual machine
The fleet ID, if this host has been assigned to a fleet
If 0, the host has not been assigned to a fleet, otherwise, the fleet is assigned to this host and the host can serve application instances for that fleet.
The ID of a new fleet that is to be assigned to this host after performing a bulkReserve operation at POST /v3/fleet/host/bulkReserve
Unix timestamp when fleet assigned to the host
The name of the rack the host is located
The date at which this host became active
The date at which this host will expire
The date at which this host was cancelled
The date at which the contract ends (if applicable)
The contract period in months
The service extend period in months
The cancellation period in months
Purchase order, if one has been supplied via our billing department
The payment term in days (how many days are invoices generated before dateEnd)
The price of this host per month in cents (see currencyId for currency)
The price of traffic overuse in cents (per TB) (see currencyId for currency)
The currency of the pricePerMonth field:
- 0: EURO
- 1: USD
- 9: YEN
The bandwidth billing method for this service:
- 1: unmetered connection
- 2: measured in TB per month
- 3: measured in mbit 95th percentile
The contractual maximum bandwidth usage value. In GB if bandwidthBillingType equals 2, in mbit otherwise
The server manufacturer brand name
The model of the server
Number of CPUs in this host
Percentage of cpu used across all cores
The amount of memory that is used by the host (in megabytes)
The amount of memory that is available on the host (in megabytes)
The amount of free memory that is available on the host (in megabytes)
If the host is reserved for a fleet isReserve set to 1
The service tag of the host
If the host is available for game hosting platform isODP set to 1
ID of Flex Metal order if this is a flex metal server
Status of server auto install if it was started by one. (created / installing / finished / failed)
Whether the host is running or not
The uptime of the host. Read-only. Only provided if the server checked-in recently
Monthly traffic of all incoming and outgoing bandwidth in GB or Mbit depending on host configuration
Whether the host has free incoming traffic or not
The outgoing traffic (Mbit or GB)
The incoming traffic (Mbit or GB)
Invalid credentials
Invalid fleetId
Internal Server Error
The Id of the fleet
The Id of the host
No Content
Invalid credentials
Invalid fleetId
Host is already reserved
Internal Server Error
No content
Remove a fleet reservation from the given host. Sets `fleetId` to `0` only if no application instances are deployed on it.
The ID of the fleet
The ID of the host
No Content
Invalid credentials
Invalid fleetId or hostId
Host cannot be unreserved
Internal Server Error
No content
The Id of the fleet
OK
Application ID
The list of application type can be found in: GET /application/type
The protocol used to manage the application (defaults to None when not set):
- 0: None
- 1: A2S
- 2: ARCUS
The public name of your application
The url to your application's website
A short description of your application
The name of the application's developer
The name of the application's publisher
The default operating system group being used for the stop method. If you have a Windows and Linux ApplicationBuild you can overwrite this on the ApplicationBuild level. Must be one of:
- 1: Windows
- 2: Linux (default)
The stop method that will be used on restart or destroy of an application instance. The default is hard kill, list of types can be found in: GET /v3/application/stopMethod
The timeout that will be used on restart or destroy of an application instance, in seconds. The default is 0 (no timeout)
UnixTimestamp
If the application currently in use or not
Invalid credentials
Invalid fleetId
Internal Server Error
The Id of the fleet
OK
Application build ID
The name of the application build
The ID of the application. May be null if buildProvisioningStorageType is LegacyFTP
The ID of the host capacity template
The application build, list of types can be found in: GET /application/type
The executable name including the path originating from the root directory of the software structure
The startup parameters required for an executable
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
ID of the application install (legacy FTP, will be removed, may not be updated)
ID of the operating system, list of operating systems can be found in: GET /v3/operatingsystem
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
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
When the application build was created (unix timestamp)
Type of storage being used GET /v3/buildProvisioning/storage/registration/types. Default: 0
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)
Invalid credentials
Invalid fleetId
Internal Server Error
The Id of the fleet
OK
of game lift environment variable
of game lift environment variable:
- awsgl_endpoint
- awsgl_region
- awsgl_token
- awsgl_hostname
- awsgl_fleetid
- raw_value
of game lift environment variable, e.g. "AWS_TOKEN_ID"
Bad request
Invalid credentials
Internal Server Error
The Id of the fleet
of game lift environment variable
of game lift environment variable:
- awsgl_endpoint
- awsgl_region
- awsgl_token
- awsgl_hostname
- awsgl_fleetid
- raw_value
of game lift environment variable, e.g. "AWS_TOKEN_ID"
OK
of game lift environment variable
of game lift environment variable:
- awsgl_endpoint
- awsgl_region
- awsgl_token
- awsgl_hostname
- awsgl_fleetid
- raw_value
of game lift environment variable, e.g. "AWS_TOKEN_ID"
Bad request
Invalid credentials
Internal Server Error
The Id of the fleet
OK
The number of hosts
The number of instances
The number of players
Invalid credentials
Invalid fleetId
Internal Server Error
Last updated
Was this helpful?