This table provides details for many of the errors you may encounter and the HTTP status codes they share. Note that this isn't an exhaustive listing. Each problem object's type member corresponds to distinct error cases. Problem types reported in HTTP error responses follow this URI pattern, where the type value appends after the common prefix string:

https://problems.luna.akamaiapis.net/config-gtm/{version}/{type}
TypeDescription
acgInvalidThe request's domain representation contains an invalid acgId, or one the client does not have access to. You can leave this member blank. The server assigns an appropriate ID automatically.
contractMustBeSpecifiedReturned when a client has access to multiple contracts and attempts to create a domain but doesn't specify which contractId to tie the domain to.
datacenterInUseReturned when a client requests to Remove a data center, but that data center is in use by one or more properties or one or more resources. Reassign such properties or resources to use alternate data centers, at which point a subsequent request to DELETE is allowed and processed.
defaultDatacenterIdReturned when creating a CIDR map. In the JSON request, check that the datacenterId member in the defaultDatacenter object is blank. The server assigns the datacenterId.
domainNameMismatchReturned when a client PUTs a JSON representation to a domain resource of a name, for example /domains/mydomain.akadns.net, but the JSON's name member doesn't match that resource name, for example {"name": "myotherdomain.akadns.net", ...}.
domainTypeInvalidReturned when creating a domain type that's not permitted due to contractual restrictions. For instance, if you purchased Weighted Load Balancing, only weighted and failover-only domains are allowed.
domainTypeRequiredReturned when creating a domain. The JSON representation's type is one of the four valid domain types: failover-only, static, weighted, or basic.
domainValidationErrorReturned when input for any POST, PUT, or DELETE operation doesn't fully meet all product requirements.
groupMustBeSpecifiedReturned when a client has access to multiple groups and attempts to create a domain but doesn't specify which groupId to tie the domain to.
invalidDNSNameReturned if a domain or property name isn't a valid DNS name.
invalidEntityReturned when the request entity failed validation of one form or another. The response entity's detail member contains a message describing what failed validation, and in most cases gives a hint on how to correct the problematic value.
malformedRequestEntityReturned when the server couldn't parse the JSON entity sent by the client. The response entity's detail member contains the message returned from the JSON parsing library, but it may not contain enough information on what is wrong. The best course of action is for the client to validate the JSON payload using the appropriate JSON schema to identify the problem.
mapNameMismatchReturned when a client PUTs a JSON representation to a geographic map or CIDR map resource of a name, for example, /geographic-maps/mymap, but the JSON's name member doesn't match that resource name, for example {"name": "myothermap", ...}.
modifiedImmutableFieldReturned if a client attempts to modify a member that is immutable.
performancePlusDomainsCanNotBeCreatedReturned when creating a domain with a type of full. You can't create this type of domain with this API. Contact Akamai customer support for assistance in creating such domains.
propertyNameMismatchReturned when a client PUTs a JSON representation to a property resource of a name, for example, /properties/foo, but the JSON's name member doesn't match that resource name, for example, {"name": "baz", ...}.
regionMustBeAssignedReturned when a client POSTs a JSON representation to Create a data center, but the JSON's datacenterId isn't blank. This member needs to be blank, as a datacenterId is assigned by the server.
regionNumberMismatchReturned when a client PUTs a JSON representation to a data center resource of a datacenterId, for example /datacenters/3131, but the JSON's datacenterId member doesn't match that resource's ID, for example {"datacenterId": 3231, ...}.
resourceNameMismatchReturned when a client PUTs a JSON representation to a resource resource of a name (for example, /resources/cpu), but the JSON's name member doesn't match that resource's name (for example, {"name": "disk", ...}).
typeMismatchReturned if a query string can't be parsed into the expected type. An example of this would be when a member requires an integer, but it contains alphabetic characters instead. The response entity's invalidValue member contains the value that couldn't be parsed.