template

Template management commands for NDCLI. Templates are collections of snippets that define firewall configurations. Templates are assigned to OUs, and all devices in that OU receive the template’s configuration.

Commands

Command	Description
template list	List templates
template describe	Show template details
template create	Create a new template
template update	Update a template
template delete	Delete a template
template add-snippet	Add a snippet to a template
template remove-snippet	Remove a snippet from a template

---

template list

List templates in your organization.

ndcli template list [flags]

Flags

Flag	Type	Default	Description
--created-after	string		Filter by created date
--created-before	string		Filter by created date
--updated-after	string		Filter by updated date
--updated-before	string		Filter by updated date
--sort-by	string	name:asc	Sort field and direction
--page	int	1	Page number
--per-page	int	30	Items per page

Date Filter Formats

Date filters accept:

• Relative: 30m, 2h, 7d, 2w (minutes, hours, days, weeks ago)
• ISO 8601: 2024-01-15T10:30:00Z

Examples

ndcli template list

ndcli template list --updated-after 7d

ndcli template list --sort-by created_at:desc

---

template describe

Show detailed information about a template including its snippets.

ndcli template describe [name]

Arguments

Argument	Required	Description
name	Yes	Template name

Output

Shows:

• Template name and description
• Creation and update timestamps
• List of assigned snippets with their types and priorities

Examples

ndcli template describe base-config
ndcli template describe production-firewall -f json

---

template create

Create a new template.

ndcli template create [name] [flags]

Arguments

Argument	Required	Description
name	Yes	Template name

Flags

Flag	Type	Description
--description	string	Template description

Examples

ndcli template create base-firewall

ndcli template create production-config \
  --description "Production firewall baseline configuration"

---

template update

Update an existing template’s name or description.

ndcli template update [name] [flags]

Arguments

Argument	Required	Description
name	Yes	Current template name

Flags

Flag	Type	Description
--name	string	New template name
--description	string	New description

Examples

ndcli template update base-config --description "Updated baseline"

ndcli template update old-name --name new-name

ndcli template update legacy-config \
  --name modern-config \
  --description "Modernized firewall configuration"

---

template delete

Delete a template.

ndcli template delete [name]

Arguments

Argument	Required	Description
name	Yes	Template name to delete

Examples

ndcli template delete deprecated-template

Caution

Before deleting, ensure no OUs are using this template. Deleting a template assigned to OUs will affect device configurations.

---

template add-snippet

Add a snippet to a template. Snippets are configuration blocks that make up the template.

ndcli template add-snippet [template] [snippet]

Arguments

Argument	Required	Description
template	Yes	Template name
snippet	Yes	Snippet name to add

Examples

ndcli template add-snippet production-config admin-users
ndcli template add-snippet production-config firewall-rules

Notes

• The snippet must exist before adding it to a template
• A snippet can be added to multiple templates
• Snippet order is determined by snippet priority

---

template remove-snippet

Remove a snippet from a template.

ndcli template remove-snippet [template] [snippet]

Arguments

Argument	Required	Description
template	Yes	Template name
snippet	Yes	Snippet name to remove

Examples

ndcli template remove-snippet staging-config old-rules

Notes

• This only removes the snippet from the template
• The snippet itself is not deleted and remains available