Skip to content

Node Registration

Location in GUI: Fabric » Inventory » Fabric Membership

Diagram
NameTypeConstraintMandatoryDefault Value
roleChoiceleaf, spine, apicYes
set_roleBooleantrue, falseNofalse
serial_numberStringRegex: ^[a-zA-Z0-9_.:-]{1,16}$No
nameStringRegex: ^[a-zA-Z0-9_.:-]{1,64}$No
idIntegermin: 1, max: 4000Yes
podIntegermin: 0, max: 255No1
typeChoicetier-2-leaf, remote-leaf-wan, virtual, border-gatewayNo
remote_pool_idIntegermin: 1, max: 255No

Example-1: In the example below we create a node registration for a leaf and a spine switch. The spine switch uses the set_role option to define that it is a spine if hardware is a dual-role.

apic:
node_policies:
nodes:
- id: 101
pod: 1
role: leaf
serial_number: ABC1234567
name: LEAF101
- id: 1001
pod: 1
role: spine
set_role: true # For dual-role switches
serial_number: ABC1234569
name: SPINE1001

Example-2: In the example below we create a node registration for a remote leaf switch.

apic:
nodes:
- id: 3101
pod: 1
role: leaf
type: remote-leaf-wan
serial_number: ABC1234568
name: RLEAF3101

Example-3: In the example below we create a node registration for a leaf that is supposed to work as a border gateway switch.

apic:
nodes:
- id: 401
pod: 1
role: leaf
type: border-gateway
serial_number: TEP-1-401
name: leaf-401

Location in GUI: Fabric » Inventory » Fabric Membership

Diagram
NameTypeConstraintMandatoryDefault Value
roleChoiceleaf, spine, apicYes
set_roleBooleantrue, falseNofalse
serial_numberStringRegex: ^[a-zA-Z0-9_.:-]{1,16}$No
nameStringRegex: ^[a-zA-Z0-9_.:-]{1,64}$No
idIntegermin: 1, max: 4000Yes
podIntegermin: 0, max: 255No1
typeChoicetier-2-leaf, remote-leaf-wan, virtualNo
remote_pool_idIntegermin: 1, max: 255No

apic:
node_policies:
nodes:
- id: 101
pod: 1
role: leaf
serial_number: ABC1234567
name: LEAF101
- id: 3101
pod: 1
role: leaf
type: remote-leaf-wan
serial_number: ABC1234568
name: RLEAF3101
- id: 1001
pod: 1
role: spine
set_role: true # For dual-role switches
serial_number: ABC1234569
name: SPINE1001

Location in GUI: Fabric » Inventory » Fabric Membership

Diagram
NameTypeConstraintMandatoryDefault Value
roleChoiceleaf, spine, apicYes
set_roleBooleantrue, falseNofalse
serial_numberStringRegex: ^[a-zA-Z0-9_.:-]{1,16}$No
nameStringRegex: ^[a-zA-Z0-9_.:-]{1,64}$No
idIntegermin: 1, max: 4000Yes
podIntegermin: 0, max: 255No1
typeChoicetier-2-leaf, remote-leaf-wan, virtualNo
remote_pool_idIntegermin: 1, max: 255No

apic:
node_policies:
nodes:
- id: 101
pod: 1
role: leaf
serial_number: ABC1234567
name: LEAF101
- id: 3101
pod: 1
role: leaf
type: remote-leaf-wan
serial-number: ABC1234568
name: RLEAF3101
- id: 1001
pod: 1
role: spine
set_role: true # For dual-role switches
serial_number: ABC1234569
name: SPINE1001

Location in GUI: Fabric » Inventory » Fabric Membership

Diagram
NameTypeConstraintMandatoryDefault Value
roleChoiceleaf, spine, apicYes
set_roleBooleantrue, falseNofalse
serial_numberStringRegex: ^[a-zA-Z0-9_.:-]{1,16}$No
nameStringRegex: ^[a-zA-Z0-9_.:-]{1,64}$No
idIntegermin: 1, max: 4000Yes
podIntegermin: 0, max: 255No1
typeChoicetier-2-leaf, remote-leaf-wan, virtualNo
remote_pool_idIntegermin: 1, max: 255No

apic:
node_policies:
nodes:
- id: 101
pod: 1
role: leaf
serial_number: ABC1234567
name: LEAF101
- id: 3101
pod: 1
role: leaf
type: remote-leaf-wan
serial-number: ABC1234568
name: RLEAF3101
- id: 1001
pod: 1
role: spine
set_role: true # For dual-role switches
serial_number: ABC1234569
name: SPINE1001