Create a data center

post

https://{hostname}/config-gtm/v1/domains/{domainName}/datacenters

This operation creates a specific data center.

Path Params

domainName

string

required

The full GTM domain name.

Query Params

accountSwitchKey

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Body Params

city

string | null

The name of the city where the data center is located.

cloneOf

integer | null

Identifies the data center's datacenterId of which this data center is a clone. A data center clone is just like any other data center except that it inherits its geographic attributes continent, country, stateOrProvince, city, latitude, and longitude from the data center of which it's a clone.

cloudServerTargeting

boolean

Balances load between two or more servers in a cloud environment. Either true if cloud server targeting is enabled or false if not.

continent

string | null

enum

A two-letter code that specifies the continent where the data center maps to. If omitted, GTM populates this data. Either AF, AS, EU, NA, OC, OT, or SA.

Allowed:

country

string | null

A two-letter ISO 3166 country code that specifies the country where the data center maps to.

defaultLoadObject

object

Specifies the load reporting interface between you and the GTM system. A load object is a file that provides real-time information about the current load, maximum allowable load, and target load on each resource. This default load object is intended to be shared. Individual resources can specify useDefaultLoadObject to use it instead of specifying their own.

latitude

number

Specifies the geographical latitude of the data center's position. See also longitude within this object.

links

array of objects

A URL path that allows direct navigation to a data center.

links

longitude

number

Specifies the geographic longitude of the data center's position. See also latitude within this object.

nickname

string

length ≤ 256

A descriptive label for the data center.

stateOrProvince

string | null

Specifies a two-letter ISO 3166 country code for the state or province where the data center is located.

cloudServerHostHeaderOverride

boolean

v1.3 Balances load between two or more servers in a cloud environment. Either true if cloud server targeting is enabled or false if not.

scorePenalty

integer

v1.3 Influences the score for a data center. Giving a positive penalty increases the score and drives traffic away from the data center. Giving a negative penalty reduces the score and draws in more traffic that would otherwise go elsewhere. As the score is measured in milliseconds of ping time, very small numbers like 1 or 2 have virtually no effect. Typically, penalties are given in the tens or hundreds. Note that scorePenalty applies only for properties that use performance load balancing.

cloud

object | null

v1.7 Identifies the cloud provider and region for this data center.

Response

201Successful response.