Building

Version:

Location in GUI: Design » Network Hierarchy

Diagram

Classes

sites (catalyst_center)

Name	Type	Constraint	Mandatory	Default Value
buildings	List	`[buildings]`	No

buildings (catalyst_center.sites)

Name	Type	Constraint	Mandatory
name	String		Yes
parent_name	String		No
cli_credentials	String		No
snmpv3_credentials	String		No
snmpv2_read_credentials	String		No
snmpv2_write_credentials	String		No
https_read_credentials	String		No
https_write_credentials	String		No
network_settings	Class	`[network_settings]`	No
latitude	Number		No
longitude	Number		No
address	String		No
country	String		No
ip_pools_reservations	List	String	No

network_settings (catalyst_center.sites.buildings)

Name	Type	Mandatory
aaa_servers	String	No
network	String	No
telemetry	String	No

Examples

Example 1: Basic building configuration with essential geographic information including coordinates and address for physical location mapping:

catalyst_center:
  sites:
    buildings:
      - name: Corporate Headquarters
        parent_name: Global/Americas/USA/California
        latitude: 37.4419
        longitude: -122.1430
      - name: London Office
        parent_name: Global/EMEA/United Kingdom
        address: 25 Canada Square, London E14 5LQ, UK
        country: United Kingdom

Example 2: Comprehensive building deployment with complete credential assignments, network settings, IP pool reservations, and detailed geographic information for enterprise facility management:

catalyst_center:
  sites:
    buildings:
      - name: Global Headquarters
        parent_name: Global/Americas/USA/California/San Jose
        latitude: 37.3382
        longitude: -121.8863
        address: 170 West Tasman Drive, San Jose, CA 95134, USA
        country: United States
        cli_credentials: GLOBAL_CLI_ADMIN
        snmpv3_credentials: SECURE_SNMPV3_AUTHPRIV
        snmpv2_read_credentials: GLOBAL_SNMP_READ
        snmpv2_write_credentials: GLOBAL_SNMP_WRITE
        https_read_credentials: API_READ_ACCESS
        https_write_credentials: API_WRITE_ACCESS
        network_settings:
          aaa_servers: ENTERPRISE_AAA_SETTINGS
          network: ENTERPRISE_NETWORK_CONFIG
          telemetry: GLOBAL_COMPREHENSIVE_TELEMETRY
        ip_pools_reservations:
          - CORPORATE_POOL
          - MGMT_NETWORK_POOL
          - SERVICE_NETWORK_POOL
      - name: European Data Center
        parent_name: Global/EMEA/Netherlands/Amsterdam
        latitude: 52.3676
        longitude: 4.9041
        address: Science Park 140, 1098 XG Amsterdam, Netherlands
        country: Netherlands
        cli_credentials: EMEA_CLI_ADMIN
        snmpv3_credentials: STANDARD_SNMPV3_AUTHNOPRIV
        snmpv2_read_credentials: EMEA_SNMP_READ
        https_read_credentials: MONITORING_API_ACCESS
        network_settings:
          aaa_servers: EMEA_AAA_SETTINGS
          network: EMEA_NETWORK_SETTINGS
          telemetry: DC_ADVANCED_TELEMETRY
        ip_pools_reservations:
          - CAMPUS_LAN_AUTO
          - CAMPUS_AP_POOL
          - CAMPUS_EXTENDED_NODE_POOL
      - name: APAC Branch Office
        parent_name: Global/APAC/Singapore
        latitude: 1.2966
        longitude: 103.7764
        address: 1 Raffles Place, Singapore 048616
        country: Singapore
        cli_credentials: BRANCH_CLI_READONLY
        snmpv2_read_credentials: BRANCH_SNMP_READ
        network_settings:
          network: BASIC_NETWORK_SETTINGS
          telemetry: BRANCH_BASIC_TELEMETRY
        ip_pools_reservations:
          - BRANCH_WAN_POOL

Location in GUI: Design » Network Hierarchy

Diagram

Classes

sites (catalyst_center)

Name	Type	Constraint	Mandatory	Default Value
buildings	List	`[buildings]`	No

buildings (catalyst_center.sites)

Name	Type	Constraint	Mandatory
name	String		Yes
parent_name	String		No
cli_credentials	String		No
snmpv3_credentials	String		No
snmpv2_read_credentials	String		No
snmpv2_write_credentials	String		No
https_read_credentials	String		No
https_write_credentials	String		No
network_settings	Class	`[network_settings]`	No
latitude	Number		No
longitude	Number		No
address	String		No
country	String		No
ip_pools_reservations	List	String	No

network_settings (catalyst_center.sites.buildings)

Name	Type	Mandatory
aaa_servers	String	No
network	String	No
telemetry	String	No

Examples

Example 1: Basic building configuration with essential geographic information including coordinates and address for physical location mapping:

catalyst_center:
  sites:
    buildings:
      - name: Corporate Headquarters
        parent_name: Global/Americas/USA/California
        latitude: 37.4419
        longitude: -122.1430
      - name: London Office
        parent_name: Global/EMEA/United Kingdom
        address: 25 Canada Square, London E14 5LQ, UK
        country: United Kingdom

Example 2: Comprehensive building deployment with complete credential assignments, network settings, IP pool reservations, and detailed geographic information for enterprise facility management:

catalyst_center:
  sites:
    buildings:
      - name: Global Headquarters
        parent_name: Global/Americas/USA/California/San Jose
        latitude: 37.3382
        longitude: -121.8863
        address: 170 West Tasman Drive, San Jose, CA 95134, USA
        country: United States
        cli_credentials: GLOBAL_CLI_ADMIN
        snmpv3_credentials: SECURE_SNMPV3_AUTHPRIV
        snmpv2_read_credentials: GLOBAL_SNMP_READ
        snmpv2_write_credentials: GLOBAL_SNMP_WRITE
        https_read_credentials: API_READ_ACCESS
        https_write_credentials: API_WRITE_ACCESS
        network_settings:
          aaa_servers: ENTERPRISE_AAA_SETTINGS
          network: ENTERPRISE_NETWORK_CONFIG
          telemetry: GLOBAL_COMPREHENSIVE_TELEMETRY
        ip_pools_reservations:
          - CORPORATE_POOL
          - MGMT_NETWORK_POOL
          - SERVICE_NETWORK_POOL
      - name: European Data Center
        parent_name: Global/EMEA/Netherlands/Amsterdam
        latitude: 52.3676
        longitude: 4.9041
        address: Science Park 140, 1098 XG Amsterdam, Netherlands
        country: Netherlands
        cli_credentials: EMEA_CLI_ADMIN
        snmpv3_credentials: STANDARD_SNMPV3_AUTHNOPRIV
        snmpv2_read_credentials: EMEA_SNMP_READ
        https_read_credentials: MONITORING_API_ACCESS
        network_settings:
          aaa_servers: EMEA_AAA_SETTINGS
          network: EMEA_NETWORK_SETTINGS
          telemetry: DC_ADVANCED_TELEMETRY
        ip_pools_reservations:
          - CAMPUS_LAN_AUTO
          - CAMPUS_AP_POOL
          - CAMPUS_EXTENDED_NODE_POOL
      - name: APAC Branch Office
        parent_name: Global/APAC/Singapore
        latitude: 1.2966
        longitude: 103.7764
        address: 1 Raffles Place, Singapore 048616
        country: Singapore
        cli_credentials: BRANCH_CLI_READONLY
        snmpv2_read_credentials: BRANCH_SNMP_READ
        network_settings:
          network: BASIC_NETWORK_SETTINGS
          telemetry: BRANCH_BASIC_TELEMETRY
        ip_pools_reservations:
          - BRANCH_WAN_POOL

Location in GUI: Design » Network Hierarchy

Diagram

Classes

sites (catalyst_center)

Name	Type	Constraint	Mandatory	Default Value
buildings	List	`[buildings]`	No

buildings (catalyst_center.sites)

Name	Type	Constraint	Mandatory
name	String		Yes
parent_name	String		No
cli_credentials	String		No
snmpv3_credentials	String		No
snmpv2_read_credentials	String		No
snmpv2_write_credentials	String		No
https_read_credentials	String		No
https_write_credentials	String		No
network_settings	Class	`[network_settings]`	No
latitude	Number		No
longitude	Number		No
address	String		No
country	String		No
ip_pools_reservations	List	String	No

network_settings (catalyst_center.sites.buildings)

Name	Type	Mandatory
aaa_servers	String	No
network	String	No
telemetry	String	No

Examples

catalyst_center:
  sites:
    buildings:
      - name: Toronto City Hall
        latitude: 43.653
        longitude: -79.384
        parent_name: Global/Canada/Toronto City Hall

Location in GUI: Design » Network Hierarchy

Diagram

Classes

sites (catalyst_center)

Name	Type	Constraint	Mandatory	Default Value
buildings	List	`[buildings]`	No

buildings (catalyst_center.sites)

Name	Type	Constraint	Mandatory
name	String		Yes
parent_name	String		No
cli_credentials	String		No
snmpv3_credentials	String		No
snmpv2_read_credentials	String		No
snmpv2_write_credentials	String		No
https_read_credentials	String		No
https_write_credentials	String		No
network_settings	Class	`[network_settings]`	No
latitude	Number		No
longitude	Number		No
address	String		No
country	String		No
ip_pools_reservations	List	String	No

network_settings (catalyst_center.sites.buildings)

Name	Type	Mandatory
aaa_servers	String	No
network	String	No
telemetry	String	No

Examples

catalyst_center:
  sites:
    buildings:
      - name: Toronto City Hall
        latitude: 43.653
        longitude: -79.384
        parent_name: Global/Canada/Toronto City Hall

Location in GUI: Design » Network Hierarchy

Diagram

Classes

sites (catalyst_center)

Name	Type	Constraint	Mandatory	Default Value
buildings	List	`[buildings]`	No

buildings (catalyst_center.sites)

Name	Type	Constraint	Mandatory
name	String		Yes
parent_name	String		No
cli_credentials	String		No
snmpv3_credentials	String		No
snmpv2_read_credentials	String		No
snmpv2_write_credentials	String		No
https_read_credentials	String		No
https_write_credentials	String		No
network_settings	Class	`[network_settings]`	No
latitude	Number		No
longitude	Number		No
address	String		No
country	String		No
ip_pools_reservations	List	String	No

network_settings (catalyst_center.sites.buildings)

Name	Type	Mandatory
aaa_servers	String	No
network	String	No
telemetry	String	No

Examples

catalyst_center:
  sites:
    buildings:
      - name: Toronto City Hall
        latitude: 43.653
        longitude: -79.384
        parent_name: Global/Canada/Toronto City Hall

Location in GUI: Design » Network Hierarchy

Diagram

Classes

sites (catalyst_center)

Name	Type	Constraint	Mandatory	Default Value
buildings	List	`[buildings]`	No

buildings (catalyst_center.sites)

Name	Type	Constraint	Mandatory
name	String		Yes
parent_name	String		No
cli_credentials	String		No
snmpv3_credentials	String		No
snmpv2_read_credentials	String		No
snmpv2_write_credentials	String		No
https_read_credentials	String		No
https_write_credentials	String		No
network_settings	Class	`[network_settings]`	No
latitude	Number		No
longitude	Number		No
address	String		No
country	String		No
ip_pools_reservations	List	String	No

network_settings (catalyst_center.sites.buildings)

Name	Type	Mandatory
aaa_servers	String	No
network	String	No
telemetry	String	No

Examples

catalyst_center:
  sites:
    buildings:
      - name: Toronto City Hall
        latitude: 43.653
        longitude: -79.384
        parent_name: Global/Canada/Toronto City Hall