# Deploymentcontainerlocation

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

<figure><img src="/files/zBRG1672S8mx3es25ZNO" 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](/game-hosting/elements/deploymentenvironment/deploymentregion.md#api-example) inside the `containers` property, as children of the [DeploymentContainer](/game-hosting/elements/deploymentenvironment/deploymentcontainer.md) elements.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.i3d.net/game-hosting/elements/deploymentenvironment/deploymentcontainerlocation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.