dtc:record:srv : DTC SRV Record object.¶
A DTC SRV object represents a DNS Traffic Control (DTC SRV) resource record. This resource record provides information on available services.
Note¶
Parameter dtc_server is required for object searches.
Object Reference¶
References to dtc:record:srv are object references.
The name part of the DTC SRV Record object reference has the following components:
The name of the DTC Server object with which the record is associated
The name of the DTC SRV record, service, protocol, and domain.
The port of the DTC SRV record.
The priority of the DTC SRV record.
The weight of the DTC SRV record.
The target of the DTC SRV record.
Example: dtc:record:srv/ZG5zLmJf5h:dtcserver/_http._tcp.test.com/7888/12/13/trgt.com
Restrictions¶
The object does not support the following operations:
Global search (searches via the search object)
Scheduling
CSV export
The object cannot be managed on Cloud Platform members.
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): dtc_server, name, port, priority, target, weight.
The following fields are required to create this object:
Field |
Notes |
---|---|
dtc_server |
|
port |
|
priority |
|
target |
|
weight |
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)
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.
dtc_server¶
- dtc_server¶
The name of the DTC Server object with which the DTC record is associated.
Type
String.
Create
The field is required on creation.
Search
The field is available for search via
‘=’ (exact equality)
Notes
The dtc_server is part of the base object.
The dtc_server cannot be updated.
name¶
- name¶
The name for an SRV record in unicode format.
Type
String.
Values with leading or trailing white space are not valid for this field.
Create
The default value is undefined.
Search
The field is available for search via
‘~=’ (regular expression)
‘=’ (exact equality)
‘:=’ (case insensitive search)
Notes
The name is part of the base object.
port¶
- port¶
The port of the SRV record. Valid values are from 0 to 65535 (inclusive), in 32-bit unsigned integer format.
Type
Unsigned integer.
Create
The field is required on creation.
Search
The field is available for search via
‘<=’ (less than search)
‘>=’ (greater than search)
‘=’ (exact equality)
Notes
The port is part of the base object.
priority¶
- priority¶
The priority of the SRV record. Valid values are from 0 to 65535 (inclusive), in 32-bit unsigned integer format.
Type
Unsigned integer.
Create
The field is required on creation.
Search
The field is available for search via
‘<=’ (less than search)
‘>=’ (greater than search)
‘=’ (exact equality)
Notes
The priority is part of the base object.
target¶
- target¶
The target of the SRV record in FQDN format. This value can be in unicode format.
Type
String.
Create
The field is required on creation.
Search
The field is available for search via
‘~=’ (regular expression)
‘=’ (exact equality)
‘:=’ (case insensitive search)
Notes
The target is part of the base object.
ttl¶
- ttl¶
The Time to Live (TTL) value.
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.
weight¶
- weight¶
The weight of the SRV record. Valid values are from 0 to 65535 (inclusive), in 32-bit unsigned integer format.
Type
Unsigned integer.
Create
The field is required on creation.
Search
The field is available for search via
‘<=’ (less than search)
‘>=’ (greater than search)
‘=’ (exact equality)
Notes
The weight is part of the base object.
Fields List¶
Field |
Type |
Req |
R/O |
Base |
Search |
---|---|---|---|---|---|
comment |
String |
N |
N |
N |
: = ~ |
disable |
Bool |
N |
N |
N |
N/A |
dtc_server |
String |
Y |
N |
Y |
= |
name |
String |
N |
N |
Y |
: = ~ |
port |
Unsigned int |
Y |
N |
Y |
< = > |
priority |
Unsigned int |
Y |
N |
Y |
< = > |
target |
String |
Y |
N |
Y |
: = ~ |
ttl |
Unsigned int |
N |
N |
N |
N/A |
use_ttl |
Bool |
N |
N |
N |
N/A |
weight |
Unsigned int |
Y |
N |
Y |
< = > |