---
title: "Retrieve a RecordAlias object."
method: GET
path: "/record:alias/{ref.ref_data}/**"
tags: ["record:alias"]
---

# Retrieve a RecordAlias object.

`GET /record:alias/{ref.ref_data}/**`

## Request

- Base URL: `https://csp.infoblox.com/wapi/v3`
- URL: `https://csp.infoblox.com/wapi/v3/record:alias/{ref.ref_data}/**`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/infoblox/apis/dns-data-web-api/docs/record:alias/:ref.ref_data/**/get.ts> (a function with typed inputs; its response is checked against the schema)

Use this method to retrieve the __RecordAlias__ object.

## Path parameters

- `ref.ref_data` string, required

## Query parameters

- `ref` string
- `_fields` string

## Response `200`

GET operation response

- V3RecordAlias: A __RecordAlias__ object (_dns/record_) represents a DNS ALIAS resource record in an authoritative zone. For creating a DNS ALIAS resource record, the following fields are required:<ul><li>_name_: The fully qualified domain name of the ALIAS record.</li><li>_target_name_: The fully qualified domain name of the target.</li><li>_target_type_: The DNS resource record type to resolve for _target_name_.</li></ul> The _name_, _target_name_, and _target_type_ fields can be modified while updating a DNS resource record.
  - `comment` string: Comment for the RecordAlias; maximum 1024 characters.
  - `creator` string: Creator for the RecordAlias. Note that changing creator from or to 'SYSTEM' value is not allowed.
  - `disable` boolean: Determines if the RecordAlias is disabled or not. False means that the RecordAlias is enabled.
  - `name` string, required: The name of the RecordAlias in FQDN format.
  - `ref` string: infoblox.ddi.wapi.objectref
  - `tags` object: The tags for the RecordAlias in JSON format.
  - `target_name` string, required: The fully qualified domain name of the target to resolve at query time.
  - `target_type` string, required: The type of DNS resource record to resolve for the target domain. Must be one of: A, AAAA, CAA, MX, NAPTR, PTR, SPF, SRV, TXT.
  - `ttl` integer: The Time To Live (TTL) value for the record. A 32-bit unsigned integer that represents the duration, in seconds, for which the RecordAlias is valid (cached). Zero indicates that the RecordAlias should not be cached.
  - `view` string: The name of the DNS view in which the RecordAlias resides. Example: "external".
  - `zone` string: The name of the zone in which the RecordAlias resides. Example: "zone.com". If a view is not specified when searching by zone, the default view is used.

---

[API](https://skmtc.dev/infoblox/apis/dns-data-web-api.md) - [All operations](https://skmtc.dev/infoblox/apis/dns-data-web-api/llms.txt) - [OpenAPI document](https://skmtc.dev/infoblox/apis/dns-data-web-api/revisions/b4b272e5590c?raw)