Skip to content

DNS Zone

DNS zones hosted within a virtual network, used to resolve internal hostnames for nodes and services. Requires virtual-networks::read to view, virtual-networks::modify to manage.

Operations

List a network's DNS zones

Request

Requires virtual-networks::read permission.

Security
JWTAuthorizer
Path
networkNamestringrequired

Network name

domainNamestringrequired

Domain name

curl -i -X GET \
  'https://apidocs.trustgrid.io/_mock/v2/domain/{domainName}/network/{networkName}/dns-zone' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

OK

Bodyapplication/json
Array [
namestring

DNS zone name (e.g. "test.com")

descriptionstring
resolverstring

Custom resolver IP (if set)

networkNamestring

Virtual network this zone belongs to

domainNamestring

Domain this zone belongs to

orgIdstring

Organization ID

typestring

Object type discriminator

Example:"DNSZone"
]
Response
[
  {
    "name": "string",
    "description": "string",
    "resolver": "string",
    "networkName": "string",
    "domainName": "string",
    "orgId": "string",
    "type": "DNSZone"
  }
]