record:unknown : DNS UNKNOWN record object.¶
An “RR of unknown type” is an RR whose RDATA format is not known to the DNS implementation at hand, and whose type is not an assigned QTYPE or Meta-TYPE as specified in 2929] nor within the range reserved in that section for assignment only to QTYPEs and Meta-TYPEs. The purpose of the Unknown resource record is to allow future DNS implementations to handle new RR types transparently. For further details see RFC-3597.
Object Reference¶
References to record:unknown are object references. The name part of a UNKNOWN record object reference has the following components:
Name of the record
Name of the view
Example: record:unknown/ZG5zLmhvc3RjkuMC4xLg:9.9.0.1/some.name.com/default
Fields¶
These fields are actual members of the object; thus, they can be requested by using _return_fields, if the fields are readable.
The basic version of the object contains the field(s): name, view.
The following fields are required to create this object:
Field |
Notes |
|---|---|
name |
|
record_type |
|
subfield_values |
cloud_info¶
- cloud_info¶
Structure containing all cloud API related information for this object.
Type
A/An Cloud Information struct.
Search
The field is not available for search.
Notes
The cloud_info cannot be updated.
cloud_info cannot be written.
comment¶
- comment¶
Comment for the record; maximum 256 characters.
Type
String.
Values with leading or trailing white space are not valid for this field.
Create
The default value is empty.
Search
The field is available for search via
‘~=’ (regular expression)
‘=’ (exact equality)
‘:=’ (case insensitive search)
creator¶
- creator¶
The record creator. Note that changing creator from or to ‘SYSTEM’ value is not allowed.
Type
String.
- Valid values are:
DYNAMIC
STATIC
SYSTEM
Create
The default value is STATIC.
Search
The field is available for search via
‘=’ (exact equality)
disable¶
- disable¶
Determines if the record is disabled or not. False means that the record is enabled.
Type
Bool.
Create
The default value is False.
Search
The field is not available for search.
display_rdata¶
- display_rdata¶
Standard textual representation of the RDATA.
Type
String.
Search
The field is available for search via
‘=’ (exact equality)
Notes
The display_rdata cannot be updated.
display_rdata cannot be written.
dns_name¶
- dns_name¶
The name of the unknown record in punycode format.
Type
String.
Values with leading or trailing white space are not valid for this field.
Search
The field is not available for search.
Notes
The dns_name cannot be updated.
dns_name cannot be written.
enable_host_name_policy¶
- enable_host_name_policy¶
Determines if host name policy is applicable for the record.
Type
Bool.
Create
The default value is False.
Search
The field is not available for search.
extattrs¶
- extattrs¶
Extensible attributes associated with the object.
For valid values for extensible attributes, see the following information.
Type
Extensible attributes.
This field allows +/- to be specified as part of the field name when updating the object, see the following information.
Create
The default value is empty.
Search
For how to search extensible attributes, see the following information.
last_queried¶
- last_queried¶
The time of the last DNS query in Epoch seconds format.
Type
Timestamp.
Search
The field is not available for search.
Notes
The last_queried cannot be updated.
last_queried cannot be written.
name¶
- name¶
The Unknown record name in FQDN format. This value can be in unicode format.
Type
String.
Values with leading or trailing white space are not valid for this field.
Create
The field is required on creation.
Search
The field is available for search via
‘~=’ (regular expression)
‘=’ (exact equality)
‘:=’ (case insensitive search)
Notes
The name is part of the base object.
policy¶
- policy¶
The host name policy for the record.
Type
String.
Search
The field is not available for search.
Notes
The policy cannot be updated.
policy cannot be written.
record_type¶
- record_type¶
Specifies type of unknown resource record.
Type
String.
Create
The field is required on creation.
Search
The field is available for search via
‘=’ (exact equality)
subfield_values¶
- subfield_values¶
The list of rdata subfield values of unknown resource record.
Type
A/An Unknown Record Rdata subfield value struct array.
Create
The field is required on creation.
Search
The field is available for search via
‘=’ (exact equality)
ttl¶
- ttl¶
The Time to Live (TTL) value for the record. A 32-bit unsigned integer that represents the duration, in seconds, for which the record is valid (cached). Zero indicates that the record should not be cached.
Type
Unsigned integer.
Create
The default value is empty.
Search
The field is not available for search.
Notes
use_ttl¶
- use_ttl¶
Use flag for: ttl
Type
Bool.
Create
The default value is False.
Search
The field is not available for search.
view¶
- view¶
The name of the DNS view in which the record resides. Example: “external”.
Type
String.
Values with leading or trailing white space are not valid for this field.
Create
The default value is The default DNS view.
Search
The field is available for search via
‘=’ (exact equality)
Notes
The view is part of the base object.
zone¶
- zone¶
The name of the zone in which the record resides. Example: “zone.com”. If a view is not specified when searching by zone, the default view is used.
Type
String.
Values with leading or trailing white space are not valid for this field.
Search
The field is available for search via
‘=’ (exact equality)
Notes
The zone cannot be updated.
zone cannot be written.
Fields List¶
Field |
Type |
Req |
R/O |
Base |
Search |
|---|---|---|---|---|---|
cloud_info |
struct |
N |
Y |
N |
N/A |
comment |
String |
N |
N |
N |
: = ~ |
creator |
String |
N |
N |
N |
= |
disable |
Bool |
N |
N |
N |
N/A |
display_rdata |
String |
N |
Y |
N |
= |
dns_name |
String |
N |
Y |
N |
N/A |
enable_host_name_policy |
Bool |
N |
N |
N |
N/A |
extattrs |
Extattr |
N |
N |
N |
ext |
last_queried |
Timestamp |
N |
Y |
N |
N/A |
name |
String |
Y |
N |
Y |
: = ~ |
policy |
String |
N |
Y |
N |
N/A |
record_type |
String |
Y |
N |
N |
= |
subfield_values |
[struct] |
Y |
N |
N |
= |
ttl |
Unsigned int |
N |
N |
N |
N/A |
use_ttl |
Bool |
N |
N |
N |
N/A |
view |
String |
N |
N |
Y |
= |
zone |
String |
N |
Y |
N |
= |
