awsrte53taskgroup : AWS Route53 task group object.

An AWS Route53 task group is a collection of one or more tasks allowing you to specify various zone filters to retrieve DNS zone data from AWS Route53 service using specified AWS user credentials. Grouping these tasks together helps organize related groups of sync data, enable/disable these and manage the grid member these run on.

Object Reference

References to awsrte53taskgroup are object references.

The name part of the name server group object reference has the following components:

• Name of the AWS Route53 task group

Example: awsrte53taskgroup/ZG5zLmJpbmRfY25h:extdatagroup

Restrictions

The object does not support the following operations:

• 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): account_id, comment, disabled, name, sync_child_accounts, sync_status.

The following fields are required to create this object:

Field	Notes
aws_account_ids_file_token	See the field description for more information
consolidated_view	See the field description for more information
grid_member
name
network_view	See the field description for more information

account_id

account_id

The AWS Account ID associated with this task group.

Type

String.

Search

The field is available for search via

• ‘=’ (exact equality)

Notes

The account_id is part of the base object.

The account_id cannot be updated.

account_id cannot be written.

accounts_list

accounts_list

The AWS Account IDs list associated with this task group.

Type

String.

Search

The field is available for search via

• ‘=’ (exact equality)

Notes

The accounts_list cannot be updated.

accounts_list cannot be written.

aws_account_ids_file_token

aws_account_ids_file_token

The AWS account IDs file’s token.

Type

String.

Create

The aws_account_ids_file_token is required if multiple_accounts_sync_policy is set to UPLOAD_CHILDREN

Search

The field is available for search via

• ‘=’ (exact equality)

comment

comment

Comment for the task group; 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)

Notes

The comment is part of the base object.

consolidate_zones

consolidate_zones

Indicates if all zones need to be saved into a single view.

Type

Bool.

Create

The default value is False.

Search

The field is available for search via

• ‘=’ (exact equality)

Notes

The consolidate_zones cannot be updated.

consolidated_view

consolidated_view

The name of the DNS view for consolidating zones.

Type

String.

Values with leading or trailing white space are not valid for this field.

Create

The consolidated view is required if consolidate_zones is set and network_view_mapping_policy is DIRECT

Search

The field is available for search via

• ‘=’ (exact equality)

Notes

The consolidated_view cannot be updated.

disabled

disabled

Indicates if the task group is enabled or disabled.

Type

Bool.

Create

The default value is False.

Search

The field is available for search via

• ‘=’ (exact equality)

Notes

The disabled is part of the base object.

grid_member

grid_member

Member on which the tasks in this task group will be run.

Type

String.

Create

The field is required on creation.

Search

The field is available for search via

• ‘=’ (exact equality)

multiple_accounts_sync_policy

multiple_accounts_sync_policy

Discover all child accounts or Upload child account ids to discover..

Type

String.

Valid values are:

• DISCOVER_CHILDREN

• NONE

• UPLOAD_CHILDREN

Create

The default value is NONE.

Search

The field is available for search via

• ‘=’ (exact equality)

name

name

The name of this AWS Route53 sync task group.

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.

network_view

network_view

The name of the tenant’s network view.

Type

String.

Values with leading or trailing white space are not valid for this field.

Create

The network view required if network_view_mapping_policy is set to DIRECT

Search

The field is available for search via

• ‘=’ (exact equality)

Notes

The network_view cannot be updated.

network_view_mapping_policy

network_view_mapping_policy

The network view mapping policy.

Type

String.

Valid values are:

• AUTO_CREATE

• DIRECT

Create

The default value is AUTO_CREATE.

Search

The field is available for search via

• ‘=’ (exact equality)

Notes

The network_view_mapping_policy cannot be updated.

role_arn

role_arn

Role ARN for syncing child accounts; maximum 128 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)

sync_child_accounts

sync_child_accounts

Synchronizing child accounts is enabled or disabled.

Type

Bool.

Create

The default value is False.

Search

The field is available for search via

• ‘=’ (exact equality)

Notes

The sync_child_accounts is part of the base object.

sync_status

sync_status

Indicate the overall sync status of this task group.

Type

String.

Valid values are:

• ERROR

• NEW

• OK

• WARNING

Search

The field is available for search via

• ‘=’ (exact equality)

Notes

The sync_status is part of the base object.

The sync_status cannot be updated.

sync_status cannot be written.

task_list

task_list

List of AWS Route53 tasks in this group.

Type

A/An AWS Route53 task struct array.

Create

The default value is:

empty

Search

The field is not available for search.

Function Calls

task_control

This function performs action on a task. Current support is for RUN action.

This function does not support multiple object matches when called as part of an atomic insertion operation.

Input fields

action ( String. Valid values are: “RUN” ). This parameter is mandatory. The task control action to perform. Currently only start is supported.

cloud_dns_server_type ( String. Valid values are: “AWS”, “Azure” ). This parameter is mandatory. This field containes the name of the cloud provider.

task_name ( String. ). This parameter is mandatory. This field containes the name of the task to perform this action on.

Output fields

None

Fields List

Field	Type	Req	R/O	Base	Search
account_id	String	N	Y	Y	=
accounts_list	String	N	Y	N	=
aws_account_ids_file_token	String	Y*	N	N	=
comment	String	N	N	Y	: = ~
consolidate_zones	Bool	N	N	N	=
consolidated_view	String	Y*	N	N	=
disabled	Bool	N	N	Y	=
grid_member	String	Y	N	N	=
multiple_accounts_sync_policy	String	N	N	N	=
name	String	Y	N	Y	: = ~
network_view	String	Y*	N	N	=
network_view_mapping_policy	String	N	N	N	=
role_arn	String	N	N	N	: = ~
sync_child_accounts	Bool	N	N	Y	=
sync_status	String	N	Y	Y	=
task_list	[struct]	N	N	N	N/A

* Required in some cases, see detailed field description above.