Create Zone

Connects user to an existing zone. User must be a member of the group that has access to the zone. Connection info is optional, if no info is provided the default VinylDNS connections will be used.

HTTP REQUEST

POST /zones

HTTP REQUEST PARAMS

Zone fields - adminGroupId, name, and email are required. Refer to zone model.

EXAMPLE HTTP REQUEST

{
  "adminGroupId": "9b22b686-54bc-47fb-a8f8-cdc48e6d04ae",
  "name": "dummy.",
  "email": "test@example.com"
}

HTTP RESPONSE TYPES

Code description
202 Accepted - The zone change is queued and is returned in the response body
400 Bad Request - Connection failed, or group did not have access to the zone
401 Unauthorized - The authentication information provided is invalid. Typically the request was not signed properly, or the access key and secret used to sign the request are incorrect
403 Forbidden - the user does not have the access required to perform the action
409 Conflict - Zone already connected to

HTTP RESPONSE ATTRIBUTES

name type description
status string Status of zone change
zone map Refer to zone model
created string The timestamp (UTC) the change was initiated
changeType string Type of change requested (Create, Update, Sync, Delete); in this case Create
userId string The user id that initiated the change
id string The ID of the change. This is not the ID of the zone

EXAMPLE RESPONSE

{
  "status": "Pending",
  "zone": {
    "status": "Pending",
    "account": "test_group",
    "name": "488e6063-7832-40f6-87d3-87dae50c690a.",
    "created": "2016-12-28T18:00:32Z",
    "adminGroupId": "test-group-id",
    "email": "test@test.com",
    "shared": false,
    "acl": {
      "rules": [

      ]
    },
    "id": "8ba20b72-cfdb-49d3-9216-9100aeaee7fc"
  },
  "created": "2016-12-28T18:00:32Z",
  "changeType": "Create",
  "userId": "vinyl",
  "id": "dd449c27-bed5-4cd5-95e6-4c54fb20d930"
}