---
updatedAt: 2026-05-26T22:12:05.000Z
agentTools:
  siteIndex: https://techdocs.akamai.com/llms.txt
  projectIndex: https://techdocs.akamai.com/gtm/llms.txt
---

# Remove a data center

Remove a data center: This operation removes a data center. You can only remove a data center when no properties or resources are assigned to it.

# OpenAPI definition

```json
{
  "externalDocs": {
    "description": "See documentation for Akamai's Global Traffic Management API",
    "url": "https://techdocs.akamai.com/gtm/reference"
  },
  "info": {
    "license": {
      "name": "Apache 2.0",
      "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
    },
    "title": "Data centers",
    "version": "v1"
  },
  "openapi": "3.0.0",
  "paths": {
    "/domains/{domainName}/datacenters/{datacenterId}": {
      "delete": {
        "description": "Remove a data center: This operation removes a data center. You can only remove a data center when no properties or resources are assigned to it.",
        "externalDocs": {
          "description": "See documentation for this operation in Akamai's Global Traffic Management API",
          "url": "https://techdocs.akamai.com/gtm/reference/delete-datacenter"
        },
        "operationId": "delete-datacenter",
        "parameters": [
          {
            "description": "For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).",
            "in": "query",
            "name": "accountSwitchKey",
            "required": false,
            "schema": {
              "example": "1-5C0YLB:1-8BYUX",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "datacenter-vnd-config-gtm.v1.8+json": {
                "example": {
                  "resource": null,
                  "status": {
                    "changeId": "66c7ff0b-4b9e-41cc-9fd0-34d4f75c2484",
                    "links": [
                      {
                        "href": "/config-gtm/v1/domains/example.akadns.net/status/current",
                        "rel": "self"
                      }
                    ],
                    "message": "Change Pending",
                    "passingValidation": true,
                    "propagationStatus": "PENDING",
                    "propagationStatusDate": "2014-04-03T21:18:01.000+0000"
                  }
                },
                "schema": {
                  "additionalProperties": true,
                  "properties": {
                    "resource": {
                      "allOf": [
                        {
                          "allOf": [
                            {
                              "allOf": [
                                {
                                  "allOf": [
                                    {
                                      "allOf": [
                                        {
                                          "allOf": [
                                            {
                                              "allOf": [
                                                {
                                                  "allOf": [
                                                    {
                                                      "additionalProperties": true,
                                                      "description": "The data centers in the GTM domain.",
                                                      "properties": {
                                                        "city": {
                                                          "description": "The name of the city where the data center is located.",
                                                          "nullable": true,
                                                          "type": "string"
                                                        },
                                                        "cloneOf": {
                                                          "description": "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.",
                                                          "nullable": true,
                                                          "type": "integer"
                                                        },
                                                        "cloudServerTargeting": {
                                                          "description": "Whether cloud server targeting is enabled to balance load between two or more servers in a cloud environment.",
                                                          "type": "boolean"
                                                        },
                                                        "continent": {
                                                          "description": "A two-letter code that specifies the continent where the data center maps to. If omitted, GTM populates this data. Possible values are: `AF`, `AS`, `EU`, `NA`, `OC`, `OT`, or `SA`.",
                                                          "enum": [
                                                            "AF",
                                                            "AS",
                                                            "EU",
                                                            "NA",
                                                            "OC",
                                                            "OT",
                                                            "SA"
                                                          ],
                                                          "maxLength": 2,
                                                          "nullable": true,
                                                          "type": "string"
                                                        },
                                                        "country": {
                                                          "description": "A two-letter [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) country code that specifies the country where the data center maps to.",
                                                          "maxLength": 2,
                                                          "nullable": true,
                                                          "type": "string"
                                                        },
                                                        "datacenterId": {
                                                          "description": "__Read-only__ A unique identifier for an existing data center in the domain.",
                                                          "readOnly": true,
                                                          "type": "integer"
                                                        },
                                                        "defaultLoadObject": {
                                                          "additionalProperties": false,
                                                          "description": "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.",
                                                          "properties": {
                                                            "loadObject": {
                                                              "description": "Specifies the load object that GTM requests. A load object is a file that provides real-time information about the current load, maximum allowable load, and target load on each resource. The value cannot begin with a `:` character, and is limited to a maximum of 256 characters.",
                                                              "maxLength": 256,
                                                              "nullable": true,
                                                              "pattern": "^(?!:).*$",
                                                              "type": "string"
                                                            },
                                                            "loadObjectPort": {
                                                              "description": "Specifies the TCP port to connect to when requesting the load object. A value of `0` means to use the default port, equivalent to either `80` or `443`.",
                                                              "maximum": 65535,
                                                              "minimum": 0,
                                                              "type": "integer"
                                                            },
                                                            "loadServers": {
                                                              "description": "Specifies a list of servers to request the load object from. 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](https://tools.ietf.org/html/rfc1918) addresses.",
                                                              "items": {
                                                                "maxLength": 256,
                                                                "type": "string"
                                                              },
                                                              "nullable": true,
                                                              "type": "array"
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "latitude": {
                                                          "description": "Specifies the geographical latitude of the data center's position. See also `longitude` within this object.",
                                                          "type": "number"
                                                        },
                                                        "links": {
                                                          "description": "A URL path that allows direct navigation to a data center.",
                                                          "items": {
                                                            "additionalProperties": false,
                                                            "description": "Lists navigable URLs to resources.",
                                                            "properties": {
                                                              "href": {
                                                                "description": "Provides a hypermedia link to the complete URL that uniquely defines a resource.",
                                                                "type": "string"
                                                              },
                                                              "rel": {
                                                                "description": "Indicates the link relationship of the object.",
                                                                "type": "string"
                                                              }
                                                            },
                                                            "type": "object",
                                                            "x-akamai": {
                                                              "file-path": "schemas/link.yaml"
                                                            }
                                                          },
                                                          "type": "array"
                                                        },
                                                        "longitude": {
                                                          "description": "Specifies the geographic longitude of the data center's position. See also `latitude` within this object.",
                                                          "type": "number"
                                                        },
                                                        "nickname": {
                                                          "description": "A descriptive label for the data center.",
                                                          "maxLength": 256,
                                                          "type": "string"
                                                        },
                                                        "stateOrProvince": {
                                                          "description": "Specifies a two-letter [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) country code for the state or province where the data center is located.",
                                                          "nullable": true,
                                                          "type": "string"
                                                        },
                                                        "virtual": {
                                                          "description": "__Read-only__ Whether the data center is virtual. `true` when no cloud provider or physical region is associated with the data center. `false` when a cloud provider or physical region is set.",
                                                          "readOnly": true,
                                                          "type": "boolean"
                                                        }
                                                      },
                                                      "type": "object",
                                                      "x-akamai": {
                                                        "file-path": "schemas/datacenter-vnd-config-gtm.v1.0.yaml"
                                                      }
                                                    },
                                                    {
                                                      "description": "The data centers in the GTM domain.",
                                                      "type": "object"
                                                    }
                                                  ],
                                                  "title": "datacenter v1.1",
                                                  "x-akamai": {
                                                    "file-path": "schemas/datacenter-vnd-config-gtm.v1.1.yaml"
                                                  }
                                                },
                                                {
                                                  "description": "The data centers in the GTM domain.",
                                                  "type": "object"
                                                }
                                              ],
                                              "title": "datacenter v1.2",
                                              "x-akamai": {
                                                "file-path": "schemas/datacenter-vnd-config-gtm.v1.2.yaml"
                                              }
                                            },
                                            {
                                              "additionalProperties": true,
                                              "description": "The data centers in the GTM domain.",
                                              "properties": {
                                                "cloudServerHostHeaderOverride": {
                                                  "description": "__v1.3__ Whether the host header sent during liveness tests is overridden with the cloud server's host name. Requires `cloudServerTargeting` to be enabled.",
                                                  "type": "boolean",
                                                  "x-akamai": {
                                                    "labels": [
                                                      "v1.3"
                                                    ]
                                                  }
                                                },
                                                "scorePenalty": {
                                                  "description": "__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.",
                                                  "type": "integer",
                                                  "x-akamai": {
                                                    "labels": [
                                                      "v1.3"
                                                    ]
                                                  }
                                                }
                                              },
                                              "type": "object"
                                            }
                                          ],
                                          "title": "datacenter v1.3",
                                          "x-akamai": {
                                            "file-path": "schemas/datacenter-vnd-config-gtm.v1.3.yaml"
                                          }
                                        },
                                        {
                                          "description": "The data centers in the GTM domain.",
                                          "type": "object"
                                        }
                                      ],
                                      "title": "datacenter v1.4",
                                      "x-akamai": {
                                        "file-path": "schemas/datacenter-vnd-config-gtm.v1.4.yaml"
                                      }
                                    },
                                    {
                                      "description": "The data centers in the GTM domain.",
                                      "type": "object"
                                    }
                                  ],
                                  "title": "datacenter v1.5",
                                  "x-akamai": {
                                    "file-path": "schemas/datacenter-vnd-config-gtm.v1.5.yaml"
                                  }
                                },
                                {
                                  "description": "The data centers in the GTM domain.",
                                  "type": "object"
                                }
                              ],
                              "title": "datacenter v1.6",
                              "x-akamai": {
                                "file-path": "schemas/datacenter-vnd-config-gtm.v1.6.yaml"
                              }
                            },
                            {
                              "additionalProperties": true,
                              "description": "The data centers in the GTM domain.",
                              "properties": {
                                "cloud": {
                                  "additionalProperties": false,
                                  "description": "__v1.7__ Identifies the cloud provider and region for this data center.",
                                  "nullable": true,
                                  "properties": {
                                    "provider": {
                                      "description": "The cloud provider for this data center.",
                                      "type": "string"
                                    },
                                    "regionId": {
                                      "description": "The cloud region identifier for this data center.",
                                      "type": "string"
                                    }
                                  },
                                  "type": "object",
                                  "x-akamai": {
                                    "labels": [
                                      "v1.7"
                                    ]
                                  }
                                }
                              },
                              "type": "object"
                            }
                          ],
                          "title": "datacenter v1.7",
                          "x-akamai": {
                            "file-path": "schemas/datacenter-vnd-config-gtm.v1.7.yaml"
                          }
                        },
                        {
                          "description": "The data centers in the GTM domain.",
                          "type": "object"
                        }
                      ],
                      "title": "datacenter v1.8",
                      "x-akamai": {
                        "file-path": "schemas/datacenter-vnd-config-gtm.v1.8.yaml"
                      }
                    },
                    "status": {
                      "additionalProperties": false,
                      "description": "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](ref:get-status-current) operation, which returns information about the current condition of the change in the domain's activation.",
                      "properties": {
                        "changeId": {
                          "description": "__Read-only__ A unique identifier generated when a change occurs to the domain.",
                          "maxLength": 36,
                          "minLength": 36,
                          "readOnly": true,
                          "type": "string"
                        },
                        "links": {
                          "description": "Specifies the URL path that allows direct navigation to the domain.",
                          "items": {
                            "additionalProperties": false,
                            "description": "Lists navigable URLs to resources.",
                            "properties": {
                              "href": {
                                "description": "Provides a hypermedia link to the complete URL that uniquely defines a resource.",
                                "type": "string"
                              },
                              "rel": {
                                "description": "Indicates the link relationship of the object.",
                                "type": "string"
                              }
                            },
                            "type": "object",
                            "x-akamai": {
                              "file-path": "schemas/link.yaml"
                            }
                          },
                          "type": "array"
                        },
                        "message": {
                          "description": "__Read-only__ A notification generated when a change occurs to the domain. The maximum length is 4000 characters.",
                          "maxLength": 4000,
                          "readOnly": true,
                          "type": "string"
                        },
                        "passingValidation": {
                          "description": "__Read-only__ Indicates if the domain validates.",
                          "readOnly": true,
                          "type": "boolean"
                        },
                        "propagationStatus": {
                          "description": "Tracks the status of the domain's propagation state. Possible values are: `PENDING`, `COMPLETE`, or `DENIED`. A `DENIED` value indicates that the domain configuration is invalid, and doesn't propagate until the validation errors are resolved.",
                          "enum": [
                            "PENDING",
                            "COMPLETE",
                            "DENIED"
                          ],
                          "maxLength": 20,
                          "type": "string"
                        },
                        "propagationStatusDate": {
                          "description": "__Read-only__ An ISO 8601 timestamp indicating when a change occurs to the domain.",
                          "format": "date-time",
                          "readOnly": true,
                          "type": "string"
                        }
                      },
                      "type": "object",
                      "x-akamai": {
                        "file-path": "schemas/status.yaml"
                      }
                    }
                  },
                  "type": "object",
                  "x-akamai": {
                    "file-path": "schemas/update-datacenter-response-v1.8.yaml"
                  }
                }
              }
            },
            "description": "Successful response."
          }
        },
        "summary": "Remove a data center",
        "tags": [
          "Data centers"
        ]
      },
      "parameters": [
        {
          "description": "Numeric `id` of the data center.",
          "in": "path",
          "name": "datacenterId",
          "required": true,
          "schema": {
            "example": 1,
            "type": "integer"
          },
          "x-akamai": {
            "file-path": "parameters/datacenter-id-path.yaml"
          }
        },
        {
          "description": "The full GTM domain name.",
          "in": "path",
          "name": "domainName",
          "required": true,
          "schema": {
            "example": "example.akadns.net",
            "type": "string"
          },
          "x-akamai": {
            "file-path": "parameters/domain-name-path.yaml"
          }
        }
      ],
      "x-akamai": {
        "file-path": "paths/data-center.yaml",
        "path-info": "/domains/{domainName}/datacenters/{datacenterId}"
      }
    }
  },
  "servers": [
    {
      "url": "https://{hostname}/config-gtm/v1"
    }
  ],
  "x-akamai": {
    "auth-type": "EDGE_GRID",
    "file-path": "08-data-centers.yaml"
  },
  "x-readme": {
    "explorer-enabled": false,
    "samples-languages": [
      "curl",
      "python",
      "node"
    ]
  }
}
```

# Sibling pages

* [Create a data center](https://techdocs.akamai.com/gtm/reference/post-datacenter.md)
* [List data centers](https://techdocs.akamai.com/gtm/reference/get-datacenters.md)
* [Create an IPv4 data center for ip-version-selector](https://techdocs.akamai.com/gtm/reference/post-datacenter-for-ipv.md)
* [Create an IPv6 data center for ip-version-selector](https://techdocs.akamai.com/gtm/reference/post-datacenter-for-ipv6.md)
* [Create a default data center](https://techdocs.akamai.com/gtm/reference/post-default-datacenter-for-maps.md)
* [Get a data center](https://techdocs.akamai.com/gtm/reference/get-datacenter.md)
* [Update a data center](https://techdocs.akamai.com/gtm/reference/put-datacenter.md)