Documentation

CreateBuildWithManagedContainer

Creates a multiplayer server build with a managed container.

Request Details

Creates a multiplayer server build with a managed container and returns information about the build creation request.

CreateBuildWithManagedContainerRequest
Request Properties
BuildName (required) String

The build name.

ContainerFlavor ContainerFlavor

The flavor of container to create a build from.

GameAssetReferences (required) List<AssetReferenceParams>

The list of game assets related to the build.

GameCertificateReferences List<GameCertificateReferenceParams>

The game certificates for the build.

Metadata Dict<String, String>

Metadata to tag the build. The keys are case insensitive. The build metadata is made available to the server through Game Server SDK (GSDK).

MultiplayerServerCountPerVm (required) int32

The number of multiplayer servers to host on a single VM.

Ports (required) List<Port>

The ports to map the build on.

RegionConfigurations (required) List<BuildRegionParams>

The region configurations for the build.

StartMultiplayerServerCommand (required) String

The command to run when the multiplayer server is started, including any arguments.

VmSize AzureVmSize

The VM size to create the build on.

POST https://{{TitleID}}.playfabapi.com/MultiplayerServer/CreateBuildWithManagedContainer
    Content-Type: application/json
{
  "StartMultiplayerServerCommand": "C:\\Assets\\gameserver.exe -startserver",
  "GameAssetReferences": [
    {
      "FileName": "gameserver.zip",
      "MountPath": "C:\\Asset\\"
    }
  ],
  "ContainerFlavor": "ManagedWindowsServerCore",
  "BuildName": "GameBuildName",
  "Metadata": {
    "MetadataKey": "MetadataValue"
  },
  "VmSize": "Standard_D2_v2",
  "MultiplayerServerCountPerVm": 10,
  "Ports": [
    {
      "Name": "PortName",
      "Num": 1243,
      "Protocol": "TCP"
    }
  ],
  "RegionConfigurations": [
    {
      "Region": "EastUs",
      "MaxServers": 10,
      "StandbyServers": 5
    },
    {
      "Region": "WestUs",
      "MaxServers": 12,
      "StandbyServers": 8
    },
    {
      "Region": "NorthEurope",
      "MaxServers": 7,
      "StandbyServers": 3
    }
  ],
  "GameCertificateReferences": [
    {
      "Name": "CertName",
      "GsdkAlias": "CertGsdkAlias"
    }
  ]
}
        

Response Details

CreateBuildWithManagedContainerResponse
Result Properties
BuildId String

The guid string build ID. Must be unique for every build.

BuildName String

The build name.

ContainerFlavor ContainerFlavor

The flavor of container of the build.

CreationTime DateTime

The time the build was created in UTC.

GameAssetReferences List<AssetReference>

The game assets for the build.

GameCertificateReferences List<GameCertificateReference>

The game certificates for the build.

Metadata Dict<String, String>

The metadata of the build.

MultiplayerServerCountPerVm (required) int32

The number of multiplayer servers to host on a single VM of the build.

Ports List<Port>

The ports the build is mapped on.

RegionConfigurations List<BuildRegion>

The region configuration for the build.

StartMultiplayerServerCommand String

The command to run when the multiplayer server has been allocated, including any arguments.

VmSize AzureVmSize

The VM size the build was created on.

Sample Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
  "code": 200,
  "status": "OK",
  "data": {
    "StartMultiplayerServerCommand": "C:\\Assets\\gameserver.exe -startserver",
    "BuildId": "21781fa8-096d-4d9c-b699-75433d579285",
    "BuildName": "GameBuildName",
    "CreationTime": "2014-04-07T09:04:28Z",
    "Metadata": {
      "MetadataKey": "MetadataValue"
    },
    "VmSize": "Standard_D2_v2",
    "ContainerFlavor": "ManagedWindowsServerCore",
    "Ports": [
      {
        "Name": "PortName",
        "Num": 1243,
        "Protocol": "TCP"
      }
    ],
    "RegionConfigurations": [
      {
        "Region": "EastUs",
        "Status": "Initializing",
        "MaxServers": 10,
        "StandbyServers": 5
      },
      {
        "Region": "WestUs",
        "Status": "Succeeded",
        "MaxServers": 12,
        "StandbyServers": 8
      },
      {
        "Region": "NorthEurope",
        "Status": "Unhealthy",
        "MaxServers": 7,
        "StandbyServers": 3
      }
    ],
    "GameAssetReferences": [
      {
        "FileName": "gameserver.zip",
        "MountPath": "C:\\Asset\\"
      }
    ],
    "GameCertificateReferences": [
      {
        "Name": "CertName",
        "GsdkAlias": "CertGsdkAlias"
      }
    ],
    "MultiplayerServerCountPerVm": 10
  }
}

Authentication

EntityToken

Possible Error Codes

Name Code
MultiplayerServerBadRequest 1382
MultiplayerServerConflict 1386
MultiplayerServerForbidden 1384
MultiplayerServerInternalServerError 1387
MultiplayerServerUnauthorized 1383