bulkhost : Bulkhost object.¶
If you need to add a large number of hosts, you can have the Infoblox appliance add them as a group and automatically assign host names based on a range of IP addresses and name format applied to it. This group of hosts is referred to as a BulkHost. The Infoblox appliance uses the name space bulk-xx-xx-xx-xx for bulk host, so this name should not be used for CNAMEs and host aliases because doing so causes conflicts. Before adding a bulk host, make sure that no CNAMEs or host aliases uses this name.
Object Reference¶
References to bulkhost are object references.
The name part of the bulkhost object reference has the following components:
name of the zone associated with a bulkhost object.
prefix of the bulkhost object.
start IP address of the bulkhost object.
end IP address of the bulkhost object.
Example: bulkhost/ZG5zLm5ldHdvcmskMTEuMC4wLjAvOC8xMQ:zone.com/prefix/1.1.1.1/1.1.1.3
Restrictions¶
The object does not support the following operations:
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): comment, prefix.
The following fields are required to create this object:
Field |
Notes |
|---|---|
end_addr |
|
prefix |
|
start_addr |
|
zone |
cloud_info¶
- cloud_info¶
The cloud API related information.
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¶
The descriptive comment.
Type
String.
Create
The default value is empty.
Search
The field is available for search via
‘~=’ (regular expression)
‘=’ (exact equality)
‘:=’ (case insensitive search)
Notes
The comment is part of the base object.
disable¶
- disable¶
The disable flag of a DNS BulkHost record.
Type
Bool.
Create
The default value is False.
Search
The field is available for search via
‘=’ (exact equality)
dns_prefix¶
- dns_prefix¶
The prefix, in punycode format, for the bulk host.
Type
String.
Search
The field is not available for search.
Notes
The dns_prefix cannot be updated.
dns_prefix cannot be written.
end_addr¶
- end_addr¶
The last IP address in the address range for the bulk host.
Type
String.
Create
The field is required on creation.
Search
The field is available for search via
‘=’ (exact equality)
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_template¶
- name_template¶
The bulk host name template.
Type
String.
Create
The default value is empty.
Search
The field is available for search via
‘=’ (exact equality)
Notes
name_template is associated with the field use_name_template (see use flag).
network_view¶
- network_view¶
The network view associated with the bulk host view.
Type
String.
Search
The field is not available for search.
Notes
The network_view cannot be updated.
network_view cannot be written.
policy¶
- policy¶
The hostname policy for records under the bulk host parent zone.
Type
String.
Search
The field is not available for search.
Notes
The policy cannot be updated.
policy cannot be written.
prefix¶
- prefix¶
The prefix for the bulk host. The prefix is the name (or a series of characters) inserted at the beginning of each host name.
Type
String.
Create
The field is required on creation.
Search
The field is available for search via
‘~=’ (regular expression)
‘=’ (exact equality)
Notes
The prefix is part of the base object.
reverse¶
- reverse¶
The reverse flag of the BulkHost record.
Type
Bool.
Create
The default value is True.
Search
The field is available for search via
‘=’ (exact equality)
start_addr¶
- start_addr¶
The first IP address in the address range for the bulk host.
Type
String.
Create
The field is required on creation.
Search
The field is available for search via
‘=’ (exact equality)
template_format¶
- template_format¶
The bulk host name template format.
Type
String.
Search
The field is not available for search.
Notes
The template_format cannot be updated.
template_format cannot be written.
ttl¶
- ttl¶
The Time to Live (TTL) value.
Type
Unsigned integer.
Create
The default value is empty.
Search
The field is available for search via
‘=’ (exact equality)
Notes
use_name_template¶
- use_name_template¶
Use flag for: name_template
Type
Bool.
Create
The default value is False.
Search
The field is available for search via
‘=’ (exact equality)
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 view for the bulk host.
Type
String.
Create
The default value is undefined.
Search
The field is available for search via
‘~=’ (regular expression)
‘=’ (exact equality)
zone¶
- zone¶
The zone name.
Type
String.
Create
The field is required on creation.
Search
The field is available for search via
‘~=’ (regular expression)
‘=’ (exact equality)
Fields List¶
Field |
Type |
Req |
R/O |
Base |
Search |
|---|---|---|---|---|---|
cloud_info |
struct |
N |
Y |
N |
N/A |
comment |
String |
N |
N |
Y |
: = ~ |
disable |
Bool |
N |
N |
N |
= |
dns_prefix |
String |
N |
Y |
N |
N/A |
end_addr |
String |
Y |
N |
N |
= |
extattrs |
Extattr |
N |
N |
N |
ext |
last_queried |
Timestamp |
N |
Y |
N |
N/A |
name_template |
String |
N |
N |
N |
= |
network_view |
String |
N |
Y |
N |
N/A |
policy |
String |
N |
Y |
N |
N/A |
prefix |
String |
Y |
N |
Y |
= ~ |
reverse |
Bool |
N |
N |
N |
= |
start_addr |
String |
Y |
N |
N |
= |
template_format |
String |
N |
Y |
N |
N/A |
ttl |
Unsigned int |
N |
N |
N |
= |
use_name_template |
Bool |
N |
N |
N |
= |
use_ttl |
Bool |
N |
N |
N |
N/A |
view |
String |
N |
N |
N |
= ~ |
zone |
String |
Y |
N |
N |
= ~ |
