Game
Example header and default range: RANGED-DATA:start=0,results=25
OK
Deployment environment ID
The public name of your deployment environment
UnixTimestamp
Invalid credentials
Internal Server Error
GET /v3/deploymentEnvironment HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"createdAt": 1
}
]Deployment environment ID
The public name of your deployment environment
UnixTimestamp
OK
Deployment environment ID
The public name of your deployment environment
UnixTimestamp
Invalid credentials
Unprocessable Entity
Internal Server Error
POST /v3/deploymentEnvironment HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 15
{
"name": "text"
}[
{
"id": "text",
"name": "text",
"createdAt": 1
}
]The Id of the deployment environment
OK
Deployment environment ID
The public name of your deployment environment
UnixTimestamp
Invalid credentials
Invalid deploymentEnvironmentId
Internal Server Error
GET /v3/deploymentEnvironment/{deploymentEnvironmentId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"createdAt": 1
}
]The Id of the deployment environment
Deployment environment ID
The public name of your deployment environment
UnixTimestamp
OK
Deployment environment ID
The public name of your deployment environment
UnixTimestamp
Invalid credentials
Invalid deploymentEnvironmentId
Unprocessable Entity
Internal Server Error
PUT /v3/deploymentEnvironment/{deploymentEnvironmentId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 15
{
"name": "text"
}[
{
"id": "text",
"name": "text",
"createdAt": 1
}
]The Id of the deployment environment
No Content
No content
Invalid credentials
Invalid deploymentEnvironmentId
Cannot delete
Internal Server Error
DELETE /v3/deploymentEnvironment/{deploymentEnvironmentId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
The Id of the deployment environment
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 deploymentEnvironmentId
Internal Server Error
GET /v3/deploymentEnvironment/{deploymentEnvironmentId}/fleet HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"operationalStatus": 1,
"isGameLift": true
}
]The Id of the deployment environment
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 deploymentEnvironmentId
Internal Server Error
GET /v3/deploymentEnvironment/{deploymentEnvironmentId}/host HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"userId": 1,
"serverId": 1,
"serverName": "text",
"serverType": 1,
"projectName": "text",
"clientServerName": "text",
"clientState": "text",
"liveHostName": "text",
"category": "text",
"osId": 1,
"locationId": 1,
"dcLocationId": 1,
"instanceType": "text",
"fleetId": "text",
"newFleetId": "text",
"fleetAssociatedSince": 1,
"rackName": "text",
"dateStart": "text",
"dateEnd": "text",
"dateCancelled": "text",
"dateEndContract": "text",
"contractPeriod": 1,
"extendPeriod": 1,
"cancellationPeriod": 1,
"purchaseOrder": "text",
"paymentTerm": 1,
"pricePerMonth": "text",
"pricePerTbOveruse": "text",
"currencyId": 1,
"bandwidthBillingType": 1,
"bandwidthContractual": 1,
"ipAddress": [
{
"ipAddress": "text",
"version": 1,
"type": 1,
"private": 1,
"interface": 1,
"macAddress": "text",
"rDns": "text",
"vlanId": 1,
"gateway": "text",
"netmask": "text",
"prefix": 1
}
],
"brand": "text",
"model": "text",
"numCpu": 1,
"cpuInfo": "text",
"cpuType": "text",
"cpuLoad": 1,
"cpu": {
"socket": 1,
"cores": 1,
"threads": 1,
"info": "text",
"type": "text"
},
"memUsed": 1,
"memMax": 1,
"memFree": 1,
"disk": [
{
"diskType": "text",
"diskMedium": "text",
"model": "text",
"product": "text",
"diskSerial": "text",
"firmwareVersion": "text",
"rotationRate": 1,
"sectorSizeLogical": 1,
"sectorSizePhysical": 1,
"size": 1
}
],
"memory": [
{
"brand": "text",
"model": "text",
"size": 1,
"speed": 1,
"ecc": 1,
"memoryBank": 1,
"memoryType": "text",
"memorySlot": "text",
"memorySerial": "text"
}
],
"isReserve": 1,
"labels": [
{
"key": "text",
"value": "text"
}
],
"serviceTag": "text",
"isODP": 1,
"fmOrderId": "text",
"installStatus": "text",
"status": "text",
"uptime": 1,
"trafficSum": 1,
"uplinks": [
{
"uplinkId": 1,
"aggregate": true
}
],
"freeIncomingTraffic": true,
"outgoingTrafficSum": 1,
"incomingTrafficSum": 1
}
]The Id of the deployment environment
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 deploymentEnvironmentId
Internal Server Error
GET /v3/deploymentEnvironment/{deploymentEnvironmentId}/application/inUse HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"type": 1,
"managementProtocol": 1,
"name": "text",
"websiteUrl": "text",
"description": "text",
"developerName": "text",
"publisherName": "text",
"stopDefaultOsGroup": 1,
"stopMethod": 1,
"stopTimeout": 1,
"createdAt": 1,
"inUse": 1
}
]The Id of the deployment environment
The Id of the application
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 deploymentEnvironmentId or applicationId
Internal Server Error
GET /v3/deploymentEnvironment/{deploymentEnvironmentId}/application/{applicationId}/fleet HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"operationalStatus": 1,
"isGameLift": true
}
]The Id of the deployment environment
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 deploymentEnvironmentId
Internal Server Error
GET /v3/deploymentEnvironment/{deploymentEnvironmentId}/applicationBuild/inUse HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"applicationId": "text",
"hostCapacityTemplateId": "text",
"type": 1,
"executable": "text",
"startupParameters": "text",
"instanceDoesReadyCallback": 1,
"osId": 1,
"stopMethod": 1,
"stopTimeout": 1,
"createdAt": 1,
"label": [
{
"key": "text",
"value": "text"
}
],
"applicationBuildFile": {
"id": "text",
"buildProvisioningFileId": "text",
"buildProvisioningRegistrationId": "text",
"fileName": "text",
"fileSize": 1,
"version": "text",
"md5CheckSum": "text",
"path": "text",
"domain": "text",
"createdAt": 1,
"changedAt": 1,
"availableOnCDN": 1
},
"buildProvisioningStorageType": 1,
"runAsRoot": 1
}
]The Id of the deployment environment
OK
The deployment profile ID
IDs of the fleets in which this deployment profile is being used
This deployment profile's name
This deployment profile's description
Possible values:
- 1: Round robin
The minimum amount of game instances that should always be deployed for each deployment region in this deployment profile. Can be overridden per deployment region
The maximum amount of game instances that can be deployed in each region. Can be overridden per region.
Null value means that there is no maximumCapacity
Global buffer value, to be applied to individual deployment regions. Can be overridden per region
Possible values:
- 0: Absolute value
- 1: Percentage value (must be accompanied by
bufferValueMinandbufferValueMax)
The minimum absolute bufferValue when using a percentage, to prevent bufferValue from going too low
The maximum absolute bufferValue when using a percentage, to prevent bufferValue from going too high
When 1, markedForDeletion will propagate to all deployment regions of this deployment profile.
Scaling down will happen slowly as application instances get removed naturally.
After all application instances are removed, the deployment profile is set to inactive
1Possible values:
- 0: Deployment profile has no active application instances
- 1: Deployment profile has active application instance(s)
Unix timestamp of creation time
Invalid credentials
Invalid deploymentEnvironmentId
Internal Server Error
GET /v3/deploymentEnvironment/{deploymentEnvironmentId}/deploymentProfile HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"fleetIds": [
"text"
],
"name": "text",
"description": "text",
"strategyType": 1,
"minimumCapacity": 1,
"maximumCapacity": 1,
"bufferValue": 1,
"bufferValueType": 1,
"bufferValueMin": 1,
"bufferValueMax": 1,
"markedForDeletion": 1,
"inUse": 1,
"deploymentRegions": [
{
"id": "text",
"name": "text",
"i3dDcLocationIds": [
1
],
"i3dDcLocationIdsToBeRemoved": [
1
],
"minimumCapacity": 1,
"maximumCapacity": 1,
"bufferValue": 1,
"bufferValueType": 1,
"bufferValueMin": 1,
"bufferValueMax": 1,
"strategyType": 1,
"markedForDeletion": 1,
"containers": [
{
"id": "text",
"markedForDeletion": 1,
"containerLocations": [
{
"id": "text",
"cloudProviderId": 1,
"dcLocationId": 1,
"primaryInstanceTypeName": "text",
"primaryInstanceTypeStatus": 1,
"secondaryInstanceTypeName": "text",
"secondaryInstanceTypeStatus": 1,
"markedForDeletion": 1
}
]
}
],
"inUse": 1
}
],
"createdAt": 1
}
]Note: bare metal servers and VMs are exposed in the same manner, as "dedicated servers". hostId can be found in the /host endpoint.
The Id of the deployment environment
Label expressions can be used to apply more specific search parameters and can be written in standard SQL query language.
E.g. region_id=123 or multiple filters: region_id=123 and fleet_id=456 or host_id=46256 The provided filter query needs to be url encoded. E.g.
region_id%3D123 or multiple filters: region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256 The total would look like:
/deploymentEnvironment/{deploymentEnvironmentId}/applicationInstance?labels=region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256
If you want to filter on a non-numeric label such as region_name, you have to wrap the value in double quotes: region_name="Rotterdam"
Warning: the labels query parameter is ignored when passing a PAGE-TOKEN and the original labels string will be used for that request instead.
More information on the use of labels can be found here.
Filter expression can be used to apply more specific search on most parameters in the application instance, it is written like
this E.G. regionId=123 or multiple filters: regionId=123 and fleetId=456, only the AND statement is supported at this time. You can also
search inside nested objects like metaData.key="testing" and metaData.value="test" You can only search on exact matches.
Warning: the filters query parameter is ignored when passing a PAGE-TOKEN and the original filters string will be used for that request
instead.
Warning: filtering on the following parameters is currently not supported and will give an error:
autoRestart, liveGameVersion, liveHostName, liveMap, liveRules, manuallyDeployed, markedForDeletion, numPlayers, numPlayersMax,
pid, pidChangedAt, startedAt, status, stoppedAt, updatedAt
Sort expression to sort your results in the order that you like E.G. "sort=fleetId=ASC and applicationId DESC" Be aware that all filters
and sorting should be url encoded.
Warning: the sort query parameter is ignored when passing a PAGE-TOKEN and the original sort string will be used for that request instead
Warning: sorting on the following parameters is currently not supported and will give an error:
autoRestart, liveGameVersion, liveHostName, liveMap, liveRules, manuallyDeployed, markedForDeletion, numPlayers, numPlayersMax,
pid, pidChangedAt, startedAt, status, stoppedAt, updatedAt
Example header and default range: RANGED-DATA: start=0,results=25
Warning: the start variable of the RANGED-DATA object has been deprecated for this endpoint. It is not possible to supply a start, see
PAGE-TOKEN header for a replacement
This token will be provided by this endpoint to allow for pagination functionality. By performing a request to this endpoint
without the PAGE-TOKEN you will retrieve the first page of search results. If a PAGE-TOKEN is returned, a next page may be requested by
supplying that token in the next request using the same PAGE-TOKEN key and value in the request header. If no PAGE-TOKEN is returned, the last
page has been reached and no further data can be requested. A returned PAGE-TOKEN is valid until the date specified in the Expires response
header. Example: PAGE-TOKEN: eyJjb25kaXRpb25zIjp7InVzZXJJZCI6NjY2ODI1fSwibGFiZWxz(...) (truncated for readability)
Expires header example: Expires: Fri, 08 Jan 2021 09:10:29 GMT
OK
Application instance ID
The deployment environment ID of this application instance
The deployment environment name of this application instance
The fleet ID of this application instance
The fleet name of this application instance
The application instance is host on this server.
0 if this instance runs on a bare metal server, 1 if it runs on a VM
The application ID of this application instance
The application name of this application instance
The type of the application, the different types can be found in: GET /v3/application/type
The application build ID of this application instance
The application build name of this application instance
ID of the application install
The datacenter ID of where this application instance is located
The datacenter name of where this application instance is located
The deployment region ID of where this application instance is located
The deployment region name of where this application instance is located
The application instance status, list of application instance status can be found in GET /v3/applicationInstance/status
The Unix timestamp at which this application instance is created
The Unix timestamp at which this application instance is started
The Unix timestamp at which this application instance is stopped
The process ID of the application instance running on the host
The Unix timestamp of the moment the process ID has been changed on the host
The exact startup parameters that were used to start this application instance with all properties resolved to their
respective values. Will be null if the instance has not been started, but will retain its previous value if it was stopped. Once set it will never be
cleared again
The name of the executable that was ran when the application instance started. Will be null if the instance has not been
started, but will retain its previous value if it was stopped. Once set it will never be cleared again
If set to 1, the application instance was manually deployed, instead of automatically deployed through the system
The maximum number of players on the application instance (this only apply to application instances of the type game)
The number of online players on the application instance (this only apply to application instances of the type game)
The live host name of the application instance (this only apply to application instances of the type game)
The live map of an application instance (this only apply to application instances of the type game)
The live game version of an application instance (this only apply to application instances of the type game)
The Unix timestamp at which this application instance is live data is updated (this only apply to application instances of the type game)
The live rules of an application instance (this only apply to application instances of the type game)
If auto restart is 1 then the application instance will auto restart, when 0 the application instance auto restart will be disabled
If an application will be deleted it will be 1, 0 otherwise
1 if Arcus is available & running for this application instance, 0 otherwise.
Note: If your application's managementProtocol is NOT set to Arcus, this value will always be 0, even if your
game server would support the Arcus protocol. The protocol is only tested, and this value potentially be set to 1,
when the managementProtocol is set to Arcus.
PAGE-TOKEN did not have an expected structure and is invalid. Please try again by sending a request without a PAGE-TOKEN and restarting
Invalid credentials
Invalid deploymentEnvironmentId
PAGE-TOKEN is expired. Acquire a new PAGE-TOKEN by sending a request without a PAGE-TOKEN and try again
Internal Server Error
GET /v3/deploymentEnvironment/{deploymentEnvironmentId}/applicationInstance HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"deploymentEnvironmentId": "text",
"deploymentEnvironmentName": "text",
"fleetId": "text",
"fleetName": "text",
"hostId": 1,
"isVirtual": 1,
"applicationId": "text",
"applicationName": "text",
"applicationType": 1,
"applicationBuildId": "text",
"applicationBuildName": "text",
"dcLocationId": 1,
"dcLocationName": "text",
"regionId": "text",
"regionName": "text",
"status": 1,
"createdAt": 1,
"startedAt": 1,
"stoppedAt": 1,
"pid": 1,
"pidChangedAt": 1,
"startupParams": "text",
"executable": "text",
"manuallyDeployed": 1,
"properties": [
{
"id": "text",
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}
],
"ipAddress": [
{
"ipAddress": "text",
"ipVersion": 1,
"private": 1
}
],
"labelReadOnly": [
{
"key": "text",
"value": "text"
}
],
"labelPublic": [
{
"key": "text",
"value": "text"
}
],
"metadata": [
{
"key": "text",
"value": "text"
}
],
"numPlayersMax": 1,
"numPlayers": 1,
"liveHostName": "text",
"liveMap": "text",
"liveGameVersion": "text",
"updatedAt": 1,
"liveRules": "text",
"autoRestart": 1,
"markedForDeletion": 1,
"arcusAvailable": 1
}
]OK
The number of hosts
The number of instances
The number of players
Invalid credentials
Invalid deploymentEnvironmentId
Internal Server Error
GET /v3/telemetry/deploymentEnvironment/{deploymentEnvironmentId}/current HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"hosts": 1,
"instances": 1,
"players": 1
}
]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
GET /v3/fleet HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"operationalStatus": 1,
"isGameLift": true
}
]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
POST /v3/fleet HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 238
{
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"isGameLift": true
}[
{
"id": "text",
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"operationalStatus": 1,
"isGameLift": true
}
]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
GET /v3/fleet/{fleetId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"operationalStatus": 1,
"isGameLift": true
}
]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
PUT /v3/fleet/{fleetId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 238
{
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"isGameLift": true
}[
{
"id": "text",
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"operationalStatus": 1,
"isGameLift": true
}
]The ID of the fleet
No Content
No content
Invalid credentials
Invalid fleetId
Fleet in use, cannot delete
Internal Server Error
DELETE /v3/fleet/{fleetId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
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
PUT /v3/fleet/{fleetId}/operationalStatus HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 23
{
"operationalStatus": 1
}[
{
"id": "text",
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"operationalStatus": 1,
"isGameLift": true
}
]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
GET /v3/fleet/{fleetId}/host/reserved HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"userId": 1,
"serverId": 1,
"serverName": "text",
"serverType": 1,
"projectName": "text",
"clientServerName": "text",
"clientState": "text",
"liveHostName": "text",
"category": "text",
"osId": 1,
"locationId": 1,
"dcLocationId": 1,
"instanceType": "text",
"fleetId": "text",
"newFleetId": "text",
"fleetAssociatedSince": 1,
"rackName": "text",
"dateStart": "text",
"dateEnd": "text",
"dateCancelled": "text",
"dateEndContract": "text",
"contractPeriod": 1,
"extendPeriod": 1,
"cancellationPeriod": 1,
"purchaseOrder": "text",
"paymentTerm": 1,
"pricePerMonth": "text",
"pricePerTbOveruse": "text",
"currencyId": 1,
"bandwidthBillingType": 1,
"bandwidthContractual": 1,
"ipAddress": [
{
"ipAddress": "text",
"version": 1,
"type": 1,
"private": 1,
"interface": 1,
"macAddress": "text",
"rDns": "text",
"vlanId": 1,
"gateway": "text",
"netmask": "text",
"prefix": 1
}
],
"brand": "text",
"model": "text",
"numCpu": 1,
"cpuInfo": "text",
"cpuType": "text",
"cpuLoad": 1,
"cpu": {
"socket": 1,
"cores": 1,
"threads": 1,
"info": "text",
"type": "text"
},
"memUsed": 1,
"memMax": 1,
"memFree": 1,
"disk": [
{
"diskType": "text",
"diskMedium": "text",
"model": "text",
"product": "text",
"diskSerial": "text",
"firmwareVersion": "text",
"rotationRate": 1,
"sectorSizeLogical": 1,
"sectorSizePhysical": 1,
"size": 1
}
],
"memory": [
{
"brand": "text",
"model": "text",
"size": 1,
"speed": 1,
"ecc": 1,
"memoryBank": 1,
"memoryType": "text",
"memorySlot": "text",
"memorySerial": "text"
}
],
"isReserve": 1,
"labels": [
{
"key": "text",
"value": "text"
}
],
"serviceTag": "text",
"isODP": 1,
"fmOrderId": "text",
"installStatus": "text",
"status": "text",
"uptime": 1,
"trafficSum": 1,
"uplinks": [
{
"uplinkId": 1,
"aggregate": true
}
],
"freeIncomingTraffic": true,
"outgoingTrafficSum": 1,
"incomingTrafficSum": 1
}
]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
No content
Invalid credentials
Unprocessable Entity
Internal Server Error
POST /v3/fleet/host/bulkReserve HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 55
{
"fleetId": "text",
"hosts": [
1
],
"methodId": 1,
"timeout": 1
}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
GET /v3/fleet/host/bulkReserve/{traceId}/status HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"oldFleetId": "text",
"newFleetId": "text",
"hostId": 1,
"inProgress": 1
}
]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
GET /v3/fleet/{fleetId}/host HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"userId": 1,
"serverId": 1,
"serverName": "text",
"serverType": 1,
"projectName": "text",
"clientServerName": "text",
"clientState": "text",
"liveHostName": "text",
"category": "text",
"osId": 1,
"locationId": 1,
"dcLocationId": 1,
"instanceType": "text",
"fleetId": "text",
"newFleetId": "text",
"fleetAssociatedSince": 1,
"rackName": "text",
"dateStart": "text",
"dateEnd": "text",
"dateCancelled": "text",
"dateEndContract": "text",
"contractPeriod": 1,
"extendPeriod": 1,
"cancellationPeriod": 1,
"purchaseOrder": "text",
"paymentTerm": 1,
"pricePerMonth": "text",
"pricePerTbOveruse": "text",
"currencyId": 1,
"bandwidthBillingType": 1,
"bandwidthContractual": 1,
"ipAddress": [
{
"ipAddress": "text",
"version": 1,
"type": 1,
"private": 1,
"interface": 1,
"macAddress": "text",
"rDns": "text",
"vlanId": 1,
"gateway": "text",
"netmask": "text",
"prefix": 1
}
],
"brand": "text",
"model": "text",
"numCpu": 1,
"cpuInfo": "text",
"cpuType": "text",
"cpuLoad": 1,
"cpu": {
"socket": 1,
"cores": 1,
"threads": 1,
"info": "text",
"type": "text"
},
"memUsed": 1,
"memMax": 1,
"memFree": 1,
"disk": [
{
"diskType": "text",
"diskMedium": "text",
"model": "text",
"product": "text",
"diskSerial": "text",
"firmwareVersion": "text",
"rotationRate": 1,
"sectorSizeLogical": 1,
"sectorSizePhysical": 1,
"size": 1
}
],
"memory": [
{
"brand": "text",
"model": "text",
"size": 1,
"speed": 1,
"ecc": 1,
"memoryBank": 1,
"memoryType": "text",
"memorySlot": "text",
"memorySerial": "text"
}
],
"isReserve": 1,
"labels": [
{
"key": "text",
"value": "text"
}
],
"serviceTag": "text",
"isODP": 1,
"fmOrderId": "text",
"installStatus": "text",
"status": "text",
"uptime": 1,
"trafficSum": 1,
"uplinks": [
{
"uplinkId": 1,
"aggregate": true
}
],
"freeIncomingTraffic": true,
"outgoingTrafficSum": 1,
"incomingTrafficSum": 1
}
]The Id of the fleet
The Id of the host
No Content
No content
Invalid credentials
Invalid fleetId
Host is already reserved
Internal Server Error
PUT /v3/fleet/{fleetId}/host/{hostId}/reserve HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
Remove a fleet reservation from the given host. Sets `fleetId` to `0` only if no application instances are deployed on it.
There are three situations you need to be aware of when un-reserving a fleet:
- You have application instances on the host and auto-scaling is enabled: Eventually the host is scaled down and its
fleetIdwill be set to0, at which point it may be re-purposed for another fleet - You have application instances on the host and auto-scaling is not enabled: The host is not automatically scaled down and you will need to manually scale down the application instances on this host for it to be available for another fleet
- You have no application instances: The host is unreserved and its
fleetIdis immediately set to0, allowing the host to be re-purposed for another fleet
The ID of the fleet
The ID of the host
No Content
No content
Invalid credentials
Invalid fleetId or hostId
Host cannot be unreserved
Internal Server Error
PUT /v3/fleet/{fleetId}/host/{hostId}/unreserve HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
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
GET /v3/fleet/{fleetId}/application/inUse HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"type": 1,
"managementProtocol": 1,
"name": "text",
"websiteUrl": "text",
"description": "text",
"developerName": "text",
"publisherName": "text",
"stopDefaultOsGroup": 1,
"stopMethod": 1,
"stopTimeout": 1,
"createdAt": 1,
"inUse": 1
}
]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
GET /v3/fleet/{fleetId}/applicationBuild/inUse HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"applicationId": "text",
"hostCapacityTemplateId": "text",
"type": 1,
"executable": "text",
"startupParameters": "text",
"instanceDoesReadyCallback": 1,
"osId": 1,
"stopMethod": 1,
"stopTimeout": 1,
"createdAt": 1,
"label": [
{
"key": "text",
"value": "text"
}
],
"applicationBuildFile": {
"id": "text",
"buildProvisioningFileId": "text",
"buildProvisioningRegistrationId": "text",
"fileName": "text",
"fileSize": 1,
"version": "text",
"md5CheckSum": "text",
"path": "text",
"domain": "text",
"createdAt": 1,
"changedAt": 1,
"availableOnCDN": 1
},
"buildProvisioningStorageType": 1,
"runAsRoot": 1
}
]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
GET /v3/fleet/{fleetId}/gameLiftDeploymentEnvironmentVariables HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"type": "text",
"name": "text"
}
]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
PUT /v3/fleet/{fleetId}/gameLiftDeploymentEnvironmentVariables HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 43
[
{
"id": "text",
"type": "text",
"name": "text"
}
][
{
"id": "text",
"type": "text",
"name": "text"
}
]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
GET /v3/telemetry/fleet/{fleetId}/current HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"hosts": 1,
"instances": 1,
"players": 1
}
]Example header and default range: RANGED-DATA:start=0,results=25
OK
Game deployment template ID
IDs of the fleets that use this template
The public name of your game deployment template
Indicates whether this game deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
Invalid credentials
Internal Server Error
GET /v3/deploymentTemplate/game HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"fleetIds": [
"text"
],
"name": "text",
"inUse": 1,
"createdAt": 1,
"gameDeploymentTemplateBuild": [
{
"applicationBuildId": "text"
}
]
}
]Game deployment template ID
IDs of the fleets that use this template
The public name of your game deployment template
Indicates whether this game deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
OK
Game deployment template ID
IDs of the fleets that use this template
The public name of your game deployment template
Indicates whether this game deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
Invalid credentials
Unprocessable Entity
Internal Server Error
POST /v3/deploymentTemplate/game HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 77
{
"name": "text",
"gameDeploymentTemplateBuild": [
{
"applicationBuildId": "text"
}
]
}[
{
"id": "text",
"fleetIds": [
"text"
],
"name": "text",
"inUse": 1,
"createdAt": 1,
"gameDeploymentTemplateBuild": [
{
"applicationBuildId": "text"
}
]
}
]The Id of the deployment template
OK
Game deployment template ID
IDs of the fleets that use this template
The public name of your game deployment template
Indicates whether this game deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
Invalid credentials
Invalid deploymentTemplateId
Internal Server Error
GET /v3/deploymentTemplate/game/{deploymentTemplateId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"fleetIds": [
"text"
],
"name": "text",
"inUse": 1,
"createdAt": 1,
"gameDeploymentTemplateBuild": [
{
"applicationBuildId": "text"
}
]
}
]The Id of the deployment template
Game deployment template ID
IDs of the fleets that use this template
The public name of your game deployment template
Indicates whether this game deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
OK
Game deployment template ID
IDs of the fleets that use this template
The public name of your game deployment template
Indicates whether this game deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
Invalid credentials
Invalid deploymentTemplateId
Unprocessable Entity
Internal Server Error
PUT /v3/deploymentTemplate/game/{deploymentTemplateId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 77
{
"name": "text",
"gameDeploymentTemplateBuild": [
{
"applicationBuildId": "text"
}
]
}{
"id": "text",
"fleetIds": [
"text"
],
"name": "text",
"inUse": 1,
"createdAt": 1,
"gameDeploymentTemplateBuild": [
{
"applicationBuildId": "text"
}
]
}The Id of the deployment template
No Content
No content
Invalid credentials
Invalid deploymentTemplateId
If the template is in use, it cannot be deleted
Internal Server Error
DELETE /v3/deploymentTemplate/game/{deploymentTemplateId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
The Id of the deployment template
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
Invalid deploymentTemplateId
Internal Server Error
GET /v3/deploymentTemplate/game/{deploymentTemplateId}/fleet HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"operationalStatus": 1,
"isGameLift": true
}
]Example header and default range: RANGED-DATA:start=0,results=25
OK
Utility deployment template ID
IDs of the fleets that use this template
The name of your utility deployment template
Indicates whether this utility deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
Invalid credentials
Internal Server Error
GET /v3/deploymentTemplate/utility HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"fleetIds": [
"text"
],
"name": "text",
"inUse": 1,
"createdAt": 1,
"utilityDeploymentTemplateBuild": [
{
"applicationBuildId": "text",
"deployOn": 1,
"installsPerLocation": 1
}
]
}
]Utility deployment template ID
IDs of the fleets that use this template
The name of your utility deployment template
Indicates whether this utility deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
OK
Utility deployment template ID
IDs of the fleets that use this template
The name of your utility deployment template
Indicates whether this utility deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
Invalid credentials
Invalid deploymentTemplateId
Unprocessable Entity
Internal Server Error
POST /v3/deploymentTemplate/utility HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 117
{
"name": "text",
"utilityDeploymentTemplateBuild": [
{
"applicationBuildId": "text",
"deployOn": 1,
"installsPerLocation": 1
}
]
}[
{
"id": "text",
"fleetIds": [
"text"
],
"name": "text",
"inUse": 1,
"createdAt": 1,
"utilityDeploymentTemplateBuild": [
{
"applicationBuildId": "text",
"deployOn": 1,
"installsPerLocation": 1
}
]
}
]The Id of the deployment template
OK
Utility deployment template ID
IDs of the fleets that use this template
The name of your utility deployment template
Indicates whether this utility deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
Invalid credentials
Invalid deploymentTemplateId
Internal Server Error
GET /v3/deploymentTemplate/utility/{deploymentTemplateId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"fleetIds": [
"text"
],
"name": "text",
"inUse": 1,
"createdAt": 1,
"utilityDeploymentTemplateBuild": [
{
"applicationBuildId": "text",
"deployOn": 1,
"installsPerLocation": 1
}
]
}
]The Id of the deployment template
Utility deployment template ID
IDs of the fleets that use this template
The name of your utility deployment template
Indicates whether this utility deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
OK
Utility deployment template ID
IDs of the fleets that use this template
The name of your utility deployment template
Indicates whether this utility deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
Invalid credentials
Invalid deploymentTemplateId
Unprocessable Entity
Internal Server Error
PUT /v3/deploymentTemplate/utility/{deploymentTemplateId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 117
{
"name": "text",
"utilityDeploymentTemplateBuild": [
{
"applicationBuildId": "text",
"deployOn": 1,
"installsPerLocation": 1
}
]
}[
{
"id": "text",
"fleetIds": [
"text"
],
"name": "text",
"inUse": 1,
"createdAt": 1,
"utilityDeploymentTemplateBuild": [
{
"applicationBuildId": "text",
"deployOn": 1,
"installsPerLocation": 1
}
]
}
]The Id of the deployment template
No Content
No content
Invalid credentials
Invalid deploymentTemplateId
If the template is in use, it cannot be deleted
Internal Server Error
DELETE /v3/deploymentTemplate/utility/{deploymentTemplateId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
The Id of the deployment template
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
Invalid deploymentTemplateId
Internal Server Error
GET /v3/deploymentTemplate/utility/{deploymentTemplateId}/fleet HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"operationalStatus": 1,
"isGameLift": true
}
]Example header and default range: RANGED-DATA:start=0,results=25
OK
dependency Deployment template ID
Name of the dependency deployment template
Dependency installer build ID
Dependency uninstaller build ID
IDs of the fleets that use this template
Indicates whether this dependency deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
Invalid credentials
Internal Server Error
GET /v3/deploymentTemplate/dependency HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"dependencyInstallerBuildId": "text",
"dependencyUninstallerBuildId": "text",
"fleetIds": [
"text"
],
"inUse": 1,
"createdAt": 1
}
]dependency Deployment template ID
Name of the dependency deployment template
Dependency installer build ID
Dependency uninstaller build ID
IDs of the fleets that use this template
Indicates whether this dependency deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
OK
dependency Deployment template ID
Name of the dependency deployment template
Dependency installer build ID
Dependency uninstaller build ID
IDs of the fleets that use this template
Indicates whether this dependency deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
Invalid credentials
Unprocessable Entity
Internal Server Error
POST /v3/deploymentTemplate/dependency HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 89
{
"name": "text",
"dependencyInstallerBuildId": "text",
"dependencyUninstallerBuildId": "text"
}[
{
"id": "text",
"name": "text",
"dependencyInstallerBuildId": "text",
"dependencyUninstallerBuildId": "text",
"fleetIds": [
"text"
],
"inUse": 1,
"createdAt": 1
}
]The Id of the dependency deployment template
OK
dependency Deployment template ID
Name of the dependency deployment template
Dependency installer build ID
Dependency uninstaller build ID
IDs of the fleets that use this template
Indicates whether this dependency deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
Invalid credentials
Invalid deploymentTemplateId
Internal Server Error
GET /v3/deploymentTemplate/dependency/{deploymentTemplateId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"dependencyInstallerBuildId": "text",
"dependencyUninstallerBuildId": "text",
"fleetIds": [
"text"
],
"inUse": 1,
"createdAt": 1
}
]The Id of the dependency deployment template
dependency Deployment template ID
Name of the dependency deployment template
Dependency installer build ID
Dependency uninstaller build ID
IDs of the fleets that use this template
Indicates whether this dependency deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
OK
dependency Deployment template ID
Name of the dependency deployment template
Dependency installer build ID
Dependency uninstaller build ID
IDs of the fleets that use this template
Indicates whether this dependency deployment template is used by one or more fleets. A template cannot be deleted as long as this value is 1.
UnixTimestamp
Invalid credentials
Invalid deploymentTemplateId
Unprocessable Entity
Internal Server Error
PUT /v3/deploymentTemplate/dependency/{deploymentTemplateId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 89
{
"name": "text",
"dependencyInstallerBuildId": "text",
"dependencyUninstallerBuildId": "text"
}[
{
"id": "text",
"name": "text",
"dependencyInstallerBuildId": "text",
"dependencyUninstallerBuildId": "text",
"fleetIds": [
"text"
],
"inUse": 1,
"createdAt": 1
}
]The Id of the dependency deployment template
No Content
No content
Invalid credentials
Invalid deploymentTemplateId
If the template is in use, it cannot be deleted
Internal Server Error
DELETE /v3/deploymentTemplate/dependency/{deploymentTemplateId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
The Id of the dependency deployment template
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
Invalid deploymentTemplateId
Internal Server Error
GET /v3/deploymentTemplate/dependency/{deploymentTemplateId}/fleet HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"operationalStatus": 1,
"isGameLift": true
}
]Example header and default range: RANGED-DATA:start=0,results=25
OK
The ID of the Host Capacity Template
IDs of the Fleets that use this Host Capacity Template
IDs of the Application Builds that use this Host Capacity Template
The public name of your Host Capacity Template
1 if the Host Capacity Template is in use by a Fleet or Application Build, 0 if it is not.
The Unix timestamp at which this element is created
Invalid credentials
Internal Server Error
GET /v3/hostCapacityTemplate HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"fleetIds": [
"text"
],
"applicationBuildIds": [
"text"
],
"name": "text",
"inUse": 1,
"createdAt": 1
}
]The ID of the Host Capacity Template
IDs of the Fleets that use this Host Capacity Template
IDs of the Application Builds that use this Host Capacity Template
The public name of your Host Capacity Template
1 if the Host Capacity Template is in use by a Fleet or Application Build, 0 if it is not.
The Unix timestamp at which this element is created
OK
The ID of the Host Capacity Template
IDs of the Fleets that use this Host Capacity Template
IDs of the Application Builds that use this Host Capacity Template
The public name of your Host Capacity Template
1 if the Host Capacity Template is in use by a Fleet or Application Build, 0 if it is not.
The Unix timestamp at which this element is created
Invalid credentials
Unprocessable Entity
Internal Server Error
POST /v3/hostCapacityTemplate HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 25
{
"name": "text",
"inUse": 1
}[
{
"id": "text",
"fleetIds": [
"text"
],
"applicationBuildIds": [
"text"
],
"name": "text",
"inUse": 1,
"createdAt": 1
}
]The Id of the host capacity template
OK
The ID of the Host Capacity Template
IDs of the Fleets that use this Host Capacity Template
IDs of the Application Builds that use this Host Capacity Template
The public name of your Host Capacity Template
1 if the Host Capacity Template is in use by a Fleet or Application Build, 0 if it is not.
The Unix timestamp at which this element is created
Invalid credentials
Invalid hostCapacityTemplateId
Internal Server Error
GET /v3/hostCapacityTemplate/{hostCapacityTemplateId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"fleetIds": [
"text"
],
"applicationBuildIds": [
"text"
],
"name": "text",
"inUse": 1,
"createdAt": 1
}
]The Id of the host capacity template
The ID of the Host Capacity Template
IDs of the Fleets that use this Host Capacity Template
IDs of the Application Builds that use this Host Capacity Template
The public name of your Host Capacity Template
1 if the Host Capacity Template is in use by a Fleet or Application Build, 0 if it is not.
The Unix timestamp at which this element is created
OK
The ID of the Host Capacity Template
IDs of the Fleets that use this Host Capacity Template
IDs of the Application Builds that use this Host Capacity Template
The public name of your Host Capacity Template
1 if the Host Capacity Template is in use by a Fleet or Application Build, 0 if it is not.
The Unix timestamp at which this element is created
Invalid credentials
Invalid hostCapacityTemplateId
Unprocessable Entity
Internal Server Error
PUT /v3/hostCapacityTemplate/{hostCapacityTemplateId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 25
{
"name": "text",
"inUse": 1
}[
{
"id": "text",
"fleetIds": [
"text"
],
"applicationBuildIds": [
"text"
],
"name": "text",
"inUse": 1,
"createdAt": 1
}
]The Id of the host capacity template
No Content
No content
Invalid credentials
Invalid hostCapacityTemplateId
Cannot delete
Internal Server Error
DELETE /v3/hostCapacityTemplate/{hostCapacityTemplateId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
The Id of the host capacity template
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
Invalid hostCapacityTemplateId
Internal Server Error
GET /v3/hostCapacityTemplate/{hostCapacityTemplateId}/fleet HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"operationalStatus": 1,
"isGameLift": true
}
]The Id of the host capacity template
Example header and default range: RANGED-DATA:start=0,results=25
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 hostCapacityTemplateId
Internal Server Error
GET /v3/hostCapacityTemplate/{hostCapacityTemplateId}/applicationBuild HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"applicationId": "text",
"hostCapacityTemplateId": "text",
"type": 1,
"executable": "text",
"startupParameters": "text",
"instanceDoesReadyCallback": 1,
"osId": 1,
"stopMethod": 1,
"stopTimeout": 1,
"createdAt": 1,
"label": [
{
"key": "text",
"value": "text"
}
],
"applicationBuildFile": {
"id": "text",
"buildProvisioningFileId": "text",
"buildProvisioningRegistrationId": "text",
"fileName": "text",
"fileSize": 1,
"version": "text",
"md5CheckSum": "text",
"path": "text",
"domain": "text",
"createdAt": 1,
"changedAt": 1,
"availableOnCDN": 1
},
"buildProvisioningStorageType": 1,
"runAsRoot": 1
}
]The ID of the hostCapacityTemplate
Example header and default range: RANGED-DATA:start=0,results=25
OK
The ID of the Instance Type Capacity
The ID of the Host Capacity Template to which this element is linked
Cloud provider ID. For a list of cloud providers see GET /v3/cloud/provider
The instance type to which the capacity applies. This is the name of instance types found at various cloud providers.
See GET /cloud/instanceType (for virtual servers) and GET /host/instanceType (for bare metal servers)
1 if the instance type is a virtual server, 0 if it is a bare metal server
The capacity of the instance type
The Unix timestamp at which this element is created
Invalid credentials
Internal Server Error
GET /v3/hostCapacityTemplate/{hostCapacityTemplateId}/instanceTypeCapacity HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"hostCapacityTemplateId": "text",
"providerId": 1,
"instanceType": "text",
"isVirtual": 1,
"capacity": 1,
"createdAt": 1
}
]The ID of the hostCapacityTemplate
The ID of the Instance Type Capacity
The ID of the Host Capacity Template to which this element is linked
Cloud provider ID. For a list of cloud providers see GET /v3/cloud/provider
The instance type to which the capacity applies. This is the name of instance types found at various cloud providers.
See GET /cloud/instanceType (for virtual servers) and GET /host/instanceType (for bare metal servers)
1 if the instance type is a virtual server, 0 if it is a bare metal server
The capacity of the instance type
The Unix timestamp at which this element is created
OK
The ID of the Instance Type Capacity
The ID of the Host Capacity Template to which this element is linked
Cloud provider ID. For a list of cloud providers see GET /v3/cloud/provider
The instance type to which the capacity applies. This is the name of instance types found at various cloud providers.
See GET /cloud/instanceType (for virtual servers) and GET /host/instanceType (for bare metal servers)
1 if the instance type is a virtual server, 0 if it is a bare metal server
The capacity of the instance type
The Unix timestamp at which this element is created
Invalid credentials
Unprocessable Entity
Internal Server Error
POST /v3/hostCapacityTemplate/{hostCapacityTemplateId}/instanceTypeCapacity HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 51
{
"providerId": 1,
"instanceType": "text",
"capacity": 1
}[
{
"id": "text",
"hostCapacityTemplateId": "text",
"providerId": 1,
"instanceType": "text",
"isVirtual": 1,
"capacity": 1,
"createdAt": 1
}
]The Id of the instance type capacity
OK
The ID of the Instance Type Capacity
The ID of the Host Capacity Template to which this element is linked
Cloud provider ID. For a list of cloud providers see GET /v3/cloud/provider
The instance type to which the capacity applies. This is the name of instance types found at various cloud providers.
See GET /cloud/instanceType (for virtual servers) and GET /host/instanceType (for bare metal servers)
1 if the instance type is a virtual server, 0 if it is a bare metal server
The capacity of the instance type
The Unix timestamp at which this element is created
Invalid credentials
Invalid instanceTypeCapacityId
Internal Server Error
GET /v3/instanceTypeCapacity/{instanceTypeCapacityId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"hostCapacityTemplateId": "text",
"providerId": 1,
"instanceType": "text",
"isVirtual": 1,
"capacity": 1,
"createdAt": 1
}
]The Id of the host capacity template
The ID of the Instance Type Capacity
The ID of the Host Capacity Template to which this element is linked
Cloud provider ID. For a list of cloud providers see GET /v3/cloud/provider
The instance type to which the capacity applies. This is the name of instance types found at various cloud providers.
See GET /cloud/instanceType (for virtual servers) and GET /host/instanceType (for bare metal servers)
1 if the instance type is a virtual server, 0 if it is a bare metal server
The capacity of the instance type
The Unix timestamp at which this element is created
OK
The ID of the Instance Type Capacity
The ID of the Host Capacity Template to which this element is linked
Cloud provider ID. For a list of cloud providers see GET /v3/cloud/provider
The instance type to which the capacity applies. This is the name of instance types found at various cloud providers.
See GET /cloud/instanceType (for virtual servers) and GET /host/instanceType (for bare metal servers)
1 if the instance type is a virtual server, 0 if it is a bare metal server
The capacity of the instance type
The Unix timestamp at which this element is created
Invalid credentials
Invalid instanceTypeCapacityId
Unprocessable Entity
Internal Server Error
PUT /v3/instanceTypeCapacity/{instanceTypeCapacityId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 51
{
"providerId": 1,
"instanceType": "text",
"capacity": 1
}[
{
"id": "text",
"hostCapacityTemplateId": "text",
"providerId": 1,
"instanceType": "text",
"isVirtual": 1,
"capacity": 1,
"createdAt": 1
}
]The Id of the host capacity template
No Content
No content
Invalid credentials
Invalid instanceTypeCapacityId
Cannot delete
Internal Server Error
DELETE /v3/instanceTypeCapacity/{instanceTypeCapacityId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
Label expressions can be used to apply more specific search parameters and can be written in standard SQL query language.
E.g. region_id=123 or multiple filters: region_id=123 and fleet_id=456 or host_id=46256 The provided filter query needs to be url encoded. E.g.
region_id%3D123 or multiple filters: region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256 The total would look like:
/host?labels=region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256
If you want to filter on a non-numeric label such as region_name, you have to wrap the value in double quotes: region_name="Rotterdam"
Warning: the labels query parameter is ignored when passing a PAGE-TOKEN and the original labels string will be used for that request instead.
For more information about labels check details
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
Internal Server Error
GET /v3/host HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"userId": 1,
"serverId": 1,
"serverName": "text",
"serverType": 1,
"projectName": "text",
"clientServerName": "text",
"clientState": "text",
"liveHostName": "text",
"category": "text",
"osId": 1,
"locationId": 1,
"dcLocationId": 1,
"instanceType": "text",
"fleetId": "text",
"newFleetId": "text",
"fleetAssociatedSince": 1,
"rackName": "text",
"dateStart": "text",
"dateEnd": "text",
"dateCancelled": "text",
"dateEndContract": "text",
"contractPeriod": 1,
"extendPeriod": 1,
"cancellationPeriod": 1,
"purchaseOrder": "text",
"paymentTerm": 1,
"pricePerMonth": "text",
"pricePerTbOveruse": "text",
"currencyId": 1,
"bandwidthBillingType": 1,
"bandwidthContractual": 1,
"ipAddress": [
{
"ipAddress": "text",
"version": 1,
"type": 1,
"private": 1,
"interface": 1,
"macAddress": "text",
"rDns": "text",
"vlanId": 1,
"gateway": "text",
"netmask": "text",
"prefix": 1
}
],
"brand": "text",
"model": "text",
"numCpu": 1,
"cpuInfo": "text",
"cpuType": "text",
"cpuLoad": 1,
"cpu": {
"socket": 1,
"cores": 1,
"threads": 1,
"info": "text",
"type": "text"
},
"memUsed": 1,
"memMax": 1,
"memFree": 1,
"disk": [
{
"diskType": "text",
"diskMedium": "text",
"model": "text",
"product": "text",
"diskSerial": "text",
"firmwareVersion": "text",
"rotationRate": 1,
"sectorSizeLogical": 1,
"sectorSizePhysical": 1,
"size": 1
}
],
"memory": [
{
"brand": "text",
"model": "text",
"size": 1,
"speed": 1,
"ecc": 1,
"memoryBank": 1,
"memoryType": "text",
"memorySlot": "text",
"memorySerial": "text"
}
],
"isReserve": 1,
"labels": [
{
"key": "text",
"value": "text"
}
],
"serviceTag": "text",
"isODP": 1,
"fmOrderId": "text",
"installStatus": "text",
"status": "text",
"uptime": 1,
"trafficSum": 1,
"uplinks": [
{
"uplinkId": 1,
"aggregate": true
}
],
"freeIncomingTraffic": true,
"outgoingTrafficSum": 1,
"incomingTrafficSum": 1
}
]Fields return in response, only fields available in model can be filter out
Example header and default range: RANGED-DATA:start=0,results=25
OK
The ID of this host
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
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
Internal Server Error
GET /v3/host/summary HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"serverId": 1,
"serverName": "text",
"serverType": 1,
"projectName": "text",
"clientServerName": "text",
"clientState": "text",
"liveHostName": "text",
"category": "text",
"osId": 1,
"locationId": 1,
"dcLocationId": 1,
"instanceType": "text",
"fleetId": "text",
"newFleetId": "text",
"fleetAssociatedSince": 1,
"rackName": "text",
"dateStart": "text",
"dateEnd": "text",
"dateCancelled": "text",
"dateEndContract": "text",
"contractPeriod": 1,
"extendPeriod": 1,
"cancellationPeriod": 1,
"purchaseOrder": "text",
"paymentTerm": 1,
"pricePerMonth": "text",
"pricePerTbOveruse": "text",
"currencyId": 1,
"bandwidthBillingType": 1,
"bandwidthContractual": 1,
"brand": "text",
"model": "text",
"isReserve": 1,
"serviceTag": "text",
"isODP": 1,
"fmOrderId": "text",
"installStatus": "text",
"status": "text",
"uptime": 1,
"trafficSum": 1,
"freeIncomingTraffic": true,
"outgoingTrafficSum": 1,
"incomingTrafficSum": 1
}
]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
Internal Server Error
GET /v3/host/{hostId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"userId": 1,
"serverId": 1,
"serverName": "text",
"serverType": 1,
"projectName": "text",
"clientServerName": "text",
"clientState": "text",
"liveHostName": "text",
"category": "text",
"osId": 1,
"locationId": 1,
"dcLocationId": 1,
"instanceType": "text",
"fleetId": "text",
"newFleetId": "text",
"fleetAssociatedSince": 1,
"rackName": "text",
"dateStart": "text",
"dateEnd": "text",
"dateCancelled": "text",
"dateEndContract": "text",
"contractPeriod": 1,
"extendPeriod": 1,
"cancellationPeriod": 1,
"purchaseOrder": "text",
"paymentTerm": 1,
"pricePerMonth": "text",
"pricePerTbOveruse": "text",
"currencyId": 1,
"bandwidthBillingType": 1,
"bandwidthContractual": 1,
"ipAddress": [
{
"ipAddress": "text",
"version": 1,
"type": 1,
"private": 1,
"interface": 1,
"macAddress": "text",
"rDns": "text",
"vlanId": 1,
"gateway": "text",
"netmask": "text",
"prefix": 1
}
],
"brand": "text",
"model": "text",
"numCpu": 1,
"cpuInfo": "text",
"cpuType": "text",
"cpuLoad": 1,
"cpu": {
"socket": 1,
"cores": 1,
"threads": 1,
"info": "text",
"type": "text"
},
"memUsed": 1,
"memMax": 1,
"memFree": 1,
"disk": [
{
"diskType": "text",
"diskMedium": "text",
"model": "text",
"product": "text",
"diskSerial": "text",
"firmwareVersion": "text",
"rotationRate": 1,
"sectorSizeLogical": 1,
"sectorSizePhysical": 1,
"size": 1
}
],
"memory": [
{
"brand": "text",
"model": "text",
"size": 1,
"speed": 1,
"ecc": 1,
"memoryBank": 1,
"memoryType": "text",
"memorySlot": "text",
"memorySerial": "text"
}
],
"isReserve": 1,
"labels": [
{
"key": "text",
"value": "text"
}
],
"serviceTag": "text",
"isODP": 1,
"fmOrderId": "text",
"installStatus": "text",
"status": "text",
"uptime": 1,
"trafficSum": 1,
"uplinks": [
{
"uplinkId": 1,
"aggregate": true
}
],
"freeIncomingTraffic": true,
"outgoingTrafficSum": 1,
"incomingTrafficSum": 1
}
]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)
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
Not Found
Unprocessable Entity
Internal Server Error
PUT /v3/host/{hostId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 121
{
"projectName": "text",
"clientServerName": "text",
"clientState": "text",
"labels": [
{
"key": "text",
"value": "text"
}
],
"uptime": 1
}[
{
"id": 1,
"userId": 1,
"serverId": 1,
"serverName": "text",
"serverType": 1,
"projectName": "text",
"clientServerName": "text",
"clientState": "text",
"liveHostName": "text",
"category": "text",
"osId": 1,
"locationId": 1,
"dcLocationId": 1,
"instanceType": "text",
"fleetId": "text",
"newFleetId": "text",
"fleetAssociatedSince": 1,
"rackName": "text",
"dateStart": "text",
"dateEnd": "text",
"dateCancelled": "text",
"dateEndContract": "text",
"contractPeriod": 1,
"extendPeriod": 1,
"cancellationPeriod": 1,
"purchaseOrder": "text",
"paymentTerm": 1,
"pricePerMonth": "text",
"pricePerTbOveruse": "text",
"currencyId": 1,
"bandwidthBillingType": 1,
"bandwidthContractual": 1,
"ipAddress": [
{
"ipAddress": "text",
"version": 1,
"type": 1,
"private": 1,
"interface": 1,
"macAddress": "text",
"rDns": "text",
"vlanId": 1,
"gateway": "text",
"netmask": "text",
"prefix": 1
}
],
"brand": "text",
"model": "text",
"numCpu": 1,
"cpuInfo": "text",
"cpuType": "text",
"cpuLoad": 1,
"cpu": {
"socket": 1,
"cores": 1,
"threads": 1,
"info": "text",
"type": "text"
},
"memUsed": 1,
"memMax": 1,
"memFree": 1,
"disk": [
{
"diskType": "text",
"diskMedium": "text",
"model": "text",
"product": "text",
"diskSerial": "text",
"firmwareVersion": "text",
"rotationRate": 1,
"sectorSizeLogical": 1,
"sectorSizePhysical": 1,
"size": 1
}
],
"memory": [
{
"brand": "text",
"model": "text",
"size": 1,
"speed": 1,
"ecc": 1,
"memoryBank": 1,
"memoryType": "text",
"memorySlot": "text",
"memorySerial": "text"
}
],
"isReserve": 1,
"labels": [
{
"key": "text",
"value": "text"
}
],
"serviceTag": "text",
"isODP": 1,
"fmOrderId": "text",
"installStatus": "text",
"status": "text",
"uptime": 1,
"trafficSum": 1,
"uplinks": [
{
"uplinkId": 1,
"aggregate": true
}
],
"freeIncomingTraffic": true,
"outgoingTrafficSum": 1,
"incomingTrafficSum": 1
}
]The ID of the host
OK
Task ID
Task name
The ID of the batch the task belongs to
The ID of the task category. Valid values are:
- 1: game server
The ID of the entity the task is being executed for. E.g. a game server ID (categoryId 1)
Currently active action index - relates to the action index as found in the template.
Unix timestamp indicating the start of execution.
Unix timestamp indicating lastest activity.
Unix timestamp at which the task was finished.
The result of the task. 0: pending, 1: in progress, 2: paused, 125: cancelled, 126: done with error, 127: done
The result of the task in message form.
Invalid credentials
Invalid hostId
Internal Server Error
GET /v3/host/{hostId}/task HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"name": "text",
"batchId": 1,
"categoryId": 1,
"entityId": 1,
"currentActionIdx": 1,
"executeAt": 1,
"lastActivityAt": 1,
"finishedAt": 1,
"resultCode": 1,
"resultText": "text"
}
]OK
The ID of this host
The ID of the physical machine
Percentage of cpu used across all cores
The amount of memory that is available on the host (in megabytes)
The amount of memory that is used by the host (in megabytes)
The amount of free memory that is available on the host (in megabytes)
Invalid credentials
Internal Server Error
GET /v3/host/liveState HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"serverId": 1,
"cpuLoad": 1,
"memMax": 1,
"memUsed": 1,
"memFree": 1
}
]Example header and default range: RANGED-DATA:start=0,results=25
OK
The ID of the instance type
The name of the instance type
The type of CPU of the instance type
The speed of CPU of the instance type
The number of CPUs of the instance type
The number of cores per CPUs of the instance type
The type of memory of the instance type
The memory speed of the instance type
The amount of memory of the instance type in MB
Invalid credentials
Internal Server Error
GET /v3/host/instanceType HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"instanceType": "text",
"cpuType": "text",
"cpuSpeed": 1,
"numCpu": 1,
"numCoresPerCpu": 1,
"memoryType": "text",
"memorySpeed": 1,
"memorySize": 1
}
]ID of the host to fetch invoices for
Example header and default range: RANGED-DATA:start=0,results=25
OK
The ID of the invoice
The date the invoice was created
The due date of the invoice
The number of the invoice
A unique hash for this invoice
The description of the invoice
The currency that is being used
The currency sign that is being used
The amount of the invoice with VAT in cents
The amount of the invoice without VAT in cents
The payment status
The timestamp that the invoice was paid, if paid
If this field is 1 it means that invoice is a credit invoice
The remaining amount of invoice
The total paid amount of invoice
Invalid credentials
Invalid host ID
Internal Server Error
GET /v3/host/{hostId}/invoice HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"creationDate": 1,
"dueDate": 1,
"invoiceNumber": "text",
"invoiceHash": "text",
"description": "text",
"currency": "text",
"currencySign": "text",
"amountIncVAT": "text",
"amountExclVAT": "text",
"paymentStatus": 1,
"paymentDate": 1,
"isCredit": 1,
"remainingAmount": "text",
"totalPaidAmount": "text"
}
]Cancels a host. If you cancel a host you will continue to have access to the host until the end of the contract
ID of the host to cancel
cancelled successfully
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 host ID
Unable to cancel host
Internal Server Error
PUT /v3/host/{hostId}/cancel HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
{
"id": 1,
"userId": 1,
"serverId": 1,
"serverName": "text",
"serverType": 1,
"projectName": "text",
"clientServerName": "text",
"clientState": "text",
"liveHostName": "text",
"category": "text",
"osId": 1,
"locationId": 1,
"dcLocationId": 1,
"instanceType": "text",
"fleetId": "text",
"newFleetId": "text",
"fleetAssociatedSince": 1,
"rackName": "text",
"dateStart": "text",
"dateEnd": "text",
"dateCancelled": "text",
"dateEndContract": "text",
"contractPeriod": 1,
"extendPeriod": 1,
"cancellationPeriod": 1,
"purchaseOrder": "text",
"paymentTerm": 1,
"pricePerMonth": "text",
"pricePerTbOveruse": "text",
"currencyId": 1,
"bandwidthBillingType": 1,
"bandwidthContractual": 1,
"ipAddress": [
{
"ipAddress": "text",
"version": 1,
"type": 1,
"private": 1,
"interface": 1,
"macAddress": "text",
"rDns": "text",
"vlanId": 1,
"gateway": "text",
"netmask": "text",
"prefix": 1
}
],
"brand": "text",
"model": "text",
"numCpu": 1,
"cpuInfo": "text",
"cpuType": "text",
"cpuLoad": 1,
"cpu": {
"socket": 1,
"cores": 1,
"threads": 1,
"info": "text",
"type": "text"
},
"memUsed": 1,
"memMax": 1,
"memFree": 1,
"disk": [
{
"diskType": "text",
"diskMedium": "text",
"model": "text",
"product": "text",
"diskSerial": "text",
"firmwareVersion": "text",
"rotationRate": 1,
"sectorSizeLogical": 1,
"sectorSizePhysical": 1,
"size": 1
}
],
"memory": [
{
"brand": "text",
"model": "text",
"size": 1,
"speed": 1,
"ecc": 1,
"memoryBank": 1,
"memoryType": "text",
"memorySlot": "text",
"memorySerial": "text"
}
],
"isReserve": 1,
"labels": [
{
"key": "text",
"value": "text"
}
],
"serviceTag": "text",
"isODP": 1,
"fmOrderId": "text",
"installStatus": "text",
"status": "text",
"uptime": 1,
"trafficSum": 1,
"uplinks": [
{
"uplinkId": 1,
"aggregate": true
}
],
"freeIncomingTraffic": true,
"outgoingTrafficSum": 1,
"incomingTrafficSum": 1
}Reverts the cancellation of a host. You cannot revert the cancellation a host if the current date is equal to or past the end of contract date, nor if the host was never cancelled
ID of the host to revert the cancellation for
cancellation was reverted successfully
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 host ID
Unable to revert cancellation of host
Internal Server Error
PUT /v3/host/{hostId}/cancel/revert HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
{
"id": 1,
"userId": 1,
"serverId": 1,
"serverName": "text",
"serverType": 1,
"projectName": "text",
"clientServerName": "text",
"clientState": "text",
"liveHostName": "text",
"category": "text",
"osId": 1,
"locationId": 1,
"dcLocationId": 1,
"instanceType": "text",
"fleetId": "text",
"newFleetId": "text",
"fleetAssociatedSince": 1,
"rackName": "text",
"dateStart": "text",
"dateEnd": "text",
"dateCancelled": "text",
"dateEndContract": "text",
"contractPeriod": 1,
"extendPeriod": 1,
"cancellationPeriod": 1,
"purchaseOrder": "text",
"paymentTerm": 1,
"pricePerMonth": "text",
"pricePerTbOveruse": "text",
"currencyId": 1,
"bandwidthBillingType": 1,
"bandwidthContractual": 1,
"ipAddress": [
{
"ipAddress": "text",
"version": 1,
"type": 1,
"private": 1,
"interface": 1,
"macAddress": "text",
"rDns": "text",
"vlanId": 1,
"gateway": "text",
"netmask": "text",
"prefix": 1
}
],
"brand": "text",
"model": "text",
"numCpu": 1,
"cpuInfo": "text",
"cpuType": "text",
"cpuLoad": 1,
"cpu": {
"socket": 1,
"cores": 1,
"threads": 1,
"info": "text",
"type": "text"
},
"memUsed": 1,
"memMax": 1,
"memFree": 1,
"disk": [
{
"diskType": "text",
"diskMedium": "text",
"model": "text",
"product": "text",
"diskSerial": "text",
"firmwareVersion": "text",
"rotationRate": 1,
"sectorSizeLogical": 1,
"sectorSizePhysical": 1,
"size": 1
}
],
"memory": [
{
"brand": "text",
"model": "text",
"size": 1,
"speed": 1,
"ecc": 1,
"memoryBank": 1,
"memoryType": "text",
"memorySlot": "text",
"memorySerial": "text"
}
],
"isReserve": 1,
"labels": [
{
"key": "text",
"value": "text"
}
],
"serviceTag": "text",
"isODP": 1,
"fmOrderId": "text",
"installStatus": "text",
"status": "text",
"uptime": 1,
"trafficSum": 1,
"uplinks": [
{
"uplinkId": 1,
"aggregate": true
}
],
"freeIncomingTraffic": true,
"outgoingTrafficSum": 1,
"incomingTrafficSum": 1
}ID of the host to fetch traffic for
ID of the uplink to fetch traffic for
Start unix timestamp
End unix timestamp
OK
Unit of data frequency, possible interval options are as follows
- day
Invalid credentials
Invalid host ID or uplink ID
Internal Server Error
GET /v3/host/{hostId}/network/usage/{upLinkId}/raw HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"ingress": "text",
"egress": "text",
"sum": "text"
}
]
}
]ID of the host to fetch traffic for
ID of the uplink to fetch traffic for
Base64 encoded image string
Invalid credentials
Invalid host ID or uplink ID
Internal Server Error
GET /v3/host/{hostId}/network/usage/{upLinkId}/graph/year HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
"text"
]ID of the host to fetch traffic for
ID of the uplink to fetch traffic for
Base64 encoded image string
Invalid credentials
Invalid host ID or uplink ID
Internal Server Error
GET /v3/host/{hostId}/network/usage/{upLinkId}/graph/month HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
"text"
]ID of the host to fetch traffic for
ID of the uplink to fetch traffic for
Base64 encoded image string
Invalid credentials
Invalid host ID or uplink ID
Internal Server Error
GET /v3/host/{hostId}/network/usage/{upLinkId}/graph/week HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
"text"
]ID of the host to fetch traffic for
ID of the uplink to fetch traffic for
Base64 encoded image string
Invalid credentials
Invalid host ID or uplink ID
Internal Server Error
GET /v3/host/{hostId}/network/usage/{upLinkId}/graph/day HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
"text"
]ID of the host to fetch the status for
OK
The incoming data usage
The corresponding date
Invalid credentials
Invalid host ID
Internal Server Error
GET /v3/host/{hostId}/status HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"result": "text",
"timestamp": 1
}
]ID of the host to fetch BMC status for
OK
The incoming data usage
The corresponding date
Invalid credentials
Invalid host ID
Internal Server Error
GET /v3/host/{hostId}/bmcStatus HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"result": "text",
"timestamp": 1
}
]ID of the host to turn on
OK
The incoming data usage
The corresponding date
Invalid credentials
Invalid host ID
Internal Server Error
PUT /v3/host/{hostId}/start HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"result": "text",
"timestamp": 1
}
]ID of the host to turn off
OK
The incoming data usage
The corresponding date
Invalid credentials
Invalid host ID
Internal Server Error
PUT /v3/host/{hostId}/stop HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"result": "text",
"timestamp": 1
}
]ID of the host to restart
OK
The incoming data usage
The corresponding date
Invalid credentials
Invalid host ID
Internal Server Error
PUT /v3/host/{hostId}/restart HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"result": "text",
"timestamp": 1
}
]ID of the host to install
Perform a quick format of all drives. Default: true
For an overview of available SSH keys, see /v3/sshKey. Only required for Linux OSs, except Talos.
OK
Perform a quick format of all drives. Default: true
For an overview of available SSH keys, see /v3/sshKey. Only required for Linux OSs, except Talos.
Invalid host ID
Unprocessable entity
Internal Server Error
POST /v3/host/{hostId}/os/install HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 146
{
"hostname": "text",
"os": {
"id": 1,
"kernelParams": [
{
"key": "text",
"value": "text"
}
]
},
"postInstallScript": "text",
"quickFormat": true,
"sshKeyUuid": "text"
}[
{
"hostname": "text",
"os": {
"id": 1,
"kernelParams": [
{
"key": "text",
"value": "text"
}
]
},
"postInstallScript": "text",
"quickFormat": true,
"sshKeyUuid": "text"
}
]ID of the host to fetch install logs for
Example header and default range: RANGED-DATA:start=0,results=25
OK
The ID of this log
Does the server log has an open issue
Time of the log
Server log issue category
Server log issue description
Whether or not server log issue is resolved
Server log category name
Invalid credentials
Not Found
Internal Server Error
GET /v3/host/{hostId}/os/installLog HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"issueOpen": 1,
"dateStamp": 1,
"issueCategory": "text",
"issueDescription": "text",
"issueResolved": "text",
"catName": "text"
}
]ID of the host to format disks for
Can be quick format or a full secure disk wipe. Available options: quick | fullwipe
OK
Can be quick format or a full secure disk wipe. Available options: quick | fullwipe
Invalid host ID
Unprocessable entity
Internal Server Error
POST /v3/host/{hostId}/formatDisks HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 17
{
"method": "text"
}[
{
"method": "text"
}
]ID of the host to fetch alert for
Example header and default range: RANGED-DATA:start=0,results=25
OK
Host alert ID
At what percentage of bandwidth usage to trigger the alert
Will send an email notification when alert is triggered
WIll create a ticket notification when alert is triggered
UNIX timestamp of the last time the alert was triggered
UNIX timestamp of the time the alert was created
Invalid credentials
Invalid host ID
Internal Server Error
GET /v3/host/{hostId}/alert HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"percentage": 1,
"sendMail": 1,
"sendTicket": 1,
"triggered": 1,
"createdAt": 1
}
]ID of the host to create an alert for
Host alert ID
At what percentage of bandwidth usage to trigger the alert
Will send an email notification when alert is triggered
WIll create a ticket notification when alert is triggered
UNIX timestamp of the last time the alert was triggered
UNIX timestamp of the time the alert was created
OK
Host alert ID
At what percentage of bandwidth usage to trigger the alert
Will send an email notification when alert is triggered
WIll create a ticket notification when alert is triggered
UNIX timestamp of the last time the alert was triggered
UNIX timestamp of the time the alert was created
Invalid credentials
Invalid host ID
Unprocessable Entity
Internal Server Error
POST /v3/host/{hostId}/alert HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 44
{
"percentage": 1,
"sendMail": 1,
"sendTicket": 1
}[
{
"id": 1,
"percentage": 1,
"sendMail": 1,
"sendTicket": 1,
"triggered": 1,
"createdAt": 1
}
]ID of the host that the alert belongs to
ID of the host alert to update
Host alert ID
At what percentage of bandwidth usage to trigger the alert
Will send an email notification when alert is triggered
WIll create a ticket notification when alert is triggered
UNIX timestamp of the last time the alert was triggered
UNIX timestamp of the time the alert was created
OK
Host alert ID
At what percentage of bandwidth usage to trigger the alert
Will send an email notification when alert is triggered
WIll create a ticket notification when alert is triggered
UNIX timestamp of the last time the alert was triggered
UNIX timestamp of the time the alert was created
Invalid credentials
Invalid host ID or alert ID
Unprocessable Entity
Internal Server Error
PUT /v3/host/{hostId}/alert/{hostAlertId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 44
{
"percentage": 1,
"sendMail": 1,
"sendTicket": 1
}[
{
"id": 1,
"percentage": 1,
"sendMail": 1,
"sendTicket": 1,
"triggered": 1,
"createdAt": 1
}
]ID of the host that the alert belongs to
ID of the alert to delete
No Content
No content
Invalid credentials
Invalid host ID or alert ID
Internal Server Error
DELETE /v3/host/{hostId}/alert/{hostAlertId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
ID of the host to which IP address belongs to
IP address to set RDNS entry for
The hostname
The corresponding ip for the host
No Content
No content
Invalid credentials
Invalid host ID or IP address
Internal Server Error
PUT /v3/host/{hostId}/network/rdns/{ipAddress} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 19
{
"hostname": "text"
}No content
Example header and default range: RANGED-DATA:start=0,results=25
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
Internal Server Error
GET /v3/application HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"type": 1,
"managementProtocol": 1,
"name": "text",
"websiteUrl": "text",
"description": "text",
"developerName": "text",
"publisherName": "text",
"stopDefaultOsGroup": 1,
"stopMethod": 1,
"stopTimeout": 1,
"createdAt": 1,
"inUse": 1
}
]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
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
Unprocessable Entity
Internal Server Error
POST /v3/application HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 188
{
"type": 1,
"managementProtocol": 1,
"name": "text",
"websiteUrl": "text",
"description": "text",
"developerName": "text",
"publisherName": "text",
"stopDefaultOsGroup": 1,
"stopMethod": 1,
"stopTimeout": 1
}[
{
"id": "text",
"type": 1,
"managementProtocol": 1,
"name": "text",
"websiteUrl": "text",
"description": "text",
"developerName": "text",
"publisherName": "text",
"stopDefaultOsGroup": 1,
"stopMethod": 1,
"stopTimeout": 1,
"createdAt": 1,
"inUse": 1
}
]The Id of the application for which to fetch the information
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 applicationId
Internal Server Error
GET /v3/application/{applicationId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"type": 1,
"managementProtocol": 1,
"name": "text",
"websiteUrl": "text",
"description": "text",
"developerName": "text",
"publisherName": "text",
"stopDefaultOsGroup": 1,
"stopMethod": 1,
"stopTimeout": 1,
"createdAt": 1,
"inUse": 1
}
]The Id of the application to update
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
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 applicationId
Application type can not be changed
Unprocessable Entity
Internal Server Error
PUT /v3/application/{applicationId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 188
{
"type": 1,
"managementProtocol": 1,
"name": "text",
"websiteUrl": "text",
"description": "text",
"developerName": "text",
"publisherName": "text",
"stopDefaultOsGroup": 1,
"stopMethod": 1,
"stopTimeout": 1
}[
{
"id": "text",
"type": 1,
"managementProtocol": 1,
"name": "text",
"websiteUrl": "text",
"description": "text",
"developerName": "text",
"publisherName": "text",
"stopDefaultOsGroup": 1,
"stopMethod": 1,
"stopTimeout": 1,
"createdAt": 1,
"inUse": 1
}
]The Id of the application to delete
No Content
No content
Invalid credentials
Invalid applicationId
Application is in use
Internal Server Error
DELETE /v3/application/{applicationId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
OK
Application type ID
Application type description
Invalid credentials
Internal Server Error
GET /v3/application/type HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"typeId": 1,
"typeDescription": "text"
}
]The Id of the application for which to fetch the installs
OK
Application install ID
Application install assigned to applicationId
The list of Application types can be found in: GET /application/type
Application install created at timestamp
Application install name
Application install version
Operating system group ID (1 = windows, 2 = linux)
Application install active
Application install release notes
Path of the file on the file server
File size in bytes
Archive file SHA-256 hash
SHA-256 hash of the executable in the archive
Status of application install.
Does the archive contain the game instance executable?
Invalid credentials
Invalid applicationId
Internal Server Error
GET /v3/application/{applicationId}/install HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"applicationId": "text",
"applicationType": 1,
"createdAt": 1,
"name": "text",
"version": "text",
"osGroupId": 1,
"active": 1,
"releaseNotes": "text",
"filePath": "text",
"fileSize": 1,
"fileSHA256": "text",
"executableSHA256": "text",
"status": 1,
"installHasExe": 1
}
]The Id of the application for which to fetch the application builds
Label expressions can be used to apply more specific search parameters and can be written in standard SQL query language.
E.g. region_id=123 or multiple filters: region_id=123 and fleet_id=456 or host_id=46256 The provided filter query needs to be url encoded. E.g.
region_id%3D123 or multiple filters: region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256 The total would look like:
/application/{applicationId}/applicationBuild?labels=region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256
If you want to filter on a non-numeric label such as region_name, you have to wrap the value in double quotes: region_name="Rotterdam".
For more information about labels check details
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 applicationId
Labels error
Internal Server Error
GET /v3/application/{applicationId}/applicationBuild HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"applicationId": "text",
"hostCapacityTemplateId": "text",
"type": 1,
"executable": "text",
"startupParameters": "text",
"instanceDoesReadyCallback": 1,
"osId": 1,
"stopMethod": 1,
"stopTimeout": 1,
"createdAt": 1,
"label": [
{
"key": "text",
"value": "text"
}
],
"applicationBuildFile": {
"id": "text",
"buildProvisioningFileId": "text",
"buildProvisioningRegistrationId": "text",
"fileName": "text",
"fileSize": 1,
"version": "text",
"md5CheckSum": "text",
"path": "text",
"domain": "text",
"createdAt": 1,
"changedAt": 1,
"availableOnCDN": 1
},
"buildProvisioningStorageType": 1,
"runAsRoot": 1
}
]Get all the application builds which have application instances created for the given application
The Id of the application for which to fetch the application builds
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 applicationId
Labels error
Internal Server Error
GET /v3/application/{applicationId}/applicationBuild/inUse HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"applicationId": "text",
"hostCapacityTemplateId": "text",
"type": 1,
"executable": "text",
"startupParameters": "text",
"instanceDoesReadyCallback": 1,
"osId": 1,
"stopMethod": 1,
"stopTimeout": 1,
"createdAt": 1,
"label": [
{
"key": "text",
"value": "text"
}
],
"applicationBuildFile": {
"id": "text",
"buildProvisioningFileId": "text",
"buildProvisioningRegistrationId": "text",
"fileName": "text",
"fileSize": 1,
"version": "text",
"md5CheckSum": "text",
"path": "text",
"domain": "text",
"createdAt": 1,
"changedAt": 1,
"availableOnCDN": 1
},
"buildProvisioningStorageType": 1,
"runAsRoot": 1
}
]OK
Invalid credentials
Invalid applicationId
Internal Server Error
GET /v3/application/stopMethod HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"linux": [
{
"id": 1,
"description": "text"
}
],
"windows": [
{
"id": 1,
"description": "text"
}
]
}
]OK
Deployment environment ID
The public name of your deployment environment
UnixTimestamp
Invalid credentials
Invalid applicationId
Internal Server Error
GET /v3/application/{applicationId}/deploymentEnvironment HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"createdAt": 1
}
]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 applicationId
Internal Server Error
GET /v3/application/{applicationId}/fleet HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"operationalStatus": 1,
"isGameLift": true
}
]OK
Invalid credentials
Invalid applicationId
Internal Server Error
GET /v3/application/{applicationId}/deploymentTemplate HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"fleetIds": [
"text"
],
"name": "text",
"inUse": 1,
"createdAt": 1,
"gameDeploymentTemplateBuild": [
{
"applicationBuildId": "text"
}
]
}
]The Id of the application for which to fetch the properties
OK
The application property ID
The application property type. For a list of application property types see
GET /v3/application/property/type
The application property key. Only hyphens (-), underscores (_), lowercase characters and numbers are allowed. Keys must start with a lowercase character
The application property value
Invalid credentials
Invalid applicationId
Internal Server Error
GET /v3/application/{applicationId}/property HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}
]The Id of the application for which the property will be created
The application property ID
The application property type. For a list of application property types see
GET /v3/application/property/type
The application property key. Only hyphens (-), underscores (_), lowercase characters and numbers are allowed. Keys must start with a lowercase character
The application property value
OK
The application property ID
The application property type. For a list of application property types see
GET /v3/application/property/type
The application property key. Only hyphens (-), underscores (_), lowercase characters and numbers are allowed. Keys must start with a lowercase character
The application property value
Invalid credentials
Invalid applicationId
Network port is already in use by another network port property
Unprocessable Entity
Internal Server Error
POST /v3/application/{applicationId}/property HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 62
{
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}[
{
"id": "text",
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}
]The Id of the application the property belongs to
Id of the property to fetch
OK
The application property ID
The application property type. For a list of application property types see
GET /v3/application/property/type
The application property key. Only hyphens (-), underscores (_), lowercase characters and numbers are allowed. Keys must start with a lowercase character
The application property value
Invalid credentials
Invalid applicationId or propertyId
Internal Server Error
GET /v3/application/{applicationId}/property/{propertyId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}
]The Id of the application the property belongs to
The Id of the property to update
The application property ID
The application property type. For a list of application property types see
GET /v3/application/property/type
The application property key. Only hyphens (-), underscores (_), lowercase characters and numbers are allowed. Keys must start with a lowercase character
The application property value
OK
The application property ID
The application property type. For a list of application property types see
GET /v3/application/property/type
The application property key. Only hyphens (-), underscores (_), lowercase characters and numbers are allowed. Keys must start with a lowercase character
The application property value
Invalid credentials
Invalid applicationId or propertyId
Network port is already in use by another network port property
Unprocessable Entity
Internal Server Error
PUT /v3/application/{applicationId}/property/{propertyId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 62
{
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}[
{
"id": "text",
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}
]The Id of the application for which to delete the property
Property Id to delete
No Content
No content
Invalid credentials
Invalid applicationId or propertyId
Unprocessable Entity
Internal Server Error
DELETE /v3/application/{applicationId}/property/{propertyId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
OK
Application type ID
Application type description
Invalid credentials
Internal Server Error
GET /v3/application/property/type HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"typeId": 1,
"typeDescription": "text"
}
]OK
The number of hosts
The number of instances
The number of players
Invalid credentials
Invalid applicationId
Internal Server Error
GET /v3/telemetry/application/{applicationId}/current HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"hosts": 1,
"instances": 1,
"players": 1
}
]Unix timestamp. Filter from time, default value is -1 day
Unix timestamp. Filter to time, default value is now
OK
Unit of data frequency, possible interval options are as follows
- minute
- hour
- day
- month
Invalid credentials
Invalid applicationId
Internal Server Error
GET /v3/telemetry/application/{applicationId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"hosts": 1,
"instances": 1,
"players": 1
}
]
}
]OK
ID of the build provisioning storage type
Description of the build provisioning storage type
Invalid credentials
Internal Server Error
GET /v3/applicationBuild/storage/types HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"description": "text"
}
]Example header and default range: RANGED-DATA:start=0,results=25
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
Labels error
Internal Server Error
GET /v3/applicationBuild HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"applicationId": "text",
"hostCapacityTemplateId": "text",
"type": 1,
"executable": "text",
"startupParameters": "text",
"instanceDoesReadyCallback": 1,
"osId": 1,
"stopMethod": 1,
"stopTimeout": 1,
"createdAt": 1,
"label": [
{
"key": "text",
"value": "text"
}
],
"applicationBuildFile": {
"id": "text",
"buildProvisioningFileId": "text",
"buildProvisioningRegistrationId": "text",
"fileName": "text",
"fileSize": 1,
"version": "text",
"md5CheckSum": "text",
"path": "text",
"domain": "text",
"createdAt": 1,
"changedAt": 1,
"availableOnCDN": 1
},
"buildProvisioningStorageType": 1,
"runAsRoot": 1
}
]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)
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
Conflict
Unprocessable Entity
Internal Server Error
POST /v3/applicationBuild HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 438
{
"name": "text",
"applicationId": "text",
"hostCapacityTemplateId": "text",
"executable": "text",
"startupParameters": "text",
"instanceDoesReadyCallback": 1,
"osId": 1,
"stopMethod": 1,
"stopTimeout": 1,
"label": [
{
"key": "text",
"value": "text"
}
],
"applicationBuildFile": {
"buildProvisioningFileId": "text",
"buildProvisioningRegistrationId": "text",
"fileName": "text",
"version": "text",
"path": "text",
"domain": "text"
},
"buildProvisioningStorageType": 1,
"runAsRoot": 1
}[
{
"id": "text",
"name": "text",
"applicationId": "text",
"hostCapacityTemplateId": "text",
"type": 1,
"executable": "text",
"startupParameters": "text",
"instanceDoesReadyCallback": 1,
"osId": 1,
"stopMethod": 1,
"stopTimeout": 1,
"createdAt": 1,
"label": [
{
"key": "text",
"value": "text"
}
],
"applicationBuildFile": {
"id": "text",
"buildProvisioningFileId": "text",
"buildProvisioningRegistrationId": "text",
"fileName": "text",
"fileSize": 1,
"version": "text",
"md5CheckSum": "text",
"path": "text",
"domain": "text",
"createdAt": 1,
"changedAt": 1,
"availableOnCDN": 1
},
"buildProvisioningStorageType": 1,
"runAsRoot": 1
}
]The Id of the application build
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 applicationBuildId
Internal Server Error
GET /v3/applicationBuild/{applicationBuildId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"applicationId": "text",
"hostCapacityTemplateId": "text",
"type": 1,
"executable": "text",
"startupParameters": "text",
"instanceDoesReadyCallback": 1,
"osId": 1,
"stopMethod": 1,
"stopTimeout": 1,
"createdAt": 1,
"label": [
{
"key": "text",
"value": "text"
}
],
"applicationBuildFile": {
"id": "text",
"buildProvisioningFileId": "text",
"buildProvisioningRegistrationId": "text",
"fileName": "text",
"fileSize": 1,
"version": "text",
"md5CheckSum": "text",
"path": "text",
"domain": "text",
"createdAt": 1,
"changedAt": 1,
"availableOnCDN": 1
},
"buildProvisioningStorageType": 1,
"runAsRoot": 1
}
]The Id of the application build
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)
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 applicationBuildId
Conflict
Unprocessable Entity
Internal Server Error
PUT /v3/applicationBuild/{applicationBuildId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 438
{
"name": "text",
"applicationId": "text",
"hostCapacityTemplateId": "text",
"executable": "text",
"startupParameters": "text",
"instanceDoesReadyCallback": 1,
"osId": 1,
"stopMethod": 1,
"stopTimeout": 1,
"label": [
{
"key": "text",
"value": "text"
}
],
"applicationBuildFile": {
"buildProvisioningFileId": "text",
"buildProvisioningRegistrationId": "text",
"fileName": "text",
"version": "text",
"path": "text",
"domain": "text"
},
"buildProvisioningStorageType": 1,
"runAsRoot": 1
}[
{
"id": "text",
"name": "text",
"applicationId": "text",
"hostCapacityTemplateId": "text",
"type": 1,
"executable": "text",
"startupParameters": "text",
"instanceDoesReadyCallback": 1,
"osId": 1,
"stopMethod": 1,
"stopTimeout": 1,
"createdAt": 1,
"label": [
{
"key": "text",
"value": "text"
}
],
"applicationBuildFile": {
"id": "text",
"buildProvisioningFileId": "text",
"buildProvisioningRegistrationId": "text",
"fileName": "text",
"fileSize": 1,
"version": "text",
"md5CheckSum": "text",
"path": "text",
"domain": "text",
"createdAt": 1,
"changedAt": 1,
"availableOnCDN": 1
},
"buildProvisioningStorageType": 1,
"runAsRoot": 1
}
]The Id of the application build
No Content
No content
Invalid credentials
Invalid applicationBuildId
applicationBuildId is in use
Internal Server Error
DELETE /v3/applicationBuild/{applicationBuildId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
The ID of the application build
OK
Deployment environment ID
The public name of your deployment environment
UnixTimestamp
Invalid credentials
Invalid applicationBuildId
Internal Server Error
GET /v3/applicationBuild/{applicationBuildId}/deploymentEnvironment HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"createdAt": 1
}
]The ID of the application build
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 applicationBuildId
Internal Server Error
GET /v3/applicationBuild/{applicationBuildId}/fleet HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"operationalStatus": 1,
"isGameLift": true
}
]The ID of the application build
OK
Invalid credentials
Invalid applicationBuildId
Internal Server Error
GET /v3/applicationBuild/{applicationBuildId}/deploymentTemplate HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"fleetIds": [
"text"
],
"name": "text",
"inUse": 1,
"createdAt": 1,
"gameDeploymentTemplateBuild": [
{
"applicationBuildId": "text"
}
]
}
]OK
The number of hosts
The number of instances
The number of players
Invalid credentials
Invalid applicationBuildId
Internal Server Error
GET /v3/telemetry/applicationBuild/{applicationBuildId}/current HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"hosts": 1,
"instances": 1,
"players": 1
}
]Unix timestamp. Filter from time, default value is -1 day
Unix timestamp. Filter to time, default value is now
OK
Unit of data frequency, possible interval options are as follows
- minute
- hour
- day
- month
Invalid credentials
Invalid applicationBuildId
Internal Server Error
GET /v3/telemetry/applicationBuild/{applicationBuildId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"hosts": 1,
"instances": 1,
"players": 1
}
]
}
]The Id of the application build
OK
The application build property ID
The application build property type. For a list of application property types see
GET /v3/application/property/type
The application build property key. Only hyphens (-), underscores (_), lowercase characters and numbers are allowed. Keys must start with a lowercase character
The application build property value
Invalid credentials
Invalid applicationBuildId
Internal Server Error
GET /v3/applicationBuild/{applicationBuildId}/property HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}
]The Id of the application build
The Id of the application build property
OK
The application build property ID
The application build property type. For a list of application property types see
GET /v3/application/property/type
The application build property key. Only hyphens (-), underscores (_), lowercase characters and numbers are allowed. Keys must start with a lowercase character
The application build property value
Invalid credentials
Invalid applicationBuildId or propertyId
Internal Server Error
GET /v3/applicationBuild/{applicationBuildId}/property/{propertyId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}
]The Id of the application build
The Id of the application build property to update
The application build property ID
The application build property type. For a list of application property types see
GET /v3/application/property/type
The application build property key. Only hyphens (-), underscores (_), lowercase characters and numbers are allowed. Keys must start with a lowercase character
The application build property value
OK
The application build property ID
The application build property type. For a list of application property types see
GET /v3/application/property/type
The application build property key. Only hyphens (-), underscores (_), lowercase characters and numbers are allowed. Keys must start with a lowercase character
The application build property value
Invalid credentials
Invalid applicationBuildId or propertyId
Network port is already in use by another network port property
Unprocessable Entity
Internal Server Error
PUT /v3/applicationBuild/{applicationBuildId}/property/{propertyId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 24
{
"propertyValue": "text"
}[
{
"id": "text",
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}
]The Id of the application build
OK
Application build configuration ID
Configuration file path
Configuration file name
Configuration file contents
UnixTimestamp
Invalid credentials
Invalid applicationBuildId
Internal Server Error
GET /v3/applicationBuild/{applicationBuildId}/configuration HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"configPath": "text",
"configName": "text",
"configContent": "text",
"createdAt": 1
}
]The Id of the application build
Application build configuration ID
Configuration file path
Configuration file name
Configuration file contents
UnixTimestamp
OK
Application build configuration ID
Configuration file path
Configuration file name
Configuration file contents
UnixTimestamp
Invalid credentials
Invalid applicationBuildId
Unprocessable Entity
Internal Server Error
POST /v3/applicationBuild/{applicationBuildId}/configuration HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 64
{
"configPath": "text",
"configName": "text",
"configContent": "text"
}[
{
"id": "text",
"configPath": "text",
"configName": "text",
"configContent": "text",
"createdAt": 1
}
]The Id of the application build
The Id of the specific configuration
OK
Application build configuration ID
Configuration file path
Configuration file name
Configuration file contents
UnixTimestamp
Invalid credentials
Invalid applicationBuildId or applicationBuildConfigurationId
Internal Server Error
GET /v3/applicationBuild/{applicationBuildId}/configuration/{applicationBuildConfigurationId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"configPath": "text",
"configName": "text",
"configContent": "text",
"createdAt": 1
}
]The Id of the application build
The Id of the specific configuration
Application build configuration ID
Configuration file path
Configuration file name
Configuration file contents
UnixTimestamp
OK
Application build configuration ID
Configuration file path
Configuration file name
Configuration file contents
UnixTimestamp
Invalid credentials
Invalid applicationBuildId or applicationBuildConfigurationId
Unprocessable Entity
Internal Server Error
PUT /v3/applicationBuild/{applicationBuildId}/configuration/{applicationBuildConfigurationId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 64
{
"configPath": "text",
"configName": "text",
"configContent": "text"
}[
{
"id": "text",
"configPath": "text",
"configName": "text",
"configContent": "text",
"createdAt": 1
}
]The Id of the application build
The Id of the specific configuration
No Content
No content
Invalid credentials
Invalid applicationBuildId or applicationBuildConfigurationId
Internal Server Error
DELETE /v3/applicationBuild/{applicationBuildId}/configuration/{applicationBuildConfigurationId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
OK
Patch job type ID
Patch job type description
Invalid credentials
Internal Server Error
GET /v3/patchJob/type HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"typeId": 1,
"typeDescription": "text"
}
]OK
Patch job type ID
Patch job type description
Invalid credentials
Internal Server Error
GET /v3/patchJob/runtimeType HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"typeId": 1,
"typeDescription": "text"
}
]OK
Patch job status ID
Patch job status description
Invalid credentials
Internal Server Error
GET /v3/patchJob/status HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"description": "text"
}
]Deployment environment ID
Application ID
List of fleet ID
List of application build ID
OK
Region name of application instances
Data center location name
Application build version number
Number of application instances
Invalid credentials
Internal Server Error
POST /v3/patchJob/applicationInstancePreview HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 102
{
"deploymentEnvironmentId": "text",
"applicationId": "text",
"fleet": [
"text"
],
"applicationBuild": [
"text"
]
}[
{
"region": "text",
"dataCenter": "text",
"buildVersion": "text",
"numberOfInstances": 1
}
]Example header and default range: RANGED-DATA:start=0,results=25
OK
Patch job ID
Deployment environment ID
Application ID
Patch job type, you can find the list available patch job type GET /v3/patchJob/type
Name of the patch job method
Name of the patch job (unique)
Status of the patch job, you can find the list available patch job type GET /v3/patchJob/status
Stop method of an application instance, you can find the list available application instance stop methods GET /v3/application/stopMethod
Name of the stop method
Stop method timeout of an application instance in seconds
Comments for patch job
Start time when the patch job will be started. The default value is 0, this means start directly after creation of the patch job, else the patch job will start at the provided UTC timestamp
Timestamp when the patch job has been started in UTC
Timestamp when the patch job has been created
Timestamp when the patch job last has been changed
Timestamp when the patch job has been finished in UTC
If the patch job can be cancelled, when is 1 you can cancel the patch job else not
If filled in, this ID points to the patch job that has been reverted by this patch job
If filled in, this ID points to the PatchJob that has reverted this patch job
Invalid credentials
Internal Server Error
GET /v3/patchJob HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"deploymentEnvironmentId": "text",
"applicationId": "text",
"patchJobMethodId": 1,
"patchJobMethod": "text",
"patchJobName": "text",
"status": 1,
"stopMethodId": 1,
"stopMethodName": "text",
"stopMethodTimeout": 1,
"comments": "text",
"schedulerStartTime": 1,
"patchJobStartTime": 1,
"patchJobOverallProgress": {
"total": 1,
"downloaded": 1,
"stopped": 1,
"success": 1,
"failed": 1,
"started": 1,
"canceled": 1,
"remaining": 1
},
"applicationBuild": [
{
"id": "text",
"oldApplicationBuildId": "text",
"newApplicationBuildId": "text"
}
],
"fleet": [
{
"id": "text",
"fleetId": "text"
}
],
"email": [
{
"id": "text",
"email": "text",
"progressReport": 1,
"resultReport": 1,
"createdAt": 1,
"changedAt": 1
}
],
"createdAt": 1,
"changedAt": 1,
"finishedAt": 1,
"isRevertable": 1,
"revertsPatchJobId": 1,
"revertedByPatchJobId": 1
}
]Patch job ID
Deployment environment ID
Application ID
Patch job type, you can find the list available patch job type GET /v3/patchJob/type
Name of the patch job method
Name of the patch job (unique)
Status of the patch job, you can find the list available patch job type GET /v3/patchJob/status
Stop method of an application instance, you can find the list available application instance stop methods GET /v3/application/stopMethod
Name of the stop method
Stop method timeout of an application instance in seconds
Comments for patch job
Start time when the patch job will be started. The default value is 0, this means start directly after creation of the patch job, else the patch job will start at the provided UTC timestamp
Timestamp when the patch job has been started in UTC
Timestamp when the patch job has been created
Timestamp when the patch job last has been changed
Timestamp when the patch job has been finished in UTC
If the patch job can be cancelled, when is 1 you can cancel the patch job else not
If filled in, this ID points to the patch job that has been reverted by this patch job
If filled in, this ID points to the PatchJob that has reverted this patch job
OK
Patch job ID
Deployment environment ID
Application ID
Patch job type, you can find the list available patch job type GET /v3/patchJob/type
Name of the patch job method
Name of the patch job (unique)
Status of the patch job, you can find the list available patch job type GET /v3/patchJob/status
Stop method of an application instance, you can find the list available application instance stop methods GET /v3/application/stopMethod
Name of the stop method
Stop method timeout of an application instance in seconds
Comments for patch job
Start time when the patch job will be started. The default value is 0, this means start directly after creation of the patch job, else the patch job will start at the provided UTC timestamp
Timestamp when the patch job has been started in UTC
Timestamp when the patch job has been created
Timestamp when the patch job last has been changed
Timestamp when the patch job has been finished in UTC
If the patch job can be cancelled, when is 1 you can cancel the patch job else not
If filled in, this ID points to the patch job that has been reverted by this patch job
If filled in, this ID points to the PatchJob that has reverted this patch job
Invalid credentials
Internal Server Error
POST /v3/patchJob HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 357
{
"deploymentEnvironmentId": "text",
"applicationId": "text",
"patchJobMethodId": 1,
"patchJobName": "text",
"stopMethodId": 1,
"stopMethodTimeout": 1,
"comments": "text",
"schedulerStartTime": 1,
"applicationBuild": [
{
"oldApplicationBuildId": "text",
"newApplicationBuildId": "text"
}
],
"fleet": [
{
"fleetId": "text"
}
],
"email": [
{
"email": "text",
"progressReport": 1,
"resultReport": 1
}
]
}[
{
"id": "text",
"deploymentEnvironmentId": "text",
"applicationId": "text",
"patchJobMethodId": 1,
"patchJobMethod": "text",
"patchJobName": "text",
"status": 1,
"stopMethodId": 1,
"stopMethodName": "text",
"stopMethodTimeout": 1,
"comments": "text",
"schedulerStartTime": 1,
"patchJobStartTime": 1,
"patchJobOverallProgress": {
"total": 1,
"downloaded": 1,
"stopped": 1,
"success": 1,
"failed": 1,
"started": 1,
"canceled": 1,
"remaining": 1
},
"applicationBuild": [
{
"id": "text",
"oldApplicationBuildId": "text",
"newApplicationBuildId": "text"
}
],
"fleet": [
{
"id": "text",
"fleetId": "text"
}
],
"email": [
{
"id": "text",
"email": "text",
"progressReport": 1,
"resultReport": 1,
"createdAt": 1,
"changedAt": 1
}
],
"createdAt": 1,
"changedAt": 1,
"finishedAt": 1,
"isRevertable": 1,
"revertsPatchJobId": 1,
"revertedByPatchJobId": 1
}
]The Id of the patch job for which to fetch the information
OK
Patch job ID
Deployment environment ID
Application ID
Patch job type, you can find the list available patch job type GET /v3/patchJob/type
Name of the patch job method
Name of the patch job (unique)
Status of the patch job, you can find the list available patch job type GET /v3/patchJob/status
Stop method of an application instance, you can find the list available application instance stop methods GET /v3/application/stopMethod
Name of the stop method
Stop method timeout of an application instance in seconds
Comments for patch job
Start time when the patch job will be started. The default value is 0, this means start directly after creation of the patch job, else the patch job will start at the provided UTC timestamp
Timestamp when the patch job has been started in UTC
Timestamp when the patch job has been created
Timestamp when the patch job last has been changed
Timestamp when the patch job has been finished in UTC
If the patch job can be cancelled, when is 1 you can cancel the patch job else not
If filled in, this ID points to the patch job that has been reverted by this patch job
If filled in, this ID points to the PatchJob that has reverted this patch job
Invalid credentials
Invalid patchJobId
Internal Server Error
GET /v3/patchJob/{patchJobId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"deploymentEnvironmentId": "text",
"applicationId": "text",
"patchJobMethodId": 1,
"patchJobMethod": "text",
"patchJobName": "text",
"status": 1,
"stopMethodId": 1,
"stopMethodName": "text",
"stopMethodTimeout": 1,
"comments": "text",
"schedulerStartTime": 1,
"patchJobStartTime": 1,
"patchJobOverallProgress": {
"total": 1,
"downloaded": 1,
"stopped": 1,
"success": 1,
"failed": 1,
"started": 1,
"canceled": 1,
"remaining": 1
},
"applicationBuild": [
{
"id": "text",
"oldApplicationBuildId": "text",
"newApplicationBuildId": "text"
}
],
"fleet": [
{
"id": "text",
"fleetId": "text"
}
],
"email": [
{
"id": "text",
"email": "text",
"progressReport": 1,
"resultReport": 1,
"createdAt": 1,
"changedAt": 1
}
],
"createdAt": 1,
"changedAt": 1,
"finishedAt": 1,
"isRevertable": 1,
"revertsPatchJobId": 1,
"revertedByPatchJobId": 1
}
]The Id of the patch job
Patch job ID
Deployment environment ID
Application ID
Patch job type, you can find the list available patch job type GET /v3/patchJob/type
Name of the patch job method
Name of the patch job (unique)
Status of the patch job, you can find the list available patch job type GET /v3/patchJob/status
Stop method of an application instance, you can find the list available application instance stop methods GET /v3/application/stopMethod
Name of the stop method
Stop method timeout of an application instance in seconds
Comments for patch job
Start time when the patch job will be started. The default value is 0, this means start directly after creation of the patch job, else the patch job will start at the provided UTC timestamp
Timestamp when the patch job has been started in UTC
Timestamp when the patch job has been created
Timestamp when the patch job last has been changed
Timestamp when the patch job has been finished in UTC
If the patch job can be cancelled, when is 1 you can cancel the patch job else not
If filled in, this ID points to the patch job that has been reverted by this patch job
If filled in, this ID points to the PatchJob that has reverted this patch job
OK
Patch job ID
Deployment environment ID
Application ID
Patch job type, you can find the list available patch job type GET /v3/patchJob/type
Name of the patch job method
Name of the patch job (unique)
Status of the patch job, you can find the list available patch job type GET /v3/patchJob/status
Stop method of an application instance, you can find the list available application instance stop methods GET /v3/application/stopMethod
Name of the stop method
Stop method timeout of an application instance in seconds
Comments for patch job
Start time when the patch job will be started. The default value is 0, this means start directly after creation of the patch job, else the patch job will start at the provided UTC timestamp
Timestamp when the patch job has been started in UTC
Timestamp when the patch job has been created
Timestamp when the patch job last has been changed
Timestamp when the patch job has been finished in UTC
If the patch job can be cancelled, when is 1 you can cancel the patch job else not
If filled in, this ID points to the patch job that has been reverted by this patch job
If filled in, this ID points to the PatchJob that has reverted this patch job
Invalid credentials
Invalid patchJobId
Internal Server Error
PUT /v3/patchJob/{patchJobId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 357
{
"deploymentEnvironmentId": "text",
"applicationId": "text",
"patchJobMethodId": 1,
"patchJobName": "text",
"stopMethodId": 1,
"stopMethodTimeout": 1,
"comments": "text",
"schedulerStartTime": 1,
"applicationBuild": [
{
"oldApplicationBuildId": "text",
"newApplicationBuildId": "text"
}
],
"fleet": [
{
"fleetId": "text"
}
],
"email": [
{
"email": "text",
"progressReport": 1,
"resultReport": 1
}
]
}[
{
"id": "text",
"deploymentEnvironmentId": "text",
"applicationId": "text",
"patchJobMethodId": 1,
"patchJobMethod": "text",
"patchJobName": "text",
"status": 1,
"stopMethodId": 1,
"stopMethodName": "text",
"stopMethodTimeout": 1,
"comments": "text",
"schedulerStartTime": 1,
"patchJobStartTime": 1,
"patchJobOverallProgress": {
"total": 1,
"downloaded": 1,
"stopped": 1,
"success": 1,
"failed": 1,
"started": 1,
"canceled": 1,
"remaining": 1
},
"applicationBuild": [
{
"id": "text",
"oldApplicationBuildId": "text",
"newApplicationBuildId": "text"
}
],
"fleet": [
{
"id": "text",
"fleetId": "text"
}
],
"email": [
{
"id": "text",
"email": "text",
"progressReport": 1,
"resultReport": 1,
"createdAt": 1,
"changedAt": 1
}
],
"createdAt": 1,
"changedAt": 1,
"finishedAt": 1,
"isRevertable": 1,
"revertsPatchJobId": 1,
"revertedByPatchJobId": 1
}
]Example header and default range: RANGED-DATA:start=0,results=25
OK
Patch job ID
Deployment environment ID
Application ID
Name of the application
Name of all the application builds that will be patched
Patch job type, you can find the list available patch job type GET /v3/patchJob/type
Name of the patch job chosen
Name of the patch job (unique)
Status of the patch job
Comments for patch job
When the patch job needs to start, default value is 0 this means it’s start directly after creating the patch job, else there needs to give a timestamp in UTC when the job needs to start
Timestamp when the patch job has been started in UTC
Timestamp when the patch job has been finished in UTC
If the patch job can be cancelled
Invalid credentials
Internal Server Error
GET /v3/patchJob/summary HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"deploymentEnvironmentId": "text",
"applicationId": "text",
"applicationName": "text",
"newApplicationBuildName": "text",
"patchJobMethodId": 1,
"patchJobMethodName": "text",
"patchJobName": "text",
"status": 1,
"comments": "text",
"schedulerStartTime": 1,
"patchJobStartTime": 1,
"finishedAt": 1,
"isRevertable": 1,
"patchJobOverallProgress": {
"total": 1,
"downloaded": 1,
"stopped": 1,
"success": 1,
"failed": 1,
"started": 1,
"canceled": 1,
"remaining": 1
}
}
]The Id of the deployment environment
The Id of the application (game or utility)
OK
ID of the fleet
Name of the fleet
Invalid credentials
Invalid deploymentEnvironmentId or applicationId
Internal Server Error
GET /v3/patchJob/deploymentEnvironment/{deploymentEnvironmentId}/application/{applicationId}/fleet HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"applicationBuild": [
{
"id": "text",
"name": "text",
"osId": 1
}
]
}
]The Id of the patch job
OK
ID of a patch job email
Email address for reporting (unique)
If 1 progress report will be send, if 0 no progress report will be send
If 1 result report will be send, if 0 no result report will be send
Timestamp when the patch job email has been created
Timestamp when the patch job email last has been changed
Invalid credentials
Invalid patchJobId
Internal Server Error
GET /v3/patchJob/{patchJobId}/email HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"email": "text",
"progressReport": 1,
"resultReport": 1,
"createdAt": 1,
"changedAt": 1
}
]The Id of the patch job
ID of a patch job email
Email address for reporting (unique)
If 1 progress report will be send, if 0 no progress report will be send
If 1 result report will be send, if 0 no result report will be send
Timestamp when the patch job email has been created
Timestamp when the patch job email last has been changed
OK
ID of a patch job email
Email address for reporting (unique)
If 1 progress report will be send, if 0 no progress report will be send
If 1 result report will be send, if 0 no result report will be send
Timestamp when the patch job email has been created
Timestamp when the patch job email last has been changed
Invalid credentials
Invalid patchJobId
Internal Server Error
POST /v3/patchJob/{patchJobId}/email HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 52
{
"email": "text",
"progressReport": 1,
"resultReport": 1
}[
{
"id": "text",
"email": "text",
"progressReport": 1,
"resultReport": 1,
"createdAt": 1,
"changedAt": 1
}
]The Id of the patch job to put on hold
OK
Patch job ID
Deployment environment ID
Application ID
Patch job type, you can find the list available patch job type GET /v3/patchJob/type
Name of the patch job method
Name of the patch job (unique)
Status of the patch job, you can find the list available patch job type GET /v3/patchJob/status
Stop method of an application instance, you can find the list available application instance stop methods GET /v3/application/stopMethod
Name of the stop method
Stop method timeout of an application instance in seconds
Comments for patch job
Start time when the patch job will be started. The default value is 0, this means start directly after creation of the patch job, else the patch job will start at the provided UTC timestamp
Timestamp when the patch job has been started in UTC
Timestamp when the patch job has been created
Timestamp when the patch job last has been changed
Timestamp when the patch job has been finished in UTC
If the patch job can be cancelled, when is 1 you can cancel the patch job else not
If filled in, this ID points to the patch job that has been reverted by this patch job
If filled in, this ID points to the PatchJob that has reverted this patch job
Invalid credentials
Invalid patchJobId
Internal Server Error
PUT /v3/patchJob/{patchJobId}/hold HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"deploymentEnvironmentId": "text",
"applicationId": "text",
"patchJobMethodId": 1,
"patchJobMethod": "text",
"patchJobName": "text",
"status": 1,
"stopMethodId": 1,
"stopMethodName": "text",
"stopMethodTimeout": 1,
"comments": "text",
"schedulerStartTime": 1,
"patchJobStartTime": 1,
"patchJobOverallProgress": {
"total": 1,
"downloaded": 1,
"stopped": 1,
"success": 1,
"failed": 1,
"started": 1,
"canceled": 1,
"remaining": 1
},
"applicationBuild": [
{
"id": "text",
"oldApplicationBuildId": "text",
"newApplicationBuildId": "text"
}
],
"fleet": [
{
"id": "text",
"fleetId": "text"
}
],
"email": [
{
"id": "text",
"email": "text",
"progressReport": 1,
"resultReport": 1,
"createdAt": 1,
"changedAt": 1
}
],
"createdAt": 1,
"changedAt": 1,
"finishedAt": 1,
"isRevertable": 1,
"revertsPatchJobId": 1,
"revertedByPatchJobId": 1
}
]The Id of the patch job
OK
Patch job ID
Deployment environment ID
Application ID
Patch job type, you can find the list available patch job type GET /v3/patchJob/type
Name of the patch job method
Name of the patch job (unique)
Status of the patch job, you can find the list available patch job type GET /v3/patchJob/status
Stop method of an application instance, you can find the list available application instance stop methods GET /v3/application/stopMethod
Name of the stop method
Stop method timeout of an application instance in seconds
Comments for patch job
Start time when the patch job will be started. The default value is 0, this means start directly after creation of the patch job, else the patch job will start at the provided UTC timestamp
Timestamp when the patch job has been started in UTC
Timestamp when the patch job has been created
Timestamp when the patch job last has been changed
Timestamp when the patch job has been finished in UTC
If the patch job can be cancelled, when is 1 you can cancel the patch job else not
If filled in, this ID points to the patch job that has been reverted by this patch job
If filled in, this ID points to the PatchJob that has reverted this patch job
Invalid credentials
Invalid patchJobId
Internal Server Error
PUT /v3/patchJob/{patchJobId}/unhold HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"deploymentEnvironmentId": "text",
"applicationId": "text",
"patchJobMethodId": 1,
"patchJobMethod": "text",
"patchJobName": "text",
"status": 1,
"stopMethodId": 1,
"stopMethodName": "text",
"stopMethodTimeout": 1,
"comments": "text",
"schedulerStartTime": 1,
"patchJobStartTime": 1,
"patchJobOverallProgress": {
"total": 1,
"downloaded": 1,
"stopped": 1,
"success": 1,
"failed": 1,
"started": 1,
"canceled": 1,
"remaining": 1
},
"applicationBuild": [
{
"id": "text",
"oldApplicationBuildId": "text",
"newApplicationBuildId": "text"
}
],
"fleet": [
{
"id": "text",
"fleetId": "text"
}
],
"email": [
{
"id": "text",
"email": "text",
"progressReport": 1,
"resultReport": 1,
"createdAt": 1,
"changedAt": 1
}
],
"createdAt": 1,
"changedAt": 1,
"finishedAt": 1,
"isRevertable": 1,
"revertsPatchJobId": 1,
"revertedByPatchJobId": 1
}
]The Id of the patch job
OK
Patch job ID
Deployment environment ID
Application ID
Patch job type, you can find the list available patch job type GET /v3/patchJob/type
Name of the patch job method
Name of the patch job (unique)
Status of the patch job, you can find the list available patch job type GET /v3/patchJob/status
Stop method of an application instance, you can find the list available application instance stop methods GET /v3/application/stopMethod
Name of the stop method
Stop method timeout of an application instance in seconds
Comments for patch job
Start time when the patch job will be started. The default value is 0, this means start directly after creation of the patch job, else the patch job will start at the provided UTC timestamp
Timestamp when the patch job has been started in UTC
Timestamp when the patch job has been created
Timestamp when the patch job last has been changed
Timestamp when the patch job has been finished in UTC
If the patch job can be cancelled, when is 1 you can cancel the patch job else not
If filled in, this ID points to the patch job that has been reverted by this patch job
If filled in, this ID points to the PatchJob that has reverted this patch job
Invalid credentials
Invalid patchJobId
Internal Server Error
PUT /v3/patchJob/{patchJobId}/cancel HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"deploymentEnvironmentId": "text",
"applicationId": "text",
"patchJobMethodId": 1,
"patchJobMethod": "text",
"patchJobName": "text",
"status": 1,
"stopMethodId": 1,
"stopMethodName": "text",
"stopMethodTimeout": 1,
"comments": "text",
"schedulerStartTime": 1,
"patchJobStartTime": 1,
"patchJobOverallProgress": {
"total": 1,
"downloaded": 1,
"stopped": 1,
"success": 1,
"failed": 1,
"started": 1,
"canceled": 1,
"remaining": 1
},
"applicationBuild": [
{
"id": "text",
"oldApplicationBuildId": "text",
"newApplicationBuildId": "text"
}
],
"fleet": [
{
"id": "text",
"fleetId": "text"
}
],
"email": [
{
"id": "text",
"email": "text",
"progressReport": 1,
"resultReport": 1,
"createdAt": 1,
"changedAt": 1
}
],
"createdAt": 1,
"changedAt": 1,
"finishedAt": 1,
"isRevertable": 1,
"revertsPatchJobId": 1,
"revertedByPatchJobId": 1
}
]The Id of the patch job
No Content
No content
Invalid credentials
Invalid patchJobId
unprocessable patchJob
Internal Server Error
PUT /v3/patchJob/{patchJobId}/stop HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
The Id of the patch job
The Id of the patch job report email
OK
Patch job ID
Deployment environment ID
Application ID
Patch job type, you can find the list available patch job type GET /v3/patchJob/type
Name of the patch job method
Name of the patch job (unique)
Status of the patch job, you can find the list available patch job type GET /v3/patchJob/status
Stop method of an application instance, you can find the list available application instance stop methods GET /v3/application/stopMethod
Name of the stop method
Stop method timeout of an application instance in seconds
Comments for patch job
Start time when the patch job will be started. The default value is 0, this means start directly after creation of the patch job, else the patch job will start at the provided UTC timestamp
Timestamp when the patch job has been started in UTC
Timestamp when the patch job has been created
Timestamp when the patch job last has been changed
Timestamp when the patch job has been finished in UTC
If the patch job can be cancelled, when is 1 you can cancel the patch job else not
If filled in, this ID points to the patch job that has been reverted by this patch job
If filled in, this ID points to the PatchJob that has reverted this patch job
Invalid credentials
Invalid patchJobId or reportEmailId
Internal Server Error
DELETE /v3/patchJob/{patchJobId}/email/{patchJobReportEmailId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"deploymentEnvironmentId": "text",
"applicationId": "text",
"patchJobMethodId": 1,
"patchJobMethod": "text",
"patchJobName": "text",
"status": 1,
"stopMethodId": 1,
"stopMethodName": "text",
"stopMethodTimeout": 1,
"comments": "text",
"schedulerStartTime": 1,
"patchJobStartTime": 1,
"patchJobOverallProgress": {
"total": 1,
"downloaded": 1,
"stopped": 1,
"success": 1,
"failed": 1,
"started": 1,
"canceled": 1,
"remaining": 1
},
"applicationBuild": [
{
"id": "text",
"oldApplicationBuildId": "text",
"newApplicationBuildId": "text"
}
],
"fleet": [
{
"id": "text",
"fleetId": "text"
}
],
"email": [
{
"id": "text",
"email": "text",
"progressReport": 1,
"resultReport": 1,
"createdAt": 1,
"changedAt": 1
}
],
"createdAt": 1,
"changedAt": 1,
"finishedAt": 1,
"isRevertable": 1,
"revertsPatchJobId": 1,
"revertedByPatchJobId": 1
}
]The Id of the patch job
OK
ID of a patch job email
Email address for reporting (unique)
If 1 progress report will be send, if 0 no progress report will be send
If 1 result report will be send, if 0 no result report will be send
Timestamp when the patch job email has been created
Timestamp when the patch job email last has been changed
Invalid credentials
Invalid patchJobId
Internal Server Error
PUT /v3/patchJob/{patchJobId}/email/bulk HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 72
{
"patchJobEmail": [
{
"email": "text",
"progressReport": 1,
"resultReport": 1
}
]
}[
{
"id": "text",
"email": "text",
"progressReport": 1,
"resultReport": 1,
"createdAt": 1,
"changedAt": 1
}
]OK
Patch job ID
Name of the patch job
Unix timestamp when the status of the patch job has been changed
Unix timestamp when the patch job finished (if 0 then the patch job is still running)
Unix timestamp when the patch job started
Name of the patch job method (strategy)
Status of the patch job
Invalid credentials
Internal Server Error
GET /v3/patchJob/{patchJobId}/report/progress HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"patchJobId": "text",
"patchJobName": "text",
"changedAt": 1,
"finishedAt": 1,
"startedAt": 1,
"patchJobMethodName": "text",
"patchJobStatus": 1,
"deploymentEnvironment": {
"id": "text",
"name": "text"
},
"oldApplicationBuilds": [
{
"id": "text",
"name": "text",
"version": "text"
}
],
"newApplicationBuild": {
"id": "text",
"name": "text",
"version": "text"
},
"progress": {
"total": 1,
"downloaded": 1,
"stopped": 1,
"success": 1,
"failed": 1,
"started": 1,
"canceled": 1,
"remaining": 1
},
"fleetData": [
{
"fleet": {
"id": "text",
"name": "text"
},
"progress": {
"total": 1,
"downloaded": 1,
"stopped": 1,
"success": 1,
"failed": 1,
"started": 1,
"canceled": 1,
"remaining": 1
},
"deploymentRegionData": [
{
"deploymentRegion": {
"id": "text",
"name": "text"
},
"progress": {
"total": 1,
"downloaded": 1,
"stopped": 1,
"success": 1,
"failed": 1,
"started": 1,
"canceled": 1,
"remaining": 1
},
"dcLocationData": [
{
"dcLocation": {
"id": 1,
"name": "text"
},
"dcLocationRegionName": "text",
"progress": {
"total": 1,
"downloaded": 1,
"stopped": 1,
"success": 1,
"failed": 1,
"started": 1,
"canceled": 1,
"remaining": 1
}
}
]
}
]
}
]
}
]Example header and default range: RANGED-DATA:start=0,results=25
OK
Application instance ID
The deployment environment ID of this application instance
The deployment environment name of this application instance
The fleet ID of this application instance
The fleet name of this application instance
The application instance is host on this server.
0 if this instance runs on a bare metal server, 1 if it runs on a VM
The application ID of this application instance
The application name of this application instance
The type of the application, the different types can be found in: GET /application/type
The application build ID of this application instance
The application build name of this application instance
ID of the application install
The datacenter ID of where this application instance is located
The datacenter name of where this application instance is located
The deployment region ID of where this application instance is located
The deployment region name of where this application instance is located
The application instance status, list of application instance status can be found in GET /v3/applicationInstance/status
The Unix timestamp at which this application instance is created
The Unix timestamp at which this application instance is started
The Unix timestamp at which this application instance is stopped
The process ID of the application instance running on the host
The Unix timestamp of the moment the process ID has been changed on the host
If set to 1, the application instance was manually deployed.
If auto restart is 1 than the application instance will auto restart, when 0 the application instance auto restart will be disabled
if an application will be deleted it will be 1 else 0
1 if Arcus is available & running for this application instance, 0 otherwise.
Note: If your application's managementProtocol is NOT set to Arcus, this value will always be 0, even if your
game server would support the Arcus protocol. The protocol is only tested, and this value potentially be set to 1,
when the managementProtocol is set to Arcus.
Invalid credentials
Internal Server Error
GET /v3/patchJob/{patchJobId}/failedApplicationInstances HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
RANGED-DATA: text
Accept: */*
[
{
"id": "text",
"deploymentEnvironmentId": "text",
"deploymentEnvironmentName": "text",
"fleetId": "text",
"fleetName": "text",
"hostId": 1,
"isVirtual": 1,
"applicationId": "text",
"applicationName": "text",
"applicationType": 1,
"applicationBuildId": "text",
"applicationBuildName": "text",
"dcLocationId": 1,
"dcLocationName": "text",
"regionId": "text",
"regionName": "text",
"status": 1,
"createdAt": 1,
"startedAt": 1,
"stoppedAt": 1,
"pid": 1,
"pidChangedAt": 1,
"manuallyDeployed": 1,
"autoRestart": 1,
"markedForDeletion": 1,
"arcusAvailable": 1
}
]OK
Application instance ID
The application's fleet ID
The application's fleet name
The application instance is host on this server.
0 if this instance runs on a bare metal server, 1 if it runs on a VM
The ID of the application
The application's application name
The type of the application, the different types can be found in: GET /v3/application/type]
The ID of the application build
The application's application build name
ID of the application install
The datacenter ID of where this application instance is located
The application's dc location name
The deployment region ID of where this application instance is located
The application's region name
The application instance status, list of application instance status can be found in GET /v3/applicationInstance/status
The Unix timestamp at which this application instance is created
The Unix timestamp at which this application instance is started
The Unix timestamp at which this application instance is stopped
The process ID of the application instance running on the host
The Unix timestamp of the moment the process ID has been changed on the host
If set to 1, the application instance was manually deployed.
The maximum number of players on the application instance (this only apply to application instances of the type game)
The number of online players on the application instance (this only apply to application instances of the type game)
The live host name of the application instance (this only apply to application instances of the type game)
The live map of an application instance (this only apply to application instances of the type game)
The live game version of an application instance (this only apply to application instances of the type game)
The live rules of an application instance (this only apply to application instances of the type game)
If auto restart is 1 than the application instance will auto restart, when 0 the application instance auto restart will be disabled
if an application will be deleted it will be 1 else 0
The exit code of the application, if it has crashed during patching else it will be 0
The reason why the application instance failed to patch
The start parameters that were used to start the application
Invalid credentials
Internal Server Error
GET /v3/patchJob/{patchJobId}/applicationInstance/{applicationInstanceId}/failedApplicationInstance HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"fleetId": "text",
"fleetName": "text",
"hostId": 1,
"isVirtual": 1,
"applicationId": "text",
"applicationName": "text",
"applicationType": 1,
"applicationBuildId": "text",
"applicationBuildName": "text",
"dcLocationId": 1,
"dcLocationName": "text",
"regionId": "text",
"regionName": "text",
"status": 1,
"createdAt": 1,
"startedAt": 1,
"stoppedAt": 1,
"pid": 1,
"pidChangedAt": 1,
"manuallyDeployed": 1,
"properties": [
{
"id": "text",
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}
],
"ipAddress": [
{
"ipAddress": "text",
"ipVersion": 1,
"private": 1
}
],
"labelReadOnly": [
{
"key": "text",
"value": "text"
}
],
"labelPublic": [
{
"key": "text",
"value": "text"
}
],
"metadata": [
{
"key": "text",
"value": "text"
}
],
"numPlayersMax": 1,
"numPlayers": 1,
"liveHostName": "text",
"liveMap": "text",
"liveGameVersion": "text",
"liveRules": "text",
"autoRestart": 1,
"markedForDeletion": 1,
"exitCode": 1,
"failingReason": "text",
"startParameters": "text"
}
]Label expressions can be used to apply more specific search parameters and can be written in standard SQL query language.
E.g. region_id=123 or multiple filters: region_id=123 and fleet_id=456 or host_id=46256 The provided filter query needs to be url encoded. E.g.
region_id%3D123 or multiple filters: region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256 The total would look like:
/applicationInstance?labels=region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256
If you want to filter on a non-numeric label such as region_name, you have to wrap the value in double quotes: region_name="Rotterdam"
Warning: the labels query parameter is ignored when passing a PAGE-TOKEN and the original labels string will be used for that request
instead. More information on the use of labels can be found in the
label documentation.
Filter expression can be used to apply more specific search on most parameters in the application instance, it is written like
this E.G. regionId=123 or multiple filters: regionId=123 and fleetId=456, only the AND statement is supported at this time. You can also
search inside nested objects like metadata.key="testing" and metadata.value="test" You can only search on exact matches.
Warning: the filters query parameter is ignored when passing a PAGE-TOKEN and the original filters string will be used for that request
instead.
Warning: filtering on the following parameters is currently not supported and will give an error:
autoRestart, liveGameVersion, liveHostName, liveMap, liveRules, manuallyDeployed, markedForDeletion, numPlayers, numPlayersMax,
pid, pidChangedAt, startedAt, status, stoppedAt, updatedAt
Sort expression to sort your results in the order that you like E.G. sort=fleetId ASC, applicationId DESC Be aware that all filters
and sorting should be url encoded.
Warning: the sort query parameter is ignored when passing a PAGE-TOKEN and the original sort string will be used for that request instead
Warning: sorting on the following parameters is currently not supported and will give an error:
autoRestart, liveGameVersion, liveHostName, liveMap, liveRules, manuallyDeployed, markedForDeletion, numPlayers, numPlayersMax,
pid, pidChangedAt, startedAt, status, stoppedAt, updatedAt
Example header and default range: RANGED-DATA: start=0,results=25
Warning: the start variable of the RANGED-DATA object has been deprecated for this endpoint. It is not possible to supply a start, see
PAGE-TOKEN header for a replacement
This token will be provided by this endpoint to allow for pagination functionality. By performing a request to this endpoint
without the PAGE-TOKEN you will retrieve the first page of search results. If a PAGE-TOKEN is returned, a next page may be requested by
supplying that token in the next request using the same PAGE-TOKEN key and value in the request header. If no PAGE-TOKEN is returned, the last
page has been reached and no further data can be requested. A returned PAGE-TOKEN is valid until the date specified in the Expires response
header. Example: PAGE-TOKEN: eyJjb25kaXRpb25zIjp7InVzZXJJZCI6NjY2ODI1fSwibGFiZWxz(...) (truncated for readability)
Expires header example: Expires: Fri, 08 Jan 2021 09:10:29 GMT
OK
Application instance ID
The deployment environment ID of this application instance
The deployment environment name of this application instance
The fleet ID of this application instance
The fleet name of this application instance
The application instance is host on this server.
0 if this instance runs on a bare metal server, 1 if it runs on a VM
The application ID of this application instance
The application name of this application instance
The type of the application, the different types can be found in: GET /v3/application/type
The application build ID of this application instance
The application build name of this application instance
ID of the application install
The datacenter ID of where this application instance is located
The datacenter name of where this application instance is located
The deployment region ID of where this application instance is located
The deployment region name of where this application instance is located
The application instance status, list of application instance status can be found in GET /v3/applicationInstance/status
The Unix timestamp at which this application instance is created
The Unix timestamp at which this application instance is started
The Unix timestamp at which this application instance is stopped
The process ID of the application instance running on the host
The Unix timestamp of the moment the process ID has been changed on the host
The exact startup parameters that were used to start this application instance with all properties resolved to their
respective values. Will be null if the instance has not been started, but will retain its previous value if it was stopped. Once set it will never be
cleared again
The name of the executable that was ran when the application instance started. Will be null if the instance has not been
started, but will retain its previous value if it was stopped. Once set it will never be cleared again
If set to 1, the application instance was manually deployed, instead of automatically deployed through the system
The maximum number of players on the application instance (this only apply to application instances of the type game)
The number of online players on the application instance (this only apply to application instances of the type game)
The live host name of the application instance (this only apply to application instances of the type game)
The live map of an application instance (this only apply to application instances of the type game)
The live game version of an application instance (this only apply to application instances of the type game)
The Unix timestamp at which this application instance is live data is updated (this only apply to application instances of the type game)
The live rules of an application instance (this only apply to application instances of the type game)
If auto restart is 1 then the application instance will auto restart, when 0 the application instance auto restart will be disabled
If an application will be deleted it will be 1, 0 otherwise
1 if Arcus is available & running for this application instance, 0 otherwise.
Note: If your application's managementProtocol is NOT set to Arcus, this value will always be 0, even if your
game server would support the Arcus protocol. The protocol is only tested, and this value potentially be set to 1,
when the managementProtocol is set to Arcus.
PAGE-TOKENdid not have an expected structure and is invalid. Please try again by sending a request without aPAGE-TOKENand restarting.- An invalid filter or sort column is provided
Invalid credentials
PAGE-TOKEN is expired. Acquire a new PAGE-TOKEN by sending a request without a PAGE-TOKEN and try again
Labels error
Internal Server Error
GET /v3/applicationInstance HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"deploymentEnvironmentId": "text",
"deploymentEnvironmentName": "text",
"fleetId": "text",
"fleetName": "text",
"hostId": 1,
"isVirtual": 1,
"applicationId": "text",
"applicationName": "text",
"applicationType": 1,
"applicationBuildId": "text",
"applicationBuildName": "text",
"dcLocationId": 1,
"dcLocationName": "text",
"regionId": "text",
"regionName": "text",
"status": 1,
"createdAt": 1,
"startedAt": 1,
"stoppedAt": 1,
"pid": 1,
"pidChangedAt": 1,
"startupParams": "text",
"executable": "text",
"manuallyDeployed": 1,
"properties": [
{
"id": "text",
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}
],
"ipAddress": [
{
"ipAddress": "text",
"ipVersion": 1,
"private": 1
}
],
"labelReadOnly": [
{
"key": "text",
"value": "text"
}
],
"labelPublic": [
{
"key": "text",
"value": "text"
}
],
"metadata": [
{
"key": "text",
"value": "text"
}
],
"numPlayersMax": 1,
"numPlayers": 1,
"liveHostName": "text",
"liveMap": "text",
"liveGameVersion": "text",
"updatedAt": 1,
"liveRules": "text",
"autoRestart": 1,
"markedForDeletion": 1,
"arcusAvailable": 1
}
]Label expressions can be used to apply more specific search parameters and can be written in standard SQL query language.
E.g. region_id=123 or multiple filters: region_id=123 and fleet_id=456 or host_id=46256 The provided filter query needs to be url encoded. E.g.
region_id%3D123 or multiple filters: region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256 The total would look like:
/applicationInstance/summary?labels=region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256
If you want to filter on a non-numeric label such as region_name, you have to wrap the value in double quotes: region_name="Rotterdam"
Warning: the labels query parameter is ignored when passing a PAGE-TOKEN and the original labels string will be used for that request
instead. More information on the use of labels can be found in the
label documentation.
Filter expression can be used to apply more specific search on most parameters in the application instance, it is written like
this E.G. regionId=123 or multiple filters: regionId=123 and fleetId=456, only the AND statement is supported at this time. You can also
search inside nested objects like metadata.key="testing" and metadata.value="test" You can only search on exact matches.
Warning: the filters query parameter is ignored when passing a PAGE-TOKEN and the original filters string will be used for that request
instead.
Warning: filtering on the following parameters is currently not supported and will give an error:
autoRestart, liveGameVersion, liveHostName, liveMap, liveRules, manuallyDeployed, markedForDeletion, numPlayers, numPlayersMax,
pid, pidChangedAt, startedAt, status, stoppedAt, updatedAt
Sort expression to sort your results in the order that you like E.G. sort=fleetId ASC, applicationId DESC Be aware that all filters
and sorting should be url encoded.
Warning: the sort query parameter is ignored when passing a PAGE-TOKEN and the original sort string will be used for that request instead
Warning: sorting on the following parameters is currently not supported and will give an error:
autoRestart, liveGameVersion, liveHostName, liveMap, liveRules, manuallyDeployed, markedForDeletion, numPlayers, numPlayersMax,
pid, pidChangedAt, startedAt, status, stoppedAt, updatedAt
Fields return in response, only fields available in model can be filter out
Example header and default range: RANGED-DATA: start=0,results=25
Warning: the start variable of the RANGED-DATA object has been deprecated for this endpoint. It is not possible to supply a start, see
PAGE-TOKEN header for a replacement
This token will be provided by this endpoint to allow for pagination functionality. By performing a request to this endpoint
without the PAGE-TOKEN you will retrieve the first page of search results. If a PAGE-TOKEN is returned, a next page may be requested by
supplying that token in the next request using the same PAGE-TOKEN key and value in the request header. If no PAGE-TOKEN is returned, the last
page has been reached and no further data can be requested. A returned PAGE-TOKEN is valid until the date specified in the Expires response
header. Example: PAGE-TOKEN: eyJjb25kaXRpb25zIjp7InVzZXJJZCI6NjY2ODI1fSwibGFiZWxz(...) (truncated for readability)
Expires header example: Expires: Fri, 08 Jan 2021 09:10:29 GMT
OK
Application instance ID
The deployment environment ID of this application instance
The deployment environment name of this application instance
The fleet ID of this application instance
The fleet name of this application instance
The application instance is host on this server.
0 if this instance runs on a bare metal server, 1 if it runs on a VM
The application ID of this application instance
The application name of this application instance
The type of the application, the different types can be found in: GET /application/type
The application build ID of this application instance
The application build name of this application instance
ID of the application install
The datacenter ID of where this application instance is located
The datacenter name of where this application instance is located
The deployment region ID of where this application instance is located
The deployment region name of where this application instance is located
The application instance status, list of application instance status can be found in GET /v3/applicationInstance/status
The Unix timestamp at which this application instance is created
The Unix timestamp at which this application instance is started
The Unix timestamp at which this application instance is stopped
The process ID of the application instance running on the host
The Unix timestamp of the moment the process ID has been changed on the host
If set to 1, the application instance was manually deployed.
If auto restart is 1 than the application instance will auto restart, when 0 the application instance auto restart will be disabled
if an application will be deleted it will be 1 else 0
1 if Arcus is available & running for this application instance, 0 otherwise.
Note: If your application's managementProtocol is NOT set to Arcus, this value will always be 0, even if your
game server would support the Arcus protocol. The protocol is only tested, and this value potentially be set to 1,
when the managementProtocol is set to Arcus.
PAGE-TOKENdid not have an expected structure and is invalid. Please try again by sending a request without aPAGE-TOKENand restarting.- An invalid filter or sort column is provided
Invalid credentials
PAGE-TOKEN is expired. Acquire a new PAGE-TOKEN by sending a request without a PAGE-TOKEN and try again
Labels error
Internal Server Error
GET /v3/applicationInstance/summary HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"deploymentEnvironmentId": "text",
"deploymentEnvironmentName": "text",
"fleetId": "text",
"fleetName": "text",
"hostId": 1,
"isVirtual": 1,
"applicationId": "text",
"applicationName": "text",
"applicationType": 1,
"applicationBuildId": "text",
"applicationBuildName": "text",
"dcLocationId": 1,
"dcLocationName": "text",
"regionId": "text",
"regionName": "text",
"status": 1,
"createdAt": 1,
"startedAt": 1,
"stoppedAt": 1,
"pid": 1,
"pidChangedAt": 1,
"manuallyDeployed": 1,
"autoRestart": 1,
"markedForDeletion": 1,
"arcusAvailable": 1
}
]OK
Status code of an application instance
Application instance status name
Application instance status description
If isDependency=1, status code represent for application instance dependency installer and uninstaller, in case of isDependency=0 status code represents application instance game and utility type
Invalid credentials
Unprocessable Entity
Internal Server Error
GET /v3/applicationInstance/status HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"statusId": 1,
"statusDescription": "text",
"description": "text",
"isDependency": 1
}
]Note: bare metal servers and VMs are exposed in the same manner, as "dedicated servers". hostId can be found in the /host endpoint.
The ID of the host
Label expressions can be used to apply more specific search parameters and can be written in standard SQL query language.
E.g. region_id=123 or multiple filters: region_id=123 and fleet_id=456 or host_id=46256 The provided filter query needs to be url encoded.
E.g. region_id%3D123 or multiple filters: region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256 The total would look like:
/applicationInstance/host/{hostId}?labels=region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256
If you want to filter on a non-numeric label such as region_name, you have to wrap the value in double quotes: region_name="Rotterdam"
Warning: the labels query parameter is ignored when passing a PAGE-TOKEN and the original labels string will be used for that request
instead. More information on the use of labels can be found in the
label documentation.
Filter expression can be used to apply more specific search on most parameters in the application instance, it is written like
this E.G. regionId=123 or multiple filters: regionId=123 and fleetId=456, only the AND statement is supported at this time. You can also
search inside nested objects like metadata.key="testing" and metadata.value="test" You can only search on exact matches.
Warning: the filters query parameter is ignored when passing a PAGE-TOKEN and the original filters string will be used for that request
instead.
Warning: filtering on the following parameters is currently not supported and will give an error:
autoRestart, liveGameVersion, liveHostName, liveMap, liveRules, manuallyDeployed, markedForDeletion, numPlayers,
numPlayersMax, pid, pidChangedAt, startedAt, status, stoppedAt, updatedAt
Sort expression to sort your results in the order that you like E.G. sort=fleetId ASC, applicationId DESC Be aware that all
filters and sorting should be url encoded.
Warning: the sort query parameter is ignored when passing a PAGE-TOKEN and the original sort string will be used for that request instead
Warning: sorting on the following parameters is currently not supported and will give an error:
autoRestart, liveGameVersion, liveHostName, liveMap, liveRules, manuallyDeployed, markedForDeletion, numPlayers,
numPlayersMax, pid, pidChangedAt, startedAt, status, stoppedAt, updatedAt
Example header and default range: RANGED-DATA: start=0,results=25
Warning: the start variable of the RANGED-DATA object has been deprecated for this endpoint. It is not possible to supply a start, see
PAGE-TOKEN header for a replacement
This token will be provided by this endpoint to allow for pagination functionality. By performing a request to this endpoint
without the PAGE-TOKEN you will retrieve the first page of search results. If a PAGE-TOKEN is returned, a next page may be requested by
supplying that token in the next request using the same PAGE-TOKEN key and value in the request header. If no PAGE-TOKEN is returned, the
last page has been reached and no further data can be requested. A returned PAGE-TOKEN is valid until the date specified in the Expires
response header. Example: PAGE-TOKEN: eyJjb25kaXRpb25zIjp7InVzZXJJZCI6NjY2ODI1fSwibGFiZWxz(...) (truncated for readability) Expires header
example: Expires: Fri, 08 Jan 2021 09:10:29 GMT
OK
Application instance ID
The deployment environment ID of this application instance
The deployment environment name of this application instance
The fleet ID of this application instance
The fleet name of this application instance
The application instance is host on this server.
0 if this instance runs on a bare metal server, 1 if it runs on a VM
The application ID of this application instance
The application name of this application instance
The type of the application, the different types can be found in: GET /v3/application/type
The application build ID of this application instance
The application build name of this application instance
ID of the application install
The datacenter ID of where this application instance is located
The datacenter name of where this application instance is located
The deployment region ID of where this application instance is located
The deployment region name of where this application instance is located
The application instance status, list of application instance status can be found in GET /v3/applicationInstance/status
The Unix timestamp at which this application instance is created
The Unix timestamp at which this application instance is started
The Unix timestamp at which this application instance is stopped
The process ID of the application instance running on the host
The Unix timestamp of the moment the process ID has been changed on the host
The exact startup parameters that were used to start this application instance with all properties resolved to their
respective values. Will be null if the instance has not been started, but will retain its previous value if it was stopped. Once set it will never be
cleared again
The name of the executable that was ran when the application instance started. Will be null if the instance has not been
started, but will retain its previous value if it was stopped. Once set it will never be cleared again
If set to 1, the application instance was manually deployed, instead of automatically deployed through the system
The maximum number of players on the application instance (this only apply to application instances of the type game)
The number of online players on the application instance (this only apply to application instances of the type game)
The live host name of the application instance (this only apply to application instances of the type game)
The live map of an application instance (this only apply to application instances of the type game)
The live game version of an application instance (this only apply to application instances of the type game)
The Unix timestamp at which this application instance is live data is updated (this only apply to application instances of the type game)
The live rules of an application instance (this only apply to application instances of the type game)
If auto restart is 1 then the application instance will auto restart, when 0 the application instance auto restart will be disabled
If an application will be deleted it will be 1, 0 otherwise
1 if Arcus is available & running for this application instance, 0 otherwise.
Note: If your application's managementProtocol is NOT set to Arcus, this value will always be 0, even if your
game server would support the Arcus protocol. The protocol is only tested, and this value potentially be set to 1,
when the managementProtocol is set to Arcus.
PAGE-TOKENdid not have an expected structure and is invalid. Please try again by sending a request without aPAGE-TOKENand restarting.- An invalid filter or sort column is provided
Invalid credentials
Invalid hostId
PAGE-TOKEN is expired. Acquire a new PAGE-TOKEN by sending a request without a PAGE-TOKEN and try again
Labels error
Internal Server Error
GET /v3/applicationInstance/host/{hostId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"deploymentEnvironmentId": "text",
"deploymentEnvironmentName": "text",
"fleetId": "text",
"fleetName": "text",
"hostId": 1,
"isVirtual": 1,
"applicationId": "text",
"applicationName": "text",
"applicationType": 1,
"applicationBuildId": "text",
"applicationBuildName": "text",
"dcLocationId": 1,
"dcLocationName": "text",
"regionId": "text",
"regionName": "text",
"status": 1,
"createdAt": 1,
"startedAt": 1,
"stoppedAt": 1,
"pid": 1,
"pidChangedAt": 1,
"startupParams": "text",
"executable": "text",
"manuallyDeployed": 1,
"properties": [
{
"id": "text",
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}
],
"ipAddress": [
{
"ipAddress": "text",
"ipVersion": 1,
"private": 1
}
],
"labelReadOnly": [
{
"key": "text",
"value": "text"
}
],
"labelPublic": [
{
"key": "text",
"value": "text"
}
],
"metadata": [
{
"key": "text",
"value": "text"
}
],
"numPlayersMax": 1,
"numPlayers": 1,
"liveHostName": "text",
"liveMap": "text",
"liveGameVersion": "text",
"updatedAt": 1,
"liveRules": "text",
"autoRestart": 1,
"markedForDeletion": 1,
"arcusAvailable": 1
}
]Creates a new application instance entity in our database, on the provided host ID (can be a bare metal server or a VM). Afterwards you can deploy software on it. hostId equals hostID, found in the /host endpoint.
The ID of the fleet
The ID of the host
Application instance ID
The deployment environment ID of this application instance
The deployment environment name of this application instance
The fleet ID of this application instance
The fleet name of this application instance
The application instance is host on this server.
0 if this instance runs on a bare metal server, 1 if it runs on a VM
The application ID of this application instance
The application name of this application instance
The type of the application, the different types can be found in: GET /v3/application/type
The application build ID of this application instance
The application build name of this application instance
ID of the application install
The datacenter ID of where this application instance is located
The datacenter name of where this application instance is located
The deployment region ID of where this application instance is located
The deployment region name of where this application instance is located
The application instance status, list of application instance status can be found in GET /v3/applicationInstance/status
The Unix timestamp at which this application instance is created
The Unix timestamp at which this application instance is started
The Unix timestamp at which this application instance is stopped
The process ID of the application instance running on the host
The Unix timestamp of the moment the process ID has been changed on the host
The exact startup parameters that were used to start this application instance with all properties resolved to their
respective values. Will be null if the instance has not been started, but will retain its previous value if it was stopped. Once set it will never be
cleared again
The name of the executable that was ran when the application instance started. Will be null if the instance has not been
started, but will retain its previous value if it was stopped. Once set it will never be cleared again
If set to 1, the application instance was manually deployed, instead of automatically deployed through the system
The maximum number of players on the application instance (this only apply to application instances of the type game)
The number of online players on the application instance (this only apply to application instances of the type game)
The live host name of the application instance (this only apply to application instances of the type game)
The live map of an application instance (this only apply to application instances of the type game)
The live game version of an application instance (this only apply to application instances of the type game)
The Unix timestamp at which this application instance is live data is updated (this only apply to application instances of the type game)
The live rules of an application instance (this only apply to application instances of the type game)
If auto restart is 1 then the application instance will auto restart, when 0 the application instance auto restart will be disabled
If an application will be deleted it will be 1, 0 otherwise
1 if Arcus is available & running for this application instance, 0 otherwise.
Note: If your application's managementProtocol is NOT set to Arcus, this value will always be 0, even if your
game server would support the Arcus protocol. The protocol is only tested, and this value potentially be set to 1,
when the managementProtocol is set to Arcus.
OK
Application instance ID
The deployment environment ID of this application instance
The deployment environment name of this application instance
The fleet ID of this application instance
The fleet name of this application instance
The application instance is host on this server.
0 if this instance runs on a bare metal server, 1 if it runs on a VM
The application ID of this application instance
The application name of this application instance
The type of the application, the different types can be found in: GET /v3/application/type
The application build ID of this application instance
The application build name of this application instance
ID of the application install
The datacenter ID of where this application instance is located
The datacenter name of where this application instance is located
The deployment region ID of where this application instance is located
The deployment region name of where this application instance is located
The application instance status, list of application instance status can be found in GET /v3/applicationInstance/status
The Unix timestamp at which this application instance is created
The Unix timestamp at which this application instance is started
The Unix timestamp at which this application instance is stopped
The process ID of the application instance running on the host
The Unix timestamp of the moment the process ID has been changed on the host
The exact startup parameters that were used to start this application instance with all properties resolved to their
respective values. Will be null if the instance has not been started, but will retain its previous value if it was stopped. Once set it will never be
cleared again
The name of the executable that was ran when the application instance started. Will be null if the instance has not been
started, but will retain its previous value if it was stopped. Once set it will never be cleared again
If set to 1, the application instance was manually deployed, instead of automatically deployed through the system
The maximum number of players on the application instance (this only apply to application instances of the type game)
The number of online players on the application instance (this only apply to application instances of the type game)
The live host name of the application instance (this only apply to application instances of the type game)
The live map of an application instance (this only apply to application instances of the type game)
The live game version of an application instance (this only apply to application instances of the type game)
The Unix timestamp at which this application instance is live data is updated (this only apply to application instances of the type game)
The live rules of an application instance (this only apply to application instances of the type game)
If auto restart is 1 then the application instance will auto restart, when 0 the application instance auto restart will be disabled
If an application will be deleted it will be 1, 0 otherwise
1 if Arcus is available & running for this application instance, 0 otherwise.
Note: If your application's managementProtocol is NOT set to Arcus, this value will always be 0, even if your
game server would support the Arcus protocol. The protocol is only tested, and this value potentially be set to 1,
when the managementProtocol is set to Arcus.
Invalid credentials
Invalid hostId or fleetId
Host assigned to a different fleet or host has no hostagent installed
Invalid properties (e.g. similar ports as another application instance, or the fleet is missing deployment profile)
Internal Server Error
POST /v3/applicationInstance/fleet/{fleetId}/host/{hostId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 90
{
"labelPublic": [
{
"key": "text",
"value": "text"
}
],
"metadata": [
{
"key": "text",
"value": "text"
}
]
}[
{
"id": "text",
"deploymentEnvironmentId": "text",
"deploymentEnvironmentName": "text",
"fleetId": "text",
"fleetName": "text",
"hostId": 1,
"isVirtual": 1,
"applicationId": "text",
"applicationName": "text",
"applicationType": 1,
"applicationBuildId": "text",
"applicationBuildName": "text",
"dcLocationId": 1,
"dcLocationName": "text",
"regionId": "text",
"regionName": "text",
"status": 1,
"createdAt": 1,
"startedAt": 1,
"stoppedAt": 1,
"pid": 1,
"pidChangedAt": 1,
"startupParams": "text",
"executable": "text",
"manuallyDeployed": 1,
"properties": [
{
"id": "text",
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}
],
"ipAddress": [
{
"ipAddress": "text",
"ipVersion": 1,
"private": 1
}
],
"labelReadOnly": [
{
"key": "text",
"value": "text"
}
],
"labelPublic": [
{
"key": "text",
"value": "text"
}
],
"metadata": [
{
"key": "text",
"value": "text"
}
],
"numPlayersMax": 1,
"numPlayers": 1,
"liveHostName": "text",
"liveMap": "text",
"liveGameVersion": "text",
"updatedAt": 1,
"liveRules": "text",
"autoRestart": 1,
"markedForDeletion": 1,
"arcusAvailable": 1
}
]The ID of the application instance
OK
Application instance ID
The deployment environment ID of this application instance
The deployment environment name of this application instance
The fleet ID of this application instance
The fleet name of this application instance
The application instance is host on this server.
0 if this instance runs on a bare metal server, 1 if it runs on a VM
The application ID of this application instance
The application name of this application instance
The type of the application, the different types can be found in: GET /v3/application/type
The application build ID of this application instance
The application build name of this application instance
ID of the application install
The datacenter ID of where this application instance is located
The datacenter name of where this application instance is located
The deployment region ID of where this application instance is located
The deployment region name of where this application instance is located
The application instance status, list of application instance status can be found in GET /v3/applicationInstance/status
The Unix timestamp at which this application instance is created
The Unix timestamp at which this application instance is started
The Unix timestamp at which this application instance is stopped
The process ID of the application instance running on the host
The Unix timestamp of the moment the process ID has been changed on the host
The exact startup parameters that were used to start this application instance with all properties resolved to their
respective values. Will be null if the instance has not been started, but will retain its previous value if it was stopped. Once set it will never be
cleared again
The name of the executable that was ran when the application instance started. Will be null if the instance has not been
started, but will retain its previous value if it was stopped. Once set it will never be cleared again
If set to 1, the application instance was manually deployed, instead of automatically deployed through the system
The maximum number of players on the application instance (this only apply to application instances of the type game)
The number of online players on the application instance (this only apply to application instances of the type game)
The live host name of the application instance (this only apply to application instances of the type game)
The live map of an application instance (this only apply to application instances of the type game)
The live game version of an application instance (this only apply to application instances of the type game)
The Unix timestamp at which this application instance is live data is updated (this only apply to application instances of the type game)
The live rules of an application instance (this only apply to application instances of the type game)
If auto restart is 1 then the application instance will auto restart, when 0 the application instance auto restart will be disabled
If an application will be deleted it will be 1, 0 otherwise
1 if Arcus is available & running for this application instance, 0 otherwise.
Note: If your application's managementProtocol is NOT set to Arcus, this value will always be 0, even if your
game server would support the Arcus protocol. The protocol is only tested, and this value potentially be set to 1,
when the managementProtocol is set to Arcus.
Invalid credentials
Invalid applicationInstanceId
Unprocessable Entity
Internal Server Error
GET /v3/applicationInstance/{applicationInstanceId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"deploymentEnvironmentId": "text",
"deploymentEnvironmentName": "text",
"fleetId": "text",
"fleetName": "text",
"hostId": 1,
"isVirtual": 1,
"applicationId": "text",
"applicationName": "text",
"applicationType": 1,
"applicationBuildId": "text",
"applicationBuildName": "text",
"dcLocationId": 1,
"dcLocationName": "text",
"regionId": "text",
"regionName": "text",
"status": 1,
"createdAt": 1,
"startedAt": 1,
"stoppedAt": 1,
"pid": 1,
"pidChangedAt": 1,
"startupParams": "text",
"executable": "text",
"manuallyDeployed": 1,
"properties": [
{
"id": "text",
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}
],
"ipAddress": [
{
"ipAddress": "text",
"ipVersion": 1,
"private": 1
}
],
"labelReadOnly": [
{
"key": "text",
"value": "text"
}
],
"labelPublic": [
{
"key": "text",
"value": "text"
}
],
"metadata": [
{
"key": "text",
"value": "text"
}
],
"numPlayersMax": 1,
"numPlayers": 1,
"liveHostName": "text",
"liveMap": "text",
"liveGameVersion": "text",
"updatedAt": 1,
"liveRules": "text",
"autoRestart": 1,
"markedForDeletion": 1,
"arcusAvailable": 1
}
]The ID of the application instance
Application instance ID
The deployment environment ID of this application instance
The deployment environment name of this application instance
The fleet ID of this application instance
The fleet name of this application instance
The application instance is host on this server.
0 if this instance runs on a bare metal server, 1 if it runs on a VM
The application ID of this application instance
The application name of this application instance
The type of the application, the different types can be found in: GET /v3/application/type
The application build ID of this application instance
The application build name of this application instance
ID of the application install
The datacenter ID of where this application instance is located
The datacenter name of where this application instance is located
The deployment region ID of where this application instance is located
The deployment region name of where this application instance is located
The application instance status, list of application instance status can be found in GET /v3/applicationInstance/status
The Unix timestamp at which this application instance is created
The Unix timestamp at which this application instance is started
The Unix timestamp at which this application instance is stopped
The process ID of the application instance running on the host
The Unix timestamp of the moment the process ID has been changed on the host
The exact startup parameters that were used to start this application instance with all properties resolved to their
respective values. Will be null if the instance has not been started, but will retain its previous value if it was stopped. Once set it will never be
cleared again
The name of the executable that was ran when the application instance started. Will be null if the instance has not been
started, but will retain its previous value if it was stopped. Once set it will never be cleared again
If set to 1, the application instance was manually deployed, instead of automatically deployed through the system
The maximum number of players on the application instance (this only apply to application instances of the type game)
The number of online players on the application instance (this only apply to application instances of the type game)
The live host name of the application instance (this only apply to application instances of the type game)
The live map of an application instance (this only apply to application instances of the type game)
The live game version of an application instance (this only apply to application instances of the type game)
The Unix timestamp at which this application instance is live data is updated (this only apply to application instances of the type game)
The live rules of an application instance (this only apply to application instances of the type game)
If auto restart is 1 then the application instance will auto restart, when 0 the application instance auto restart will be disabled
If an application will be deleted it will be 1, 0 otherwise
1 if Arcus is available & running for this application instance, 0 otherwise.
Note: If your application's managementProtocol is NOT set to Arcus, this value will always be 0, even if your
game server would support the Arcus protocol. The protocol is only tested, and this value potentially be set to 1,
when the managementProtocol is set to Arcus.
OK
Application instance ID
The deployment environment ID of this application instance
The deployment environment name of this application instance
The fleet ID of this application instance
The fleet name of this application instance
The application instance is host on this server.
0 if this instance runs on a bare metal server, 1 if it runs on a VM
The application ID of this application instance
The application name of this application instance
The type of the application, the different types can be found in: GET /v3/application/type
The application build ID of this application instance
The application build name of this application instance
ID of the application install
The datacenter ID of where this application instance is located
The datacenter name of where this application instance is located
The deployment region ID of where this application instance is located
The deployment region name of where this application instance is located
The application instance status, list of application instance status can be found in GET /v3/applicationInstance/status
The Unix timestamp at which this application instance is created
The Unix timestamp at which this application instance is started
The Unix timestamp at which this application instance is stopped
The process ID of the application instance running on the host
The Unix timestamp of the moment the process ID has been changed on the host
The exact startup parameters that were used to start this application instance with all properties resolved to their
respective values. Will be null if the instance has not been started, but will retain its previous value if it was stopped. Once set it will never be
cleared again
The name of the executable that was ran when the application instance started. Will be null if the instance has not been
started, but will retain its previous value if it was stopped. Once set it will never be cleared again
If set to 1, the application instance was manually deployed, instead of automatically deployed through the system
The maximum number of players on the application instance (this only apply to application instances of the type game)
The number of online players on the application instance (this only apply to application instances of the type game)
The live host name of the application instance (this only apply to application instances of the type game)
The live map of an application instance (this only apply to application instances of the type game)
The live game version of an application instance (this only apply to application instances of the type game)
The Unix timestamp at which this application instance is live data is updated (this only apply to application instances of the type game)
The live rules of an application instance (this only apply to application instances of the type game)
If auto restart is 1 then the application instance will auto restart, when 0 the application instance auto restart will be disabled
If an application will be deleted it will be 1, 0 otherwise
1 if Arcus is available & running for this application instance, 0 otherwise.
Note: If your application's managementProtocol is NOT set to Arcus, this value will always be 0, even if your
game server would support the Arcus protocol. The protocol is only tested, and this value potentially be set to 1,
when the managementProtocol is set to Arcus.
Invalid credentials
Invalid applicationInstanceId
Unprocessable Entity
Internal Server Error
PUT /v3/applicationInstance/{applicationInstanceId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 90
{
"labelPublic": [
{
"key": "text",
"value": "text"
}
],
"metadata": [
{
"key": "text",
"value": "text"
}
]
}[
{
"id": "text",
"deploymentEnvironmentId": "text",
"deploymentEnvironmentName": "text",
"fleetId": "text",
"fleetName": "text",
"hostId": 1,
"isVirtual": 1,
"applicationId": "text",
"applicationName": "text",
"applicationType": 1,
"applicationBuildId": "text",
"applicationBuildName": "text",
"dcLocationId": 1,
"dcLocationName": "text",
"regionId": "text",
"regionName": "text",
"status": 1,
"createdAt": 1,
"startedAt": 1,
"stoppedAt": 1,
"pid": 1,
"pidChangedAt": 1,
"startupParams": "text",
"executable": "text",
"manuallyDeployed": 1,
"properties": [
{
"id": "text",
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}
],
"ipAddress": [
{
"ipAddress": "text",
"ipVersion": 1,
"private": 1
}
],
"labelReadOnly": [
{
"key": "text",
"value": "text"
}
],
"labelPublic": [
{
"key": "text",
"value": "text"
}
],
"metadata": [
{
"key": "text",
"value": "text"
}
],
"numPlayersMax": 1,
"numPlayers": 1,
"liveHostName": "text",
"liveMap": "text",
"liveGameVersion": "text",
"updatedAt": 1,
"liveRules": "text",
"autoRestart": 1,
"markedForDeletion": 1,
"arcusAvailable": 1
}
]The ID of the application instance
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
No content
Invalid credentials
Invalid applicationInstanceId
Internal Server Error
DELETE /v3/applicationInstance/{applicationInstanceId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 26
{
"methodId": 1,
"timeout": 1
}No content
Set the online status of a single application instance. Only possible if the application instance status is at least "offline (2)"
The ID of the application instance
Possible values:
- 3: starting
- 4: online
- 5: allocated (only possible if previous status is online)
OK
Application instance ID
The deployment environment ID of this application instance
The deployment environment name of this application instance
The fleet ID of this application instance
The fleet name of this application instance
The application instance is host on this server.
0 if this instance runs on a bare metal server, 1 if it runs on a VM
The application ID of this application instance
The application name of this application instance
The type of the application, the different types can be found in: GET /v3/application/type
The application build ID of this application instance
The application build name of this application instance
ID of the application install
The datacenter ID of where this application instance is located
The datacenter name of where this application instance is located
The deployment region ID of where this application instance is located
The deployment region name of where this application instance is located
The application instance status, list of application instance status can be found in GET /v3/applicationInstance/status
The Unix timestamp at which this application instance is created
The Unix timestamp at which this application instance is started
The Unix timestamp at which this application instance is stopped
The process ID of the application instance running on the host
The Unix timestamp of the moment the process ID has been changed on the host
The exact startup parameters that were used to start this application instance with all properties resolved to their
respective values. Will be null if the instance has not been started, but will retain its previous value if it was stopped. Once set it will never be
cleared again
The name of the executable that was ran when the application instance started. Will be null if the instance has not been
started, but will retain its previous value if it was stopped. Once set it will never be cleared again
If set to 1, the application instance was manually deployed, instead of automatically deployed through the system
The maximum number of players on the application instance (this only apply to application instances of the type game)
The number of online players on the application instance (this only apply to application instances of the type game)
The live host name of the application instance (this only apply to application instances of the type game)
The live map of an application instance (this only apply to application instances of the type game)
The live game version of an application instance (this only apply to application instances of the type game)
The Unix timestamp at which this application instance is live data is updated (this only apply to application instances of the type game)
The live rules of an application instance (this only apply to application instances of the type game)
If auto restart is 1 then the application instance will auto restart, when 0 the application instance auto restart will be disabled
If an application will be deleted it will be 1, 0 otherwise
1 if Arcus is available & running for this application instance, 0 otherwise.
Note: If your application's managementProtocol is NOT set to Arcus, this value will always be 0, even if your
game server would support the Arcus protocol. The protocol is only tested, and this value potentially be set to 1,
when the managementProtocol is set to Arcus.
Invalid credentials
Invalid applicationInstanceId
Invalid status value
Internal Server Error
PUT /v3/applicationInstance/{applicationInstanceId}/status/{status} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"deploymentEnvironmentId": "text",
"deploymentEnvironmentName": "text",
"fleetId": "text",
"fleetName": "text",
"hostId": 1,
"isVirtual": 1,
"applicationId": "text",
"applicationName": "text",
"applicationType": 1,
"applicationBuildId": "text",
"applicationBuildName": "text",
"dcLocationId": 1,
"dcLocationName": "text",
"regionId": "text",
"regionName": "text",
"status": 1,
"createdAt": 1,
"startedAt": 1,
"stoppedAt": 1,
"pid": 1,
"pidChangedAt": 1,
"startupParams": "text",
"executable": "text",
"manuallyDeployed": 1,
"properties": [
{
"id": "text",
"propertyType": 1,
"propertyKey": "text",
"propertyValue": "text"
}
],
"ipAddress": [
{
"ipAddress": "text",
"ipVersion": 1,
"private": 1
}
],
"labelReadOnly": [
{
"key": "text",
"value": "text"
}
],
"labelPublic": [
{
"key": "text",
"value": "text"
}
],
"metadata": [
{
"key": "text",
"value": "text"
}
],
"numPlayersMax": 1,
"numPlayers": 1,
"liveHostName": "text",
"liveMap": "text",
"liveGameVersion": "text",
"updatedAt": 1,
"liveRules": "text",
"autoRestart": 1,
"markedForDeletion": 1,
"arcusAvailable": 1
}
]The ID of the application instance
OK
Task ID
Task name
The ID of the batch the task belongs to
The ID of the task category. Valid values are:
- 1: game server
The ID of the entity the task is being executed for. E.g. a game server ID (categoryId 1)
Currently active action index - relates to the action index as found in the template.
Unix timestamp indicating the start of execution.
Unix timestamp indicating lastest activity.
Unix timestamp at which the task was finished.
The result of the task. 0: pending, 1: in progress, 2: paused, 125: cancelled, 126: done with error, 127: done
The result of the task in message form.
Invalid credentials
Invalid applicationInstanceId
Internal Server Error
POST /v3/applicationInstance/{applicationInstanceId}/start HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"name": "text",
"batchId": 1,
"categoryId": 1,
"entityId": 1,
"currentActionIdx": 1,
"executeAt": 1,
"lastActivityAt": 1,
"finishedAt": 1,
"resultCode": 1,
"resultText": "text"
}
]Stop the application instance given, if no stop method is provided we will use the stop method of the application build or application. The default is hard kill
The ID of the application instance
Stop method type, list of types can be found in: GET /v3/application/stopMethod
Stop method timeout in seconds, default value is 1800 seconds.
OK
Task ID
Task name
The ID of the batch the task belongs to
The ID of the task category. Valid values are:
- 1: game server
The ID of the entity the task is being executed for. E.g. a game server ID (categoryId 1)
Currently active action index - relates to the action index as found in the template.
Unix timestamp indicating the start of execution.
Unix timestamp indicating lastest activity.
Unix timestamp at which the task was finished.
The result of the task. 0: pending, 1: in progress, 2: paused, 125: cancelled, 126: done with error, 127: done
The result of the task in message form.
Invalid credentials
Invalid applicationInstanceId
Unprocessable Entity
Internal Server Error
POST /v3/applicationInstance/{applicationInstanceId}/stop HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 26
{
"methodId": 1,
"timeout": 1
}[
{
"id": 1,
"name": "text",
"batchId": 1,
"categoryId": 1,
"entityId": 1,
"currentActionIdx": 1,
"executeAt": 1,
"lastActivityAt": 1,
"finishedAt": 1,
"resultCode": 1,
"resultText": "text"
}
]Stop and start a single application instance. Also works if it is already stopped. You can give an stop method in the body, if not given we will use the stop method defined in the application build or application. Default is hard kill
The ID of the application instance
Stop method type, list of types can be found in: GET /v3/application/stopMethod
Stop method timeout in seconds, default value is 1800 seconds.
OK
Task ID
Task name
The ID of the batch the task belongs to
The ID of the task category. Valid values are:
- 1: game server
The ID of the entity the task is being executed for. E.g. a game server ID (categoryId 1)
Currently active action index - relates to the action index as found in the template.
Unix timestamp indicating the start of execution.
Unix timestamp indicating lastest activity.
Unix timestamp at which the task was finished.
The result of the task. 0: pending, 1: in progress, 2: paused, 125: cancelled, 126: done with error, 127: done
The result of the task in message form.
Invalid credentials
Invalid applicationInstanceId
Expectation Failed
Unprocessable Entity
Internal Server Error
POST /v3/applicationInstance/{applicationInstanceId}/restart HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 26
{
"methodId": 1,
"timeout": 1
}[
{
"id": 1,
"name": "text",
"batchId": 1,
"categoryId": 1,
"entityId": 1,
"currentActionIdx": 1,
"executeAt": 1,
"lastActivityAt": 1,
"finishedAt": 1,
"resultCode": 1,
"resultText": "text"
}
]The ID of the application instance
An application build ID
OK
Task ID
Task name
The ID of the batch the task belongs to
The ID of the task category. Valid values are:
- 1: game server
The ID of the entity the task is being executed for. E.g. a game server ID (categoryId 1)
Currently active action index - relates to the action index as found in the template.
Unix timestamp indicating the start of execution.
Unix timestamp indicating lastest activity.
Unix timestamp at which the task was finished.
The result of the task. 0: pending, 1: in progress, 2: paused, 125: cancelled, 126: done with error, 127: done
The result of the task in message form.
Invalid credentials
Invalid applicationInstanceId
Expectation Failed
Unprocessable Entity
Internal Server Error
POST /v3/applicationInstance/{applicationInstanceId}/deploy HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 29
{
"applicationBuildId": "text"
}[
{
"id": 1,
"name": "text",
"batchId": 1,
"categoryId": 1,
"entityId": 1,
"currentActionIdx": 1,
"executeAt": 1,
"lastActivityAt": 1,
"finishedAt": 1,
"resultCode": 1,
"resultText": "text"
}
]The ID of the application instance
OK
Task ID
Task name
The ID of the batch the task belongs to
The ID of the task category. Valid values are:
- 1: game server
The ID of the entity the task is being executed for. E.g. a game server ID (categoryId 1)
Currently active action index - relates to the action index as found in the template.
Unix timestamp indicating the start of execution.
Unix timestamp indicating lastest activity.
Unix timestamp at which the task was finished.
The result of the task. 0: pending, 1: in progress, 2: paused, 125: cancelled, 126: done with error, 127: done
The result of the task in message form.
Invalid credentials
Invalid applicationInstanceId
Internal Server Error
GET /v3/applicationInstance/{applicationInstanceId}/task HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"name": "text",
"batchId": 1,
"categoryId": 1,
"entityId": 1,
"currentActionIdx": 1,
"executeAt": 1,
"lastActivityAt": 1,
"finishedAt": 1,
"resultCode": 1,
"resultText": "text"
}
]The ID of the application
Label expressions can be used to apply more specific search parameters and can be written in standard SQL query language.
E.g. region_id=123 or multiple filters: region_id=123 and fleet_id=456 or host_id=46256 The provided filter query needs to be url encoded. E.g.
region_id%3D123 or multiple filters: region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256 The total would look like:
/applicationInstance/application/{applicationId}?labels=region_id%3D123%20and%20fleet_id%3D456%20or%20host_id%3D46256
If you want to filter on a non-numeric label such as region_name, you have to wrap the value in double quotes: region_name="Rotterdam"
Warning: the labels query parameter is ignored when passing a PAGE-TOKEN and the original labels string will be used for that request
instead. More information on the use of labels can be found in the
label documentation.
Filter expression can be used to apply more specific search on most parameters in the application instance, it is written like
this E.G. regionId=123 or multiple filters: regionId=123 and fleetId=456, You can only use AND statement You can also search inside nested
objects like metadata.key='testing' and metadata.value='test' You can only search on exact matches.
Warning: the filters query parameter is ignored when passing a PAGE-TOKEN and the original filters string will be used for that request
instead.
Warning: filtering on the following parameters is currently not supported and will give an error:
autoRestart, liveGameVersion, liveHostName, liveMap, liveRules, manuallyDeployed, markedForDeletion, numPlayers, numPlayersMax,
pid, pidChangedAt, startedAt, status, stoppedAt, updatedAt
Sort expression to sort your results in the order that you like E.G. sort=fleetId ASC, applicationId DESC Be aware that all filters
and sorting should be url encoded.
Warning: the sort query parameter is ignored when passing a PAGE-TOKEN and the original sort string will be used for that request instead
Warning: sorting on the following parameters is currently not supported and will give an error:
autoRestart, liveGameVersion, liveHostName, liveMap, liveRules, manuallyDeployed, markedForDeletion, numPlayers, numPlayersMax,
pid, pidChangedAt, startedAt, status, stoppedAt, updatedAt
Example header and default range: RANGED-DATA: start=0,results=25
Warning: the start variable of the RANGED-DATA object has been deprecated for this endpoint. It is not possible to supply a start, see
PAGE-TOKEN header for a replacement
This token will be provided by this endpoint to allow for pagination functionality. By performing a request to this endpoint
without the PAGE-TOKEN you will retrieve the first page of search results. If a PAGE-TOKEN is returned, a next page may be requested by
supplying that token in the next request using the same PAGE-TOKEN key and value in the request header. If no PAGE-TOKEN is returned, the last
page has been reached and no further data can be requested. A returned PAGE-TOKEN is valid until the date specified in the Expires response
header. Example: PAGE-TOKEN: eyJjb25kaXRpb25zIjp7InVzZXJJZCI6NjY2ODI1fSwibGFiZWxz(...) (truncated for readability)
Expires header example: Expires: Fri, 08 Jan 2021 09:10:29 GMT