DeploymentProfile

(Cloud) deployment and scaling configuration

Get all the deployment profiles you have created

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringOptional

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

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The deployment profile ID

fleetIdsstring[]Read-onlyRequired

IDs of the fleets in which this deployment profile is being used

namestringRequired

This deployment profile's name

descriptionstringOptional

This deployment profile's description

strategyTypeinteger · integerRequired

Possible values:

  • 1: Round robin
minimumCapacityinteger · integerRequired

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

maximumCapacityinteger · integer · nullableOptional

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

bufferValueinteger · integerRequired

Global buffer value, to be applied to individual deployment regions. Can be overridden per region

bufferValueTypeinteger · integerRequired

Possible values:

  • 0: Absolute value
  • 1: Percentage value (must be accompanied by bufferValueMin and bufferValueMax)
bufferValueMininteger · integer · nullableOptional

The minimum absolute bufferValue when using a percentage, to prevent bufferValue from going too low

bufferValueMaxinteger · integer · nullableOptional

The maximum absolute bufferValue when using a percentage, to prevent bufferValue from going too high

markedForDeletioninteger · integerRead-onlyRequired

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

Example: 1
inUseinteger · integerRead-onlyRequired

Possible values:

  • 0: Deployment profile has no active application instances
  • 1: Deployment profile has active application instance(s)
createdAtinteger · integerRead-onlyRequired

Unix timestamp of creation time

get
/v3/deploymentProfile

Create a new deployment profile

post
Authorizations
PRIVATE-TOKENstringRequired
Body
idstringRead-onlyRequired

The deployment profile ID

fleetIdsstring[]Read-onlyRequired

IDs of the fleets in which this deployment profile is being used

namestringRequired

This deployment profile's name

descriptionstringOptional

This deployment profile's description

strategyTypeinteger · integerRequired

Possible values:

  • 1: Round robin
minimumCapacityinteger · integerRequired

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

maximumCapacityinteger · integer · nullableOptional

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

bufferValueinteger · integerRequired

Global buffer value, to be applied to individual deployment regions. Can be overridden per region

bufferValueTypeinteger · integerRequired

Possible values:

  • 0: Absolute value
  • 1: Percentage value (must be accompanied by bufferValueMin and bufferValueMax)
bufferValueMininteger · integer · nullableOptional

The minimum absolute bufferValue when using a percentage, to prevent bufferValue from going too low

bufferValueMaxinteger · integer · nullableOptional

The maximum absolute bufferValue when using a percentage, to prevent bufferValue from going too high

markedForDeletioninteger · integerRead-onlyRequired

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

Example: 1
inUseinteger · integerRead-onlyRequired

Possible values:

  • 0: Deployment profile has no active application instances
  • 1: Deployment profile has active application instance(s)
createdAtinteger · integerRead-onlyRequired

Unix timestamp of creation time

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The deployment profile ID

fleetIdsstring[]Read-onlyRequired

IDs of the fleets in which this deployment profile is being used

namestringRequired

This deployment profile's name

descriptionstringOptional

This deployment profile's description

strategyTypeinteger · integerRequired

Possible values:

  • 1: Round robin
minimumCapacityinteger · integerRequired

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

maximumCapacityinteger · integer · nullableOptional

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

bufferValueinteger · integerRequired

Global buffer value, to be applied to individual deployment regions. Can be overridden per region

bufferValueTypeinteger · integerRequired

Possible values:

  • 0: Absolute value
  • 1: Percentage value (must be accompanied by bufferValueMin and bufferValueMax)
bufferValueMininteger · integer · nullableOptional

The minimum absolute bufferValue when using a percentage, to prevent bufferValue from going too low

bufferValueMaxinteger · integer · nullableOptional

The maximum absolute bufferValue when using a percentage, to prevent bufferValue from going too high

markedForDeletioninteger · integerRead-onlyRequired

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

Example: 1
inUseinteger · integerRead-onlyRequired

Possible values:

  • 0: Deployment profile has no active application instances
  • 1: Deployment profile has active application instance(s)
createdAtinteger · integerRead-onlyRequired

Unix timestamp of creation time

post
/v3/deploymentProfile

Get all the deployment profiles you have created

get
Authorizations
PRIVATE-TOKENstringRequired
Header parameters
RANGED-DATAstringOptional

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

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The deployment profile ID

fleetIdsstring[]Read-onlyRequired

IDs of the fleets in which this deployment profile is being used

namestringRequired

This deployment profile's name

descriptionstringOptional

This deployment profile's description

strategyTypeinteger · integerRequired

Possible values:

  • 1: Round robin
minimumCapacityinteger · integerRequired

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

maximumCapacityinteger · integer · nullableOptional

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

bufferValueinteger · integerRequired

Global buffer value, to be applied to individual deployment regions. Can be overridden per region

bufferValueTypeinteger · integerRequired

Possible values:

  • 0: Absolute value
  • 1: Percentage value (must be accompanied by bufferValueMin and bufferValueMax)
bufferValueMininteger · integer · nullableOptional

The minimum absolute bufferValue when using a percentage, to prevent bufferValue from going too low

bufferValueMaxinteger · integer · nullableOptional

The maximum absolute bufferValue when using a percentage, to prevent bufferValue from going too high

markedForDeletioninteger · integerRead-onlyRequired

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

Example: 1
inUseinteger · integerRead-onlyRequired

Possible values:

  • 0: Deployment profile has no active application instances
  • 1: Deployment profile has active application instance(s)
createdAtinteger · integerRead-onlyRequired

Unix timestamp of creation time

get
/v3/deploymentProfile/summary

Get the given deployment profile

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentProfileIdstringRequired

The Id of the deployment profile

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The deployment profile ID

fleetIdsstring[]Read-onlyRequired

IDs of the fleets in which this deployment profile is being used

namestringRequired

This deployment profile's name

descriptionstringOptional

This deployment profile's description

strategyTypeinteger · integerRequired

Possible values:

  • 1: Round robin
minimumCapacityinteger · integerRequired

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

maximumCapacityinteger · integer · nullableOptional

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

bufferValueinteger · integerRequired

Global buffer value, to be applied to individual deployment regions. Can be overridden per region

bufferValueTypeinteger · integerRequired

Possible values:

  • 0: Absolute value
  • 1: Percentage value (must be accompanied by bufferValueMin and bufferValueMax)
bufferValueMininteger · integer · nullableOptional

The minimum absolute bufferValue when using a percentage, to prevent bufferValue from going too low

bufferValueMaxinteger · integer · nullableOptional

The maximum absolute bufferValue when using a percentage, to prevent bufferValue from going too high

markedForDeletioninteger · integerRead-onlyRequired

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

Example: 1
inUseinteger · integerRead-onlyRequired

Possible values:

  • 0: Deployment profile has no active application instances
  • 1: Deployment profile has active application instance(s)
createdAtinteger · integerRead-onlyRequired

Unix timestamp of creation time

get
/v3/deploymentProfile/{deploymentProfileId}

Update given deployment profile

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentProfileIdstringRequired

The Id of the deployment profile

Body
idstringRead-onlyRequired

The deployment profile ID

fleetIdsstring[]Read-onlyRequired

IDs of the fleets in which this deployment profile is being used

namestringRequired

This deployment profile's name

descriptionstringOptional

This deployment profile's description

strategyTypeinteger · integerRequired

Possible values:

  • 1: Round robin
minimumCapacityinteger · integerRequired

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

maximumCapacityinteger · integer · nullableOptional

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

bufferValueinteger · integerRequired

Global buffer value, to be applied to individual deployment regions. Can be overridden per region

bufferValueTypeinteger · integerRequired

Possible values:

  • 0: Absolute value
  • 1: Percentage value (must be accompanied by bufferValueMin and bufferValueMax)
bufferValueMininteger · integer · nullableOptional

The minimum absolute bufferValue when using a percentage, to prevent bufferValue from going too low

bufferValueMaxinteger · integer · nullableOptional

The maximum absolute bufferValue when using a percentage, to prevent bufferValue from going too high

markedForDeletioninteger · integerRead-onlyRequired

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

Example: 1
inUseinteger · integerRead-onlyRequired

Possible values:

  • 0: Deployment profile has no active application instances
  • 1: Deployment profile has active application instance(s)
createdAtinteger · integerRead-onlyRequired

Unix timestamp of creation time

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The deployment profile ID

fleetIdsstring[]Read-onlyRequired

IDs of the fleets in which this deployment profile is being used

namestringRequired

This deployment profile's name

descriptionstringOptional

This deployment profile's description

strategyTypeinteger · integerRequired

Possible values:

  • 1: Round robin
minimumCapacityinteger · integerRequired

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

maximumCapacityinteger · integer · nullableOptional

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

bufferValueinteger · integerRequired

Global buffer value, to be applied to individual deployment regions. Can be overridden per region

bufferValueTypeinteger · integerRequired

Possible values:

  • 0: Absolute value
  • 1: Percentage value (must be accompanied by bufferValueMin and bufferValueMax)
bufferValueMininteger · integer · nullableOptional

The minimum absolute bufferValue when using a percentage, to prevent bufferValue from going too low

bufferValueMaxinteger · integer · nullableOptional

The maximum absolute bufferValue when using a percentage, to prevent bufferValue from going too high

markedForDeletioninteger · integerRead-onlyRequired

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

Example: 1
inUseinteger · integerRead-onlyRequired

Possible values:

  • 0: Deployment profile has no active application instances
  • 1: Deployment profile has active application instance(s)
createdAtinteger · integerRead-onlyRequired

Unix timestamp of creation time

put
/v3/deploymentProfile/{deploymentProfileId}

Delete given deployment profile (it will delete all the application instances if there are any)

delete

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)

Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentProfileIdstringRequired

Id of the deployment profile to delete

Query parameters
methodIdintegerOptional

Id for the method of deletion: hard-kill = 1, graceful=2

startTimeintegerOptional

Unix timestamp. When to start deleting the containerLocation and its contents. Default = now

endTimeintegerOptional

Unix timestamp. Time limit in which to delete all remaining game servers immediately (not graceful). Default = 0 (no limit)

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Task ID

namestringRead-onlyRequired

Task name

batchIdinteger · integerRead-onlyRequired

The ID of the batch the task belongs to

categoryIdinteger · integerRead-onlyRequired

The ID of the task category. Valid values are:

  • 1: game server
entityIdinteger · integerRead-onlyRequired

The ID of the entity the task is being executed for. E.g. a game server ID (categoryId 1)

currentActionIdxinteger · integerRead-onlyRequired

Currently active action index - relates to the action index as found in the template.

executeAtinteger · integerRead-onlyRequired

Unix timestamp indicating the start of execution.

lastActivityAtinteger · integerRead-onlyRequired

Unix timestamp indicating lastest activity.

finishedAtinteger · integerRead-onlyRequired

Unix timestamp at which the task was finished.

resultCodeinteger · integerRead-onlyRequired

The result of the task. 0: pending, 1: in progress, 2: paused, 125: cancelled, 126: done with error, 127: done

resultTextstringRead-onlyRequired

The result of the task in message form.

delete
/v3/deploymentProfile/{deploymentProfileId}

Get the given deployment region

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentRegionIdstringRequired

The Id of the deployment region

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

This deployment region's ID

namestringRequired

The name of the deployment region

i3dDcLocationIdsinteger · integer[]Required

All the i3D.net DC location IDs configured for this deployment region. You can get available IDs via GET /cloud/dcLocation

i3dDcLocationIdsToBeRemovedinteger · integer[]Optional

i3D.net data center location IDs scheduled for removal from this region

minimumCapacityinteger · integer · nullableOptional

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

maximumCapacityinteger · integer · nullableOptional

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

bufferValueinteger · integer · nullableOptional

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

bufferValueTypeinteger · integer · nullableOptional

Override for DeploymentProfile.bufferValueType. Possible values:

  • 0: Absolute value
  • 1: Percentage value (must be accompanied by bufferValueMin and bufferValueMax) Null value means that the bufferValueType provided in the deployment profile will persist
bufferValueMininteger · integer · nullableOptional

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

bufferValueMaxinteger · integer · nullableOptional

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

strategyTypeinteger · integer · nullableOptional

Override value for DeploymentProfile.strategyType. Possible values:

  • 0: Use default
  • 1: Round robin
  • null: The strategyType provided in the deployment profile will persist
markedForDeletioninteger · integerRead-onlyRequired

If set to 1, all application instances will be gracefully removed inside the deployment region. Afterwards this deployment region will be set to inactive

inUseinteger · integerRead-onlyRequired

Possible values:

  • 0: Deployment region has no active application instances
  • 1: Deployment region has active application instance(s)
get
/v3/deploymentRegion/{deploymentRegionId}

Update given deployment region

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentRegionIdstringRequired

Id of the deployment region to update

Body
idstringRead-onlyRequired

This deployment region's ID

namestringRequired

The name of the deployment region

i3dDcLocationIdsinteger · integer[]Required

All the i3D.net DC location IDs configured for this deployment region. You can get available IDs via GET /cloud/dcLocation

i3dDcLocationIdsToBeRemovedinteger · integer[]Optional

i3D.net data center location IDs scheduled for removal from this region

minimumCapacityinteger · integer · nullableOptional

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

maximumCapacityinteger · integer · nullableOptional

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

bufferValueinteger · integer · nullableOptional

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

bufferValueTypeinteger · integer · nullableOptional

Override for DeploymentProfile.bufferValueType. Possible values:

  • 0: Absolute value
  • 1: Percentage value (must be accompanied by bufferValueMin and bufferValueMax) Null value means that the bufferValueType provided in the deployment profile will persist
bufferValueMininteger · integer · nullableOptional

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

bufferValueMaxinteger · integer · nullableOptional

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

strategyTypeinteger · integer · nullableOptional

Override value for DeploymentProfile.strategyType. Possible values:

  • 0: Use default
  • 1: Round robin
  • null: The strategyType provided in the deployment profile will persist
markedForDeletioninteger · integerRead-onlyRequired

If set to 1, all application instances will be gracefully removed inside the deployment region. Afterwards this deployment region will be set to inactive

inUseinteger · integerRead-onlyRequired

Possible values:

  • 0: Deployment region has no active application instances
  • 1: Deployment region has active application instance(s)
Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

This deployment region's ID

namestringRequired

The name of the deployment region

i3dDcLocationIdsinteger · integer[]Required

All the i3D.net DC location IDs configured for this deployment region. You can get available IDs via GET /cloud/dcLocation

i3dDcLocationIdsToBeRemovedinteger · integer[]Optional

i3D.net data center location IDs scheduled for removal from this region

minimumCapacityinteger · integer · nullableOptional

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

maximumCapacityinteger · integer · nullableOptional

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

bufferValueinteger · integer · nullableOptional

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

bufferValueTypeinteger · integer · nullableOptional

Override for DeploymentProfile.bufferValueType. Possible values:

  • 0: Absolute value
  • 1: Percentage value (must be accompanied by bufferValueMin and bufferValueMax) Null value means that the bufferValueType provided in the deployment profile will persist
bufferValueMininteger · integer · nullableOptional

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

bufferValueMaxinteger · integer · nullableOptional

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

strategyTypeinteger · integer · nullableOptional

Override value for DeploymentProfile.strategyType. Possible values:

  • 0: Use default
  • 1: Round robin
  • null: The strategyType provided in the deployment profile will persist
markedForDeletioninteger · integerRead-onlyRequired

If set to 1, all application instances will be gracefully removed inside the deployment region. Afterwards this deployment region will be set to inactive

inUseinteger · integerRead-onlyRequired

Possible values:

  • 0: Deployment region has no active application instances
  • 1: Deployment region has active application instance(s)
put
/v3/deploymentRegion/{deploymentRegionId}

Delete given deployment profile region (it will delete all the application instances if there are any)

delete

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)

Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentRegionIdstringRequired

Id of the deployment profile region to delete

Query parameters
methodIdintegerOptional

Id for the method of deletion: hard-kill = 1, graceful=2

startTimeintegerOptional

Unix timestamp. When to start deleting the containerLocation and its contents. Default = now

endTimeintegerOptional

Unix timestamp. Time limit in which to delete all remaining game servers immediately (not graceful). Default = 0 (no limit)

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Task ID

namestringRead-onlyRequired

Task name

batchIdinteger · integerRead-onlyRequired

The ID of the batch the task belongs to

categoryIdinteger · integerRead-onlyRequired

The ID of the task category. Valid values are:

  • 1: game server
entityIdinteger · integerRead-onlyRequired

The ID of the entity the task is being executed for. E.g. a game server ID (categoryId 1)

currentActionIdxinteger · integerRead-onlyRequired

Currently active action index - relates to the action index as found in the template.

executeAtinteger · integerRead-onlyRequired

Unix timestamp indicating the start of execution.

lastActivityAtinteger · integerRead-onlyRequired

Unix timestamp indicating lastest activity.

finishedAtinteger · integerRead-onlyRequired

Unix timestamp at which the task was finished.

resultCodeinteger · integerRead-onlyRequired

The result of the task. 0: pending, 1: in progress, 2: paused, 125: cancelled, 126: done with error, 127: done

resultTextstringRead-onlyRequired

The result of the task in message form.

delete
/v3/deploymentRegion/{deploymentRegionId}

Create a new deployment region for the given profile

post
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentProfileIdstringRequired

The Id of the deployment profile

Body
idstringRead-onlyRequired

This deployment region's ID

namestringRequired

The name of the deployment region

i3dDcLocationIdsinteger · integer[]Required

All the i3D.net DC location IDs configured for this deployment region. You can get available IDs via GET /cloud/dcLocation

i3dDcLocationIdsToBeRemovedinteger · integer[]Optional

i3D.net data center location IDs scheduled for removal from this region

minimumCapacityinteger · integer · nullableOptional

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

maximumCapacityinteger · integer · nullableOptional

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

bufferValueinteger · integer · nullableOptional

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

bufferValueTypeinteger · integer · nullableOptional

Override for DeploymentProfile.bufferValueType. Possible values:

  • 0: Absolute value
  • 1: Percentage value (must be accompanied by bufferValueMin and bufferValueMax) Null value means that the bufferValueType provided in the deployment profile will persist
bufferValueMininteger · integer · nullableOptional

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

bufferValueMaxinteger · integer · nullableOptional

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

strategyTypeinteger · integer · nullableOptional

Override value for DeploymentProfile.strategyType. Possible values:

  • 0: Use default
  • 1: Round robin
  • null: The strategyType provided in the deployment profile will persist
markedForDeletioninteger · integerRead-onlyRequired

If set to 1, all application instances will be gracefully removed inside the deployment region. Afterwards this deployment region will be set to inactive

inUseinteger · integerRead-onlyRequired

Possible values:

  • 0: Deployment region has no active application instances
  • 1: Deployment region has active application instance(s)
Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

This deployment region's ID

namestringRequired

The name of the deployment region

i3dDcLocationIdsinteger · integer[]Required

All the i3D.net DC location IDs configured for this deployment region. You can get available IDs via GET /cloud/dcLocation

i3dDcLocationIdsToBeRemovedinteger · integer[]Optional

i3D.net data center location IDs scheduled for removal from this region

minimumCapacityinteger · integer · nullableOptional

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

maximumCapacityinteger · integer · nullableOptional

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

bufferValueinteger · integer · nullableOptional

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

bufferValueTypeinteger · integer · nullableOptional

Override for DeploymentProfile.bufferValueType. Possible values:

  • 0: Absolute value
  • 1: Percentage value (must be accompanied by bufferValueMin and bufferValueMax) Null value means that the bufferValueType provided in the deployment profile will persist
bufferValueMininteger · integer · nullableOptional

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

bufferValueMaxinteger · integer · nullableOptional

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

strategyTypeinteger · integer · nullableOptional

Override value for DeploymentProfile.strategyType. Possible values:

  • 0: Use default
  • 1: Round robin
  • null: The strategyType provided in the deployment profile will persist
markedForDeletioninteger · integerRead-onlyRequired

If set to 1, all application instances will be gracefully removed inside the deployment region. Afterwards this deployment region will be set to inactive

inUseinteger · integerRead-onlyRequired

Possible values:

  • 0: Deployment region has no active application instances
  • 1: Deployment region has active application instance(s)
post
/v3/deploymentProfile/{deploymentProfileId}/deploymentRegion

Delete given deployment profile container (it will delete all the application instances if there are any)

delete

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)

Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentContainerIdstringRequired

Id of the deployment profile container to delete

Query parameters
methodIdintegerOptional

Id for the method of deletion: hard-kill = 1, graceful=2

startTimeintegerOptional

Unix timestamp. When to start deleting the containerLocation and its contents. Default = now

endTimeintegerOptional

Unix timestamp. Time limit in which to delete all remaining game servers immediately (not graceful). Default = 0 (no limit)

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Task ID

namestringRead-onlyRequired

Task name

batchIdinteger · integerRead-onlyRequired

The ID of the batch the task belongs to

categoryIdinteger · integerRead-onlyRequired

The ID of the task category. Valid values are:

  • 1: game server
entityIdinteger · integerRead-onlyRequired

The ID of the entity the task is being executed for. E.g. a game server ID (categoryId 1)

currentActionIdxinteger · integerRead-onlyRequired

Currently active action index - relates to the action index as found in the template.

executeAtinteger · integerRead-onlyRequired

Unix timestamp indicating the start of execution.

lastActivityAtinteger · integerRead-onlyRequired

Unix timestamp indicating lastest activity.

finishedAtinteger · integerRead-onlyRequired

Unix timestamp at which the task was finished.

resultCodeinteger · integerRead-onlyRequired

The result of the task. 0: pending, 1: in progress, 2: paused, 125: cancelled, 126: done with error, 127: done

resultTextstringRead-onlyRequired

The result of the task in message form.

delete
/v3/deploymentContainer/{deploymentContainerId}

Delete given deployment profile containerLocation (it will delete all the application instances if there are any)

delete

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)

Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentContainerLocationIdstringRequired

Id of the deployment profile containerLocation to delete

Query parameters
methodIdintegerOptional

Id for the method of deletion: hard-kill = 1, graceful=2

startTimeintegerOptional

Unix timestamp. When to start deleting the containerLocation and its contents. Default = now

endTimeintegerOptional

Unix timestamp. Time limit in which to delete all remaining game servers immediately (not graceful). Default = 0 (no limit)

Responses
chevron-right
200

OK

application/json
idinteger · integerRead-onlyRequired

Task ID

namestringRead-onlyRequired

Task name

batchIdinteger · integerRead-onlyRequired

The ID of the batch the task belongs to

categoryIdinteger · integerRead-onlyRequired

The ID of the task category. Valid values are:

  • 1: game server
entityIdinteger · integerRead-onlyRequired

The ID of the entity the task is being executed for. E.g. a game server ID (categoryId 1)

currentActionIdxinteger · integerRead-onlyRequired

Currently active action index - relates to the action index as found in the template.

executeAtinteger · integerRead-onlyRequired

Unix timestamp indicating the start of execution.

lastActivityAtinteger · integerRead-onlyRequired

Unix timestamp indicating lastest activity.

finishedAtinteger · integerRead-onlyRequired

Unix timestamp at which the task was finished.

resultCodeinteger · integerRead-onlyRequired

The result of the task. 0: pending, 1: in progress, 2: paused, 125: cancelled, 126: done with error, 127: done

resultTextstringRead-onlyRequired

The result of the task in message form.

delete
/v3/deploymentContainerLocation/{deploymentContainerLocationId}

Cancel the deletion of given deployment profile (it will stop deletion but what has been deleted is lost already)

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentProfileIdstringRequired

Id of the deployment profile to stop deleting

Responses
put
/v3/deploymentProfile/{deploymentProfileId}/canceldelete

No content

Cancel deletion of given deployment region (it will stop deletion but what has been deleted is lost already)

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentRegionIdintegerRequired

Id of the deployment region to stop deleting

Responses
put
/v3/deploymentRegion/{deploymentRegionId}/canceldelete

No content

Cancel delete given cloud deployment container

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentContainerIdstringRequired

Id of the deployment container to stop deleting

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

The deployment profile ID

fleetIdsstring[]Read-onlyRequired

IDs of the fleets in which this deployment profile is being used

namestringRequired

This deployment profile's name

descriptionstringOptional

This deployment profile's description

strategyTypeinteger · integerRequired

Possible values:

  • 1: Round robin
minimumCapacityinteger · integerRequired

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

maximumCapacityinteger · integer · nullableOptional

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

bufferValueinteger · integerRequired

Global buffer value, to be applied to individual deployment regions. Can be overridden per region

bufferValueTypeinteger · integerRequired

Possible values:

  • 0: Absolute value
  • 1: Percentage value (must be accompanied by bufferValueMin and bufferValueMax)
bufferValueMininteger · integer · nullableOptional

The minimum absolute bufferValue when using a percentage, to prevent bufferValue from going too low

bufferValueMaxinteger · integer · nullableOptional

The maximum absolute bufferValue when using a percentage, to prevent bufferValue from going too high

markedForDeletioninteger · integerRead-onlyRequired

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

Example: 1
inUseinteger · integerRead-onlyRequired

Possible values:

  • 0: Deployment profile has no active application instances
  • 1: Deployment profile has active application instance(s)
createdAtinteger · integerRead-onlyRequired

Unix timestamp of creation time

put
/v3/deploymentContainer/{deploymentContainerId}/canceldelete

Cancel deletion of given deployment profile containerLocation

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentContainerLocationIdstringRequired

Id of the deployment containerLocation to stop deleting

Responses
put
/v3/deploymentContainerLocation/{deploymentContainerLocationId}/canceldelete

No content

Get a list of deployment region properties

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentRegionIdstringRequired

The Id of the deployment region

Header parameters
RANGED-DATAstringOptional

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

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

Deployment region property ID

applicationPropertyIdstringRequired

The application property ID that this regional property overrides

propertyValuestringRequired

The overridden value of the application property

get
/v3/deploymentRegion/{deploymentRegionId}/property

Create a new deployment region property

post
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentRegionIdstringRequired

The Id of the deployment region

Body
idstringRead-onlyRequired

Deployment region property ID

applicationPropertyIdstringRequired

The application property ID that this regional property overrides

propertyValuestringRequired

The overridden value of the application property

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

Deployment region property ID

applicationPropertyIdstringRequired

The application property ID that this regional property overrides

propertyValuestringRequired

The overridden value of the application property

post
/v3/deploymentRegion/{deploymentRegionId}/property

Get a specific deployment region property

get
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentRegionIdstringRequired

The Id of the deployment region

propertyIdstringRequired

The Id of the deployment region property

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

Deployment region property ID

applicationPropertyIdstringRequired

The application property ID that this regional property overrides

propertyValuestringRequired

The overridden value of the application property

get
/v3/deploymentRegion/{deploymentRegionId}/property/{propertyId}

Update a deployment region property

put
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentRegionIdstringRequired

The Id of the deployment region

propertyIdstringRequired

The Id of the deployment region property

Body
idstringRead-onlyRequired

Deployment region property ID

applicationPropertyIdstringRequired

The application property ID that this regional property overrides

propertyValuestringRequired

The overridden value of the application property

Responses
chevron-right
200

OK

application/json
idstringRead-onlyRequired

Deployment region property ID

applicationPropertyIdstringRequired

The application property ID that this regional property overrides

propertyValuestringRequired

The overridden value of the application property

put
/v3/deploymentRegion/{deploymentRegionId}/property/{propertyId}

Deletes a deployment region property (does not delete the application property)

delete
Authorizations
PRIVATE-TOKENstringRequired
Path parameters
deploymentRegionIdstringRequired

The Id of the deployment region

propertyIdstringRequired

The Id of the deployment region property

Responses
delete
/v3/deploymentRegion/{deploymentRegionId}/property/{propertyId}

No content

Last updated

Was this helpful?