ou

Organizational unit (OU) management commands for NDCLI. OUs allow you to organize devices into logical groups and assign templates to groups of devices.

Commands

Command	Description
ou list	List organizational units
ou describe	Show OU details
ou create	Create a new OU
ou delete	Delete an OU
ou rename	Rename an OU
ou device-list	List devices in an OU
ou add-device	Add a device to an OU
ou remove-device	Remove a device from an OU
ou template	Manage OU templates

---

ou list

List organizational units in your organization.

ndcli ou list [flags]

Flags

Flag	Type	Default	Description
--name	string		Filter by name (regex pattern)
--status	string	all	Filter by status: all, enabled
--created-after	string		Filter by created date
--created-before	string		Filter by created date
--sort-by	string	name	Sort field: name, device_count, created_at, updated_at
--sort-order	string	asc	Sort order: asc, desc
--page	int	1	Page number
--per-page	int	20	Items per page (1-100)

Examples

ndcli ou list

ndcli ou list --name "prod.*"

ndcli ou list --sort-by device_count --sort-order desc

ndcli ou list --created-after 7d

---

ou describe

Show detailed information about an organizational unit.

ndcli ou describe [name]

Arguments

Argument	Required	Description
name	Yes	OU name

Output

Shows:

• OU name and description
• Status
• Device count
• Assigned templates
• Creation and update timestamps

Examples

ndcli ou describe production
ndcli ou describe staging -f json

---

ou create

Create a new organizational unit.

ndcli ou create [name] [flags]

Arguments

Argument	Required	Description
name	Yes	OU name

Flags

Flag	Type	Description
--description	string	OU description

Examples

ndcli ou create production

ndcli ou create staging --description "Pre-production testing environment"

---

ou delete

Delete an organizational unit.

ndcli ou delete [name]

Arguments

Argument	Required	Description
name	Yes	OU name to delete

Examples

ndcli ou delete deprecated-ou

Caution

Devices in the OU will be unassigned from any OU. Consider moving devices before deletion.

---

ou rename

Rename an organizational unit.

ndcli ou rename [old-name] [new-name]

Arguments

Argument	Required	Description
old-name	Yes	Current OU name
new-name	Yes	New OU name

Examples

ndcli ou rename test staging

---

ou device-list

List all devices assigned to an organizational unit.

ndcli ou device-list [ou]

Arguments

Argument	Required	Description
ou	Yes	OU name

Examples

ndcli ou device-list production
ndcli ou device-list staging -f json

---

ou add-device

Add a device to an organizational unit.

ndcli ou add-device [ou] [device]

Arguments

Argument	Required	Description
ou	Yes	OU name
device	Yes	Device name to add

Examples

ndcli ou add-device production fw-datacenter-01

Notes

• A device can only belong to one OU at a time
• Adding a device to an OU removes it from its previous OU

---

ou remove-device

Remove a device from an organizational unit.

ndcli ou remove-device [ou] [device]

Arguments

Argument	Required	Description
ou	Yes	OU name
device	Yes	Device name to remove

Examples

ndcli ou remove-device production old-firewall

---

ou template

Manage templates assigned to an organizational unit.

ou template list

List templates assigned to an OU.

ndcli ou template list [ou]

Arguments

Argument	Required	Description
ou	Yes	OU name

Examples

ndcli ou template list production

---

ou template add

Add a template to an OU. Devices in the OU will receive configurations from this template.

ndcli ou template add [ou] [template]

Arguments

Argument	Required	Description
ou	Yes	OU name
template	Yes	Template name to add

Examples

ndcli ou template add production base-firewall-config

---

ou template remove

Remove a template from an OU.

ndcli ou template remove [ou] [template]

Arguments

Argument	Required	Description
ou	Yes	OU name
template	Yes	Template name to remove

Examples

ndcli ou template remove staging deprecated-template