# Deploymentcontainerlocation

The DeploymentContainerLocation element defines a cloud (dc) location to burst towards when your bare metal pool runs dry.

<figure><img src="https://3255620342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTxqXHcEUC6lhXmjD6wE0%2Fuploads%2FXTF1IvF3vzdcdBjx7rts%2FDeploymentConfigurationOverviewContLoc.png?alt=media&#x26;token=36290c68-1026-43e3-9da6-2f297e02f5d3" alt=""><figcaption></figcaption></figure>

Figure 1: Highlighting where the DeploymentContainerLocation elements belong in the overview.

## Usage

## Element structure

| Property                  | Value type | Required  | Description                                                                                                                                                                                                                                                            |
| ------------------------- | ---------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id                        | string     | Read-only | Unique identifier of this element                                                                                                                                                                                                                                      |
| cloudProviderId           | int        | Yes       | The cloud provider ID of this location                                                                                                                                                                                                                                 |
| dcLocationId              | int        | Yes       | The dcLocation ID (see [`/cloud/dcLocation`](https://www.i3d.net/docs/api/v3/game-publisher#/Cloud/getCloudDcLocations))                                                                                                                                               |
| primaryInstanceTypeName   | string     | Yes       | The primary instance type to use                                                                                                                                                                                                                                       |
| secondaryInstanceTypeName | string     | No        | The secondary instance type to use                                                                                                                                                                                                                                     |
| cpuPlatform               | string     | No        | The CPU platform to use for the given cloudProviderId. Get all possible values from [`/cloud/cpuPlatform`](https://www.i3d.net/docs/api/v3/game-publisher#/Cloud/getCloudCpuPlatforms). Note that this selector is currently only required for the GCP cloud platform) |
| markedForDeletion         | boolean    | Read-only | If set to true, the platform will gracefully remove all game servers and VMs in this cloud location. Afterwards this cloud location will really be deleted                                                                                                             |

Table 1: DeploymentContainerLocation element structure

## API example

DeploymentContainerLocation elements are not created separately, but are always [created and updated inside the DeploymentRegion element](https://docs.i3d.net/game-hosting/elements/deploymentregion#api-example) inside the `containers` property, as children of the [DeploymentContainer](https://docs.i3d.net/game-hosting/elements/deploymentenvironment/deploymentcontainer) elements.