Akamai APIs API Documentation
Create a zone
POST https://{{host}}/config-dns/v2/zones?contractId={{contractId}}&gid={{gid}}
Creates a new zone. Carefully review the documentation for which fields are relevant to the type of zone you're creating.
Body
PARAM
| Key | Datatype | Required | Description |
contractId
|
string | (Required) The contract to use for the new zone. | |
gid
|
string | (Required) The currently selected group ID to manage. | |
accountSwitchKey
|
string | (Optional) 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). |
HEADERS
| Key | Datatype | Required | Description |
Content-Type
|
string | ||
Accept
|
string |
RESPONSES
status Created
| {
"activationState": "ERROR",
"aliasCount": 1,
"comment": "Initial add",
"contractId": "C-0N7RAC71",
"lastActivationDate": "2021-01-03T12:00:00Z",
"lastModifiedBy": "szhang",
"lastModifiedDate": "2021-12-11T03:21:00Z",
"masters": [
"192.0.2.200",
"192.0.2.200"
],
"signAndServe": false,
"tsigKey": {
"algorithm": "hmac-sha512",
"name": "other.com.akamai.com.",
"secret": "Ok1qR5IW1ajVka5cHPEJQIXfLyx5V3PSkFBROAzOn21JumDq6nIpoj6H8rfj5Uo+Ok55ZWQ0Wgrf302fDscHLw=="
},
"type": "SECONDARY",
"versionId": "7949b2db-ac43-4773-a3ec-dc93202142fd",
"zone": "other.com"
} |
Curl
curl -X POST 'https://undefined/config-dns/v2/zones?contractId=&gid=?contractId=&gid=&accountSwitchKey=' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"comment":"Adding bodies of water","masters":["192.0.2.183","192.0.2.113"],"type":"SECONDARY","zone":"river.com"}'
ENDPOINTS