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}
| Type | Description |
|---|---|
acgInvalid | The 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. |
contractMustBeSpecified | Returned 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. |
datacenterInUse | Returned 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. |
defaultDatacenterId | Returned 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. |
domainNameMismatch | Returned 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", ...}. |
domainTypeInvalid | Returned 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. |
domainTypeRequired | Returned when creating a domain. The JSON representation's type is one of the four valid domain types: failover-only, static, weighted, or basic. |
domainValidationError | Returned when input for any POST, PUT, or DELETE operation doesn't fully meet all product requirements. |
groupMustBeSpecified | Returned 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. |
invalidDNSName | Returned if a domain or property name isn't a valid DNS name. |
invalidEntity | Returned 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. |
malformedRequestEntity | Returned 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. |
mapNameMismatch | Returned 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", ...}. |
modifiedImmutableField | Returned if a client attempts to modify a member that is immutable. |
performancePlusDomainsCanNotBeCreated | Returned 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. |
propertyNameMismatch | Returned 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", ...}. |
regionMustBeAssigned | Returned 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. |
regionNumberMismatch | Returned 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, ...}. |
resourceNameMismatch | Returned 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", ...}). |
typeMismatch | Returned 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. |