Game
Example header and default range: RANGED-DATA:start=0,results=25
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
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
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
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
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
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
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
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
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
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
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
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
}
]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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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"
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
}
]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)
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
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"
}
]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
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
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
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
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
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
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
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
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
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
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
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
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
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
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.
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
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
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
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
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
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
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
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
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
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
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
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
DELETE /v3/application/{applicationId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
The Id of the application for which to fetch the installs
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
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
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
}
]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"
}
]
}
]GET /v3/application/{applicationId}/deploymentEnvironment HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"name": "text",
"createdAt": 1
}
]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
}
]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
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
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
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
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
DELETE /v3/application/{applicationId}/property/{propertyId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
GET /v3/application/property/type HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"typeId": 1,
"typeDescription": "text"
}
]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
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
}
]
}
]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
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)
The application build file to be used for the application instance
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)
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
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)
The application build file to be used for the application instance
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)
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
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
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
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
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"
}
]
}
]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
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
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
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
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
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
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
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
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
DELETE /v3/applicationBuild/{applicationBuildId}/configuration/{applicationBuildConfigurationId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
Deployment environment ID
Application ID
List of fleet ID
List of application build ID
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
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
How many application instances are being patched
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
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
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
How many application instances are being patched
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
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
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)
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
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
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
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
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
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
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
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
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
}
]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
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
}
]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
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
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
}
]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
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.
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
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.
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.
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)
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
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.
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.
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
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
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
GET /v3/applicationInstance/application/{applicationId} 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
}
]Get empty game instances per region for the given applicationId. Currently implies the ONLINE UNALLOCATED game server status.
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/game/{applicationId}/empty/regions?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".
More information on the use of labels can be found in the
label documentation.
Example header and default range: RANGED-DATA:start=0,results=25
GET /v3/applicationInstance/game/{applicationId}/empty/regions HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"regionId": "text",
"allocatableInstances": 1,
"applicationInstances": [
"text"
]
}
]Get empty game instance for the given applicationId. Currently, implies the ONLINE UNALLOCATED game server status.
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/game/{applicationId}/empty?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".
More information on the use of labels can be found in the
label documentation.
Example header and default range: RANGED-DATA:start=0,results=25
GET /v3/applicationInstance/game/{applicationId}/empty 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
}
]Allocate an ONLINE application instance and return errors if there are no application instances to allocate
Fetches an empty ONLINE application instance with the given labels or filters, for the given application ID and changes its status to ALLOCATED.
You may pass metadata to this request to pass information to the application instance during allocation.
This v3 endpoint returns various errors if allocation failed instead of an empty array to help you pinpoint why allocation may have failed
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/game/{applicationId}/empty/allocate?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"
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 only search on exact matches.
Warning: filtering on the following parameters is currently not supported and will give an error:
autoRestart, liveGameVersion, liveHostName, liveMap, liveRules, manuallyDeployed, markedForDeletion, numPlayers, numPlayersMax,
properties, ipAddress, labelReadOnly, labelPublic, metadata, pid, pidChangedAt, startedAt, status, stoppedAt, updatedAt
If no application instances can be allocated and if your application is configured to use the Arcus protocol, and there is a connection problem with Arcus or Arcus is not implemented properly in your application build, a separate error may be thrown. Alternatively, if your `filters` contain one (or more) of the following properties but they filter out application instances that would be available for allocation, a `404` error can be thrown detailing which filter caused no application instances to be found:
* 1: `deploymentEnvironmentId` * 2: `fleetId` * 3: `regionId` * 4: `dcLocationId`
PUT /v3/applicationInstance/game/{applicationId}/empty/allocate HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 44
{
"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
GET /v3/applicationInstance/{applicationInstanceId}/metadata HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
{
"metadata": [
{
"key": "text",
"value": "text"
}
]
}The ID of the application instance
Example header and default range: RANGED-DATA:start=0,results=25
GET /v3/applicationInstance/{applicationInstanceId}/log HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"applicationInstanceId": "text",
"fleetId": "text",
"exitCode": 1,
"stdOutLog": "text",
"createdAt": 1
}
]GET /v3/applicationInstance/task/template HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"name": "text",
"description": "text",
"actions": [
{
"idx": 1,
"actionType": "text",
"requiredParams": [
"text"
]
}
]
}
]GET /v3/applicationInstance/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"
}
]Task template ID, as seen in GET /applicationInstance/task/template
Array of application instance IDs to create the tasks for
If > 0, we gather all game server IDs for this fleet and add those to the gameServerIds property
If > 0, we gather all game server IDs for this region and add those to the gameServerIds property
A unix timestamp indicating the time at which to execute the task (to schedule tasks for future execution)
POST /v3/applicationInstance/task HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 210
{
"taskTemplateId": "text",
"applicationInstanceIds": [
"text"
],
"fleetId": "text",
"regionId": "text",
"labels": [
{
"key": "text",
"value": "text"
}
],
"executeAt": 1,
"taskActionParam": [
{
"paramName": "text",
"paramValue": "text"
}
]
}[
{
"id": 1,
"createdAt": 1,
"executeAt": 1,
"finishedAt": 1,
"numTasks": 1,
"numTasksOk": 1,
"numTasksFailed": 1,
"numTasksCancelled": 1,
"taskIds": [
1
]
}
]The Id of the task
GET /v3/applicationInstance/task/{taskId} 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 task
PUT /v3/applicationInstance/task/{taskId} 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 task
DELETE /v3/applicationInstance/task/{taskId} 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"
}
]GET /v3/applicationInstance/taskBatch HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"createdAt": 1,
"executeAt": 1,
"finishedAt": 1,
"numTasks": 1,
"numTasksOk": 1,
"numTasksFailed": 1,
"numTasksCancelled": 1,
"taskIds": [
1
]
}
]The Id of the task batch
GET /v3/applicationInstance/taskBatch/{taskBatchId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"createdAt": 1,
"executeAt": 1,
"finishedAt": 1,
"numTasks": 1,
"numTasksOk": 1,
"numTasksFailed": 1,
"numTasksCancelled": 1,
"taskIds": [
1
]
}
]GET /v3/applicationInstall/assignable HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"fileName": "text",
"fileSize": 1,
"fileSHA256": "text",
"status": 1,
"statusText": "text"
}
]The Id of the assignable file
GET /v3/applicationInstall/assignable/{fileId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"fileName": "text",
"fileSize": 1,
"fileSHA256": "text",
"status": 1,
"statusText": "text"
}
]GET /v3/applicationInstall/create HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"fileId": 1,
"fileName": "text",
"fileSize": 1,
"fileSHA256": "text",
"status": 1,
"statusText": "text",
"mirrorState": [
{
"locationId": 1,
"locationName": "text",
"fileServerIds": [
1
],
"transfers": [
{
"fileServerId": 1,
"progress": 1,
"errorCount": 1,
"retries": 1
}
]
}
]
}
]The application's ID this application install is coupled to
ID of the assignableFile. Can be obtained from GET /applicationInstall/assignable
Operating system group ID (1 = windows, 2 = linux)
Application install name
Application install version
Game install release notes
Does the archive contain the game instance executable?
POST /v3/applicationInstall/create HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 120
{
"applicationId": "text",
"fileId": 1,
"osGroupId": 1,
"name": "text",
"version": "text",
"releaseNotes": "text",
"installHasExe": 1
}[
{
"id": 1,
"fileId": 1,
"fileName": "text",
"fileSize": 1,
"fileSHA256": "text",
"status": 1,
"statusText": "text",
"mirrorState": [
{
"locationId": 1,
"locationName": "text",
"fileServerIds": [
1
],
"transfers": [
{
"fileServerId": 1,
"progress": 1,
"errorCount": 1,
"retries": 1
}
]
}
]
}
]The Id of the file
GET /v3/applicationInstall/create/{fileId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"fileId": 1,
"fileName": "text",
"fileSize": 1,
"fileSHA256": "text",
"status": 1,
"statusText": "text",
"mirrorState": [
{
"locationId": 1,
"locationName": "text",
"fileServerIds": [
1
],
"transfers": [
{
"fileServerId": 1,
"progress": 1,
"errorCount": 1,
"retries": 1
}
]
}
]
}
]The Id of the file
DELETE /v3/applicationInstall/create/{fileId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
GET /v3/applicationInstall 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 install to fetch
GET /v3/applicationInstall/{installId} 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 install to update
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?
PUT /v3/applicationInstall/{installId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 140
{
"applicationId": "text",
"applicationType": 1,
"name": "text",
"version": "text",
"osGroupId": 1,
"active": 1,
"releaseNotes": "text",
"installHasExe": 1
}[
{
"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 install you want to remove
DELETE /v3/applicationInstall/{installId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
GET /v3/cloud/provider HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"name": "text",
"shortName": "text",
"active": 1
}
]Cloud provider ID. For a list of cloud providers see GET /v3/cloud/provider
GET /v3/cloud/provider/{providerId}/dcLocation HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"continentId": 1,
"country": "text",
"displayName": "text",
"providerId": 1,
"availabilityZones": [
"text"
],
"regionName": "text",
"pingSiteIds": [
"text"
]
}
]GET /v3/cloud/dcLocation HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"continentId": 1,
"country": "text",
"displayName": "text",
"providerId": 1,
"availabilityZones": [
"text"
],
"regionName": "text",
"pingSiteIds": [
"text"
]
}
]i3D.net or cloud data center location ID. For a list of all data center locations see GET /v3/cloud/dcLocation
GET /v3/cloud/dcLocation/{dcLocationId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"continentId": 1,
"country": "text",
"displayName": "text",
"providerId": 1,
"availabilityZones": [
"text"
],
"regionName": "text",
"pingSiteIds": [
"text"
]
}
]GET /v3/cloud/dcLocation/vicinityMapping HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"i3dDcLocationId": 1,
"cloudDcLocationId": 1
}
]Comma separated array of data center location Ids, example: id1,id2. For a list of all data center locations see GET /v3/cloud/dcLocation
GET /v3/cloud/dcLocation/{dcLocationIds}/vicinityMapping HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"i3dDcLocationId": 1,
"cloudDcLocationId": 1
}
]GET /v3/cloud/instanceType HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"instanceTypeId": 1,
"cloudProviderId": 1,
"dcLocationId": 1,
"instanceType": "text",
"numCores": 1,
"memory": 1,
"storage": "text",
"status": 1
}
]The Id of the data center location. For a list of all data center locations see GET /v3/cloud/dcLocation
GET /v3/cloud/instanceType/{dcLocationId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"instanceTypeId": 1,
"cloudProviderId": 1,
"dcLocationId": 1,
"instanceType": "text",
"numCores": 1,
"memory": 1,
"storage": "text",
"status": 1
}
]GET /v3/cloud/cpuPlatform HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"providerId": 1,
"dcLocationId": 1,
"cpuPlatform": "text"
}
]The Id of the data center location. For a list of all data center locations see GET /v3/cloud/dcLocation
GET /v3/cloud/cpuPlatform/{dcLocationId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"providerId": 1,
"dcLocationId": 1,
"cpuPlatform": "text"
}
]Example header and default range: RANGED-DATA:start=0,results=25
GET /v3/cloud/provider/uc/setting HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"projectId": "text",
"regionName": "text",
"publicNetworkId": "text",
"privateNetworkId": "text",
"securityGroupId": "text",
"createdAt": 1,
"changedAt": 1
}
]Ubisoft Cloud network setting id
Ubisoft Cloud project id
Ubisoft Cloud region name
Ubisoft Cloud public network UUID id e.g: (b091a99e-abdd-11ea-bb37-0242ac130002)
Ubisoft Cloud private network UUID id e.g: (d80e2d7e-aa38-490e-915c-bb56222911c3)
Ubisoft Cloud security group id e.g: (0ec61726-405c-4919-b9a1-9dcd6ae56077)
UnixTimestamp
UnixTimestamp
POST /v3/cloud/provider/uc/setting HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 116
{
"projectId": "text",
"regionName": "text",
"publicNetworkId": "text",
"privateNetworkId": "text",
"securityGroupId": "text"
}[
{
"id": "text",
"projectId": "text",
"regionName": "text",
"publicNetworkId": "text",
"privateNetworkId": "text",
"securityGroupId": "text",
"createdAt": 1,
"changedAt": 1
}
]The Id of the Ubisoft cloud setting
GET /v3/cloud/provider/uc/setting/{ucSettingId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"projectId": "text",
"regionName": "text",
"publicNetworkId": "text",
"privateNetworkId": "text",
"securityGroupId": "text",
"createdAt": 1,
"changedAt": 1
}
]The Id of the Ubisoft cloud setting
Ubisoft Cloud network setting id
Ubisoft Cloud project id
Ubisoft Cloud region name
Ubisoft Cloud public network UUID id e.g: (b091a99e-abdd-11ea-bb37-0242ac130002)
Ubisoft Cloud private network UUID id e.g: (d80e2d7e-aa38-490e-915c-bb56222911c3)
Ubisoft Cloud security group id e.g: (0ec61726-405c-4919-b9a1-9dcd6ae56077)
UnixTimestamp
UnixTimestamp
PUT /v3/cloud/provider/uc/setting/{ucSettingId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 116
{
"projectId": "text",
"regionName": "text",
"publicNetworkId": "text",
"privateNetworkId": "text",
"securityGroupId": "text"
}[
{
"id": "text",
"projectId": "text",
"regionName": "text",
"publicNetworkId": "text",
"privateNetworkId": "text",
"securityGroupId": "text",
"createdAt": 1,
"changedAt": 1
}
]The Id of the Ubisoft cloud setting
DELETE /v3/cloud/provider/uc/setting/{ucSettingId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
For a list of cloud providers see GET /v3/cloud/provider)
Example header and default range: RANGED-DATA:start=0,results=25
GET /v3/cloud/vm/log HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"cloudInstanceId": "text",
"title": "text",
"log": "text",
"timestamp": 1
}
]For a list of cloud providers see GET /v3/cloud/provider)
Example header and default range: RANGED-DATA:start=0,results=25
GET /v3/cloud/vm/error HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"hostId": 1,
"message": "text",
"arguments": [
"text"
],
"solved": 1,
"createdAt": 1
}
]For a list of cloud providers see GET /v3/cloud/provider
Example header and default range: RANGED-DATA:start=0,results=25
GET /v3/cloud/vm/uptime HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"cloudInstanceId": 1,
"providerInstanceId": "text",
"providerId": 1,
"hostId": 1,
"instanceType": "text",
"dcLocationId": 1,
"startTime": 1,
"stopTime": 1,
"upTime": 1
}
]For a list of cloud providers see GET /v3/cloud/provider
GET /v3/cloud/configuration/credential HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"providerId": 1,
"name": "text",
"params": {
"accessKeyId": "text",
"secretAccessKey": "text",
"defaultRegion": "text",
"keyPair": "text",
"securityGroup": "text",
"isGameLift": true
},
"createdAt": 1,
"verifiedAt": 1,
"credentialStatus": 1,
"invalidateAt": 1,
"invalidateReason": "text",
"status": 1
}
]For a list of cloud providers see GET /v3/cloud/provider.
In order to use your account for ODP you need to have permissions access, create and control instance templates and instances.
If you are not sure which permissions you need, please contact [email protected].
Cloud provider ID. For a list of cloud providers see GET /v3/cloud/provider
User defined name for the cloud credential
Cloud provider specific authentication params, in json format. API examples
Unix timestamp of when credentials were first stored (informative only)
Unix timestamp of credential last verification time (informative only)
Status of cloud credential
- 0: valid
- 1: invalid
Unix timestamp of invalidation
The reason for invalidation of the cloud credential
Status of a currently in use cloud credential
- 0: inactive
- 1: active
POST /v3/cloud/configuration/credential HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 179
{
"providerId": 1,
"name": "text",
"params": {
"accessKeyId": "text",
"secretAccessKey": "text",
"defaultRegion": "text",
"keyPair": "text",
"securityGroup": "text",
"isGameLift": true
},
"status": 1
}[
{
"providerId": 1,
"name": "text",
"params": {
"accessKeyId": "text",
"secretAccessKey": "text",
"defaultRegion": "text",
"keyPair": "text",
"securityGroup": "text",
"isGameLift": true
},
"createdAt": 1,
"verifiedAt": 1,
"credentialStatus": 1,
"invalidateAt": 1,
"invalidateReason": "text",
"status": 1
}
]For a list of cloud providers see GET /v3/cloud/provider
The user defined name for cloud credentials
GET /v3/cloud/configuration/credential/{credentialName} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"providerId": 1,
"name": "text",
"params": {
"accessKeyId": "text",
"secretAccessKey": "text",
"defaultRegion": "text",
"keyPair": "text",
"securityGroup": "text",
"isGameLift": true
},
"createdAt": 1,
"verifiedAt": 1,
"credentialStatus": 1,
"invalidateAt": 1,
"invalidateReason": "text",
"status": 1
}
]The user defined name for cloud credentials.
User defined name for the cloud credential
Status of a cloud credential
- 0: inactive
- 1: active
PUT /v3/cloud/configuration/credential/{credentialName} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 26
{
"name": "text",
"status": 1
}[
{
"name": "text",
"status": 1
}
]For a list of cloud providers see GET /v3/cloud/provider
The user defined name for cloud credentials.
DELETE /v3/cloud/configuration/credential/{credentialName} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
For a list of cloud providers see GET /v3/cloud/provider.
In order to use your account for the One Platform you need to have permissions to access, create and control instance templates and instances.
If you are not sure which permissions you need, please contact [email protected]. This endpoint only validates provided cloud credentials, this action won't create new
cloud credentials for your user (to do so please refer to POST /cloud/configuration/credential)
Cloud provider ID. For a list of cloud providers see GET /v3/cloud/provider
Cloud provider specific authentication params, in json format. API examples
POST /v3/cloud/configuration/credential/validate HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 154
{
"providerId": 1,
"params": {
"accessKeyId": "text",
"secretAccessKey": "text",
"defaultRegion": "text",
"keyPair": "text",
"securityGroup": "text",
"isGameLift": true
}
}No content
Example header and default range: RANGED-DATA:start=0,results=25
GET /v3/cloud/instance HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"providerInstanceId": "text",
"providerImageId": "text",
"providerId": 1,
"dediServerId": 1,
"applicationId": 1,
"fleetId": 1,
"regionId": 1,
"dcLocationId": 1,
"instanceTypeId": 1,
"availabilityZone": "text",
"name": "text",
"tag": "text",
"publicIpAddress": "text",
"status": 1,
"createdAt": 1
}
]Example header and default range: RANGED-DATA:start=0,results=25
GET /v3/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
}
]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
POST /v3/deploymentProfile HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 167
{
"name": "text",
"description": "text",
"strategyType": 1,
"minimumCapacity": 1,
"maximumCapacity": 1,
"bufferValue": 1,
"bufferValueType": 1,
"bufferValueMin": 1,
"bufferValueMax": 1
}[
{
"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
}
]Example header and default range: RANGED-DATA:start=0,results=25
GET /v3/deploymentProfile/summary 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,
"createdAt": 1
}
]The Id of the deployment profile
GET /v3/deploymentProfile/{deploymentProfileId} 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
}
]The Id of the deployment profile
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
PUT /v3/deploymentProfile/{deploymentProfileId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 167
{
"name": "text",
"description": "text",
"strategyType": 1,
"minimumCapacity": 1,
"maximumCapacity": 1,
"bufferValue": 1,
"bufferValueType": 1,
"bufferValueMin": 1,
"bufferValueMax": 1
}[
{
"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
}
]Delete given deployment profile (it will delete all the application instances if there are any)
A task will be created and returned (response 200) if the deployment profile is in use, the deployment profile will be mark for deletion and after all the application instances are deleted the deployment profile will be deleted. If not in use, then the deployment profile will be immediately deleted and no content will be returned (status 204)
Id of the deployment profile to delete
Id for the method of deletion: hard-kill = 1, graceful=2
Unix timestamp. When to start deleting the containerLocation and its contents. Default = now
Unix timestamp. Time limit in which to delete all remaining game servers immediately (not graceful). Default = 0 (no limit)
DELETE /v3/deploymentProfile/{deploymentProfileId} 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 deployment region
GET /v3/deploymentRegion/{deploymentRegionId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"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
}
]Id of the deployment region to update
This deployment region's ID
The name of the deployment region
All the i3D.net DC location IDs configured for this deployment region. You can get available IDs via GET /cloud/dcLocation
i3D.net data center location IDs scheduled for removal from this region
The minimum amount of game instances that should always be deployed in this region.
Null value means that the minimumCapacity provided in the deployment profile will persist
The maximum amount of game instances that can be deployed in this region.
Null value means that the maximumCapacity provided in the deployment profile will persist
Override for DeploymentProfile.bufferValue, to be applied only to this deployment region.
Null value means that the bufferValue provided in the deployment profile will persist
Override for DeploymentProfile.bufferValueType. Possible values:
- 0: Absolute value
- 1: Percentage value (must be accompanied by
bufferValueMinandbufferValueMax)Nullvalue means that thebufferValueTypeprovided in the deployment profile will persist
Override for DeploymentProfile.bufferValueMin. The minimum absolute bufferValue when using a percentage, to prevent bufferValue from going too low.
Null value means that the bufferValueMin provided in the deployment profile will persist.
Note: if this value is supplied (not null) with your request, bufferValue and bufferValueType become required parameters.
See POST /deploymentProfile/{deploymentProfileId} for more information
Override for DeploymentProfile.bufferValueMax. The maximum absolute bufferValue when using a percentage, to prevent bufferValue from going too high.
Null value means that the bufferValueMax provided in the deployment profile will persist.
Note: if this value is supplied (not null) with your request, bufferValue and bufferValueType become required parameters.
See POST /deploymentProfile/{deploymentProfileId} for more information
Override value for DeploymentProfile.strategyType. Possible values:
0: Use default1: Round robinnull: ThestrategyTypeprovided in the deployment profile will persist
If set to 1, all application instances will be gracefully removed inside the deployment region. Afterwards this deployment region will be set to inactive
Possible values:
- 0: Deployment region has no active application instances
- 1: Deployment region has active application instance(s)
PUT /v3/deploymentRegion/{deploymentRegionId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 350
{
"name": "text",
"i3dDcLocationIds": [
1
],
"i3dDcLocationIdsToBeRemoved": [
1
],
"minimumCapacity": 1,
"maximumCapacity": 1,
"bufferValue": 1,
"bufferValueType": 1,
"bufferValueMin": 1,
"bufferValueMax": 1,
"strategyType": 1,
"containers": [
{
"containerLocations": [
{
"cloudProviderId": 1,
"dcLocationId": 1,
"primaryInstanceTypeName": "text",
"secondaryInstanceTypeName": "text"
}
]
}
]
}[
{
"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
}
]Delete given deployment profile region (it will delete all the application instances if there are any)
A task will be created and returned (response 200) if the deployment region is in use, the deployment region will be mark for deletion and after all the application instances are deleted the deployment region will be deleted. If not in use, then the deployment region will be immediately deleted and no content will be returned (status 204)
Id of the deployment profile region to delete
Id for the method of deletion: hard-kill = 1, graceful=2
Unix timestamp. When to start deleting the containerLocation and its contents. Default = now
Unix timestamp. Time limit in which to delete all remaining game servers immediately (not graceful). Default = 0 (no limit)
DELETE /v3/deploymentRegion/{deploymentRegionId} 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 deployment profile
This deployment region's ID
The name of the deployment region
All the i3D.net DC location IDs configured for this deployment region. You can get available IDs via GET /cloud/dcLocation
i3D.net data center location IDs scheduled for removal from this region
The minimum amount of game instances that should always be deployed in this region.
Null value means that the minimumCapacity provided in the deployment profile will persist
The maximum amount of game instances that can be deployed in this region.
Null value means that the maximumCapacity provided in the deployment profile will persist
Override for DeploymentProfile.bufferValue, to be applied only to this deployment region.
Null value means that the bufferValue provided in the deployment profile will persist
Override for DeploymentProfile.bufferValueType. Possible values:
- 0: Absolute value
- 1: Percentage value (must be accompanied by
bufferValueMinandbufferValueMax)Nullvalue means that thebufferValueTypeprovided in the deployment profile will persist
Override for DeploymentProfile.bufferValueMin. The minimum absolute bufferValue when using a percentage, to prevent bufferValue from going too low.
Null value means that the bufferValueMin provided in the deployment profile will persist.
Note: if this value is supplied (not null) with your request, bufferValue and bufferValueType become required parameters.
See POST /deploymentProfile/{deploymentProfileId} for more information
Override for DeploymentProfile.bufferValueMax. The maximum absolute bufferValue when using a percentage, to prevent bufferValue from going too high.
Null value means that the bufferValueMax provided in the deployment profile will persist.
Note: if this value is supplied (not null) with your request, bufferValue and bufferValueType become required parameters.
See POST /deploymentProfile/{deploymentProfileId} for more information
Override value for DeploymentProfile.strategyType. Possible values:
0: Use default1: Round robinnull: ThestrategyTypeprovided in the deployment profile will persist
If set to 1, all application instances will be gracefully removed inside the deployment region. Afterwards this deployment region will be set to inactive
Possible values:
- 0: Deployment region has no active application instances
- 1: Deployment region has active application instance(s)
POST /v3/deploymentProfile/{deploymentProfileId}/deploymentRegion HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 350
{
"name": "text",
"i3dDcLocationIds": [
1
],
"i3dDcLocationIdsToBeRemoved": [
1
],
"minimumCapacity": 1,
"maximumCapacity": 1,
"bufferValue": 1,
"bufferValueType": 1,
"bufferValueMin": 1,
"bufferValueMax": 1,
"strategyType": 1,
"containers": [
{
"containerLocations": [
{
"cloudProviderId": 1,
"dcLocationId": 1,
"primaryInstanceTypeName": "text",
"secondaryInstanceTypeName": "text"
}
]
}
]
}[
{
"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
}
]Delete given deployment profile container (it will delete all the application instances if there are any)
A task will be created and returned (response 200) if the deployment container is in use, the deployment container will be mark for deletion and after all the application instances are deleted the deployment container will be deleted. If not in use, then the deployment container will be immediately deleted and no content will be returned (status 204)
Id of the deployment profile container to delete
Id for the method of deletion: hard-kill = 1, graceful=2
Unix timestamp. When to start deleting the containerLocation and its contents. Default = now
Unix timestamp. Time limit in which to delete all remaining game servers immediately (not graceful). Default = 0 (no limit)
DELETE /v3/deploymentContainer/{deploymentContainerId} 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"
}
]Delete given deployment profile containerLocation (it will delete all the application instances if there are any)
A task will be created and returned (response 200) if the deployment container location is in use, the deployment container location will be mark for deletion and after all the application instances are deleted the deployment container location will be deleted. If not in use, then the deployment container location will be immediately deleted and no content will be returned (status 204)
Id of the deployment profile containerLocation to delete
Id for the method of deletion: hard-kill = 1, graceful=2
Unix timestamp. When to start deleting the containerLocation and its contents. Default = now
Unix timestamp. Time limit in which to delete all remaining game servers immediately (not graceful). Default = 0 (no limit)
DELETE /v3/deploymentContainerLocation/{deploymentContainerLocationId} 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"
}
]Cancel the deletion of given deployment profile (it will stop deletion but what has been deleted is lost already)
Id of the deployment profile to stop deleting
PUT /v3/deploymentProfile/{deploymentProfileId}/canceldelete HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
Cancel deletion of given deployment region (it will stop deletion but what has been deleted is lost already)
Id of the deployment region to stop deleting
PUT /v3/deploymentRegion/{deploymentRegionId}/canceldelete HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
Id of the deployment container to stop deleting
PUT /v3/deploymentContainer/{deploymentContainerId}/canceldelete 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
}
]Id of the deployment containerLocation to stop deleting
PUT /v3/deploymentContainerLocation/{deploymentContainerLocationId}/canceldelete HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
The Id of the deployment region
Example header and default range: RANGED-DATA:start=0,results=25
GET /v3/deploymentRegion/{deploymentRegionId}/property HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"applicationPropertyId": "text",
"propertyValue": "text"
}
]The Id of the deployment region
Deployment region property ID
The application property ID that this regional property overrides
The overridden value of the application property
POST /v3/deploymentRegion/{deploymentRegionId}/property HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 55
{
"applicationPropertyId": "text",
"propertyValue": "text"
}[
{
"id": "text",
"applicationPropertyId": "text",
"propertyValue": "text"
}
]The Id of the deployment region
The Id of the deployment region property
GET /v3/deploymentRegion/{deploymentRegionId}/property/{propertyId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"applicationPropertyId": "text",
"propertyValue": "text"
}
]The Id of the deployment region
The Id of the deployment region property
Deployment region property ID
The application property ID that this regional property overrides
The overridden value of the application property
PUT /v3/deploymentRegion/{deploymentRegionId}/property/{propertyId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 55
{
"applicationPropertyId": "text",
"propertyValue": "text"
}[
{
"id": "text",
"applicationPropertyId": "text",
"propertyValue": "text"
}
]The Id of the deployment region
The Id of the deployment region property
DELETE /v3/deploymentRegion/{deploymentRegionId}/property/{propertyId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
No content
You can filter based on following parameters
- deploymentEnvironmentId
- fleetId
- hostId
- applicationId
- applicationBuildId
- applicationInstanceId
Example header and default range: RANGED-DATA:start=0,results=25
GET /v3/crash HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
RANGED-DATA: text
Accept: */*
[
{
"id": "text",
"hostId": 1,
"deploymentEnvironmentId": "text",
"fleetId": 1,
"applicationId": "text",
"applicationBuildId": "text",
"applicationBuildExecutable": "text",
"applicationBuildStartParams": "text",
"exitCode": 1,
"deploymentEnvironment": {
"id": "text",
"name": "text",
"createdAt": 1
},
"fleet": {
"id": "text",
"name": "text",
"deploymentEnvironmentId": "text",
"deploymentProfileId": "text",
"gameDeploymentTemplateId": "text",
"utilityDeploymentTemplateId": "text",
"dependencyDeploymentTemplateId": "text",
"hostCapacityTemplateId": "text",
"operationalStatus": 1,
"isGameLift": true
},
"applicationInstance": {
"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
},
"applicationInstanceConfiguration": [
{
"id": "text",
"applicationInstanceId": "text",
"applicationBuildConfigurationId": "text",
"configPath": "text",
"configName": "text",
"configContent": "text",
"updatedAt": 1,
"active": 1
}
],
"applicationInstanceMetadata": [
{
"key": "text",
"value": "text"
}
],
"createdAt": 1
}
]You can filter based on following parameters
- deploymentEnvironmentId
- fleetId
- deploymentRegionId
- dcLocationId
GET /v3/telemetry/ccu/status HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"maxPlayers": 1,
"currentPlayers": 1
}
]
}
]You can filter based on following parameters
- deploymentEnvironmentId
- fleetId
- deploymentRegionId
- dcLocationId
Unix timestamp. Filter from time, default value is -1 day
Unix timestamp. Filter to time, default value is now
GET /v3/telemetry/ccu/status/aggregate HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"ccus": [
{
"providerId": 1,
"maxPlayers": 1,
"currentPlayers": 1
}
]
}
]
}
]GET /v3/telemetry/ccu/application HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"applicationId": "text",
"applicationName": "text",
"playerCount": 1,
"maxPlayers": 1
}
]Start unix timestamp
End unix timestamp
GET /v3/telemetry/host/{hostId}/memory HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"memMax": 1,
"data": [
{
"timestamp": 1,
"memUsed": 1
}
]
}
]Start unix timestamp
End unix timestamp
GET /v3/telemetry/host/{hostId}/cpu HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"cpu": 1
}
]
}
]Start unix timestamp
End unix timestamp
GET /v3/telemetry/host/{hostId}/network HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"networkIngress": 1,
"networkEgress": 1
}
]
}
]Start unix timestamp
End unix timestamp
GET /v3/telemetry/host/{hostId}/hdd HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"hardDisk0Free": 1,
"hardDisk1Free": 1,
"hardDisk2Free": 1,
"hardDisk3Free": 1
}
]
}
]You can filter based on following parameters
- deploymentEnvironmentId
- fleetId
- deploymentRegionId
- dcLocationId
GET /v3/telemetry/host/utilization HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"hostsOccupied": 1,
"hostsFree": 1,
"hostsFull": 1,
"hostsTotal": 1,
"launched": 1,
"destroyed": 1
}
]
}
]You can filter based on following parameters
- deploymentEnvironmentId
- fleetId
- deploymentRegionId
- dcLocationId
Unix timestamp. Filter from time, default value is -1 day
Unix timestamp. Filter to time, default value is now
GET /v3/telemetry/host/utilization/aggregate HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
{
"unit": "text",
"data": [
{
"timestamp": 1,
"hosts": [
{
"providerId": 1,
"hostsOccupied": 1,
"hostsFree": 1,
"hostsFull": 1,
"hostsTotal": 1,
"launched": 1,
"destroyed": 1
}
]
}
]
}You can filter based on following parameters
- deploymentEnvironmentId
- fleetId
Unix timestamp. Filter from time, default value is -1 day
Unix timestamp. Filter to time, default value is now
GET /v3/telemetry/host/hardwareCapacity HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"value": {
"cpuPercentage": 1,
"ramPercentage": 1,
"diskPercentage": 1
}
}
]
}
]You can filter based on following parameters
- deploymentEnvironmentId
- fleetId
GET /v3/telemetry/host/hardwareCapacity/current HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"cpuPercentage": 1,
"ramPercentage": 1,
"diskPercentage": 1
}
]Unix timestamp. Filter from time, default value is -1 day
Unix timestamp. Filter to time, default value is now
GET /v3/telemetry/host/onlineStatus HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"host": [
{
"timestamp": 1,
"data": [
{
"hostType": 1,
"online": 1,
"install": 1,
"offline": 1,
"unknown": 1
}
]
}
]
}
]GET /v3/telemetry/host/onlineStatus/current HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"timestamp": 1,
"hostType": 1,
"online": 1,
"onlinePercentage": 1,
"install": 1,
"installPercentage": 1,
"offline": 1,
"offlinePercentage": 1,
"unknown": 1,
"unknownPercentage": 1,
"total": 1
}
]Example header and default range: RANGED-DATA:start=0,results=25
GET /v3/telemetry/host/overuse/current HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
RANGED-DATA: text
Accept: */*
[
{
"hostId": 1,
"hostName": "text",
"orderedBandwidth": 1,
"usedBandwidth": 1
}
]Start unix timestamp
End unix timestamp
GET /v3/telemetry/applicationInstance/{applicationInstanceId}/memory HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"memUsed": 1
}
]
}
]Start unix timestamp
End unix timestamp
GET /v3/telemetry/applicationInstance/{applicationInstanceId}/cpu HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"cpu": 1
}
]
}
]You can filter based on following parameters
- deploymentEnvironmentId
- fleetId
- deploymentRegionId
- dcLocationId
GET /v3/telemetry/applicationInstance/providerId HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"applicationInstances": [
{
"providerId": 1,
"applicationInstanceCount": 1
}
]
}
]
}
]Get the aggregated list of application instance status, according to give date range system will calculate the interval, possible interval options are as follows
- minute
- hour
- day
- month
- 0: Both game and utilities
- 1: Only game (default)
- 2: Only utilities
You can filter based on following parameters
- deploymentEnvironmentId
- fleetId
- deploymentRegionId
- dcLocationId
Unix timestamp. Filter from time, default value is -1 day
Unix timestamp. Filter to time, default value is now
GET /v3/telemetry/applicationInstance/providerId/aggregate HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"applicationInstances": [
{
"providerId": 1,
"applicationInstanceCount": 1
}
]
}
]
}
]- 0: Both game and utilities
- 1: Only game (default)
- 2: Only utilities
You can filter based on the following parameters
- deploymentProfileId
GET /v3/telemetry/applicationInstance/deploymentProfile/status HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"deploymentProfiles": [
{
"deploymentProfileId": "text",
"setup": 1,
"offline": 1,
"starting": 1,
"online": 1,
"allocated": 1,
"deploymentRegions": [
{
"deploymentRegionId": "text",
"setup": 1,
"offline": 1,
"starting": 1,
"online": 1,
"allocated": 1
}
]
}
]
}
]
}
]- 0: Both game and utilities
- 1: Only game (default)
- 2: Only utilities
You can filter based on the following parameters
- deploymentEnvironmentId
- fleetId
- deploymentRegionId
- dcLocationId
GET /v3/telemetry/applicationInstance/status HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"setup": 1,
"offline": 1,
"starting": 1,
"online": 1,
"allocated": 1
}
]
}
]Get the aggregated list of application instance status, according to give date range system will calculate the interval, possible interval options are as follows
- minute
- hour
- day
- month
- 0: Both game and utilities
- 1: Only game (default)
- 2: Only utilities
You can filter based on following parameters
- deploymentEnvironmentId
- fleetId
- regionId
- dcLocationId
Unix timestamp. Filter from time, default value is -1 day
Unix timestamp. Filter to time, default value is now
GET /v3/telemetry/applicationInstance/status/aggregate HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"setup": 1,
"offline": 1,
"starting": 1,
"online": 1,
"allocated": 1
}
]
}
]Get the current distribution of application instances (of type Game) for bare metal, flex metal and cloud
GET /v3/telemetry/applicationInstance/distribution/current HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"bareMetal": 1,
"bareMetalPercentage": 1,
"flexMetal": 1,
"flexMetalPercentage": 1,
"cloud": 1,
"cloudPercentage": 1,
"total": 1
}
]Get the historic distribution of application instances (of type Game) for bare metal, flex metal and cloud
Get the aggregated list of application instance status, according to give date range system will calculate the interval, possible interval options are as follows
- minute
- hour
- day
Unix timestamp. Filter from time, default value is -1 day
Unix timestamp. Filter to time, default value is now
GET /v3/telemetry/applicationInstance/distribution HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"bareMetal": 1,
"bareMetalPercentage": 1,
"flexMetal": 1,
"flexMetalPercentage": 1,
"cloud": 1,
"cloudPercentage": 1,
"total": 1
}
]
}
]Get the aggregated list of application instances (of type Game) for bare metal, flex metal and cloud
GET /v3/telemetry/applicationInstance/hostCapacity/current HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"bareMetal": 1,
"flexMetal": 1,
"cloud": 1
}
]Unix timestamp. Filter from time, default value is -1 day
Unix timestamp. Filter to time, default value is now
GET /v3/telemetry/applicationInstance/crash HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"unit": "text",
"data": [
{
"timestamp": 1,
"crashes": 1
}
]
}
]Example header and default range: RANGED-DATA:start=0,results=25
GET /v3/buildProvisioning/storage/registration HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"username": "text",
"port": 1,
"name": "text",
"originDomainName": "text",
"cdnDomainName": "text",
"headers": [
{
"name": "text",
"value": "text"
}
],
"contractStart": 1,
"contractEnd": 1,
"type": 1,
"createdAt": 1,
"changedAt": 1
}
]The ID of the build provisioning storage registration for which to fetch the information
GET /v3/buildProvisioning/storage/registration/{id} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"username": "text",
"port": 1,
"name": "text",
"originDomainName": "text",
"cdnDomainName": "text",
"headers": [
{
"name": "text",
"value": "text"
}
],
"contractStart": 1,
"contractEnd": 1,
"type": 1,
"createdAt": 1,
"changedAt": 1
}
]GET /v3/buildProvisioning/storage/registration/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
GET /v3/buildProvisioning/storage/file HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"buildProvisionRegistrationId": "text",
"fileName": "text",
"fileSize": 1,
"md5CheckSum": "text",
"createdAt": 1,
"changedAt": 1
}
]The ID of the build provisioning file for which to fetch the information
GET /v3/buildProvisioning/storage/file/{id} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"buildProvisionRegistrationId": "text",
"fileName": "text",
"fileSize": 1,
"md5CheckSum": "text",
"createdAt": 1,
"changedAt": 1
}
]The ID of the build provisioning registration where you want the files of
Example header and default range: RANGED-DATA:start=0,results=25
GET /v3/buildProvisioning/storage/registration/{buildProvisioningRegistrationId}/file HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Accept: */*
[
{
"id": "text",
"buildProvisionRegistrationId": "text",
"fileName": "text",
"fileSize": 1,
"md5CheckSum": "text",
"createdAt": 1,
"changedAt": 1
}
]POST /v3/customCommand/host/{hostId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 49
{
"customCommand": [
{
"key": "text",
"value": "text"
}
]
}[
{
"id": 1,
"name": "text",
"batchId": 1,
"categoryId": 1,
"entityId": 1,
"currentActionIdx": 1,
"executeAt": 1,
"lastActivityAt": 1,
"finishedAt": 1,
"resultCode": 1,
"resultText": "text"
}
]POST /v3/customCommand/applicationInstance/{applicationInstanceId} HTTP/1.1
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 49
{
"customCommand": [
{
"key": "text",
"value": "text"
}
]
}[
{
"id": 1,
"name": "text",
"batchId": 1,
"categoryId": 1,
"entityId": 1,
"currentActionIdx": 1,
"executeAt": 1,
"lastActivityAt": 1,
"finishedAt": 1,
"resultCode": 1,
"resultText": "text"
}
]Last updated
Was this helpful?