Get RecordSet

Gets a RecordSet in a specified zone.

HTTP REQUEST

GET /zones/{zoneId}/recordsets/{recordSetId}

HTTP RESPONSE TYPES

Code description
200 OK - The record set is returned
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
404 Not Found - The zone with the id specified was not found, or the record set with id was not found

HTTP RESPONSE ATTRIBUTES

The returned json object has all the fields from the RecordSet as well as an added accessLevel field

name type description
type string Type of record set
zoneId string The zone the record is stored in
name string The name of the record set
ttl integer The TTL of the record set in seconds
status string The status of the record set
created string The timestamp (UTC) the change was initiated
updated string The timestamp (UTC) the change was last updated
records array of record data Array of record data objects
id string The unique ID of the record set
account string DEPRECATED the ID of the account that created the record set
accessLevel string accessLevel that user has to record set based off acl rules and whether or not user is in Zone Admin Group
ownerGroupId string Record ownership assignment, if found, applicable if the recordset is in a shared zone
ownerGroupName string Name of assigned owner group, if found

EXAMPLE RESPONSE

{
  "type": "A",
  "zoneId": "2467dc05-68eb-4498-a9d5-78d24bb0893c",
  "name": "already-exists",
  "ttl": 38400,
  "status": "Active",
  "created": "2017-02-23T15:12:41Z",
  "updated": "2017-02-23T15:12:41Z",
  "records": [
    {
      "address": "6.6.6.1"
    }
  ],
  "id": "dd9c1120-0594-4e61-982e-8ddcbc8b2d21",
  "account": "9b22b686-54bc-47fb-a8f8-cdc48e6d04ae",
  "accessLevel": "Delete",
  "ownerGroupId": "f42385e4-5675-38c0-b42f-64105e743bfe",
  "ownerGroupName": "Shared Group"
}