GET
/
dns
/
v2
/
zones
/
{zoneName}
/
{rrsetName}
/
{rrsetType}
Get RRset
curl --request GET \
  --url https://api.gcore.com/dns/v2/zones/{zoneName}/{rrsetName}/{rrsetType} \
  --header 'Authorization: <api-key>'
{
  "filter_set_id": 123,
  "meta": {},
  "name": "sub.example.com",
  "pickers": [
    {
      "limit": 123,
      "strict": true,
      "type": "geodns"
    }
  ],
  "resource_records": [
    {
      "content": [
        "1.1.1.1"
      ],
      "enabled": true,
      "id": 42,
      "meta": {
        "continents": [
          "europe",
          "asia"
        ],
        "countries": [
          "us",
          "gb",
          "lu"
        ],
        "ip": [
          "192.168.15.150/25",
          "2003:de:2016::/48"
        ]
      }
    }
  ],
  "ttl": 123,
  "type": "A",
  "updated_at": "2023-11-07T05:31:56Z",
  "warning": "<string>",
  "warnings": [
    {
      "key": "<string>",
      "message": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

​
zoneName
string
required
​
rrsetName
string
required
​
rrsetType
string
required

Response

OutputRRSet

​
name
string
required
Example:

"sub.example.com"

​
resource_records
object[]
required

List of resource record from rrset

​
type
enum<string>
required

RRSet type

Available options:
A,
AAAA,
NS,
CNAME,
MX,
TXT,
SRV,
SOA
​
filter_set_id
integer
​
meta
object

Meta information for rrset. Map with string key and any valid json as value, with valid keys

  1. failover (object, beta feature, might be changed in the future) can have fields 1.1. protocol (string, required, HTTP, TCP, UDP, ICMP) 1.2. port (int, required, 1-65535) 1.3. frequency (int, required, in seconds 10-3600) 1.4. timeout (int, required, in seconds 1-10), 1.5. method (string, only for protocol=HTTP) 1.6. command (string, bytes to be sent only for protocol=TCP/UDP) 1.7. url (string, only for protocol=HTTP) 1.8. tls (bool, only for protocol=HTTP) 1.9. regexp (string regex to match, only for non-ICMP) 1.10. http_status_code (int, only for protocol=HTTP) 1.11. host (string, only for protocol=HTTP)
  2. geodns_link (string) - name of the geodns link to use, if previously set, must re-send when updating or CDN integration will be removed for this RRSet
Example:
{}
​
pickers
object[]

Set of pickers

​
ttl
integer
​
updated_at
string<date-time>

Timestamp marshals/unmarshals date and time as timestamp in json

​
warning
string

Warning about some possible side effects without strictly disallowing operations on rrset readonly Deprecated: use Warnings instead

​
warnings
object[]

Warning about some possible side effects without strictly disallowing operations on rrset readonly