Create a default data center

post https://{hostname}/config-gtm/v1/domains/{domainName}/datacenters/default-datacenter-for-maps

This operation creates a data center for use by the map-type properties CIDR, Geographic or AS mapping as the default data center.

Response

Response body

object

resource

object | null

Contains information about the resources in the GTM domain.

aggregationType

string

required

length ≤ 15

Specifies how GTM handles different load numbers when multiple load servers are used for a data center or property. Either sum, median, or latest. For test time load feedback, consider median. (Akamai conducts tests from multiple locations, so you can ignore outlying values.) For load feedback with manual targets or dynamic targets, consider latest because all load servers normally report similar numbers.

sum median latest

comments

string | null

Provides information about the purpose of the property.

constrainedProperty

string | null

Specifies the name of the property that this resource constrains, or ** to constrain all properties.

decayRate

number | null

0 to 1

For internal use only. Unless Akamai indicates otherwise, omit the value or set it to null.

description

string | null

A descriptive note to help you track what the resource constrains. For example, aggregate bandwidth for all properties. A maximum of 256 characters.

hostHeader

string | null

Optionally specifies the host header used when fetching the load object.

leaderString

string | null

Specifies the text that comes before the loadObject. GTM assumes that the current load is the first number to appear after this text, minus any white space. The value is a maximum of 256 characters. The default is null. For example, suppose your loadObject file contains, This is a load object. TheLoadIs:497. This is the end of the load object. Then GTM reads the current load as 497 if the leaderString is set to TheLoadIs.

leastSquaresDecay

number | null

0 to 1

For internal use only. Unless Akamai indicates otherwise, omit the value or set it to null.

links

array of objects

Specifies the URL path that allows direct navigation to the resource.

links

object

href

string

Provides a hypermedia link to the complete URL that uniquely defines a resource.

rel

string

Indicates the link relationship of the object.

loadImbalancePercentage

number | null

0 to 1000000

Indicates the percent of load imbalance factor (LIF) for the domain. It lets GTM exceed the value configured for traffic distribution. For example, if the data center's traffic allocation is 25 percent and the LIF is 1.5, the demand can grow to 37.5 percent (25% × 1.5) before the load balancer starts shifting load away from it. If the LIF is 0, no load imbalance is allowed. However, internally, GTM adds one to the LIF to allow its use as a multiplier. The default LIF is 1.1, which is displayed as 10.0 percent. The value ranges from 0 to 1000000 percent.

maxUMultiplicativeIncrement

number | null

≥ 1

For internal use only. Unless Akamai indicates otherwise, omit the value or set it to null.

name

string

required

length ≤ 150

A descriptive label for the resource. A maximum 150 non-space characters.

resourceInstances

array of objects

Contains information about the resources that constrain the properties within the data center.

resourceInstances

object

datacenterId

integer

required

A unique identifier for an existing data center in the domain.

loadObject

string | null

Identifies the load object file used to report real-time information about the current load, maximum allowable load, and target load on each resource. The maximum permitted length is 256 characters. Learn more.

loadObjectPort

integer

0 to 65535

Specifies the TCP port of the loadObject. The value ranges from 0 to 65535. If the value is 0, the default port is either 80 or 443.

loadServers

array of strings | null

Specifies a list of servers from which to request the load object. The value needs to contain IPv4 or IPv6 addresses, or DNS names that contain A or AAAA records. If a DNS name has both A and AAAA records, then GTM picks one randomly. For IP addresses, don't use non-routable RFC 1918 addresses.

loadServers

useDefaultLoadObject

boolean

Indicates whether a default loadObject is used for the resources.

type

string

required

Indicates the kind of loadObject format used to determine the load on the resource. Either XML load object via HTTP, XML load object via HTTPS, Non-XML load object via HTTP, Non-XML load object via HTTPS, Download score, or Push API.

XML load object via HTTP XML load object via HTTPS Non-XML load object via HTTP Non-XML load object via HTTPS Download score Push API

upperBound

integer | null

An optional sanity check that specifies the maximum allowed value for any component of the load object. If the loadObject contains a number that exceeds this value, it rejects the entire load object as invalid and GTM continues to use the load values from the most recently acquired loadObject. To receive an alert when a load object is rejected, log in to Control Center, select Alerts from the Common Services category, then create a Load Object File Invalid or Cannot be Fetched alert. Learn more.

status

object

Contains information about the condition of the change in the domain's activation. Any change that returns a 200 series response and goes to propagationStatus PENDING, propagates within a few minutes. To query the activation status, run the Get current status operation, which returns information about the current condition of the change in the domain's activation.

changeId

string

length ≤ 36

Read-only A unique identifier generated when a change occurs to the domain. The maximum length is 36 characters.

links

array of objects

Specifies the URL path that allows direct navigation to the domain.

links

object

href

string

Provides a hypermedia link to the complete URL that uniquely defines a resource.

rel

string

Indicates the link relationship of the object.

message

string

length ≤ 4000

Read-only A notification generated when a change occurs to the domain. The maximum length is 4000 characters.

passingValidation

boolean

Read-only Indicates if the domain validates.

propagationStatus

string

length ≤ 20

Tracks the status of the domain's propagation state. Either PENDING, COMPLETE, or DENIED. A DENIED value indicates that the domain configuration is invalid, and doesn't propagate until the validation errors are resolved.

PENDING COMPLETE DENIED

propagationStatusDate

date-time

Read-only An ISO 8601 timestamp indicating when a change occurs to the domain.

Headers

object

Location

string

Language

Authentication

Remember to add your authentication credentials to run this code.

URL


xxxxxxxxxx
1
curl --request POST \
2
     --url https://hostname/config-gtm/v1/domains/domainName/datacenters/default-datacenter-for-maps \
3
     --header 'accept: application/json'


xxxxxxxxxx
42
}
1
{
2
  "resource": {
3
    "city": null,
4
    "cloneOf": null,
5
    "cloudServerHostHeaderOverride": false,
6
    "cloudServerTargeting": false,
7
    "continent": null,
8
    "country": null,
9
    "datacenterId": 5400,
10
    "defaultLoadObject": null,
11
    "latitude": 0,
12
    "links": [
13
      {
14
        "href": "/config-gtm/v1/domains/example.akadns.net/datacenters/5400",
15
        "rel": "self"
16
      }
17
    ],
18
    "longitude": 0,
19
    "nickname": "Default Datacenter",
20
    "pingInterval": null,
21
    "pingPacketSize": null,
22
    "scorePenalty": 0,
23
    "servermonitorLivenessCount": null,
24
    "servermonitorLoadCount": null,
25
    "servermonitorPool": null,

201Successful response.