Skip to main content

Device

Location in GUI: Devices » Device Management » Device

Diagram

Classes

devices (fmc.domains)

NameTypeConstraintMandatoryDefault Value
devicesList[devices]No

devices (fmc.domains.devices)

NameTypeConstraintMandatoryDefault Value
nameStringRegex: ^[a-zA-Z0-9_.+ -]{1,64}$Yes
hostIPNo
registration_keyStringNo
device_groupStringNo
access_policyStringNo
nat_policyStringNo
health_policyStringNo
licensesListChoice[ESSENTIALS, IPS, URL, MALWARE_DEFENSE, CARRIER, SECURE_CLIENT_PREMIER, SECURE_CLIENT_PREMIER_ADVANTAGE, SECURE_CLIENT_VPNOnly, BASE, THREAT, PROTECT, CONTROL, URLFilter, MALWARE, VPN, SSL]No
nat_idStringNo
performance_tierChoiceFTDv5, FTDv10, FTDv20, FTDv30, FTDv50, LegacyNo
prohibit_packet_transferBooleantrue, falseNo
snort_engineChoiceSNORT2, SNORT3No
deployBooleantrue, falseNo
vrfsList[vrfs]No
bfdsList[bfds]No
bgp_general_settingsClass[bgp_general_settings]No

vrfs (fmc.domains.devices.devices)

NameTypeConstraintMandatoryDefault Value
nameStringRegex: ^[a-zA-Z0-9_.+ -]{1,64}$Yes
descriptionStringmax: 255No
bgpClass[bgp]No
physical_interfacesList[physical_interfaces]No
etherchannel_interfacesList[etherchannel_interfaces]No
sub_interfacesList[sub_interfaces]No
ipv4_static_routesList[ipv4_static_routes]No

bfds (fmc.domains.devices.devices)

NameTypeConstraintMandatoryDefault Value
interface_logical_nameStringRegex: ^[a-zA-Z0-9_.+ -]{1,64}$Yes
hop_typeChoiceSINGLE_HOP, MULTI_HOPYes
slow_timerIntegermin: 1000, max: 30000No
bfd_templateStringYes
source_host_objectStringNo
destination_host_objectStringNo

bgp_general_settings (fmc.domains.devices.devices)

NameTypeConstraintMandatoryDefault Value
as_numberStringYes
aggregate_timerIntegermin: 6, max: 60No
as_number_in_path_attributeIntegermin: 1, max: 254No
compare_med_from_different_neighborsBooleantrue, falseNo
compare_router_id_in_pathBooleantrue, falseNo
default_local_preferenceIntegermin: 1000, max: 4294967295No
enforce_first_peer_asBooleantrue, falseNo
graceful_restartBooleantrue, falseNo
graceful_restart_restart_timeIntegermin: 1, max: 3600No
graceful_restart_stale_path_timeIntegermin: 1, max: 3600No
hold_timeIntegermin: 1, max: 65535No
keepalive_intervalIntegermin: 1, max: 65535No
log_neighbor_changesBooleantrue, falseNo
min_hold_timeIntegermin: 1, max: 65535No
missing_med_as_bestBooleantrue, falseNo
next_hop_address_trackingBooleantrue, falseNo
next_hop_delay_intervalIntegermin: 0, max: 100No
pick_best_medBooleantrue, falseNo
reset_session_upon_failoverBooleantrue, falseNo
router_idStringNo
scanning_intervalIntegermin: 5, max: 60No
tcp_path_mtu_discoveryBooleantrue, falseNo
use_dot_notationBooleantrue, falseNo

bgp (fmc.domains.devices.devices.vrfs)

NameTypeConstraintMandatoryDefault Value
ipv4_aggregate_addressesList[ipv4_aggregate_addresses]No
ipv4_auto_aummaryBooleantrue, falseNo
ipv4_bgp_redistribute_internalBooleantrue, falseNo
ipv4_bgp_supress_inactiveBooleantrue, falseNo
ipv4_default_information_orginateBooleantrue, falseNo
ipv4_external_distanceIntegermin: 1, max: 255No
ipv4_filteringsList[ipv4_filterings]No
ipv4_forward_packets_over_multipath_ebgpIntegermin: 1, max: 8No
ipv4_forward_packets_over_multipath_ibgpIntegermin: 1, max: 8No
ipv4_internal_distanceIntegermin: 1, max: 255No
ipv4_learned_route_mapStringNo
ipv4_local_distanceIntegermin: 1, max: 255No
ipv4_neighborsList[ipv4_neighbors]No
ipv4_networksList[ipv4_networks]No
ipv4_redistributionsList[ipv4_redistributions]No
ipv4_route_injectionsList[ipv4_route_injections]No
ipv4_synchronizationBooleantrue, falseNo

physical_interfaces (fmc.domains.devices.devices.vrfs)

NameTypeConstraintMandatoryDefault Value
nameChoiceGigabitEthernet0/0, GigabitEthernet0/1, GigabitEthernet0/2, GigabitEthernet0/3, GigabitEthernet0/4, GigabitEthernet0/5, GigabitEthernet0/6, GigabitEthernet0/7, TenGigabitEthernet0/0, TenGigabitEthernet0/1Yes
modeChoiceINLINE, PASSIVE, TAP, ERSPAN, NONE, SWITCHPORTNo
active_mac_addressStringmax: 17No
allow_full_fragment_reassemblyBooleantrue, falseNo
arp_table_entriesList[arp_table_entries]No
auto_negotiationBooleantrue, falseNo
descriptionStringmax: 255No
duplexChoiceAUTO, FULL, HALFNo
enable_anti_spoofingBooleantrue, falseNo
enable_sgt_propagateBooleantrue, falseNo
enabledBooleantrue, falseNo
fec_modeChoiceAUTO, CL108RS, CL74FC, CL91RS, DISABLENo
flow_control_sendBooleantrue, falseNo
ip_based_monitoringBooleantrue, falseNo
ip_based_monitoring_next_hopIPNo
ip_based_monitoring_typeChoiceAUTO, PEER_IPV4, PEER_IPV6, AUTO4, AUTO6No
ipv4_dhcp_obtain_routeBooleantrue, falseNo
ipv4_dhcp_route_metricIntegermin: 1, max: 255No
ipv4_pppoe_authenticationChoicePAP, CHAP, MSCHAPNo
ipv4_pppoe_passwordStringNo
ipv4_pppoe_route_metricIntegermin: 1, max: 255No
ipv4_pppoe_route_settingsBooleantrue, falseNo
ipv4_pppoe_store_credentials_in_flashBooleantrue, falseNo
ipv4_pppoe_userStringNo
ipv4_pppoe_vpdn_group_nameStringNo
ipv4_static_addressIPNo
ipv4_static_netmaskIntegermin: 1, max: 31No
ipv6_addressesList[ipv6_addresses]No
ipv6_dad_attemptsIntegermin: 0, max: 600No
ipv6_default_route_by_dhcpBooleantrue, falseNo
ipv6_dhcpBooleantrue, falseNo
ipv6_dhcp_client_pd_hint_prefixesStringNo
ipv6_dhcp_client_pd_prefix_nameStringNo
ipv6_dhcp_pool_idStringNo
ipv6_enableBooleantrue, falseNo
ipv6_enable_auto_configBooleantrue, falseNo
ipv6_enable_dadBooleantrue, falseNo
ipv6_enable_dhcp_address_configBooleantrue, falseNo
ipv6_enable_dhcp_nonaddress_configBooleantrue, falseNo
ipv6_enable_raBooleantrue, falseNo
ipv6_enforce_euiBooleantrue, falseNo
ipv6_link_local_addressStringNo
ipv6_ns_intervalIntegermin: 1000, max: 3600000No
ipv6_prefixesList[ipv6_prefixes]No
ipv6_ra_intervalIntegermin: 3, max: 1800No
ipv6_ra_life_timeIntegermin: 0, max: 9000No
ipv6_reachable_timeIntegermin: 1000, max: 3600000No
lldp_receiveBooleantrue, falseNo
lldp_transmitBooleantrue, falseNo
logical_nameStringRegex: ^[a-zA-Z0-9_.+-]{1,64}$No
management_accessBooleantrue, falseNo
management_access_network_objectsList[management_access_network_objects]No
management_onlyBooleantrue, falseNo
mtuIntegermin: 64, max: 9000No
nve_onlyBooleantrue, falseNo
override_default_fragment_setting_chainIntegermin: 1, max: 8200No
override_default_fragment_setting_sizeIntegermin: 1, max: 30000No
override_default_fragment_setting_timeoutIntegermin: 1, max: 30No
priorityIntegermin: 0, max: 65535No
security_zoneStringNo
speedChoiceAUTO, TEN, HUNDRED, THOUSAND, TEN_THOUSAND, TWENTY_FIVE_THOUSAND, FORTY_THOUSAND, HUNDRED_THOUSAND, TWO_HUNDRED_THOUSAND, DETECT_SFPNo
standby_mac_addressStringNo

etherchannel_interfaces (fmc.domains.devices.devices.vrfs)

NameTypeConstraintMandatoryDefault Value
nameStringmax: 255No
modeChoiceINLINE, PASSIVE, TAP, ERSPAN, NONE, SWITCHPORTNo
active_mac_addressStringmax: 17No
allow_full_fragment_reassemblyBooleantrue, falseNo
arp_table_entriesList[arp_table_entries]No
auto_negotiationBooleantrue, falseNo
descriptionStringmax: 255No
duplexChoiceAUTO, FULL, HALFNo
enable_anti_spoofingBooleantrue, falseNo
enable_sgt_propagateBooleantrue, falseNo
enabledBooleantrue, falseNo
fec_modeChoiceAUTO, CL108RS, CL74FC, CL91RS, DISABLENo
flow_control_sendBooleantrue, falseNo
ip_based_monitoringBooleantrue, falseNo
ip_based_monitoring_next_hopIPNo
ip_based_monitoring_typeChoiceAUTO, PEER_IPV4, PEER_IPV6, AUTO4, AUTO6No
ipv4_dhcp_obtain_routeBooleantrue, falseNo
ipv4_dhcp_route_metricIntegermin: 1, max: 255No
ipv4_pppoe_authenticationChoicePAP, CHAP, MSCHAPNo
ipv4_pppoe_passwordStringNo
ipv4_pppoe_route_metricIntegermin: 1, max: 255No
ipv4_pppoe_route_settingsBooleantrue, falseNo
ipv4_pppoe_store_credentials_in_flashBooleantrue, falseNo
ipv4_pppoe_userStringNo
ipv4_pppoe_vpdn_group_nameStringNo
ipv4_static_addressIPNo
ipv4_static_netmaskIntegermin: 1, max: 31No
ipv6_addressesList[ipv6_addresses]No
ipv6_dad_attemptsIntegermin: 0, max: 600No
ipv6_default_route_by_dhcpBooleantrue, falseNo
ipv6_dhcpBooleantrue, falseNo
ipv6_dhcp_client_pd_hint_prefixesStringNo
ipv6_dhcp_client_pd_prefix_nameStringNo
ipv6_dhcp_pool_idStringNo
ipv6_enableBooleantrue, falseNo
ipv6_enable_auto_configBooleantrue, falseNo
ipv6_enable_dadBooleantrue, falseNo
ipv6_enable_dhcp_address_configBooleantrue, falseNo
ipv6_enable_dhcp_nonaddress_configBooleantrue, falseNo
ipv6_enable_raBooleantrue, falseNo
ipv6_enforce_euiBooleantrue, falseNo
ipv6_link_local_addressStringNo
ipv6_ns_intervalIntegermin: 1000, max: 3600000No
ipv6_prefixesList[ipv6_prefixes]No
ipv6_ra_intervalIntegermin: 3, max: 1800No
ipv6_ra_life_timeIntegermin: 0, max: 9000No
ipv6_reachable_timeIntegermin: 1000, max: 3600000No
lldp_receiveBooleantrue, falseNo
lldp_transmitBooleantrue, falseNo
logical_nameStringRegex: ^[a-zA-Z0-9_.+-]{1,64}$Yes
management_accessBooleantrue, falseNo
management_access_network_objectsList[management_access_network_objects]No
management_onlyBooleantrue, falseNo
mtuIntegermin: 64, max: 9000No
nve_onlyBooleantrue, falseNo
override_default_fragment_setting_chainIntegermin: 1, max: 8200No
override_default_fragment_setting_sizeIntegermin: 1, max: 30000No
override_default_fragment_setting_timeoutIntegermin: 1, max: 30No
priorityIntegermin: 0, max: 65535No
security_zoneStringNo
speedChoiceAUTO, TEN, HUNDRED, THOUSAND, TEN_THOUSAND, TWENTY_FIVE_THOUSAND, FORTY_THOUSAND, HUNDRED_THOUSAND, TWO_HUNDRED_THOUSAND, DETECT_SFPNo
standby_mac_addressStringNo

sub_interfaces (fmc.domains.devices.devices.vrfs)

NameTypeConstraintMandatoryDefault Value
nameStringmax: 255No
modeChoiceINLINE, PASSIVE, TAP, ERSPAN, NONE, SWITCHPORTNo
active_mac_addressStringmax: 17No
allow_full_fragment_reassemblyBooleantrue, falseNo
arp_table_entriesList[arp_table_entries]No
descriptionStringmax: 255No
enable_anti_spoofingBooleantrue, falseNo
enable_sgt_propagateBooleantrue, falseNo
enabledBooleantrue, falseNo
ip_based_monitoringBooleantrue, falseNo
ip_based_monitoring_next_hopIPNo
ip_based_monitoring_typeChoiceAUTO, PEER_IPV4, PEER_IPV6, AUTO4, AUTO6No
ipv4_dhcp_obtain_routeBooleantrue, falseNo
ipv4_dhcp_route_metricIntegermin: 1, max: 255No
ipv4_pppoe_authenticationChoicePAP, CHAP, MSCHAPNo
ipv4_pppoe_passwordStringNo
ipv4_pppoe_route_metricIntegermin: 1, max: 255No
ipv4_pppoe_route_settingsBooleantrue, falseNo
ipv4_pppoe_store_credentials_in_flashBooleantrue, falseNo
ipv4_pppoe_userStringNo
ipv4_pppoe_vpdn_group_nameStringNo
ipv4_static_addressIPNo
ipv4_static_netmaskIntegermin: 1, max: 31No
ipv6_addressesList[ipv6_addresses]No
ipv6_dad_attemptsIntegermin: 0, max: 600No
ipv6_default_route_by_dhcpBooleantrue, falseNo
ipv6_dhcpBooleantrue, falseNo
ipv6_dhcp_client_pd_hint_prefixesStringNo
ipv6_dhcp_client_pd_prefix_nameStringNo
ipv6_dhcp_pool_idStringNo
ipv6_enableBooleantrue, falseNo
ipv6_enable_auto_configBooleantrue, falseNo
ipv6_enable_dadBooleantrue, falseNo
ipv6_enable_dhcp_address_configBooleantrue, falseNo
ipv6_enable_dhcp_nonaddress_configBooleantrue, falseNo
ipv6_enable_raBooleantrue, falseNo
ipv6_enforce_euiBooleantrue, falseNo
ipv6_link_local_addressStringNo
ipv6_ns_intervalIntegermin: 1000, max: 3600000No
ipv6_prefixesList[ipv6_prefixes]No
ipv6_ra_intervalIntegermin: 3, max: 1800No
ipv6_ra_life_timeIntegermin: 0, max: 9000No
ipv6_reachable_timeIntegermin: 1000, max: 3600000No
logical_nameStringRegex: ^[a-zA-Z0-9_.+-]{1,64}$Yes
management_onlyBooleantrue, falseNo
mtuIntegermin: 64, max: 9000No
override_default_fragment_setting_chainIntegermin: 1, max: 8200No
override_default_fragment_setting_sizeIntegermin: 1, max: 30000No
override_default_fragment_setting_timeoutIntegermin: 1, max: 30No
priorityIntegermin: 0, max: 65535No
security_zoneStringNo
standby_mac_addressStringNo
vlanIntegermin: 1, max: 4094Yes

ipv4_static_routes (fmc.domains.devices.devices.vrfs)

NameTypeConstraintMandatoryDefault Value
nameStringRegex: ^[a-zA-Z0-9_.+-]{1,64}$No
gatewayClass[gateway]Yes
interface_logical_nameStringYes
metricIntegermin: 1, max: 254Yes
selected_networksListStringYes
tunneledBooleantrue, falseNo

ipv4_aggregate_addresses (fmc.domains.devices.devices.vrfs.bgp)

NameTypeConstraintMandatoryDefault Value
advertise_mapStringNo
attribute_mapStringNo
filterBooleantrue, falseNo
generate_asBooleantrue, falseNo
networkStringNo
suppress_mapStringNo

ipv4_filterings (fmc.domains.devices.devices.vrfs.bgp)

NameTypeConstraintMandatoryDefault Value
access_listStringNo
network_directionChoiceincomingroutefilter, outgoingroutefilterNo
prorocol_processStringNo
protocolStringNo

ipv4_neighbors (fmc.domains.devices.devices.vrfs.bgp)

NameTypeConstraintMandatoryDefault Value
enable_address_familyBooleantrue, falseNo
neighbor_addressIPNo
neighbor_authentication_passwordStringNo
neighbor_bfdChoiceSINGLE_HOP, MULTI_HOP, AUTO_DETECT_HOP, NONENo
neighbor_customized_accept_both_asBooleantrue, falseNo
neighbor_customized_local_as_numberStringNo
neighbor_customized_no_prependBooleantrue, falseNo
neighbor_customized_replace_asBooleantrue, falseNo
neighbor_descriptionStringNo
neighbor_disable_connection_verificationBooleantrue, falseNo
neighbor_filter_access_listsList[neighbor_filter_access_lists]No
neighbor_filter_as_path_listsList[neighbor_filter_as_path_lists]No
neighbor_filter_max_prefixIntegermin: 1, max: 2147483647No
neighbor_filter_prefix_listsList[neighbor_filter_prefix_lists]No
neighbor_filter_restart_intervalIntegermin: 1, max: 65535No
neighbor_filter_route_map_listsList[neighbor_filter_route_map_lists]No
neighbor_filter_threshold_valueIntegermin: 1, max: 100No
neighbor_filter_warning_onlyBooleantrue, falseNo
neighbor_generate_default_route_mapStringNo
neighbor_hold_timeIntegermin: 3, max: 65535No
neighbor_keepalive_intervalIntegermin: 0, max: 65535No
neighbor_max_hop_countIntegermin: 1, max: 255No
neighbor_min_hold_timeIntegermin: 3, max: 65535No
neighbor_nexthop_selfBooleantrue, falseNo
neighbor_remote_asStringNo
neighbor_routes_advertise_exist_nonexist_mapStringNo
neighbor_routes_advertise_mapStringNo
neighbor_routes_advertise_map_use_existBooleantrue, falseNo
neighbor_routes_advertisement_intervalIntegermin: 0, max: 600No
neighbor_routes_remove_private_asBooleantrue, falseNo
neighbor_send_community_attributeBooleantrue, falseNo
neighbor_shutdownBooleantrue, falseNo
neighbor_tcp_mtu_path_discoveryBooleantrue, falseNo
neighbor_tcp_transport_modeBooleantrue, falseNo
neighbor_versionChoice0, 4No
neighbor_weightIntegermin: 0, max: 65535No
update_source_interfaceStringNo

ipv4_networks (fmc.domains.devices.devices.vrfs.bgp)

NameTypeConstraintMandatoryDefault Value
networkStringNo
route_mapStringNo

ipv4_redistributions (fmc.domains.devices.devices.vrfs.bgp)

NameTypeConstraintMandatoryDefault Value
match_external1Booleantrue, falseNo
match_external2Booleantrue, falseNo
match_internalBooleantrue, falseNo
match_nssa_external1Booleantrue, falseNo
match_nssa_external2Booleantrue, falseNo
metricIntegermin: 0, max: 4294967295No
process_idStringNo
route_mapStringNo
source_protocolChoiceRedistributeConnected, RedistributeStatic, RedistributeOSPF, RedistributeEIGRPNo

ipv4_route_injections (fmc.domains.devices.devices.vrfs.bgp)

NameTypeConstraintMandatoryDefault Value
exist_route_mapStringNo
inject_route_mapStringNo

arp_table_entries (fmc.domains.devices.devices.vrfs.physical_interfaces)

NameTypeConstraintMandatoryDefault Value
enable_aliasBooleantrue, falseYes
ip_addressIPYes
mac_addressStringmax: 17Yes

ipv6_addresses (fmc.domains.devices.devices.vrfs.physical_interfaces)

NameTypeConstraintMandatoryDefault Value
addressStringYes
enforce_euiBooleantrue, falseYes
prefixStringYes

ipv6_prefixes (fmc.domains.devices.devices.vrfs.physical_interfaces)

NameTypeConstraintMandatoryDefault Value
addressStringYes
enforce_euiBooleantrue, falseYes
defaultStringYes

management_access_network_objects (fmc.domains.devices.devices.vrfs.physical_interfaces)

NameTypeConstraintMandatoryDefault Value
idStringYes
typeChoiceHost, Network, Range, NetworkGroupNo

gateway (fmc.domains.devices.devices.vrfs.ipv4_static_routes)

NameTypeConstraintMandatoryDefault Value
objectStringNo
literalIPNo

neighbor_filter_access_lists (fmc.domains.devices.devices.vrfs.bgp.ipv4_neighbors)

NameTypeConstraintMandatoryDefault Value
access_listStringNo
update_directionChoiceIN, OUTNo

neighbor_filter_as_path_lists (fmc.domains.devices.devices.vrfs.bgp.ipv4_neighbors)

NameTypeConstraintMandatoryDefault Value
as_pathStringNo
update_directionChoiceIN, OUTNo

neighbor_filter_prefix_lists (fmc.domains.devices.devices.vrfs.bgp.ipv4_neighbors)

NameTypeConstraintMandatoryDefault Value
prefix_listStringNo
update_directionChoiceIN, OUTNo

neighbor_filter_route_map_lists (fmc.domains.devices.devices.vrfs.bgp.ipv4_neighbors)

NameTypeConstraintMandatoryDefault Value
route_mapStringNo
update_directionChoiceIN, OUTNo

Examples

Prerequisites:

fmc:
domains:
- name: Global
policies:
access_policies:
- name: MyAccessPolicyName1
default_action: BLOCK

Device:

fmc:
domains:
- name: Global
devices:
devices:
- name: MyDeviceName1
host: 10.62.158.201
registration_key: cisco123
access_policy: MyAccessPolicyName1
deploy: true
licenses:
- ESSENTIALS
- IPS
performance_tier: FTDv5