nautobot 2.0.0a2__py3-none-any.whl → 2.0.0b1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- nautobot/__init__.py +1 -5
- nautobot/apps/api.py +6 -8
- nautobot/apps/forms.py +0 -2
- nautobot/apps/ui.py +0 -8
- nautobot/circuits/api/serializers.py +9 -119
- nautobot/circuits/api/urls.py +1 -1
- nautobot/circuits/api/views.py +0 -1
- nautobot/circuits/choices.py +0 -2
- nautobot/circuits/filters.py +7 -6
- nautobot/circuits/forms.py +3 -73
- nautobot/circuits/migrations/0001_initial_part_1.py +0 -1
- nautobot/circuits/migrations/0002_initial_part_2.py +0 -1
- nautobot/circuits/migrations/0003_auto_slug.py +0 -1
- nautobot/circuits/migrations/0004_increase_provider_account_length.py +0 -1
- nautobot/circuits/migrations/0005_providernetwork.py +0 -1
- nautobot/circuits/migrations/0006_cache_circuit_terminations.py +0 -1
- nautobot/circuits/migrations/0007_circuitterminations_primary_model.py +0 -1
- nautobot/circuits/migrations/0008_add_natural_indexing.py +0 -1
- nautobot/circuits/migrations/0009_circuittermination_location.py +0 -1
- nautobot/circuits/migrations/0010_rename_foreign_keys_and_related_names.py +0 -1
- nautobot/circuits/migrations/0011_remove_site_foreign_key_from_circuit_termination_class.py +0 -1
- nautobot/circuits/migrations/0012_created_datetime.py +0 -1
- nautobot/circuits/migrations/0013_alter_circuittermination__path.py +0 -1
- nautobot/circuits/migrations/0014_related_name_changes.py +1 -2
- nautobot/circuits/migrations/0015_remove_circuittype_provider_slug.py +20 -0
- nautobot/circuits/migrations/0016_tagsfield.py +34 -0
- nautobot/circuits/migrations/0017_fixup_null_statuses.py +22 -0
- nautobot/circuits/migrations/0018_status_nonnullable.py +22 -0
- nautobot/circuits/models.py +3 -93
- nautobot/circuits/navigation.py +14 -69
- nautobot/circuits/signals.py +0 -2
- nautobot/circuits/tables.py +42 -5
- nautobot/circuits/templates/circuits/circuit_retrieve.html +1 -1
- nautobot/circuits/templates/circuits/circuittermination_retrieve.html +1 -1
- nautobot/circuits/templates/circuits/circuittype_retrieve.html +1 -1
- nautobot/circuits/templates/circuits/provider_create.html +0 -1
- nautobot/circuits/templates/circuits/provider_retrieve.html +1 -1
- nautobot/circuits/tests/integration/test_relationships.py +13 -16
- nautobot/circuits/tests/test_api.py +13 -43
- nautobot/circuits/tests/test_filters.py +20 -15
- nautobot/circuits/tests/test_models.py +7 -3
- nautobot/circuits/tests/test_views.py +57 -67
- nautobot/circuits/views.py +18 -9
- nautobot/core/api/__init__.py +8 -2
- nautobot/core/api/authentication.py +0 -3
- nautobot/core/api/fields.py +15 -6
- nautobot/core/api/filter_backends.py +3 -2
- nautobot/core/api/metadata.py +237 -30
- nautobot/core/api/mixins.py +94 -0
- nautobot/core/api/pagination.py +3 -3
- nautobot/core/api/parsers.py +154 -0
- nautobot/core/api/renderers.py +153 -2
- nautobot/core/api/schema.py +47 -3
- nautobot/core/api/serializers.py +377 -37
- nautobot/core/api/urls.py +11 -3
- nautobot/core/api/utils.py +174 -2
- nautobot/core/api/versioning.py +32 -10
- nautobot/core/api/views.py +266 -75
- nautobot/core/apps/__init__.py +138 -221
- nautobot/core/celery/__init__.py +112 -41
- nautobot/core/celery/backends.py +19 -13
- nautobot/core/celery/control.py +46 -0
- nautobot/core/celery/encoders.py +53 -0
- nautobot/core/celery/log.py +38 -0
- nautobot/core/celery/schedulers.py +23 -4
- nautobot/core/celery/task.py +1 -16
- nautobot/core/checks.py +0 -27
- nautobot/core/choices.py +21 -113
- nautobot/core/{cli.py → cli/__init__.py} +1 -2
- nautobot/core/cli/__main__.py +3 -0
- nautobot/core/constants.py +25 -43
- nautobot/core/context_processors.py +12 -0
- nautobot/core/filters.py +2 -2
- nautobot/core/forms/__init__.py +0 -4
- nautobot/core/forms/fields.py +39 -68
- nautobot/core/forms/forms.py +27 -27
- nautobot/core/forms/utils.py +7 -59
- nautobot/core/forms/widgets.py +0 -1
- nautobot/core/graphql/__init__.py +2 -2
- nautobot/core/graphql/schema.py +4 -27
- nautobot/core/jobs/__init__.py +75 -0
- nautobot/core/management/commands/build_ui.py +255 -0
- nautobot/core/management/commands/celery.py +0 -1
- nautobot/core/management/commands/generate_test_data.py +18 -13
- nautobot/core/management/commands/post_upgrade.py +24 -24
- nautobot/core/management/commands/validate_models.py +0 -1
- nautobot/core/middleware.py +0 -1
- nautobot/core/models/__init__.py +26 -1
- nautobot/core/models/fields.py +24 -5
- nautobot/core/models/generics.py +2 -46
- nautobot/core/models/managers.py +5 -0
- nautobot/core/models/name_color_content_types.py +1 -19
- nautobot/core/models/tree_queries.py +14 -4
- nautobot/core/models/utils.py +9 -10
- nautobot/core/models/validators.py +17 -8
- nautobot/core/releases.py +8 -10
- nautobot/core/settings.py +81 -53
- nautobot/core/tables.py +5 -5
- nautobot/core/tasks.py +4 -7
- nautobot/core/templates/base.html +1 -49
- nautobot/core/templates/base_django.html +49 -0
- nautobot/core/templates/base_react.html +55 -0
- nautobot/core/templates/buttons/export.html +6 -4
- nautobot/core/templates/generic/object_bulk_create.html +10 -21
- nautobot/core/templates/generic/object_list.html +4 -1
- nautobot/core/templates/generic/object_retrieve_plugin_full_width.html +3 -0
- nautobot/core/templates/inc/footer.html +1 -0
- nautobot/core/templates/inc/javascript.html +0 -14
- nautobot/core/templates/inc/nav_menu.html +28 -33
- nautobot/core/templates/inc/object_details_advanced_panel.html +13 -0
- nautobot/core/templates/inc/relationships_table_rows.html +2 -2
- nautobot/core/templates/nautobot_config.py.j2 +8 -25
- nautobot/core/templates/plugin_template/__init__.py-tpl +1 -2
- nautobot/core/templates/rest_framework/api.html +8 -0
- nautobot/core/templatetags/buttons.py +32 -29
- nautobot/core/templatetags/helpers.py +1 -1
- nautobot/core/testing/__init__.py +47 -44
- nautobot/core/testing/api.py +365 -47
- nautobot/core/testing/filters.py +12 -7
- nautobot/core/testing/integration.py +1 -1
- nautobot/core/testing/migrations.py +2 -0
- nautobot/core/testing/mixins.py +22 -12
- nautobot/core/testing/schema.py +2 -1
- nautobot/core/testing/views.py +28 -51
- nautobot/core/tests/integration/test_filters.py +17 -8
- nautobot/core/tests/integration/test_navbar.py +11 -34
- nautobot/core/tests/integration/test_plugin_navbar.py +9 -103
- nautobot/core/tests/nautobot_config.py +2 -3
- nautobot/core/tests/runner.py +0 -1
- nautobot/core/tests/test_api.py +290 -24
- nautobot/core/tests/test_authentication.py +57 -14
- nautobot/core/tests/test_checks.py +0 -7
- nautobot/core/tests/test_choices.py +0 -1
- nautobot/core/tests/test_filters.py +117 -110
- nautobot/core/tests/test_forms.py +47 -110
- nautobot/core/tests/test_graphql.py +158 -135
- nautobot/core/tests/test_logging.py +4 -1
- nautobot/core/tests/test_managers.py +3 -5
- nautobot/core/tests/test_models.py +2 -0
- nautobot/core/tests/test_ordering.py +0 -2
- nautobot/core/tests/test_paginator.py +3 -1
- nautobot/core/tests/test_releases.py +12 -12
- nautobot/core/tests/test_templatetags_helpers.py +7 -4
- nautobot/core/tests/test_utils.py +112 -78
- nautobot/core/tests/test_views.py +12 -17
- nautobot/core/tests/test_views_utils.py +6 -9
- nautobot/core/utils/data.py +17 -0
- nautobot/core/utils/deprecation.py +13 -20
- nautobot/core/utils/filtering.py +53 -9
- nautobot/core/utils/git.py +12 -4
- nautobot/core/utils/lookup.py +3 -1
- nautobot/core/utils/requests.py +23 -116
- nautobot/core/views/__init__.py +1 -2
- nautobot/core/views/generic.py +131 -119
- nautobot/core/views/mixins.py +53 -62
- nautobot/core/views/paginator.py +0 -1
- nautobot/core/views/renderers.py +14 -12
- nautobot/core/views/utils.py +87 -4
- nautobot/dcim/api/serializers.py +160 -672
- nautobot/dcim/api/urls.py +1 -1
- nautobot/dcim/api/views.py +7 -46
- nautobot/dcim/choices.py +2 -25
- nautobot/dcim/elevations.py +0 -1
- nautobot/dcim/factory.py +15 -4
- nautobot/dcim/filters/__init__.py +42 -13
- nautobot/dcim/form_mixins.py +1 -27
- nautobot/dcim/forms.py +58 -797
- nautobot/dcim/management/commands/trace_paths.py +0 -1
- nautobot/dcim/migrations/0001_initial_part_1.py +0 -1
- nautobot/dcim/migrations/0002_initial_part_2.py +0 -1
- nautobot/dcim/migrations/0003_initial_part_3.py +0 -1
- nautobot/dcim/migrations/0004_initial_part_4.py +0 -1
- nautobot/dcim/migrations/0005_device_local_context_schema.py +0 -1
- nautobot/dcim/migrations/0006_auto_slug.py +0 -1
- nautobot/dcim/migrations/0007_device_secrets_group.py +0 -1
- nautobot/dcim/migrations/0008_increase_all_serial_lengths.py +0 -1
- nautobot/dcim/migrations/0009_add_natural_indexing.py +0 -1
- nautobot/dcim/migrations/0010_interface_status.py +0 -1
- nautobot/dcim/migrations/0011_interface_status_data_migration.py +0 -1
- nautobot/dcim/migrations/0012_interface_parent_bridge.py +0 -1
- nautobot/dcim/migrations/0013_location_location_type.py +0 -1
- nautobot/dcim/migrations/0014_location_status_data_migration.py +0 -1
- nautobot/dcim/migrations/0015_device_components__changeloggedmodel.py +0 -1
- nautobot/dcim/migrations/0016_device_components__timestamp_data_migration.py +0 -1
- nautobot/dcim/migrations/0017_locationtype_nestable.py +0 -1
- nautobot/dcim/migrations/0018_device_redundancy_group.py +0 -1
- nautobot/dcim/migrations/0019_device_redundancy_group_data_migration.py +0 -1
- nautobot/dcim/migrations/0020_move_site_fields_to_location_model.py +0 -1
- nautobot/dcim/migrations/0021_mptt_to_tree_queries.py +0 -1
- nautobot/dcim/migrations/0022_interface_mac_address_data_migration.py +0 -1
- nautobot/dcim/migrations/0023_alter_interface_mac_address.py +0 -1
- nautobot/dcim/migrations/0024_alter_device_and_rack_role_add_new_role.py +2 -2
- nautobot/dcim/migrations/0025_device_and_rack_roles_data_migrations.py +19 -14
- nautobot/dcim/migrations/0026_rename_device_and_rack_role.py +0 -1
- nautobot/dcim/migrations/0027_remove_device_role_and_rack_role.py +1 -2
- nautobot/dcim/migrations/0028_rename_foreignkey_fields.py +1 -2
- nautobot/dcim/migrations/0029_add_tree_managers_and_foreign_keys_pre_data_migration.py +0 -1
- nautobot/dcim/migrations/0030_migrate_region_and_site_data_to_locations.py +2 -2
- nautobot/dcim/migrations/0031_rename_path_end_point_related_name.py +0 -1
- nautobot/dcim/migrations/0032_remove_site_foreign_key_from_dcim_models.py +0 -1
- nautobot/dcim/migrations/0033_created_datetime.py +0 -1
- nautobot/dcim/migrations/0034_fixup_fks_and_related_names.py +0 -1
- nautobot/dcim/migrations/0035_related_name_changes.py +1 -2
- nautobot/dcim/migrations/0036_remove_region_and_site.py +1 -2
- nautobot/dcim/migrations/0037_interface_ip_addresses_m2m.py +0 -1
- nautobot/dcim/migrations/0038_alter_location_managers.py +0 -1
- nautobot/dcim/migrations/0039_remove_slug.py +24 -0
- nautobot/dcim/migrations/0040_tagsfield.py +109 -0
- nautobot/dcim/migrations/0041_ipam__namespaces.py +25 -0
- nautobot/dcim/migrations/0042_fixup_null_statuses.py +51 -0
- nautobot/dcim/migrations/0043_status_nonnullable.py +72 -0
- nautobot/dcim/models/cables.py +4 -35
- nautobot/dcim/models/device_component_templates.py +7 -2
- nautobot/dcim/models/device_components.py +26 -203
- nautobot/dcim/models/devices.py +30 -152
- nautobot/dcim/models/locations.py +3 -64
- nautobot/dcim/models/power.py +3 -51
- nautobot/dcim/models/racks.py +7 -86
- nautobot/dcim/navigation.py +141 -467
- nautobot/dcim/signals.py +0 -2
- nautobot/dcim/tables/devices.py +8 -5
- nautobot/dcim/tables/devicetypes.py +1 -1
- nautobot/dcim/tables/locations.py +2 -2
- nautobot/dcim/tables/power.py +2 -2
- nautobot/dcim/templates/dcim/console_port_connection_list.html +7 -0
- nautobot/dcim/templates/dcim/device.html +15 -4
- nautobot/dcim/templates/dcim/device_edit.html +6 -0
- nautobot/dcim/templates/dcim/deviceredundancygroup_create.html +0 -1
- nautobot/dcim/templates/dcim/devicetype.html +2 -2
- nautobot/dcim/templates/dcim/interface.html +4 -0
- nautobot/dcim/templates/dcim/interface_connection_list.html +7 -0
- nautobot/dcim/templates/dcim/interface_edit.html +1 -0
- nautobot/dcim/templates/dcim/location.html +16 -1
- nautobot/dcim/templates/dcim/locationtype.html +15 -0
- nautobot/dcim/templates/dcim/power_port_connection_list.html +7 -0
- nautobot/dcim/templates/dcim/rackgroup.html +0 -12
- nautobot/dcim/tests/integration/test_cable_connect_form.py +4 -4
- nautobot/dcim/tests/test_api.py +202 -130
- nautobot/dcim/tests/test_cablepaths.py +47 -42
- nautobot/dcim/tests/test_filters.py +156 -134
- nautobot/dcim/tests/test_forms.py +12 -213
- nautobot/dcim/tests/test_graphql.py +8 -3
- nautobot/dcim/tests/test_migrations.py +6 -11
- nautobot/dcim/tests/test_models.py +208 -158
- nautobot/dcim/tests/test_natural_ordering.py +12 -14
- nautobot/dcim/tests/test_signals.py +7 -4
- nautobot/dcim/tests/test_views.py +270 -264
- nautobot/dcim/urls.py +21 -26
- nautobot/dcim/views.py +14 -156
- nautobot/docs/additional-features/caching.md +6 -87
- nautobot/docs/additional-features/job-scheduling-and-approvals.md +3 -0
- nautobot/docs/additional-features/jobs.md +179 -197
- nautobot/docs/administration/nautobot-server.md +9 -24
- nautobot/docs/administration/nautobot-shell.md +6 -6
- nautobot/docs/administration/replicating-nautobot.md +0 -10
- nautobot/docs/configuration/index.md +9 -9
- nautobot/docs/configuration/optional-settings.md +32 -61
- nautobot/docs/configuration/required-settings.md +11 -52
- nautobot/docs/development/application-registry.md +2 -13
- nautobot/docs/development/best-practices.md +2 -1
- nautobot/docs/development/docker-compose-advanced-use-cases.md +1 -1
- nautobot/docs/development/extending-models.md +15 -17
- nautobot/docs/development/generic-views.md +0 -2
- nautobot/docs/development/getting-started.md +56 -6
- nautobot/docs/development/navigation-menu.md +22 -93
- nautobot/docs/development/react-ui.md +105 -0
- nautobot/docs/development/release-checklist.md +3 -3
- nautobot/docs/development/role-internals.md +1 -3
- nautobot/docs/development/style-guide.md +6 -4
- nautobot/docs/development/templates.md +2 -1
- nautobot/docs/docker/index.md +16 -14
- nautobot/docs/index.md +7 -3
- nautobot/docs/installation/index.md +4 -1
- nautobot/docs/installation/migrating-from-netbox.md +12 -43
- nautobot/docs/installation/migrating-from-postgresql.md +1 -1
- nautobot/docs/installation/nautobot.md +1 -1
- nautobot/docs/installation/tables/v2-api-behavior-changes.yaml +70 -0
- nautobot/docs/installation/tables/v2-api-removed-fields.yaml +142 -0
- nautobot/docs/installation/tables/v2-api-renamed-fields.yaml +124 -0
- nautobot/docs/installation/tables/v2-code-location-changes.yaml +241 -0
- nautobot/docs/installation/tables/v2-code-removals.yaml +67 -0
- nautobot/docs/installation/tables/v2-database-behavior-changes.yaml +37 -0
- nautobot/docs/installation/tables/v2-database-removed-fields.yaml +166 -0
- nautobot/docs/installation/tables/v2-database-renamed-fields.yaml +340 -0
- nautobot/docs/installation/tables/v2-filters-corrected-fields.yaml +28 -0
- nautobot/docs/installation/tables/v2-filters-enhanced-fields.yaml +241 -0
- nautobot/docs/installation/tables/v2-filters-removed-fields.yaml +553 -0
- nautobot/docs/installation/tables/v2-filters-renamed-fields.yaml +223 -0
- nautobot/docs/installation/tables/v2-logging-renamed-loggers.yaml +23 -0
- nautobot/docs/installation/upgrading-from-nautobot-v1.md +190 -636
- nautobot/docs/installation/upgrading.md +5 -2
- nautobot/docs/models/dcim/device.md +3 -0
- nautobot/docs/models/dcim/deviceredundancygroup.md +3 -3
- nautobot/docs/models/extras/computedfield.md +4 -4
- nautobot/docs/models/extras/dynamicgroup.md +9 -9
- nautobot/docs/models/extras/gitrepository.md +3 -0
- nautobot/docs/models/extras/job.md +1 -0
- nautobot/docs/models/extras/jobbutton.md +18 -13
- nautobot/docs/models/extras/jobhook.md +7 -4
- nautobot/docs/models/extras/jobresult.md +6 -2
- nautobot/docs/models/extras/relationship.md +2 -2
- nautobot/docs/models/extras/status.md +6 -19
- nautobot/docs/models/ipam/ipaddress.md +3 -0
- nautobot/docs/models/ipam/vrf.md +0 -3
- nautobot/docs/models/virtualization/virtualmachine.md +3 -0
- nautobot/docs/plugins/development.md +92 -24
- nautobot/docs/release-notes/version-1.5.md +96 -0
- nautobot/docs/release-notes/version-2.0.md +216 -0
- nautobot/docs/requirements.txt +5 -4
- nautobot/docs/rest-api/overview.md +384 -215
- nautobot/docs/rest-api/ui-related-endpoints.md +9 -0
- nautobot/extras/admin.py +3 -5
- nautobot/extras/api/customfields.py +15 -39
- nautobot/extras/api/fields.py +0 -11
- nautobot/extras/api/mixins.py +45 -0
- nautobot/extras/api/relationships.py +63 -159
- nautobot/extras/api/serializers.py +165 -706
- nautobot/extras/api/urls.py +1 -1
- nautobot/extras/api/views.py +295 -282
- nautobot/extras/apps.py +4 -7
- nautobot/extras/choices.py +11 -22
- nautobot/extras/constants.py +9 -3
- nautobot/extras/datasources/__init__.py +2 -0
- nautobot/extras/datasources/git.py +135 -186
- nautobot/extras/datasources/registry.py +25 -35
- nautobot/extras/factory.py +1 -3
- nautobot/extras/filters/__init__.py +49 -47
- nautobot/extras/filters/mixins.py +10 -8
- nautobot/extras/forms/forms.py +72 -148
- nautobot/extras/forms/mixins.py +34 -57
- nautobot/extras/health_checks.py +0 -33
- nautobot/extras/jobs.py +387 -566
- nautobot/extras/management/__init__.py +55 -48
- nautobot/extras/management/commands/renaturalize.py +0 -1
- nautobot/extras/management/commands/runjob.py +24 -62
- nautobot/extras/management/commands/webhook_receiver.py +0 -1
- nautobot/extras/managers.py +30 -7
- nautobot/extras/migrations/0001_initial_part_1.py +0 -1
- nautobot/extras/migrations/0002_initial_part_2.py +0 -1
- nautobot/extras/migrations/0003_initial_part_3.py +0 -1
- nautobot/extras/migrations/0004_populate_default_status_records.py +0 -1
- nautobot/extras/migrations/0005_configcontext_device_types.py +0 -1
- nautobot/extras/migrations/0006_graphqlquery.py +0 -1
- nautobot/extras/migrations/0007_configcontextschema.py +0 -1
- nautobot/extras/migrations/0008_jobresult__custom_field_data.py +0 -1
- nautobot/extras/migrations/0009_computedfield.py +0 -1
- nautobot/extras/migrations/0010_change_cf_validation_max_min_field_to_bigint.py +0 -1
- nautobot/extras/migrations/0011_fileattachment_fileproxy.py +0 -1
- nautobot/extras/migrations/0012_healthchecktestmodel.py +0 -1
- nautobot/extras/migrations/0013_default_fallback_value_computedfield.py +0 -1
- nautobot/extras/migrations/0014_auto_slug.py +0 -1
- nautobot/extras/migrations/0015_scheduled_job.py +0 -1
- nautobot/extras/migrations/0016_secret.py +0 -1
- nautobot/extras/migrations/0017_joblogentry.py +0 -1
- nautobot/extras/migrations/0018_joblog_data_migration.py +0 -2
- nautobot/extras/migrations/0019_joblogentry__meta_options__related_name.py +0 -1
- nautobot/extras/migrations/0020_customfield_changelog.py +0 -1
- nautobot/extras/migrations/0021_customfield_changelog_data.py +0 -1
- nautobot/extras/migrations/0022_objectchange_object_datav2.py +0 -1
- nautobot/extras/migrations/0023_job_model.py +0 -1
- nautobot/extras/migrations/0024_job_data_migration.py +0 -1
- nautobot/extras/migrations/0025_add_advanced_ui_boolean_to_customfield_conputedfield_and_relationship.py +0 -1
- nautobot/extras/migrations/0026_job_add_gitrepository_fk.py +0 -1
- nautobot/extras/migrations/0027_job_gitrepository_data_migration.py +0 -1
- nautobot/extras/migrations/0028_job_reduce_source.py +0 -1
- nautobot/extras/migrations/0029_dynamicgroup.py +0 -1
- nautobot/extras/migrations/0030_webhook_alter_unique_together.py +0 -1
- nautobot/extras/migrations/0031_tag_content_types.py +0 -1
- nautobot/extras/migrations/0032_tag_content_types_data_migration.py +0 -1
- nautobot/extras/migrations/0033_add__optimized_indexing.py +0 -1
- nautobot/extras/migrations/0034_alter_fileattachment_mimetype.py +0 -1
- nautobot/extras/migrations/0035_scheduledjob_crontab.py +0 -1
- nautobot/extras/migrations/0036_job_add_has_sensitive_variables.py +0 -1
- nautobot/extras/migrations/0037_configcontextschema__remove_name_unique__create_constraint_unique_name_owner.py +0 -1
- nautobot/extras/migrations/0038_configcontext_locations.py +0 -1
- nautobot/extras/migrations/0039_objectchange__add_change_context.py +0 -1
- nautobot/extras/migrations/0040_dynamicgroup__dynamicgroupmembership.py +0 -1
- nautobot/extras/migrations/0041_jobresult_job_kwargs.py +0 -1
- nautobot/extras/migrations/0042_job__add_is_job_hook_receiver.py +0 -1
- nautobot/extras/migrations/0043_note.py +0 -1
- nautobot/extras/migrations/0044_add_job_hook.py +0 -1
- nautobot/extras/migrations/0045_add_custom_field_slug.py +0 -1
- nautobot/extras/migrations/0046_populate_custom_field_slug_label.py +0 -1
- nautobot/extras/migrations/0047_enforce_custom_field_slug.py +0 -1
- nautobot/extras/migrations/0048_alter_objectchange_change_context_detail.py +0 -1
- nautobot/extras/migrations/0049_alter_tag_slug.py +0 -1
- nautobot/extras/migrations/0050_customfield_grouping.py +0 -1
- nautobot/extras/migrations/0051_add_job_task_queues.py +0 -1
- nautobot/extras/migrations/0052_configcontext_device_redundancy_groups.py +0 -1
- nautobot/extras/migrations/0053_relationship_required_on.py +0 -1
- nautobot/extras/migrations/0054_scheduledjob_kwargs_request_user_change.py +0 -1
- nautobot/extras/migrations/0055_configcontext_dynamic_groups.py +0 -1
- nautobot/extras/migrations/0056_objectchange_add_reverse_time_idx.py +0 -1
- nautobot/extras/migrations/0057_jobbutton.py +0 -1
- nautobot/extras/migrations/0058_jobresult_add_time_status_idxs.py +38 -0
- nautobot/extras/migrations/{0058_joblogentry_scheduledjob_webhook_data_migration.py → 0059_joblogentry_scheduledjob_webhook_data_migration.py} +1 -2
- nautobot/extras/migrations/{0059_alter_joblogentry_scheduledjob_webhook_fields.py → 0060_alter_joblogentry_scheduledjob_webhook_fields.py} +1 -2
- nautobot/extras/migrations/{0060_role_and_alter_status.py → 0061_role_and_alter_status.py} +1 -8
- nautobot/extras/migrations/{0061_collect_roles_from_related_apps_roles.py → 0062_collect_roles_from_related_apps_roles.py} +33 -33
- nautobot/extras/migrations/{0062_alter_role_options.py → 0063_alter_role_options.py} +1 -2
- nautobot/extras/migrations/{0063_alter_configcontext_and_add_new_role.py → 0064_alter_configcontext_and_add_new_role.py} +1 -2
- nautobot/extras/migrations/0065_configcontext_data_migrations.py +44 -0
- nautobot/extras/migrations/{0065_rename_configcontext_role.py → 0066_rename_configcontext_role.py} +1 -2
- nautobot/extras/migrations/{0066_jobresult__add_celery_fields.py → 0067_jobresult__add_celery_fields.py} +36 -3
- nautobot/extras/migrations/{0067_created_datetime.py → 0068_created_datetime.py} +1 -2
- nautobot/extras/migrations/{0068_remove_site_and_region_attributes_from_config_context.py → 0069_remove_site_and_region_attributes_from_config_context.py} +1 -2
- nautobot/extras/migrations/{0069_replace_related_names.py → 0070_replace_related_names.py} +1 -1
- nautobot/extras/migrations/{0070_rename_model_fields.py → 0071_rename_model_fields.py} +1 -2
- nautobot/extras/migrations/0072_job__unique_name_data_migration.py +86 -0
- nautobot/extras/migrations/{0072_job__unique_name.py → 0073_job__unique_name.py} +13 -10
- nautobot/extras/migrations/{0073_remove_gitrepository_fields.py → 0074_remove_gitrepository_fields.py} +1 -2
- nautobot/extras/migrations/{0074_rename_slug_to_key_for_custom_field.py → 0075_rename_slug_to_key_for_custom_field.py} +1 -1
- nautobot/extras/migrations/{0075_migrate_custom_field_data.py → 0076_migrate_custom_field_data.py} +1 -1
- nautobot/extras/migrations/{0076_remove_name_field_and_make_label_field_non_nullable.py → 0077_remove_name_field_and_make_label_field_non_nullable.py} +1 -1
- nautobot/extras/migrations/0078_remove_slug.py +45 -0
- nautobot/extras/migrations/0079_tagsfield.py +28 -0
- nautobot/extras/migrations/0080_rename_relationship_slug_to_key.py +17 -0
- nautobot/extras/migrations/0081_rename_relationship_name_to_label.py +29 -0
- nautobot/extras/migrations/0082_ensure_relationship_keys_are_unique.py +43 -0
- nautobot/extras/migrations/0083_rename_computed_field_slug_to_key.py +21 -0
- nautobot/extras/migrations/0084_taggeditem_cleanup.py +43 -0
- nautobot/extras/migrations/0085_taggeditem_uniqueness.py +22 -0
- nautobot/extras/migrations/0086_job__celery_task_fields__dryrun_support.py +81 -0
- nautobot/extras/migrations/0087_job__commit_default_data_migration.py +26 -0
- nautobot/extras/migrations/0088_joblogentry__log_level_default.py +17 -0
- nautobot/extras/migrations/0089_joblogentry__log_level_data_migration.py +34 -0
- nautobot/extras/migrations/0090_scheduledjob__data_migration.py +57 -0
- nautobot/extras/models/__init__.py +2 -3
- nautobot/extras/models/change_logging.py +0 -36
- nautobot/extras/models/customfields.py +39 -33
- nautobot/extras/models/datasources.py +48 -50
- nautobot/extras/models/groups.py +5 -12
- nautobot/extras/models/jobs.py +190 -323
- nautobot/extras/models/mixins.py +0 -71
- nautobot/extras/models/models.py +1 -22
- nautobot/extras/models/relationships.py +20 -21
- nautobot/extras/models/roles.py +0 -23
- nautobot/extras/models/secrets.py +2 -31
- nautobot/extras/models/statuses.py +6 -5
- nautobot/extras/models/tags.py +2 -17
- nautobot/extras/navigation.py +89 -307
- nautobot/extras/plugins/__init__.py +3 -121
- nautobot/extras/plugins/utils.py +0 -3
- nautobot/extras/plugins/validators.py +5 -4
- nautobot/extras/plugins/views.py +16 -4
- nautobot/extras/querysets.py +1 -7
- nautobot/extras/registry.py +3 -0
- nautobot/extras/signals.py +26 -60
- nautobot/extras/tables.py +42 -49
- nautobot/extras/tasks.py +0 -12
- nautobot/extras/templates/extras/configcontext.html +1 -1
- nautobot/extras/templates/extras/configcontextschema.html +16 -1
- nautobot/extras/templates/extras/customfield.html +0 -13
- nautobot/extras/templates/extras/dynamicgroup_edit.html +0 -1
- nautobot/extras/templates/extras/gitrepository.html +3 -3
- nautobot/extras/templates/extras/inc/jobresult.html +10 -0
- nautobot/extras/templates/extras/inc/panel_jobhistory.html +1 -1
- nautobot/extras/templates/extras/job.html +35 -25
- nautobot/extras/templates/extras/job_approval_request.html +15 -30
- nautobot/extras/templates/extras/job_detail.html +13 -31
- nautobot/extras/templates/extras/job_edit.html +14 -17
- nautobot/extras/templates/extras/jobresult.html +24 -6
- nautobot/extras/templates/extras/objectchange_list.html +1 -1
- nautobot/extras/templates/extras/scheduledjob.html +2 -2
- nautobot/extras/templates/extras/secret.html +28 -0
- nautobot/extras/templates/extras/secret_edit.html +0 -1
- nautobot/extras/templates/extras/secretsgroup_edit.html +0 -1
- nautobot/extras/templatetags/custom_links.py +0 -2
- nautobot/extras/templatetags/job_buttons.py +1 -0
- nautobot/extras/templatetags/plugins.py +0 -1
- nautobot/extras/{tests/example_jobs → test_jobs}/api_test_job.py +13 -6
- nautobot/extras/test_jobs/atomic_transaction.py +53 -0
- nautobot/extras/test_jobs/dry_run.py +29 -0
- nautobot/extras/{tests/example_jobs/test_duplicate_name.py → test_jobs/duplicate_name.py} +4 -0
- nautobot/extras/test_jobs/duplicate_name2.py +9 -0
- nautobot/extras/test_jobs/fail.py +23 -0
- nautobot/extras/{tests/example_jobs/test_field_default.py → test_jobs/field_default.py} +4 -0
- nautobot/extras/{tests/example_jobs/test_field_order.py → test_jobs/field_order.py} +4 -0
- nautobot/extras/{tests/example_jobs/test_file_upload_fail.py → test_jobs/file_upload_fail.py} +11 -6
- nautobot/extras/test_jobs/file_upload_pass.py +25 -0
- nautobot/extras/test_jobs/has_sensitive_variables.py +25 -0
- nautobot/extras/test_jobs/ipaddress_vars.py +66 -0
- nautobot/extras/test_jobs/job_button_receiver.py +28 -0
- nautobot/extras/test_jobs/job_hook_receiver.py +29 -0
- nautobot/extras/test_jobs/job_variables.py +88 -0
- nautobot/extras/test_jobs/location_with_custom_field.py +45 -0
- nautobot/extras/test_jobs/log_redaction.py +20 -0
- nautobot/extras/test_jobs/log_skip_db_logging.py +17 -0
- nautobot/extras/test_jobs/modify_db.py +25 -0
- nautobot/extras/{tests/example_jobs/test_no_field_order.py → test_jobs/no_field_order.py} +4 -0
- nautobot/extras/test_jobs/object_var_optional.py +21 -0
- nautobot/extras/test_jobs/object_var_required.py +21 -0
- nautobot/extras/test_jobs/object_vars.py +26 -0
- nautobot/extras/test_jobs/pass.py +25 -0
- nautobot/extras/test_jobs/profiling.py +32 -0
- nautobot/extras/test_jobs/read_only_job.py +15 -0
- nautobot/extras/{tests/example_jobs/test_required_args.py → test_jobs/required_args.py} +4 -0
- nautobot/extras/{tests/example_jobs/test_soft_time_limit_greater_than_time_limit.py → test_jobs/soft_time_limit_greater_than_time_limit.py} +5 -1
- nautobot/extras/{tests/example_jobs/test_task_queues.py → test_jobs/task_queues.py} +5 -1
- nautobot/extras/tests/integration/__init__.py +3 -3
- nautobot/extras/tests/integration/test_computedfields.py +1 -1
- nautobot/extras/tests/integration/test_configcontextschema.py +7 -5
- nautobot/extras/tests/integration/test_customfields.py +4 -2
- nautobot/extras/tests/integration/test_dynamicgroups.py +2 -2
- nautobot/extras/tests/integration/test_jobs.py +25 -27
- nautobot/extras/tests/integration/test_notes.py +8 -4
- nautobot/extras/tests/integration/test_plugins.py +4 -4
- nautobot/extras/tests/integration/test_relationships.py +2 -2
- nautobot/extras/tests/test_api.py +371 -381
- nautobot/extras/tests/test_changelog.py +17 -16
- nautobot/extras/tests/test_context_managers.py +5 -6
- nautobot/extras/tests/test_customfields.py +112 -73
- nautobot/extras/tests/test_datasources.py +191 -117
- nautobot/extras/tests/test_dynamicgroups.py +45 -68
- nautobot/extras/tests/test_filters.py +170 -130
- nautobot/extras/tests/test_forms.py +107 -109
- nautobot/extras/tests/{test_scripts.py → test_job_variables.py} +43 -49
- nautobot/extras/tests/test_jobs.py +271 -273
- nautobot/extras/tests/test_management.py +3 -6
- nautobot/extras/tests/test_migrations.py +5 -3
- nautobot/extras/tests/test_models.py +121 -173
- nautobot/extras/tests/test_notes.py +0 -1
- nautobot/extras/tests/test_plugins.py +55 -89
- nautobot/extras/tests/test_relationships.py +174 -130
- nautobot/extras/tests/test_tags.py +6 -12
- nautobot/extras/tests/test_utils.py +31 -1
- nautobot/extras/tests/test_views.py +223 -184
- nautobot/extras/tests/test_webhooks.py +16 -15
- nautobot/extras/urls.py +69 -69
- nautobot/extras/utils.py +137 -163
- nautobot/extras/views.py +81 -153
- nautobot/ipam/api/fields.py +17 -0
- nautobot/ipam/api/serializers.py +77 -164
- nautobot/ipam/api/urls.py +4 -1
- nautobot/ipam/api/views.py +28 -19
- nautobot/ipam/apps.py +1 -0
- nautobot/ipam/choices.py +5 -12
- nautobot/ipam/constants.py +1 -0
- nautobot/ipam/factory.py +41 -30
- nautobot/ipam/filters.py +58 -25
- nautobot/ipam/forms.py +82 -211
- nautobot/ipam/graphql/types.py +0 -9
- nautobot/ipam/lookups.py +13 -8
- nautobot/ipam/management/commands/__init__.py +0 -0
- nautobot/ipam/management/commands/fix_prefix_broadcast.py +17 -0
- nautobot/ipam/migrations/0001_initial_part_1.py +0 -1
- nautobot/ipam/migrations/0002_initial_part_2.py +0 -1
- nautobot/ipam/migrations/0003_remove_max_length.py +0 -1
- nautobot/ipam/migrations/0004_fixup_p2p_broadcast.py +0 -1
- nautobot/ipam/migrations/0005_auto_slug.py +0 -1
- nautobot/ipam/migrations/0006_ipaddress_nat_outside_list.py +0 -1
- nautobot/ipam/migrations/0007_add_natural_indexing.py +0 -1
- nautobot/ipam/migrations/0008_prefix_vlan_vlangroup_location.py +0 -1
- nautobot/ipam/migrations/0009_alter_vlan_name.py +0 -1
- nautobot/ipam/migrations/0010_alter_ipam_role_add_new_role.py +1 -2
- nautobot/ipam/migrations/0011_migrate_ipam_role_data.py +32 -39
- nautobot/ipam/migrations/0012_rename_ipam_roles.py +0 -1
- nautobot/ipam/migrations/0013_delete_role.py +0 -1
- nautobot/ipam/migrations/0014_rename_foreign_keys_and_related_names.py +0 -1
- nautobot/ipam/migrations/0015_prefix_add_type.py +0 -1
- nautobot/ipam/migrations/0016_prefix_type_data_migration.py +0 -3
- nautobot/ipam/migrations/0017_prefix_remove_is_pool.py +0 -1
- nautobot/ipam/migrations/0018_remove_site_foreign_key_from_ipam_models.py +0 -1
- nautobot/ipam/migrations/0019_created_datetime.py +0 -1
- nautobot/ipam/migrations/0020_related_name_changes.py +1 -2
- nautobot/ipam/migrations/0021_prefix_add_rir_and_date_allocated.py +0 -1
- nautobot/ipam/migrations/0022_aggregate_to_prefix_data_migration.py +3 -5
- nautobot/ipam/migrations/0023_delete_aggregate.py +0 -1
- nautobot/ipam/migrations/0024_interface_to_ipaddress_m2m.py +0 -1
- nautobot/ipam/migrations/0025_interface_ipaddress_m2m_data_migration.py +0 -1
- nautobot/ipam/migrations/0026_ipaddress_remove_assigned_object.py +0 -1
- nautobot/ipam/migrations/0027_remove_rir_slug.py +16 -0
- nautobot/ipam/migrations/0028_tagsfield.py +44 -0
- nautobot/ipam/migrations/0029_ip_address_to_interface_uniqueness_constraints.py +18 -0
- nautobot/ipam/migrations/0030_ipam__namespaces.py +231 -0
- nautobot/ipam/migrations/0031_ipam__prefix__add_parent.py +58 -0
- nautobot/ipam/migrations/0032_ipam__namespaces_finish.py +63 -0
- nautobot/ipam/migrations/0033_fixup_null_statuses.py +26 -0
- nautobot/ipam/migrations/0034_status_nonnullable.py +36 -0
- nautobot/ipam/models.py +579 -368
- nautobot/ipam/navigation.py +36 -159
- nautobot/ipam/querysets.py +117 -90
- nautobot/ipam/signals.py +89 -0
- nautobot/ipam/tables.py +86 -28
- nautobot/ipam/templates/ipam/ipaddress.html +14 -30
- nautobot/ipam/templates/ipam/ipaddress_edit.html +1 -0
- nautobot/ipam/templates/ipam/namespace_ipaddresses.html +11 -0
- nautobot/ipam/templates/ipam/namespace_prefixes.html +11 -0
- nautobot/ipam/templates/ipam/namespace_retrieve.html +42 -0
- nautobot/ipam/templates/ipam/namespace_vrfs.html +11 -0
- nautobot/ipam/templates/ipam/prefix.html +27 -33
- nautobot/ipam/templates/ipam/prefix_edit.html +7 -1
- nautobot/ipam/templates/ipam/vlangroup.html +0 -13
- nautobot/ipam/templates/ipam/vrf.html +6 -4
- nautobot/ipam/templates/ipam/vrf_edit.html +20 -2
- nautobot/ipam/tests/integration/test_prefixes.py +4 -27
- nautobot/ipam/tests/test_api.py +60 -61
- nautobot/ipam/tests/test_filters.py +187 -126
- nautobot/ipam/tests/test_forms.py +12 -6
- nautobot/ipam/tests/test_graphql.py +8 -6
- nautobot/ipam/tests/test_migrations.py +8 -13
- nautobot/ipam/tests/test_models.py +426 -274
- nautobot/ipam/tests/test_ordering.py +6 -3
- nautobot/ipam/tests/test_querysets.py +340 -96
- nautobot/ipam/tests/test_views.py +100 -55
- nautobot/ipam/urls.py +28 -5
- nautobot/ipam/{utils.py → utils/__init__.py} +2 -2
- nautobot/ipam/utils/migrations.py +713 -0
- nautobot/ipam/views.py +237 -122
- nautobot/project-static/docs/404.html +1399 -166
- nautobot/project-static/docs/additional-features/caching.html +1416 -320
- nautobot/project-static/docs/additional-features/change-logging.html +1389 -190
- nautobot/project-static/docs/additional-features/config-contexts.html +1389 -190
- nautobot/project-static/docs/additional-features/graphql.html +1389 -190
- nautobot/project-static/docs/additional-features/healthcheck.html +1389 -190
- nautobot/project-static/docs/additional-features/job-scheduling-and-approvals.html +1393 -190
- nautobot/project-static/docs/additional-features/jobs.html +1677 -460
- nautobot/project-static/docs/additional-features/napalm.html +1389 -190
- nautobot/project-static/docs/additional-features/prometheus-metrics.html +1389 -190
- nautobot/project-static/docs/additional-features/template-filters.html +1389 -190
- nautobot/project-static/docs/administration/celery-queues.html +1389 -190
- nautobot/project-static/docs/administration/nautobot-server.html +1553 -375
- nautobot/project-static/docs/administration/nautobot-shell.html +1395 -196
- nautobot/project-static/docs/administration/permissions.html +1389 -190
- nautobot/project-static/docs/administration/replicating-nautobot.html +1387 -207
- nautobot/project-static/docs/apps/index.html +1389 -190
- nautobot/project-static/docs/apps/nautobot-apps.html +1387 -175
- nautobot/project-static/docs/assets/javascripts/bundle.51198bba.min.js +29 -0
- nautobot/project-static/docs/assets/javascripts/bundle.51198bba.min.js.map +8 -0
- nautobot/project-static/docs/assets/javascripts/workers/{search.16e2a7d4.min.js → search.208ed371.min.js} +9 -15
- nautobot/project-static/docs/assets/javascripts/workers/{search.16e2a7d4.min.js.map → search.208ed371.min.js.map} +4 -4
- nautobot/project-static/docs/assets/stylesheets/main.ded33207.min.css +1 -0
- nautobot/project-static/docs/assets/stylesheets/main.ded33207.min.css.map +1 -0
- nautobot/project-static/docs/assets/stylesheets/palette.a0c5b2b5.min.css +1 -0
- nautobot/project-static/docs/assets/stylesheets/palette.a0c5b2b5.min.css.map +1 -0
- nautobot/project-static/docs/code-reference/nautobot/apps/__init__.html +1775 -590
- nautobot/project-static/docs/code-reference/nautobot/apps/admin.html +1389 -190
- nautobot/project-static/docs/code-reference/nautobot/apps/api.html +3588 -1922
- nautobot/project-static/docs/code-reference/nautobot/apps/choices.html +1461 -262
- nautobot/project-static/docs/code-reference/nautobot/apps/config.html +1401 -170
- nautobot/project-static/docs/code-reference/nautobot/apps/datasources.html +1396 -191
- nautobot/project-static/docs/code-reference/nautobot/apps/filters.html +2095 -894
- nautobot/project-static/docs/code-reference/nautobot/apps/forms.html +2357 -1194
- nautobot/project-static/docs/code-reference/nautobot/apps/models.html +2258 -940
- nautobot/project-static/docs/code-reference/nautobot/apps/secrets.html +1389 -190
- nautobot/project-static/docs/code-reference/nautobot/apps/tables.html +1400 -201
- nautobot/project-static/docs/code-reference/nautobot/apps/testing.html +11068 -7861
- nautobot/project-static/docs/code-reference/nautobot/apps/ui.html +2867 -2224
- nautobot/project-static/docs/code-reference/nautobot/apps/urls.html +1389 -190
- nautobot/project-static/docs/code-reference/nautobot/apps/views.html +2641 -1573
- nautobot/project-static/docs/configuration/authentication/ldap.html +1389 -190
- nautobot/project-static/docs/configuration/authentication/remote.html +1389 -190
- nautobot/project-static/docs/configuration/authentication/sso.html +1389 -190
- nautobot/project-static/docs/configuration/index.html +1398 -199
- nautobot/project-static/docs/configuration/optional-settings.html +1418 -274
- nautobot/project-static/docs/configuration/required-settings.html +1419 -287
- nautobot/project-static/docs/core-functionality/circuits.html +1446 -247
- nautobot/project-static/docs/core-functionality/device-types.html +1448 -249
- nautobot/project-static/docs/core-functionality/devices.html +1452 -249
- nautobot/project-static/docs/core-functionality/ipam.html +1452 -253
- nautobot/project-static/docs/core-functionality/power.html +1448 -249
- nautobot/project-static/docs/core-functionality/secrets.html +1448 -249
- nautobot/project-static/docs/core-functionality/services.html +1448 -249
- nautobot/project-static/docs/core-functionality/sites-and-racks.html +1448 -249
- nautobot/project-static/docs/core-functionality/tenancy.html +1448 -249
- nautobot/project-static/docs/core-functionality/virtualization.html +1452 -249
- nautobot/project-static/docs/core-functionality/vlans.html +1448 -249
- nautobot/project-static/docs/development/application-registry.html +1393 -214
- nautobot/project-static/docs/development/best-practices.html +1392 -192
- nautobot/project-static/docs/development/docker-compose-advanced-use-cases.html +1390 -191
- nautobot/project-static/docs/development/extending-models.html +1443 -257
- nautobot/project-static/docs/development/generic-views.html +1403 -174
- nautobot/project-static/docs/development/getting-started.html +1568 -262
- nautobot/project-static/docs/development/homepage.html +1389 -190
- nautobot/project-static/docs/development/index.html +1389 -190
- nautobot/project-static/docs/development/model-features.html +1389 -190
- nautobot/project-static/docs/development/natural-keys.html +1389 -190
- nautobot/project-static/docs/development/navigation-menu.html +1451 -330
- nautobot/project-static/docs/development/react-ui.html +4199 -0
- nautobot/project-static/docs/development/release-checklist.html +1392 -193
- nautobot/project-static/docs/development/role-internals.html +1402 -172
- nautobot/project-static/docs/development/style-guide.html +1399 -199
- nautobot/project-static/docs/development/templates.html +1391 -191
- nautobot/project-static/docs/development/testing.html +1389 -190
- nautobot/project-static/docs/development/user-preferences.html +1389 -190
- nautobot/project-static/docs/docker/index.html +1408 -206
- nautobot/project-static/docs/index.html +1397 -180
- nautobot/project-static/docs/installation/centos.html +1401 -170
- nautobot/project-static/docs/installation/external-authentication.html +1389 -190
- nautobot/project-static/docs/installation/http-server.html +1389 -190
- nautobot/project-static/docs/installation/index.html +1394 -191
- nautobot/project-static/docs/installation/migrating-from-netbox.html +1452 -305
- nautobot/project-static/docs/installation/migrating-from-postgresql.html +1390 -191
- nautobot/project-static/docs/installation/nautobot.html +1390 -191
- nautobot/project-static/docs/installation/region-and-site-data-migration-guide.html +1389 -190
- nautobot/project-static/docs/installation/selinux-troubleshooting.html +1401 -170
- nautobot/project-static/docs/installation/services.html +1389 -190
- nautobot/project-static/docs/installation/tables/v2-api-behavior-changes.yaml +70 -0
- nautobot/project-static/docs/installation/tables/v2-api-removed-fields.yaml +142 -0
- nautobot/project-static/docs/installation/tables/v2-api-renamed-fields.yaml +124 -0
- nautobot/project-static/docs/installation/tables/v2-code-location-changes.yaml +241 -0
- nautobot/project-static/docs/installation/tables/v2-code-removals.yaml +67 -0
- nautobot/project-static/docs/installation/tables/v2-database-behavior-changes.yaml +37 -0
- nautobot/project-static/docs/installation/tables/v2-database-removed-fields.yaml +166 -0
- nautobot/project-static/docs/installation/tables/v2-database-renamed-fields.yaml +340 -0
- nautobot/project-static/docs/installation/tables/v2-filters-corrected-fields.yaml +28 -0
- nautobot/project-static/docs/installation/tables/v2-filters-enhanced-fields.yaml +241 -0
- nautobot/project-static/docs/installation/tables/v2-filters-removed-fields.yaml +553 -0
- nautobot/project-static/docs/installation/tables/v2-filters-renamed-fields.yaml +223 -0
- nautobot/project-static/docs/installation/tables/v2-logging-renamed-loggers.yaml +23 -0
- nautobot/project-static/docs/installation/ubuntu.html +1401 -170
- nautobot/project-static/docs/installation/upgrading-from-nautobot-v1.html +4254 -1923
- nautobot/project-static/docs/installation/upgrading.html +1395 -192
- nautobot/project-static/docs/models/circuits/circuit.html +1427 -174
- nautobot/project-static/docs/models/circuits/circuittermination.html +1427 -174
- nautobot/project-static/docs/models/circuits/circuittype.html +1427 -174
- nautobot/project-static/docs/models/circuits/provider.html +1427 -174
- nautobot/project-static/docs/models/circuits/providernetwork.html +1427 -174
- nautobot/project-static/docs/models/dcim/cable.html +1458 -174
- nautobot/project-static/docs/models/dcim/consoleport.html +1427 -174
- nautobot/project-static/docs/models/dcim/consoleporttemplate.html +1427 -174
- nautobot/project-static/docs/models/dcim/consoleserverport.html +1427 -174
- nautobot/project-static/docs/models/dcim/consoleserverporttemplate.html +1427 -174
- nautobot/project-static/docs/models/dcim/device.html +1431 -174
- nautobot/project-static/docs/models/dcim/devicebay.html +1427 -174
- nautobot/project-static/docs/models/dcim/devicebaytemplate.html +1427 -174
- nautobot/project-static/docs/models/dcim/deviceredundancygroup.html +1522 -177
- nautobot/project-static/docs/models/dcim/devicetype.html +1427 -174
- nautobot/project-static/docs/models/dcim/frontport.html +1427 -174
- nautobot/project-static/docs/models/dcim/frontporttemplate.html +1427 -174
- nautobot/project-static/docs/models/dcim/interface.html +1427 -174
- nautobot/project-static/docs/models/dcim/interfacetemplate.html +1427 -174
- nautobot/project-static/docs/models/dcim/inventoryitem.html +1427 -174
- nautobot/project-static/docs/models/dcim/location.html +1427 -174
- nautobot/project-static/docs/models/dcim/locationtype.html +1427 -174
- nautobot/project-static/docs/models/dcim/manufacturer.html +1427 -174
- nautobot/project-static/docs/models/dcim/platform.html +1427 -174
- nautobot/project-static/docs/models/dcim/powerfeed.html +1425 -172
- nautobot/project-static/docs/models/dcim/poweroutlet.html +1427 -174
- nautobot/project-static/docs/models/dcim/poweroutlettemplate.html +1427 -174
- nautobot/project-static/docs/models/dcim/powerpanel.html +1425 -172
- nautobot/project-static/docs/models/dcim/powerport.html +1427 -174
- nautobot/project-static/docs/models/dcim/powerporttemplate.html +1427 -174
- nautobot/project-static/docs/models/dcim/rack.html +1427 -174
- nautobot/project-static/docs/models/dcim/rackgroup.html +1427 -174
- nautobot/project-static/docs/models/dcim/rackreservation.html +1427 -174
- nautobot/project-static/docs/models/dcim/rearport.html +1427 -174
- nautobot/project-static/docs/models/dcim/rearporttemplate.html +1427 -174
- nautobot/project-static/docs/models/dcim/region.html +1401 -170
- nautobot/project-static/docs/models/dcim/site.html +1401 -170
- nautobot/project-static/docs/models/dcim/virtualchassis.html +1425 -172
- nautobot/project-static/docs/models/extras/computedfield.html +1393 -194
- nautobot/project-static/docs/models/extras/configcontext.html +1465 -174
- nautobot/project-static/docs/models/extras/configcontextschema.html +1421 -168
- nautobot/project-static/docs/models/extras/customfield.html +1389 -190
- nautobot/project-static/docs/models/extras/customlink.html +1389 -190
- nautobot/project-static/docs/models/extras/dynamicgroup.html +1398 -199
- nautobot/project-static/docs/models/extras/exporttemplate.html +1389 -190
- nautobot/project-static/docs/models/extras/gitrepository.html +1393 -190
- nautobot/project-static/docs/models/extras/graphqlquery.html +1469 -171
- nautobot/project-static/docs/models/extras/imageattachment.html +1434 -181
- nautobot/project-static/docs/models/extras/job.html +1411 -157
- nautobot/project-static/docs/models/extras/jobbutton.html +1410 -207
- nautobot/project-static/docs/models/extras/jobhook.html +1397 -194
- nautobot/project-static/docs/models/extras/joblogentry.html +1408 -155
- nautobot/project-static/docs/models/extras/jobresult.html +1417 -159
- nautobot/project-static/docs/models/extras/note.html +1389 -190
- nautobot/project-static/docs/models/extras/relationship.html +1391 -192
- nautobot/project-static/docs/models/extras/role.html +1495 -198
- nautobot/project-static/docs/models/extras/secret.html +1492 -201
- nautobot/project-static/docs/models/extras/secretsgroup.html +1410 -157
- nautobot/project-static/docs/models/extras/status.html +1381 -221
- nautobot/project-static/docs/models/extras/tag.html +1389 -190
- nautobot/project-static/docs/models/extras/webhook.html +1389 -190
- nautobot/project-static/docs/models/ipam/ipaddress.html +1488 -200
- nautobot/project-static/docs/models/ipam/prefix.html +1410 -157
- nautobot/project-static/docs/models/ipam/rir.html +1410 -157
- nautobot/project-static/docs/models/ipam/routetarget.html +1410 -157
- nautobot/project-static/docs/models/ipam/service.html +1410 -157
- nautobot/project-static/docs/models/ipam/vlan.html +1410 -157
- nautobot/project-static/docs/models/ipam/vlangroup.html +1410 -157
- nautobot/project-static/docs/models/ipam/vrf.html +1410 -161
- nautobot/project-static/docs/models/tenancy/tenant.html +1412 -159
- nautobot/project-static/docs/models/tenancy/tenantgroup.html +1412 -159
- nautobot/project-static/docs/models/users/objectpermission.html +1462 -171
- nautobot/project-static/docs/models/users/token.html +1410 -157
- nautobot/project-static/docs/models/virtualization/cluster.html +1410 -157
- nautobot/project-static/docs/models/virtualization/clustergroup.html +1410 -157
- nautobot/project-static/docs/models/virtualization/clustertype.html +1410 -157
- nautobot/project-static/docs/models/virtualization/virtualmachine.html +1414 -157
- nautobot/project-static/docs/models/virtualization/vminterface.html +1410 -157
- nautobot/project-static/docs/objects.inv +0 -0
- nautobot/project-static/docs/plugins/development.html +1916 -646
- nautobot/project-static/docs/plugins/index.html +1389 -190
- nautobot/project-static/docs/plugins/porting-from-netbox.html +1389 -190
- nautobot/project-static/docs/release-notes/index.html +1389 -190
- nautobot/project-static/docs/release-notes/version-1.0.html +1389 -190
- nautobot/project-static/docs/release-notes/version-1.1.html +1389 -190
- nautobot/project-static/docs/release-notes/version-1.2.html +1389 -190
- nautobot/project-static/docs/release-notes/version-1.3.html +1389 -190
- nautobot/project-static/docs/release-notes/version-1.4.html +1389 -190
- nautobot/project-static/docs/release-notes/version-1.5.html +2016 -397
- nautobot/project-static/docs/release-notes/version-2.0.html +1935 -287
- nautobot/project-static/docs/requirements.txt +5 -4
- nautobot/project-static/docs/rest-api/authentication.html +1389 -190
- nautobot/project-static/docs/rest-api/filtering.html +1389 -190
- nautobot/project-static/docs/rest-api/overview.html +2002 -576
- nautobot/project-static/docs/rest-api/ui-related-endpoints.html +4057 -0
- nautobot/project-static/docs/search/search_index.json +1 -1
- nautobot/project-static/docs/sitemap.xml +197 -187
- nautobot/project-static/docs/sitemap.xml.gz +0 -0
- nautobot/project-static/docs/user-guides/custom-fields.html +1390 -191
- nautobot/project-static/docs/user-guides/getting-started/creating-devices.html +1392 -193
- nautobot/project-static/docs/user-guides/getting-started/index.html +1388 -189
- nautobot/project-static/docs/user-guides/getting-started/interfaces.html +1388 -189
- nautobot/project-static/docs/user-guides/getting-started/ipam.html +1386 -187
- nautobot/project-static/docs/user-guides/getting-started/platforms.html +1448 -249
- nautobot/project-static/docs/user-guides/getting-started/regions.html +1411 -212
- nautobot/project-static/docs/user-guides/getting-started/search-bar.html +1395 -196
- nautobot/project-static/docs/user-guides/getting-started/tenants.html +1448 -249
- nautobot/project-static/docs/user-guides/getting-started/vlans-and-vlan-groups.html +1448 -249
- nautobot/project-static/docs/user-guides/git-data-source.html +1405 -206
- nautobot/project-static/docs/user-guides/graphql.html +1402 -203
- nautobot/project-static/docs/user-guides/relationships.html +1448 -249
- nautobot/project-static/docs/user-guides/s3-django-storage.html +1448 -249
- nautobot/project-static/js/forms.js +16 -9
- nautobot/project-static/js/theme.js +5 -0
- nautobot/tenancy/api/serializers.py +4 -34
- nautobot/tenancy/api/urls.py +1 -1
- nautobot/tenancy/filters/__init__.py +9 -7
- nautobot/tenancy/filters/mixins.py +3 -2
- nautobot/tenancy/forms.py +3 -36
- nautobot/tenancy/migrations/0001_initial.py +0 -1
- nautobot/tenancy/migrations/0002_auto_slug.py +0 -1
- nautobot/tenancy/migrations/0003_mptt_to_tree_queries.py +0 -1
- nautobot/tenancy/migrations/0004_change_tree_manager_on_tree_models.py +0 -1
- nautobot/tenancy/migrations/0005_rename_foreign_keys_and_related_names.py +0 -1
- nautobot/tenancy/migrations/0006_created_datetime.py +0 -1
- nautobot/tenancy/migrations/0007_remove_tenant_tenantgroup_slug.py +20 -0
- nautobot/tenancy/migrations/0008_tagsfield.py +19 -0
- nautobot/tenancy/models.py +0 -30
- nautobot/tenancy/navigation.py +6 -39
- nautobot/tenancy/tables.py +4 -4
- nautobot/tenancy/templates/tenancy/tenant.html +12 -12
- nautobot/tenancy/templates/tenancy/tenant_edit.html +0 -1
- nautobot/tenancy/templates/tenancy/tenantgroup.html +1 -1
- nautobot/tenancy/tests/test_api.py +1 -12
- nautobot/tenancy/tests/test_filters.py +20 -12
- nautobot/tenancy/tests/test_views.py +11 -29
- nautobot/tenancy/urls.py +10 -10
- nautobot/tenancy/views.py +0 -3
- nautobot/ui/.eslintignore +6 -0
- nautobot/ui/.gitignore +10 -0
- nautobot/ui/.prettierignore +9 -0
- nautobot/ui/.prettierrc +4 -0
- nautobot/ui/README.md +33 -0
- nautobot/ui/app_imports.js.j2 +7 -0
- nautobot/ui/craco.config.js +46 -0
- nautobot/ui/jsconfig-base.json +11 -0
- nautobot/ui/jsconfig.json +5 -0
- nautobot/ui/lib/nautobot-craco-alias-plugin.js +40 -0
- nautobot/ui/package-lock.json +21451 -0
- nautobot/ui/package.json +70 -0
- nautobot/ui/public/index.html +47 -0
- nautobot/ui/public/logo192.png +0 -0
- nautobot/ui/public/logo512.png +0 -0
- nautobot/ui/public/manifest.json +25 -0
- nautobot/ui/public/nautobot_logo.svg +131 -0
- nautobot/ui/public/robots.txt +3 -0
- nautobot/ui/src/App.js +71 -0
- nautobot/ui/src/components/AppFullWidthComponents.js +8 -0
- nautobot/ui/src/components/AppTab.js +40 -0
- nautobot/ui/src/components/Apps.js +60 -0
- nautobot/ui/src/components/HomeChangelogPanel.js +98 -0
- nautobot/ui/src/components/HomePanel.js +58 -0
- nautobot/ui/src/components/JobHistoryTable.js +78 -0
- nautobot/ui/src/components/Layout.js +53 -0
- nautobot/ui/src/components/LoadingWidget.js +25 -0
- nautobot/ui/src/components/Navbar.js +116 -0
- nautobot/ui/src/components/NotificationPopover.js +27 -0
- nautobot/ui/src/components/ObjectListTable.js +209 -0
- nautobot/ui/src/components/ReferenceDataTag.js +35 -0
- nautobot/ui/src/components/RouterButton.js +10 -0
- nautobot/ui/src/components/RouterLink.js +10 -0
- nautobot/ui/src/components/SidebarNav.js +147 -0
- nautobot/ui/src/components/Table.js +48 -0
- nautobot/ui/src/components/TableItem.js +71 -0
- nautobot/ui/src/components/__tests__/AppFullWidthComponents.test.js +16 -0
- nautobot/ui/src/components/__tests__/AppTab.test.js +21 -0
- nautobot/ui/src/components/__tests__/Apps.test.js +14 -0
- nautobot/ui/src/components/__tests__/Layout.test.js +33 -0
- nautobot/ui/src/components/__tests__/Table.test.js +36 -0
- nautobot/ui/src/components/__tests__/TableItem.test.js +37 -0
- nautobot/ui/src/components/__tests__/paginator.test.js +43 -0
- nautobot/ui/src/components/__tests__/paginator_form.test.js +13 -0
- nautobot/ui/src/components/pagination.js +93 -0
- nautobot/ui/src/components/paginator.js +79 -0
- nautobot/ui/src/components/paginator_form.js +43 -0
- nautobot/ui/src/components/usePagination.js +57 -0
- nautobot/ui/src/constants/apiPath.js +10 -0
- nautobot/ui/src/constants/icons.js +15 -0
- nautobot/ui/src/constants/size.js +15 -0
- nautobot/ui/src/index.js +65 -0
- nautobot/ui/src/reportWebVitals.js +15 -0
- nautobot/ui/src/router.js +77 -0
- nautobot/ui/src/utils/api.js +131 -0
- nautobot/ui/src/utils/app-import.js +15 -0
- nautobot/ui/src/utils/color.js +15 -0
- nautobot/ui/src/utils/date.js +14 -0
- nautobot/ui/src/utils/index.js +15 -0
- nautobot/ui/src/utils/navigation.js +32 -0
- nautobot/ui/src/utils/session.js +64 -0
- nautobot/ui/src/utils/store.js +242 -0
- nautobot/ui/src/utils/string.js +6 -0
- nautobot/ui/src/utils/url.js +4 -0
- nautobot/ui/src/views/Home.js +138 -0
- nautobot/ui/src/views/InstalledApps.js +80 -0
- nautobot/ui/src/views/Login.js +48 -0
- nautobot/ui/src/views/Logout.js +20 -0
- nautobot/ui/src/views/__tests__/BSCreateViewTemplate.test.js +11 -0
- nautobot/ui/src/views/__tests__/BSListViewTemplate.test.js +107 -0
- nautobot/ui/src/views/__tests__/Login.test.js +15 -0
- nautobot/ui/src/views/generic/GenericView.js +142 -0
- nautobot/ui/src/views/generic/ObjectCreate.js +96 -0
- nautobot/ui/src/views/generic/ObjectList.js +127 -0
- nautobot/ui/src/views/generic/ObjectRetrieve.js +551 -0
- nautobot/users/admin.py +1 -1
- nautobot/users/api/serializers.py +51 -61
- nautobot/users/api/urls.py +1 -1
- nautobot/users/api/views.py +53 -2
- nautobot/users/migrations/0001_initial.py +0 -1
- nautobot/users/migrations/0002_token_ordering_by_created.py +0 -1
- nautobot/users/migrations/0003_alter_user_options.py +0 -1
- nautobot/users/migrations/0004_alter_user_managers.py +0 -1
- nautobot/users/tests/test_api.py +109 -28
- nautobot/users/tests/test_filters.py +0 -4
- nautobot/users/tests/test_models.py +0 -1
- nautobot/users/views.py +0 -7
- nautobot/virtualization/api/serializers.py +18 -132
- nautobot/virtualization/api/urls.py +1 -1
- nautobot/virtualization/api/views.py +1 -22
- nautobot/virtualization/choices.py +0 -2
- nautobot/virtualization/filters.py +12 -7
- nautobot/virtualization/forms.py +21 -117
- nautobot/virtualization/migrations/0001_initial.py +0 -1
- nautobot/virtualization/migrations/0002_virtualmachine_local_context_schema.py +0 -1
- nautobot/virtualization/migrations/0003_vminterface_verbose_name.py +0 -1
- nautobot/virtualization/migrations/0004_auto_slug.py +0 -1
- nautobot/virtualization/migrations/0005_add_natural_indexing.py +0 -1
- nautobot/virtualization/migrations/0006_vminterface_status.py +0 -1
- nautobot/virtualization/migrations/0007_vminterface_status_data_migration.py +0 -1
- nautobot/virtualization/migrations/0008_vminterface_parent.py +0 -1
- nautobot/virtualization/migrations/0009_cluster_location.py +0 -1
- nautobot/virtualization/migrations/0010_vminterface_mac_address_data_migration.py +0 -1
- nautobot/virtualization/migrations/0011_alter_vminterface_mac_address.py +0 -1
- nautobot/virtualization/migrations/0012_alter_virtualmachine_role_add_new_role.py +1 -2
- nautobot/virtualization/migrations/0013_migrate_virtualmachine_role_data.py +18 -12
- nautobot/virtualization/migrations/0014_rename_virtualmachine_roles.py +0 -1
- nautobot/virtualization/migrations/0015_rename_foreignkey_fields.py +1 -2
- nautobot/virtualization/migrations/0016_remove_site_foreign_key_from_cluster_class.py +0 -1
- nautobot/virtualization/migrations/0017_created_datetime.py +0 -1
- nautobot/virtualization/migrations/0018_related_name_changes.py +1 -2
- nautobot/virtualization/migrations/0019_vminterface_ip_addresses_m2m.py +0 -1
- nautobot/virtualization/migrations/0020_remove_clustergroup_clustertype_slug.py +20 -0
- nautobot/virtualization/migrations/0021_tagsfield_and_vminterface_to_primarymodel.py +39 -0
- nautobot/virtualization/migrations/0022_vminterface_timestamps_data_migration.py +17 -0
- nautobot/virtualization/migrations/0023_ipam__namespaces.py +25 -0
- nautobot/virtualization/migrations/0024_fixup_null_statuses.py +25 -0
- nautobot/virtualization/migrations/0025_status_nonnullable.py +29 -0
- nautobot/virtualization/models.py +39 -131
- nautobot/virtualization/navigation.py +18 -99
- nautobot/virtualization/tables.py +4 -4
- nautobot/virtualization/templates/virtualization/virtualmachine.html +13 -2
- nautobot/virtualization/templates/virtualization/virtualmachine_edit.html +6 -0
- nautobot/virtualization/tests/test_api.py +42 -52
- nautobot/virtualization/tests/test_filters.py +98 -75
- nautobot/virtualization/tests/test_models.py +36 -13
- nautobot/virtualization/tests/test_views.py +68 -73
- nautobot/virtualization/urls.py +10 -10
- nautobot/virtualization/views.py +8 -14
- {nautobot-2.0.0a2.dist-info → nautobot-2.0.0b1.dist-info}/METADATA +15 -22
- {nautobot-2.0.0a2.dist-info → nautobot-2.0.0b1.dist-info}/RECORD +987 -834
- {nautobot-2.0.0a2.dist-info → nautobot-2.0.0b1.dist-info}/WHEEL +1 -1
- nautobot/circuits/api/nested_serializers.py +0 -69
- nautobot/core/templates/plugin_template/navigation.py-tpl +0 -22
- nautobot/dcim/api/nested_serializers.py +0 -356
- nautobot/dcim/templates/dcim/device_import.html +0 -5
- nautobot/dcim/templates/dcim/device_import_child.html +0 -5
- nautobot/dcim/templates/dcim/inc/device_import_header.html +0 -4
- nautobot/extras/api/nested_serializers.py +0 -353
- nautobot/extras/migrations/0064_configcontext_data_migrations.py +0 -42
- nautobot/extras/migrations/0071_job__unique_name_data_migration.py +0 -47
- nautobot/extras/reports.py +0 -60
- nautobot/extras/scripts.py +0 -72
- nautobot/extras/tests/example_jobs/script_variables.py +0 -67
- nautobot/extras/tests/example_jobs/test_duplicate_name2.py +0 -5
- nautobot/extras/tests/example_jobs/test_fail.py +0 -16
- nautobot/extras/tests/example_jobs/test_file_upload_pass.py +0 -20
- nautobot/extras/tests/example_jobs/test_ipaddress_vars.py +0 -52
- nautobot/extras/tests/example_jobs/test_job_button_receiver.py +0 -21
- nautobot/extras/tests/example_jobs/test_job_hook_receiver.py +0 -20
- nautobot/extras/tests/example_jobs/test_location_with_custom_field.py +0 -35
- nautobot/extras/tests/example_jobs/test_log_redaction.py +0 -14
- nautobot/extras/tests/example_jobs/test_modify_db.py +0 -19
- nautobot/extras/tests/example_jobs/test_object_var_optional.py +0 -14
- nautobot/extras/tests/example_jobs/test_object_var_required.py +0 -14
- nautobot/extras/tests/example_jobs/test_object_vars.py +0 -29
- nautobot/extras/tests/example_jobs/test_pass.py +0 -19
- nautobot/extras/tests/example_jobs/test_read_only_fail.py +0 -24
- nautobot/extras/tests/example_jobs/test_read_only_no_commit_field.py +0 -10
- nautobot/extras/tests/example_jobs/test_read_only_pass.py +0 -22
- nautobot/ipam/api/nested_serializers.py +0 -143
- nautobot/project-static/docs/assets/javascripts/bundle.5a2dcb6a.min.js +0 -29
- nautobot/project-static/docs/assets/javascripts/bundle.5a2dcb6a.min.js.map +0 -8
- nautobot/project-static/docs/assets/javascripts/extra/bundle.5f09fbc3.min.js +0 -18
- nautobot/project-static/docs/assets/javascripts/extra/bundle.5f09fbc3.min.js.map +0 -8
- nautobot/project-static/docs/assets/stylesheets/extra.0d2c79a8.min.css +0 -1
- nautobot/project-static/docs/assets/stylesheets/extra.0d2c79a8.min.css.map +0 -1
- nautobot/project-static/docs/assets/stylesheets/main.975780f9.min.css +0 -1
- nautobot/project-static/docs/assets/stylesheets/main.975780f9.min.css.map +0 -1
- nautobot/project-static/docs/assets/stylesheets/palette.2505c338.min.css +0 -1
- nautobot/project-static/docs/assets/stylesheets/palette.2505c338.min.css.map +0 -1
- nautobot/tenancy/api/nested_serializers.py +0 -31
- nautobot/users/api/nested_serializers.py +0 -67
- nautobot/virtualization/api/nested_serializers.py +0 -65
- /nautobot/extras/{tests/example_jobs → test_jobs}/__init__.py +0 -0
- /nautobot/{dcim/models/sites.py → ipam/management/__init__.py} +0 -0
- {nautobot-2.0.0a2.dist-info → nautobot-2.0.0b1.dist-info}/LICENSE.txt +0 -0
- {nautobot-2.0.0a2.dist-info → nautobot-2.0.0b1.dist-info}/entry_points.txt +0 -0
|
@@ -10,8 +10,14 @@
|
|
|
10
10
|
|
|
11
11
|
<link rel="canonical" href="https://docs.nautobot.com/projects/core/en/stable/rest-api/overview.html">
|
|
12
12
|
|
|
13
|
+
|
|
14
|
+
<link rel="prev" href="../models/extras/webhook.html">
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
<link rel="next" href="filtering.html">
|
|
18
|
+
|
|
13
19
|
<link rel="icon" href="../assets/favicon.ico">
|
|
14
|
-
<meta name="generator" content="mkdocs-1.4.2, mkdocs-material-
|
|
20
|
+
<meta name="generator" content="mkdocs-1.4.2, mkdocs-material-9.1.6">
|
|
15
21
|
|
|
16
22
|
|
|
17
23
|
|
|
@@ -19,11 +25,10 @@
|
|
|
19
25
|
|
|
20
26
|
|
|
21
27
|
|
|
22
|
-
<link rel="stylesheet" href="../assets/stylesheets/main.
|
|
28
|
+
<link rel="stylesheet" href="../assets/stylesheets/main.ded33207.min.css">
|
|
23
29
|
|
|
24
30
|
|
|
25
|
-
<link rel="stylesheet" href="../assets/stylesheets/palette.
|
|
26
|
-
|
|
31
|
+
<link rel="stylesheet" href="../assets/stylesheets/palette.a0c5b2b5.min.css">
|
|
27
32
|
|
|
28
33
|
|
|
29
34
|
|
|
@@ -86,7 +91,7 @@
|
|
|
86
91
|
|
|
87
92
|
|
|
88
93
|
|
|
89
|
-
<header class="md-header md-header--lifted" data-md-component="header">
|
|
94
|
+
<header class="md-header md-header--shadow md-header--lifted" data-md-component="header">
|
|
90
95
|
<nav class="md-header__inner md-grid" aria-label="Header">
|
|
91
96
|
<a href="../index.html" title="Nautobot Documentation" class="md-header__button md-logo" aria-label="Nautobot Documentation" data-md-component="logo">
|
|
92
97
|
|
|
@@ -116,8 +121,6 @@
|
|
|
116
121
|
<form class="md-header__option" data-md-component="palette">
|
|
117
122
|
|
|
118
123
|
|
|
119
|
-
|
|
120
|
-
|
|
121
124
|
<input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="black" data-md-color-accent="" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
|
|
122
125
|
|
|
123
126
|
<label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
|
|
@@ -126,8 +129,6 @@
|
|
|
126
129
|
|
|
127
130
|
|
|
128
131
|
|
|
129
|
-
|
|
130
|
-
|
|
131
132
|
<input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="black" data-md-color-accent="" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_2">
|
|
132
133
|
|
|
133
134
|
<label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
|
|
@@ -171,7 +172,7 @@
|
|
|
171
172
|
<div class="md-search-result__meta">
|
|
172
173
|
Initializing search
|
|
173
174
|
</div>
|
|
174
|
-
<ol class="md-search-result__list"></ol>
|
|
175
|
+
<ol class="md-search-result__list" role="presentation"></ol>
|
|
175
176
|
</div>
|
|
176
177
|
</div>
|
|
177
178
|
</div>
|
|
@@ -183,7 +184,7 @@
|
|
|
183
184
|
<a href="https://github.com/nautobot/nautobot" title="Go to repository" class="md-source" data-md-component="source">
|
|
184
185
|
<div class="md-source__icon md-icon">
|
|
185
186
|
|
|
186
|
-
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.
|
|
187
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
|
|
187
188
|
</div>
|
|
188
189
|
<div class="md-source__repository">
|
|
189
190
|
GitHub
|
|
@@ -196,7 +197,7 @@
|
|
|
196
197
|
|
|
197
198
|
|
|
198
199
|
<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
|
|
199
|
-
<div class="md-
|
|
200
|
+
<div class="md-grid">
|
|
200
201
|
<ul class="md-tabs__list">
|
|
201
202
|
|
|
202
203
|
|
|
@@ -351,7 +352,7 @@
|
|
|
351
352
|
<a href="https://github.com/nautobot/nautobot" title="Go to repository" class="md-source" data-md-component="source">
|
|
352
353
|
<div class="md-source__icon md-icon">
|
|
353
354
|
|
|
354
|
-
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.
|
|
355
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
|
|
355
356
|
</div>
|
|
356
357
|
<div class="md-source__repository">
|
|
357
358
|
GitHub
|
|
@@ -389,17 +390,18 @@
|
|
|
389
390
|
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
|
|
390
391
|
|
|
391
392
|
|
|
392
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2" type="checkbox" id="__nav_2" checked>
|
|
393
393
|
|
|
394
394
|
|
|
395
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
|
|
396
|
+
|
|
395
397
|
|
|
396
398
|
|
|
397
|
-
<label class="md-nav__link" for="__nav_2">
|
|
399
|
+
<label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
|
|
398
400
|
Documentation
|
|
399
401
|
<span class="md-nav__icon md-icon"></span>
|
|
400
402
|
</label>
|
|
401
403
|
|
|
402
|
-
<nav class="md-nav" aria-
|
|
404
|
+
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
|
|
403
405
|
<label class="md-nav__title" for="__nav_2">
|
|
404
406
|
<span class="md-nav__icon md-icon"></span>
|
|
405
407
|
Documentation
|
|
@@ -415,17 +417,18 @@
|
|
|
415
417
|
<li class="md-nav__item md-nav__item--nested">
|
|
416
418
|
|
|
417
419
|
|
|
418
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2_1" type="checkbox" id="__nav_2_1" >
|
|
419
420
|
|
|
420
421
|
|
|
422
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1" >
|
|
421
423
|
|
|
422
424
|
|
|
423
|
-
|
|
425
|
+
|
|
426
|
+
<label class="md-nav__link" for="__nav_2_1" id="__nav_2_1_label" tabindex="0">
|
|
424
427
|
Installation
|
|
425
428
|
<span class="md-nav__icon md-icon"></span>
|
|
426
429
|
</label>
|
|
427
430
|
|
|
428
|
-
<nav class="md-nav" aria-
|
|
431
|
+
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_1_label" aria-expanded="false">
|
|
429
432
|
<label class="md-nav__title" for="__nav_2_1">
|
|
430
433
|
<span class="md-nav__icon md-icon"></span>
|
|
431
434
|
Installation
|
|
@@ -532,17 +535,18 @@
|
|
|
532
535
|
<li class="md-nav__item md-nav__item--nested">
|
|
533
536
|
|
|
534
537
|
|
|
535
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2_2" type="checkbox" id="__nav_2_2" >
|
|
536
538
|
|
|
537
539
|
|
|
540
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2" >
|
|
541
|
+
|
|
538
542
|
|
|
539
543
|
|
|
540
|
-
<label class="md-nav__link" for="__nav_2_2">
|
|
544
|
+
<label class="md-nav__link" for="__nav_2_2" id="__nav_2_2_label" tabindex="0">
|
|
541
545
|
Migration
|
|
542
546
|
<span class="md-nav__icon md-icon"></span>
|
|
543
547
|
</label>
|
|
544
548
|
|
|
545
|
-
<nav class="md-nav" aria-
|
|
549
|
+
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_2_label" aria-expanded="false">
|
|
546
550
|
<label class="md-nav__title" for="__nav_2_2">
|
|
547
551
|
<span class="md-nav__icon md-icon"></span>
|
|
548
552
|
Migration
|
|
@@ -635,17 +639,18 @@
|
|
|
635
639
|
<li class="md-nav__item md-nav__item--nested">
|
|
636
640
|
|
|
637
641
|
|
|
638
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2_3" type="checkbox" id="__nav_2_3" >
|
|
639
642
|
|
|
640
643
|
|
|
644
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_3" >
|
|
641
645
|
|
|
642
646
|
|
|
643
|
-
|
|
647
|
+
|
|
648
|
+
<label class="md-nav__link" for="__nav_2_3" id="__nav_2_3_label" tabindex="0">
|
|
644
649
|
Configuration
|
|
645
650
|
<span class="md-nav__icon md-icon"></span>
|
|
646
651
|
</label>
|
|
647
652
|
|
|
648
|
-
<nav class="md-nav" aria-
|
|
653
|
+
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_3_label" aria-expanded="false">
|
|
649
654
|
<label class="md-nav__title" for="__nav_2_3">
|
|
650
655
|
<span class="md-nav__icon md-icon"></span>
|
|
651
656
|
Configuration
|
|
@@ -710,17 +715,18 @@
|
|
|
710
715
|
<li class="md-nav__item md-nav__item--nested">
|
|
711
716
|
|
|
712
717
|
|
|
713
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2_4" type="checkbox" id="__nav_2_4" >
|
|
714
718
|
|
|
715
719
|
|
|
720
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4" >
|
|
721
|
+
|
|
716
722
|
|
|
717
723
|
|
|
718
|
-
<label class="md-nav__link" for="__nav_2_4">
|
|
724
|
+
<label class="md-nav__link" for="__nav_2_4" id="__nav_2_4_label" tabindex="0">
|
|
719
725
|
External Authentication
|
|
720
726
|
<span class="md-nav__icon md-icon"></span>
|
|
721
727
|
</label>
|
|
722
728
|
|
|
723
|
-
<nav class="md-nav"
|
|
729
|
+
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_4_label" aria-expanded="false">
|
|
724
730
|
<label class="md-nav__title" for="__nav_2_4">
|
|
725
731
|
<span class="md-nav__icon md-icon"></span>
|
|
726
732
|
External Authentication
|
|
@@ -785,17 +791,18 @@
|
|
|
785
791
|
<li class="md-nav__item md-nav__item--nested">
|
|
786
792
|
|
|
787
793
|
|
|
788
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2_5" type="checkbox" id="__nav_2_5" >
|
|
789
794
|
|
|
790
795
|
|
|
796
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_5" >
|
|
791
797
|
|
|
792
798
|
|
|
793
|
-
|
|
799
|
+
|
|
800
|
+
<label class="md-nav__link" for="__nav_2_5" id="__nav_2_5_label" tabindex="0">
|
|
794
801
|
Administration
|
|
795
802
|
<span class="md-nav__icon md-icon"></span>
|
|
796
803
|
</label>
|
|
797
804
|
|
|
798
|
-
<nav class="md-nav" aria-
|
|
805
|
+
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_5_label" aria-expanded="false">
|
|
799
806
|
<label class="md-nav__title" for="__nav_2_5">
|
|
800
807
|
<span class="md-nav__icon md-icon"></span>
|
|
801
808
|
Administration
|
|
@@ -888,17 +895,18 @@
|
|
|
888
895
|
<li class="md-nav__item md-nav__item--nested">
|
|
889
896
|
|
|
890
897
|
|
|
891
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2_6" type="checkbox" id="__nav_2_6" >
|
|
892
898
|
|
|
893
899
|
|
|
900
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_6" >
|
|
901
|
+
|
|
894
902
|
|
|
895
903
|
|
|
896
|
-
<label class="md-nav__link" for="__nav_2_6">
|
|
904
|
+
<label class="md-nav__link" for="__nav_2_6" id="__nav_2_6_label" tabindex="0">
|
|
897
905
|
User Guides
|
|
898
906
|
<span class="md-nav__icon md-icon"></span>
|
|
899
907
|
</label>
|
|
900
908
|
|
|
901
|
-
<nav class="md-nav"
|
|
909
|
+
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_6_label" aria-expanded="false">
|
|
902
910
|
<label class="md-nav__title" for="__nav_2_6">
|
|
903
911
|
<span class="md-nav__icon md-icon"></span>
|
|
904
912
|
User Guides
|
|
@@ -1145,17 +1153,18 @@
|
|
|
1145
1153
|
<li class="md-nav__item md-nav__item--nested">
|
|
1146
1154
|
|
|
1147
1155
|
|
|
1148
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2_7" type="checkbox" id="__nav_2_7" >
|
|
1149
1156
|
|
|
1150
1157
|
|
|
1158
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_7" >
|
|
1151
1159
|
|
|
1152
1160
|
|
|
1153
|
-
|
|
1161
|
+
|
|
1162
|
+
<label class="md-nav__link" for="__nav_2_7" id="__nav_2_7_label" tabindex="0">
|
|
1154
1163
|
Core Functionality
|
|
1155
1164
|
<span class="md-nav__icon md-icon"></span>
|
|
1156
1165
|
</label>
|
|
1157
1166
|
|
|
1158
|
-
<nav class="md-nav"
|
|
1167
|
+
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_7_label" aria-expanded="false">
|
|
1159
1168
|
<label class="md-nav__title" for="__nav_2_7">
|
|
1160
1169
|
<span class="md-nav__icon md-icon"></span>
|
|
1161
1170
|
Core Functionality
|
|
@@ -1238,8 +1247,1169 @@
|
|
|
1238
1247
|
|
|
1239
1248
|
|
|
1240
1249
|
<li class="md-nav__item">
|
|
1241
|
-
<a href="../core-functionality/secrets.html" class="md-nav__link">
|
|
1242
|
-
Secrets
|
|
1250
|
+
<a href="../core-functionality/secrets.html" class="md-nav__link">
|
|
1251
|
+
Secrets
|
|
1252
|
+
</a>
|
|
1253
|
+
</li>
|
|
1254
|
+
|
|
1255
|
+
|
|
1256
|
+
|
|
1257
|
+
|
|
1258
|
+
|
|
1259
|
+
|
|
1260
|
+
|
|
1261
|
+
|
|
1262
|
+
|
|
1263
|
+
<li class="md-nav__item">
|
|
1264
|
+
<a href="../core-functionality/services.html" class="md-nav__link">
|
|
1265
|
+
Service Mapping
|
|
1266
|
+
</a>
|
|
1267
|
+
</li>
|
|
1268
|
+
|
|
1269
|
+
|
|
1270
|
+
|
|
1271
|
+
|
|
1272
|
+
|
|
1273
|
+
|
|
1274
|
+
|
|
1275
|
+
|
|
1276
|
+
|
|
1277
|
+
<li class="md-nav__item">
|
|
1278
|
+
<a href="../core-functionality/sites-and-racks.html" class="md-nav__link">
|
|
1279
|
+
Sites, Locations, and Racks
|
|
1280
|
+
</a>
|
|
1281
|
+
</li>
|
|
1282
|
+
|
|
1283
|
+
|
|
1284
|
+
|
|
1285
|
+
|
|
1286
|
+
|
|
1287
|
+
|
|
1288
|
+
|
|
1289
|
+
|
|
1290
|
+
|
|
1291
|
+
<li class="md-nav__item">
|
|
1292
|
+
<a href="../core-functionality/tenancy.html" class="md-nav__link">
|
|
1293
|
+
Tenancy
|
|
1294
|
+
</a>
|
|
1295
|
+
</li>
|
|
1296
|
+
|
|
1297
|
+
|
|
1298
|
+
|
|
1299
|
+
|
|
1300
|
+
|
|
1301
|
+
|
|
1302
|
+
|
|
1303
|
+
|
|
1304
|
+
|
|
1305
|
+
<li class="md-nav__item">
|
|
1306
|
+
<a href="../core-functionality/virtualization.html" class="md-nav__link">
|
|
1307
|
+
Virtualization
|
|
1308
|
+
</a>
|
|
1309
|
+
</li>
|
|
1310
|
+
|
|
1311
|
+
|
|
1312
|
+
|
|
1313
|
+
|
|
1314
|
+
|
|
1315
|
+
|
|
1316
|
+
|
|
1317
|
+
|
|
1318
|
+
|
|
1319
|
+
<li class="md-nav__item">
|
|
1320
|
+
<a href="../core-functionality/vlans.html" class="md-nav__link">
|
|
1321
|
+
VLAN Management
|
|
1322
|
+
</a>
|
|
1323
|
+
</li>
|
|
1324
|
+
|
|
1325
|
+
|
|
1326
|
+
|
|
1327
|
+
|
|
1328
|
+
</ul>
|
|
1329
|
+
</nav>
|
|
1330
|
+
</li>
|
|
1331
|
+
|
|
1332
|
+
|
|
1333
|
+
|
|
1334
|
+
|
|
1335
|
+
|
|
1336
|
+
|
|
1337
|
+
|
|
1338
|
+
|
|
1339
|
+
|
|
1340
|
+
|
|
1341
|
+
<li class="md-nav__item md-nav__item--nested">
|
|
1342
|
+
|
|
1343
|
+
|
|
1344
|
+
|
|
1345
|
+
|
|
1346
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8" >
|
|
1347
|
+
|
|
1348
|
+
|
|
1349
|
+
|
|
1350
|
+
<label class="md-nav__link" for="__nav_2_8" id="__nav_2_8_label" tabindex="0">
|
|
1351
|
+
Model Details
|
|
1352
|
+
<span class="md-nav__icon md-icon"></span>
|
|
1353
|
+
</label>
|
|
1354
|
+
|
|
1355
|
+
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_8_label" aria-expanded="false">
|
|
1356
|
+
<label class="md-nav__title" for="__nav_2_8">
|
|
1357
|
+
<span class="md-nav__icon md-icon"></span>
|
|
1358
|
+
Model Details
|
|
1359
|
+
</label>
|
|
1360
|
+
<ul class="md-nav__list" data-md-scrollfix>
|
|
1361
|
+
|
|
1362
|
+
|
|
1363
|
+
|
|
1364
|
+
|
|
1365
|
+
|
|
1366
|
+
|
|
1367
|
+
|
|
1368
|
+
<li class="md-nav__item md-nav__item--nested">
|
|
1369
|
+
|
|
1370
|
+
|
|
1371
|
+
|
|
1372
|
+
|
|
1373
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8_1" >
|
|
1374
|
+
|
|
1375
|
+
|
|
1376
|
+
|
|
1377
|
+
<label class="md-nav__link" for="__nav_2_8_1" id="__nav_2_8_1_label" tabindex="0">
|
|
1378
|
+
Circuits
|
|
1379
|
+
<span class="md-nav__icon md-icon"></span>
|
|
1380
|
+
</label>
|
|
1381
|
+
|
|
1382
|
+
<nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_8_1_label" aria-expanded="false">
|
|
1383
|
+
<label class="md-nav__title" for="__nav_2_8_1">
|
|
1384
|
+
<span class="md-nav__icon md-icon"></span>
|
|
1385
|
+
Circuits
|
|
1386
|
+
</label>
|
|
1387
|
+
<ul class="md-nav__list" data-md-scrollfix>
|
|
1388
|
+
|
|
1389
|
+
|
|
1390
|
+
|
|
1391
|
+
|
|
1392
|
+
|
|
1393
|
+
|
|
1394
|
+
<li class="md-nav__item">
|
|
1395
|
+
<a href="../models/circuits/circuit.html" class="md-nav__link">
|
|
1396
|
+
Circuit
|
|
1397
|
+
</a>
|
|
1398
|
+
</li>
|
|
1399
|
+
|
|
1400
|
+
|
|
1401
|
+
|
|
1402
|
+
|
|
1403
|
+
|
|
1404
|
+
|
|
1405
|
+
|
|
1406
|
+
|
|
1407
|
+
|
|
1408
|
+
<li class="md-nav__item">
|
|
1409
|
+
<a href="../models/circuits/circuittermination.html" class="md-nav__link">
|
|
1410
|
+
Circuit Termination
|
|
1411
|
+
</a>
|
|
1412
|
+
</li>
|
|
1413
|
+
|
|
1414
|
+
|
|
1415
|
+
|
|
1416
|
+
|
|
1417
|
+
|
|
1418
|
+
|
|
1419
|
+
|
|
1420
|
+
|
|
1421
|
+
|
|
1422
|
+
<li class="md-nav__item">
|
|
1423
|
+
<a href="../models/circuits/circuittype.html" class="md-nav__link">
|
|
1424
|
+
Circuit Type
|
|
1425
|
+
</a>
|
|
1426
|
+
</li>
|
|
1427
|
+
|
|
1428
|
+
|
|
1429
|
+
|
|
1430
|
+
|
|
1431
|
+
|
|
1432
|
+
|
|
1433
|
+
|
|
1434
|
+
|
|
1435
|
+
|
|
1436
|
+
<li class="md-nav__item">
|
|
1437
|
+
<a href="../models/circuits/provider.html" class="md-nav__link">
|
|
1438
|
+
Circuit Provider
|
|
1439
|
+
</a>
|
|
1440
|
+
</li>
|
|
1441
|
+
|
|
1442
|
+
|
|
1443
|
+
|
|
1444
|
+
|
|
1445
|
+
|
|
1446
|
+
|
|
1447
|
+
|
|
1448
|
+
|
|
1449
|
+
|
|
1450
|
+
<li class="md-nav__item">
|
|
1451
|
+
<a href="../models/circuits/providernetwork.html" class="md-nav__link">
|
|
1452
|
+
Circuit Provider Network
|
|
1453
|
+
</a>
|
|
1454
|
+
</li>
|
|
1455
|
+
|
|
1456
|
+
|
|
1457
|
+
|
|
1458
|
+
|
|
1459
|
+
</ul>
|
|
1460
|
+
</nav>
|
|
1461
|
+
</li>
|
|
1462
|
+
|
|
1463
|
+
|
|
1464
|
+
|
|
1465
|
+
|
|
1466
|
+
|
|
1467
|
+
|
|
1468
|
+
|
|
1469
|
+
|
|
1470
|
+
|
|
1471
|
+
|
|
1472
|
+
<li class="md-nav__item md-nav__item--nested">
|
|
1473
|
+
|
|
1474
|
+
|
|
1475
|
+
|
|
1476
|
+
|
|
1477
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8_2" >
|
|
1478
|
+
|
|
1479
|
+
|
|
1480
|
+
|
|
1481
|
+
<label class="md-nav__link" for="__nav_2_8_2" id="__nav_2_8_2_label" tabindex="0">
|
|
1482
|
+
DCIM
|
|
1483
|
+
<span class="md-nav__icon md-icon"></span>
|
|
1484
|
+
</label>
|
|
1485
|
+
|
|
1486
|
+
<nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_8_2_label" aria-expanded="false">
|
|
1487
|
+
<label class="md-nav__title" for="__nav_2_8_2">
|
|
1488
|
+
<span class="md-nav__icon md-icon"></span>
|
|
1489
|
+
DCIM
|
|
1490
|
+
</label>
|
|
1491
|
+
<ul class="md-nav__list" data-md-scrollfix>
|
|
1492
|
+
|
|
1493
|
+
|
|
1494
|
+
|
|
1495
|
+
|
|
1496
|
+
|
|
1497
|
+
|
|
1498
|
+
<li class="md-nav__item">
|
|
1499
|
+
<a href="../models/dcim/cable.html" class="md-nav__link">
|
|
1500
|
+
Cable
|
|
1501
|
+
</a>
|
|
1502
|
+
</li>
|
|
1503
|
+
|
|
1504
|
+
|
|
1505
|
+
|
|
1506
|
+
|
|
1507
|
+
|
|
1508
|
+
|
|
1509
|
+
|
|
1510
|
+
|
|
1511
|
+
|
|
1512
|
+
<li class="md-nav__item">
|
|
1513
|
+
<a href="../models/dcim/consoleport.html" class="md-nav__link">
|
|
1514
|
+
Console Port
|
|
1515
|
+
</a>
|
|
1516
|
+
</li>
|
|
1517
|
+
|
|
1518
|
+
|
|
1519
|
+
|
|
1520
|
+
|
|
1521
|
+
|
|
1522
|
+
|
|
1523
|
+
|
|
1524
|
+
|
|
1525
|
+
|
|
1526
|
+
<li class="md-nav__item">
|
|
1527
|
+
<a href="../models/dcim/consoleporttemplate.html" class="md-nav__link">
|
|
1528
|
+
Console Port Template
|
|
1529
|
+
</a>
|
|
1530
|
+
</li>
|
|
1531
|
+
|
|
1532
|
+
|
|
1533
|
+
|
|
1534
|
+
|
|
1535
|
+
|
|
1536
|
+
|
|
1537
|
+
|
|
1538
|
+
|
|
1539
|
+
|
|
1540
|
+
<li class="md-nav__item">
|
|
1541
|
+
<a href="../models/dcim/consoleserverport.html" class="md-nav__link">
|
|
1542
|
+
Console Server Port
|
|
1543
|
+
</a>
|
|
1544
|
+
</li>
|
|
1545
|
+
|
|
1546
|
+
|
|
1547
|
+
|
|
1548
|
+
|
|
1549
|
+
|
|
1550
|
+
|
|
1551
|
+
|
|
1552
|
+
|
|
1553
|
+
|
|
1554
|
+
<li class="md-nav__item">
|
|
1555
|
+
<a href="../models/dcim/consoleserverporttemplate.html" class="md-nav__link">
|
|
1556
|
+
Console Server Port Template
|
|
1557
|
+
</a>
|
|
1558
|
+
</li>
|
|
1559
|
+
|
|
1560
|
+
|
|
1561
|
+
|
|
1562
|
+
|
|
1563
|
+
|
|
1564
|
+
|
|
1565
|
+
|
|
1566
|
+
|
|
1567
|
+
|
|
1568
|
+
<li class="md-nav__item">
|
|
1569
|
+
<a href="../models/dcim/device.html" class="md-nav__link">
|
|
1570
|
+
Device
|
|
1571
|
+
</a>
|
|
1572
|
+
</li>
|
|
1573
|
+
|
|
1574
|
+
|
|
1575
|
+
|
|
1576
|
+
|
|
1577
|
+
|
|
1578
|
+
|
|
1579
|
+
|
|
1580
|
+
|
|
1581
|
+
|
|
1582
|
+
<li class="md-nav__item">
|
|
1583
|
+
<a href="../models/dcim/devicebay.html" class="md-nav__link">
|
|
1584
|
+
Device Bay
|
|
1585
|
+
</a>
|
|
1586
|
+
</li>
|
|
1587
|
+
|
|
1588
|
+
|
|
1589
|
+
|
|
1590
|
+
|
|
1591
|
+
|
|
1592
|
+
|
|
1593
|
+
|
|
1594
|
+
|
|
1595
|
+
|
|
1596
|
+
<li class="md-nav__item">
|
|
1597
|
+
<a href="../models/dcim/devicebaytemplate.html" class="md-nav__link">
|
|
1598
|
+
Device Bay Template
|
|
1599
|
+
</a>
|
|
1600
|
+
</li>
|
|
1601
|
+
|
|
1602
|
+
|
|
1603
|
+
|
|
1604
|
+
|
|
1605
|
+
|
|
1606
|
+
|
|
1607
|
+
|
|
1608
|
+
|
|
1609
|
+
|
|
1610
|
+
<li class="md-nav__item">
|
|
1611
|
+
<a href="../models/dcim/deviceredundancygroup.html" class="md-nav__link">
|
|
1612
|
+
Device Redundancy Group
|
|
1613
|
+
</a>
|
|
1614
|
+
</li>
|
|
1615
|
+
|
|
1616
|
+
|
|
1617
|
+
|
|
1618
|
+
|
|
1619
|
+
|
|
1620
|
+
|
|
1621
|
+
|
|
1622
|
+
|
|
1623
|
+
|
|
1624
|
+
<li class="md-nav__item">
|
|
1625
|
+
<a href="../models/dcim/devicetype.html" class="md-nav__link">
|
|
1626
|
+
Device Type
|
|
1627
|
+
</a>
|
|
1628
|
+
</li>
|
|
1629
|
+
|
|
1630
|
+
|
|
1631
|
+
|
|
1632
|
+
|
|
1633
|
+
|
|
1634
|
+
|
|
1635
|
+
|
|
1636
|
+
|
|
1637
|
+
|
|
1638
|
+
<li class="md-nav__item">
|
|
1639
|
+
<a href="../models/dcim/frontport.html" class="md-nav__link">
|
|
1640
|
+
Front Port
|
|
1641
|
+
</a>
|
|
1642
|
+
</li>
|
|
1643
|
+
|
|
1644
|
+
|
|
1645
|
+
|
|
1646
|
+
|
|
1647
|
+
|
|
1648
|
+
|
|
1649
|
+
|
|
1650
|
+
|
|
1651
|
+
|
|
1652
|
+
<li class="md-nav__item">
|
|
1653
|
+
<a href="../models/dcim/frontporttemplate.html" class="md-nav__link">
|
|
1654
|
+
Front Port Template
|
|
1655
|
+
</a>
|
|
1656
|
+
</li>
|
|
1657
|
+
|
|
1658
|
+
|
|
1659
|
+
|
|
1660
|
+
|
|
1661
|
+
|
|
1662
|
+
|
|
1663
|
+
|
|
1664
|
+
|
|
1665
|
+
|
|
1666
|
+
<li class="md-nav__item">
|
|
1667
|
+
<a href="../models/dcim/interface.html" class="md-nav__link">
|
|
1668
|
+
Interface
|
|
1669
|
+
</a>
|
|
1670
|
+
</li>
|
|
1671
|
+
|
|
1672
|
+
|
|
1673
|
+
|
|
1674
|
+
|
|
1675
|
+
|
|
1676
|
+
|
|
1677
|
+
|
|
1678
|
+
|
|
1679
|
+
|
|
1680
|
+
<li class="md-nav__item">
|
|
1681
|
+
<a href="../models/dcim/interfacetemplate.html" class="md-nav__link">
|
|
1682
|
+
Interface Template
|
|
1683
|
+
</a>
|
|
1684
|
+
</li>
|
|
1685
|
+
|
|
1686
|
+
|
|
1687
|
+
|
|
1688
|
+
|
|
1689
|
+
|
|
1690
|
+
|
|
1691
|
+
|
|
1692
|
+
|
|
1693
|
+
|
|
1694
|
+
<li class="md-nav__item">
|
|
1695
|
+
<a href="../models/dcim/inventoryitem.html" class="md-nav__link">
|
|
1696
|
+
Inventory Item
|
|
1697
|
+
</a>
|
|
1698
|
+
</li>
|
|
1699
|
+
|
|
1700
|
+
|
|
1701
|
+
|
|
1702
|
+
|
|
1703
|
+
|
|
1704
|
+
|
|
1705
|
+
|
|
1706
|
+
|
|
1707
|
+
|
|
1708
|
+
<li class="md-nav__item">
|
|
1709
|
+
<a href="../models/dcim/location.html" class="md-nav__link">
|
|
1710
|
+
Location
|
|
1711
|
+
</a>
|
|
1712
|
+
</li>
|
|
1713
|
+
|
|
1714
|
+
|
|
1715
|
+
|
|
1716
|
+
|
|
1717
|
+
|
|
1718
|
+
|
|
1719
|
+
|
|
1720
|
+
|
|
1721
|
+
|
|
1722
|
+
<li class="md-nav__item">
|
|
1723
|
+
<a href="../models/dcim/locationtype.html" class="md-nav__link">
|
|
1724
|
+
Location Type
|
|
1725
|
+
</a>
|
|
1726
|
+
</li>
|
|
1727
|
+
|
|
1728
|
+
|
|
1729
|
+
|
|
1730
|
+
|
|
1731
|
+
|
|
1732
|
+
|
|
1733
|
+
|
|
1734
|
+
|
|
1735
|
+
|
|
1736
|
+
<li class="md-nav__item">
|
|
1737
|
+
<a href="../models/dcim/manufacturer.html" class="md-nav__link">
|
|
1738
|
+
Manufacturer
|
|
1739
|
+
</a>
|
|
1740
|
+
</li>
|
|
1741
|
+
|
|
1742
|
+
|
|
1743
|
+
|
|
1744
|
+
|
|
1745
|
+
|
|
1746
|
+
|
|
1747
|
+
|
|
1748
|
+
|
|
1749
|
+
|
|
1750
|
+
<li class="md-nav__item">
|
|
1751
|
+
<a href="../models/dcim/platform.html" class="md-nav__link">
|
|
1752
|
+
Platform
|
|
1753
|
+
</a>
|
|
1754
|
+
</li>
|
|
1755
|
+
|
|
1756
|
+
|
|
1757
|
+
|
|
1758
|
+
|
|
1759
|
+
|
|
1760
|
+
|
|
1761
|
+
|
|
1762
|
+
|
|
1763
|
+
|
|
1764
|
+
<li class="md-nav__item">
|
|
1765
|
+
<a href="../models/dcim/powerfeed.html" class="md-nav__link">
|
|
1766
|
+
Power Feed
|
|
1767
|
+
</a>
|
|
1768
|
+
</li>
|
|
1769
|
+
|
|
1770
|
+
|
|
1771
|
+
|
|
1772
|
+
|
|
1773
|
+
|
|
1774
|
+
|
|
1775
|
+
|
|
1776
|
+
|
|
1777
|
+
|
|
1778
|
+
<li class="md-nav__item">
|
|
1779
|
+
<a href="../models/dcim/poweroutlet.html" class="md-nav__link">
|
|
1780
|
+
Power Outlet
|
|
1781
|
+
</a>
|
|
1782
|
+
</li>
|
|
1783
|
+
|
|
1784
|
+
|
|
1785
|
+
|
|
1786
|
+
|
|
1787
|
+
|
|
1788
|
+
|
|
1789
|
+
|
|
1790
|
+
|
|
1791
|
+
|
|
1792
|
+
<li class="md-nav__item">
|
|
1793
|
+
<a href="../models/dcim/poweroutlettemplate.html" class="md-nav__link">
|
|
1794
|
+
Power Outlet Template
|
|
1795
|
+
</a>
|
|
1796
|
+
</li>
|
|
1797
|
+
|
|
1798
|
+
|
|
1799
|
+
|
|
1800
|
+
|
|
1801
|
+
|
|
1802
|
+
|
|
1803
|
+
|
|
1804
|
+
|
|
1805
|
+
|
|
1806
|
+
<li class="md-nav__item">
|
|
1807
|
+
<a href="../models/dcim/powerpanel.html" class="md-nav__link">
|
|
1808
|
+
Power Panel
|
|
1809
|
+
</a>
|
|
1810
|
+
</li>
|
|
1811
|
+
|
|
1812
|
+
|
|
1813
|
+
|
|
1814
|
+
|
|
1815
|
+
|
|
1816
|
+
|
|
1817
|
+
|
|
1818
|
+
|
|
1819
|
+
|
|
1820
|
+
<li class="md-nav__item">
|
|
1821
|
+
<a href="../models/dcim/powerport.html" class="md-nav__link">
|
|
1822
|
+
Power Port
|
|
1823
|
+
</a>
|
|
1824
|
+
</li>
|
|
1825
|
+
|
|
1826
|
+
|
|
1827
|
+
|
|
1828
|
+
|
|
1829
|
+
|
|
1830
|
+
|
|
1831
|
+
|
|
1832
|
+
|
|
1833
|
+
|
|
1834
|
+
<li class="md-nav__item">
|
|
1835
|
+
<a href="../models/dcim/powerporttemplate.html" class="md-nav__link">
|
|
1836
|
+
Power Port Template
|
|
1837
|
+
</a>
|
|
1838
|
+
</li>
|
|
1839
|
+
|
|
1840
|
+
|
|
1841
|
+
|
|
1842
|
+
|
|
1843
|
+
|
|
1844
|
+
|
|
1845
|
+
|
|
1846
|
+
|
|
1847
|
+
|
|
1848
|
+
<li class="md-nav__item">
|
|
1849
|
+
<a href="../models/dcim/rack.html" class="md-nav__link">
|
|
1850
|
+
Rack
|
|
1851
|
+
</a>
|
|
1852
|
+
</li>
|
|
1853
|
+
|
|
1854
|
+
|
|
1855
|
+
|
|
1856
|
+
|
|
1857
|
+
|
|
1858
|
+
|
|
1859
|
+
|
|
1860
|
+
|
|
1861
|
+
|
|
1862
|
+
<li class="md-nav__item">
|
|
1863
|
+
<a href="../models/dcim/rackgroup.html" class="md-nav__link">
|
|
1864
|
+
Rack Group
|
|
1865
|
+
</a>
|
|
1866
|
+
</li>
|
|
1867
|
+
|
|
1868
|
+
|
|
1869
|
+
|
|
1870
|
+
|
|
1871
|
+
|
|
1872
|
+
|
|
1873
|
+
|
|
1874
|
+
|
|
1875
|
+
|
|
1876
|
+
<li class="md-nav__item">
|
|
1877
|
+
<a href="../models/dcim/rackreservation.html" class="md-nav__link">
|
|
1878
|
+
Rack Reservation
|
|
1879
|
+
</a>
|
|
1880
|
+
</li>
|
|
1881
|
+
|
|
1882
|
+
|
|
1883
|
+
|
|
1884
|
+
|
|
1885
|
+
|
|
1886
|
+
|
|
1887
|
+
|
|
1888
|
+
|
|
1889
|
+
|
|
1890
|
+
<li class="md-nav__item">
|
|
1891
|
+
<a href="../models/dcim/rearport.html" class="md-nav__link">
|
|
1892
|
+
Rear Port
|
|
1893
|
+
</a>
|
|
1894
|
+
</li>
|
|
1895
|
+
|
|
1896
|
+
|
|
1897
|
+
|
|
1898
|
+
|
|
1899
|
+
|
|
1900
|
+
|
|
1901
|
+
|
|
1902
|
+
|
|
1903
|
+
|
|
1904
|
+
<li class="md-nav__item">
|
|
1905
|
+
<a href="../models/dcim/rearporttemplate.html" class="md-nav__link">
|
|
1906
|
+
Rear Port Template
|
|
1907
|
+
</a>
|
|
1908
|
+
</li>
|
|
1909
|
+
|
|
1910
|
+
|
|
1911
|
+
|
|
1912
|
+
|
|
1913
|
+
|
|
1914
|
+
|
|
1915
|
+
|
|
1916
|
+
|
|
1917
|
+
|
|
1918
|
+
<li class="md-nav__item">
|
|
1919
|
+
<a href="../models/dcim/virtualchassis.html" class="md-nav__link">
|
|
1920
|
+
Virtual Chassis
|
|
1921
|
+
</a>
|
|
1922
|
+
</li>
|
|
1923
|
+
|
|
1924
|
+
|
|
1925
|
+
|
|
1926
|
+
|
|
1927
|
+
</ul>
|
|
1928
|
+
</nav>
|
|
1929
|
+
</li>
|
|
1930
|
+
|
|
1931
|
+
|
|
1932
|
+
|
|
1933
|
+
|
|
1934
|
+
|
|
1935
|
+
|
|
1936
|
+
|
|
1937
|
+
|
|
1938
|
+
|
|
1939
|
+
|
|
1940
|
+
<li class="md-nav__item md-nav__item--nested">
|
|
1941
|
+
|
|
1942
|
+
|
|
1943
|
+
|
|
1944
|
+
|
|
1945
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8_3" >
|
|
1946
|
+
|
|
1947
|
+
|
|
1948
|
+
|
|
1949
|
+
<label class="md-nav__link" for="__nav_2_8_3" id="__nav_2_8_3_label" tabindex="0">
|
|
1950
|
+
Extras
|
|
1951
|
+
<span class="md-nav__icon md-icon"></span>
|
|
1952
|
+
</label>
|
|
1953
|
+
|
|
1954
|
+
<nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_8_3_label" aria-expanded="false">
|
|
1955
|
+
<label class="md-nav__title" for="__nav_2_8_3">
|
|
1956
|
+
<span class="md-nav__icon md-icon"></span>
|
|
1957
|
+
Extras
|
|
1958
|
+
</label>
|
|
1959
|
+
<ul class="md-nav__list" data-md-scrollfix>
|
|
1960
|
+
|
|
1961
|
+
|
|
1962
|
+
|
|
1963
|
+
|
|
1964
|
+
|
|
1965
|
+
|
|
1966
|
+
<li class="md-nav__item">
|
|
1967
|
+
<a href="../models/extras/configcontext.html" class="md-nav__link">
|
|
1968
|
+
Config Context
|
|
1969
|
+
</a>
|
|
1970
|
+
</li>
|
|
1971
|
+
|
|
1972
|
+
|
|
1973
|
+
|
|
1974
|
+
|
|
1975
|
+
|
|
1976
|
+
|
|
1977
|
+
|
|
1978
|
+
|
|
1979
|
+
|
|
1980
|
+
<li class="md-nav__item">
|
|
1981
|
+
<a href="../models/extras/configcontextschema.html" class="md-nav__link">
|
|
1982
|
+
Config Context Schema
|
|
1983
|
+
</a>
|
|
1984
|
+
</li>
|
|
1985
|
+
|
|
1986
|
+
|
|
1987
|
+
|
|
1988
|
+
|
|
1989
|
+
|
|
1990
|
+
|
|
1991
|
+
|
|
1992
|
+
|
|
1993
|
+
|
|
1994
|
+
<li class="md-nav__item">
|
|
1995
|
+
<a href="../models/extras/graphqlquery.html" class="md-nav__link">
|
|
1996
|
+
GraphQL Query
|
|
1997
|
+
</a>
|
|
1998
|
+
</li>
|
|
1999
|
+
|
|
2000
|
+
|
|
2001
|
+
|
|
2002
|
+
|
|
2003
|
+
|
|
2004
|
+
|
|
2005
|
+
|
|
2006
|
+
|
|
2007
|
+
|
|
2008
|
+
<li class="md-nav__item">
|
|
2009
|
+
<a href="../models/extras/imageattachment.html" class="md-nav__link">
|
|
2010
|
+
Image Attachment
|
|
2011
|
+
</a>
|
|
2012
|
+
</li>
|
|
2013
|
+
|
|
2014
|
+
|
|
2015
|
+
|
|
2016
|
+
|
|
2017
|
+
|
|
2018
|
+
|
|
2019
|
+
|
|
2020
|
+
|
|
2021
|
+
|
|
2022
|
+
<li class="md-nav__item">
|
|
2023
|
+
<a href="../models/extras/job.html" class="md-nav__link">
|
|
2024
|
+
Job
|
|
2025
|
+
</a>
|
|
2026
|
+
</li>
|
|
2027
|
+
|
|
2028
|
+
|
|
2029
|
+
|
|
2030
|
+
|
|
2031
|
+
|
|
2032
|
+
|
|
2033
|
+
|
|
2034
|
+
|
|
2035
|
+
|
|
2036
|
+
<li class="md-nav__item">
|
|
2037
|
+
<a href="../models/extras/joblogentry.html" class="md-nav__link">
|
|
2038
|
+
Job Log Entry
|
|
2039
|
+
</a>
|
|
2040
|
+
</li>
|
|
2041
|
+
|
|
2042
|
+
|
|
2043
|
+
|
|
2044
|
+
|
|
2045
|
+
|
|
2046
|
+
|
|
2047
|
+
|
|
2048
|
+
|
|
2049
|
+
|
|
2050
|
+
<li class="md-nav__item">
|
|
2051
|
+
<a href="../models/extras/jobresult.html" class="md-nav__link">
|
|
2052
|
+
Job Result
|
|
2053
|
+
</a>
|
|
2054
|
+
</li>
|
|
2055
|
+
|
|
2056
|
+
|
|
2057
|
+
|
|
2058
|
+
|
|
2059
|
+
|
|
2060
|
+
|
|
2061
|
+
|
|
2062
|
+
|
|
2063
|
+
|
|
2064
|
+
<li class="md-nav__item">
|
|
2065
|
+
<a href="../models/extras/role.html" class="md-nav__link">
|
|
2066
|
+
Role
|
|
2067
|
+
</a>
|
|
2068
|
+
</li>
|
|
2069
|
+
|
|
2070
|
+
|
|
2071
|
+
|
|
2072
|
+
|
|
2073
|
+
|
|
2074
|
+
|
|
2075
|
+
|
|
2076
|
+
|
|
2077
|
+
|
|
2078
|
+
<li class="md-nav__item">
|
|
2079
|
+
<a href="../models/extras/secret.html" class="md-nav__link">
|
|
2080
|
+
Secret
|
|
2081
|
+
</a>
|
|
2082
|
+
</li>
|
|
2083
|
+
|
|
2084
|
+
|
|
2085
|
+
|
|
2086
|
+
|
|
2087
|
+
|
|
2088
|
+
|
|
2089
|
+
|
|
2090
|
+
|
|
2091
|
+
|
|
2092
|
+
<li class="md-nav__item">
|
|
2093
|
+
<a href="../models/extras/secretsgroup.html" class="md-nav__link">
|
|
2094
|
+
Secrets group
|
|
2095
|
+
</a>
|
|
2096
|
+
</li>
|
|
2097
|
+
|
|
2098
|
+
|
|
2099
|
+
|
|
2100
|
+
|
|
2101
|
+
</ul>
|
|
2102
|
+
</nav>
|
|
2103
|
+
</li>
|
|
2104
|
+
|
|
2105
|
+
|
|
2106
|
+
|
|
2107
|
+
|
|
2108
|
+
|
|
2109
|
+
|
|
2110
|
+
|
|
2111
|
+
|
|
2112
|
+
|
|
2113
|
+
|
|
2114
|
+
<li class="md-nav__item md-nav__item--nested">
|
|
2115
|
+
|
|
2116
|
+
|
|
2117
|
+
|
|
2118
|
+
|
|
2119
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8_4" >
|
|
2120
|
+
|
|
2121
|
+
|
|
2122
|
+
|
|
2123
|
+
<label class="md-nav__link" for="__nav_2_8_4" id="__nav_2_8_4_label" tabindex="0">
|
|
2124
|
+
IPAM
|
|
2125
|
+
<span class="md-nav__icon md-icon"></span>
|
|
2126
|
+
</label>
|
|
2127
|
+
|
|
2128
|
+
<nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_8_4_label" aria-expanded="false">
|
|
2129
|
+
<label class="md-nav__title" for="__nav_2_8_4">
|
|
2130
|
+
<span class="md-nav__icon md-icon"></span>
|
|
2131
|
+
IPAM
|
|
2132
|
+
</label>
|
|
2133
|
+
<ul class="md-nav__list" data-md-scrollfix>
|
|
2134
|
+
|
|
2135
|
+
|
|
2136
|
+
|
|
2137
|
+
|
|
2138
|
+
|
|
2139
|
+
|
|
2140
|
+
<li class="md-nav__item">
|
|
2141
|
+
<a href="../models/ipam/ipaddress.html" class="md-nav__link">
|
|
2142
|
+
IP Address
|
|
2143
|
+
</a>
|
|
2144
|
+
</li>
|
|
2145
|
+
|
|
2146
|
+
|
|
2147
|
+
|
|
2148
|
+
|
|
2149
|
+
|
|
2150
|
+
|
|
2151
|
+
|
|
2152
|
+
|
|
2153
|
+
|
|
2154
|
+
<li class="md-nav__item">
|
|
2155
|
+
<a href="../models/ipam/prefix.html" class="md-nav__link">
|
|
2156
|
+
Prefix
|
|
2157
|
+
</a>
|
|
2158
|
+
</li>
|
|
2159
|
+
|
|
2160
|
+
|
|
2161
|
+
|
|
2162
|
+
|
|
2163
|
+
|
|
2164
|
+
|
|
2165
|
+
|
|
2166
|
+
|
|
2167
|
+
|
|
2168
|
+
<li class="md-nav__item">
|
|
2169
|
+
<a href="../models/ipam/rir.html" class="md-nav__link">
|
|
2170
|
+
Rir
|
|
2171
|
+
</a>
|
|
2172
|
+
</li>
|
|
2173
|
+
|
|
2174
|
+
|
|
2175
|
+
|
|
2176
|
+
|
|
2177
|
+
|
|
2178
|
+
|
|
2179
|
+
|
|
2180
|
+
|
|
2181
|
+
|
|
2182
|
+
<li class="md-nav__item">
|
|
2183
|
+
<a href="../models/ipam/routetarget.html" class="md-nav__link">
|
|
2184
|
+
Route Target
|
|
2185
|
+
</a>
|
|
2186
|
+
</li>
|
|
2187
|
+
|
|
2188
|
+
|
|
2189
|
+
|
|
2190
|
+
|
|
2191
|
+
|
|
2192
|
+
|
|
2193
|
+
|
|
2194
|
+
|
|
2195
|
+
|
|
2196
|
+
<li class="md-nav__item">
|
|
2197
|
+
<a href="../models/ipam/service.html" class="md-nav__link">
|
|
2198
|
+
Service
|
|
2199
|
+
</a>
|
|
2200
|
+
</li>
|
|
2201
|
+
|
|
2202
|
+
|
|
2203
|
+
|
|
2204
|
+
|
|
2205
|
+
|
|
2206
|
+
|
|
2207
|
+
|
|
2208
|
+
|
|
2209
|
+
|
|
2210
|
+
<li class="md-nav__item">
|
|
2211
|
+
<a href="../models/ipam/vlan.html" class="md-nav__link">
|
|
2212
|
+
VLAN
|
|
2213
|
+
</a>
|
|
2214
|
+
</li>
|
|
2215
|
+
|
|
2216
|
+
|
|
2217
|
+
|
|
2218
|
+
|
|
2219
|
+
|
|
2220
|
+
|
|
2221
|
+
|
|
2222
|
+
|
|
2223
|
+
|
|
2224
|
+
<li class="md-nav__item">
|
|
2225
|
+
<a href="../models/ipam/vlangroup.html" class="md-nav__link">
|
|
2226
|
+
VLAN Group
|
|
2227
|
+
</a>
|
|
2228
|
+
</li>
|
|
2229
|
+
|
|
2230
|
+
|
|
2231
|
+
|
|
2232
|
+
|
|
2233
|
+
|
|
2234
|
+
|
|
2235
|
+
|
|
2236
|
+
|
|
2237
|
+
|
|
2238
|
+
<li class="md-nav__item">
|
|
2239
|
+
<a href="../models/ipam/vrf.html" class="md-nav__link">
|
|
2240
|
+
VRF
|
|
2241
|
+
</a>
|
|
2242
|
+
</li>
|
|
2243
|
+
|
|
2244
|
+
|
|
2245
|
+
|
|
2246
|
+
|
|
2247
|
+
</ul>
|
|
2248
|
+
</nav>
|
|
2249
|
+
</li>
|
|
2250
|
+
|
|
2251
|
+
|
|
2252
|
+
|
|
2253
|
+
|
|
2254
|
+
|
|
2255
|
+
|
|
2256
|
+
|
|
2257
|
+
|
|
2258
|
+
|
|
2259
|
+
|
|
2260
|
+
<li class="md-nav__item md-nav__item--nested">
|
|
2261
|
+
|
|
2262
|
+
|
|
2263
|
+
|
|
2264
|
+
|
|
2265
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8_5" >
|
|
2266
|
+
|
|
2267
|
+
|
|
2268
|
+
|
|
2269
|
+
<label class="md-nav__link" for="__nav_2_8_5" id="__nav_2_8_5_label" tabindex="0">
|
|
2270
|
+
Tenancy
|
|
2271
|
+
<span class="md-nav__icon md-icon"></span>
|
|
2272
|
+
</label>
|
|
2273
|
+
|
|
2274
|
+
<nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_8_5_label" aria-expanded="false">
|
|
2275
|
+
<label class="md-nav__title" for="__nav_2_8_5">
|
|
2276
|
+
<span class="md-nav__icon md-icon"></span>
|
|
2277
|
+
Tenancy
|
|
2278
|
+
</label>
|
|
2279
|
+
<ul class="md-nav__list" data-md-scrollfix>
|
|
2280
|
+
|
|
2281
|
+
|
|
2282
|
+
|
|
2283
|
+
|
|
2284
|
+
|
|
2285
|
+
|
|
2286
|
+
<li class="md-nav__item">
|
|
2287
|
+
<a href="../models/tenancy/tenant.html" class="md-nav__link">
|
|
2288
|
+
Tenant
|
|
2289
|
+
</a>
|
|
2290
|
+
</li>
|
|
2291
|
+
|
|
2292
|
+
|
|
2293
|
+
|
|
2294
|
+
|
|
2295
|
+
|
|
2296
|
+
|
|
2297
|
+
|
|
2298
|
+
|
|
2299
|
+
|
|
2300
|
+
<li class="md-nav__item">
|
|
2301
|
+
<a href="../models/tenancy/tenantgroup.html" class="md-nav__link">
|
|
2302
|
+
Tenant Group
|
|
2303
|
+
</a>
|
|
2304
|
+
</li>
|
|
2305
|
+
|
|
2306
|
+
|
|
2307
|
+
|
|
2308
|
+
|
|
2309
|
+
</ul>
|
|
2310
|
+
</nav>
|
|
2311
|
+
</li>
|
|
2312
|
+
|
|
2313
|
+
|
|
2314
|
+
|
|
2315
|
+
|
|
2316
|
+
|
|
2317
|
+
|
|
2318
|
+
|
|
2319
|
+
|
|
2320
|
+
|
|
2321
|
+
|
|
2322
|
+
<li class="md-nav__item md-nav__item--nested">
|
|
2323
|
+
|
|
2324
|
+
|
|
2325
|
+
|
|
2326
|
+
|
|
2327
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8_6" >
|
|
2328
|
+
|
|
2329
|
+
|
|
2330
|
+
|
|
2331
|
+
<label class="md-nav__link" for="__nav_2_8_6" id="__nav_2_8_6_label" tabindex="0">
|
|
2332
|
+
Users
|
|
2333
|
+
<span class="md-nav__icon md-icon"></span>
|
|
2334
|
+
</label>
|
|
2335
|
+
|
|
2336
|
+
<nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_8_6_label" aria-expanded="false">
|
|
2337
|
+
<label class="md-nav__title" for="__nav_2_8_6">
|
|
2338
|
+
<span class="md-nav__icon md-icon"></span>
|
|
2339
|
+
Users
|
|
2340
|
+
</label>
|
|
2341
|
+
<ul class="md-nav__list" data-md-scrollfix>
|
|
2342
|
+
|
|
2343
|
+
|
|
2344
|
+
|
|
2345
|
+
|
|
2346
|
+
|
|
2347
|
+
|
|
2348
|
+
<li class="md-nav__item">
|
|
2349
|
+
<a href="../models/users/objectpermission.html" class="md-nav__link">
|
|
2350
|
+
Object Permission
|
|
2351
|
+
</a>
|
|
2352
|
+
</li>
|
|
2353
|
+
|
|
2354
|
+
|
|
2355
|
+
|
|
2356
|
+
|
|
2357
|
+
|
|
2358
|
+
|
|
2359
|
+
|
|
2360
|
+
|
|
2361
|
+
|
|
2362
|
+
<li class="md-nav__item">
|
|
2363
|
+
<a href="../models/users/token.html" class="md-nav__link">
|
|
2364
|
+
Token
|
|
2365
|
+
</a>
|
|
2366
|
+
</li>
|
|
2367
|
+
|
|
2368
|
+
|
|
2369
|
+
|
|
2370
|
+
|
|
2371
|
+
</ul>
|
|
2372
|
+
</nav>
|
|
2373
|
+
</li>
|
|
2374
|
+
|
|
2375
|
+
|
|
2376
|
+
|
|
2377
|
+
|
|
2378
|
+
|
|
2379
|
+
|
|
2380
|
+
|
|
2381
|
+
|
|
2382
|
+
|
|
2383
|
+
|
|
2384
|
+
<li class="md-nav__item md-nav__item--nested">
|
|
2385
|
+
|
|
2386
|
+
|
|
2387
|
+
|
|
2388
|
+
|
|
2389
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8_7" >
|
|
2390
|
+
|
|
2391
|
+
|
|
2392
|
+
|
|
2393
|
+
<label class="md-nav__link" for="__nav_2_8_7" id="__nav_2_8_7_label" tabindex="0">
|
|
2394
|
+
Virtualization
|
|
2395
|
+
<span class="md-nav__icon md-icon"></span>
|
|
2396
|
+
</label>
|
|
2397
|
+
|
|
2398
|
+
<nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_8_7_label" aria-expanded="false">
|
|
2399
|
+
<label class="md-nav__title" for="__nav_2_8_7">
|
|
2400
|
+
<span class="md-nav__icon md-icon"></span>
|
|
2401
|
+
Virtualization
|
|
2402
|
+
</label>
|
|
2403
|
+
<ul class="md-nav__list" data-md-scrollfix>
|
|
2404
|
+
|
|
2405
|
+
|
|
2406
|
+
|
|
2407
|
+
|
|
2408
|
+
|
|
2409
|
+
|
|
2410
|
+
<li class="md-nav__item">
|
|
2411
|
+
<a href="../models/virtualization/cluster.html" class="md-nav__link">
|
|
2412
|
+
Cluster
|
|
1243
2413
|
</a>
|
|
1244
2414
|
</li>
|
|
1245
2415
|
|
|
@@ -1252,8 +2422,8 @@
|
|
|
1252
2422
|
|
|
1253
2423
|
|
|
1254
2424
|
<li class="md-nav__item">
|
|
1255
|
-
<a href="../
|
|
1256
|
-
|
|
2425
|
+
<a href="../models/virtualization/clustergroup.html" class="md-nav__link">
|
|
2426
|
+
Cluster Group
|
|
1257
2427
|
</a>
|
|
1258
2428
|
</li>
|
|
1259
2429
|
|
|
@@ -1266,8 +2436,8 @@
|
|
|
1266
2436
|
|
|
1267
2437
|
|
|
1268
2438
|
<li class="md-nav__item">
|
|
1269
|
-
<a href="../
|
|
1270
|
-
|
|
2439
|
+
<a href="../models/virtualization/clustertype.html" class="md-nav__link">
|
|
2440
|
+
Cluster Type
|
|
1271
2441
|
</a>
|
|
1272
2442
|
</li>
|
|
1273
2443
|
|
|
@@ -1280,8 +2450,8 @@
|
|
|
1280
2450
|
|
|
1281
2451
|
|
|
1282
2452
|
<li class="md-nav__item">
|
|
1283
|
-
<a href="../
|
|
1284
|
-
|
|
2453
|
+
<a href="../models/virtualization/virtualmachine.html" class="md-nav__link">
|
|
2454
|
+
Virtual Machine
|
|
1285
2455
|
</a>
|
|
1286
2456
|
</li>
|
|
1287
2457
|
|
|
@@ -1294,23 +2464,16 @@
|
|
|
1294
2464
|
|
|
1295
2465
|
|
|
1296
2466
|
<li class="md-nav__item">
|
|
1297
|
-
<a href="../
|
|
1298
|
-
|
|
2467
|
+
<a href="../models/virtualization/vminterface.html" class="md-nav__link">
|
|
2468
|
+
VM Interface
|
|
1299
2469
|
</a>
|
|
1300
2470
|
</li>
|
|
1301
2471
|
|
|
1302
2472
|
|
|
1303
2473
|
|
|
1304
2474
|
|
|
1305
|
-
|
|
1306
|
-
|
|
1307
|
-
|
|
1308
|
-
|
|
1309
|
-
|
|
1310
|
-
<li class="md-nav__item">
|
|
1311
|
-
<a href="../core-functionality/vlans.html" class="md-nav__link">
|
|
1312
|
-
VLAN Management
|
|
1313
|
-
</a>
|
|
2475
|
+
</ul>
|
|
2476
|
+
</nav>
|
|
1314
2477
|
</li>
|
|
1315
2478
|
|
|
1316
2479
|
|
|
@@ -1332,18 +2495,19 @@
|
|
|
1332
2495
|
<li class="md-nav__item md-nav__item--nested">
|
|
1333
2496
|
|
|
1334
2497
|
|
|
1335
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2_8" type="checkbox" id="__nav_2_8" >
|
|
1336
2498
|
|
|
1337
2499
|
|
|
2500
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_9" >
|
|
2501
|
+
|
|
1338
2502
|
|
|
1339
2503
|
|
|
1340
|
-
<label class="md-nav__link" for="
|
|
2504
|
+
<label class="md-nav__link" for="__nav_2_9" id="__nav_2_9_label" tabindex="0">
|
|
1341
2505
|
Additional Features
|
|
1342
2506
|
<span class="md-nav__icon md-icon"></span>
|
|
1343
2507
|
</label>
|
|
1344
2508
|
|
|
1345
|
-
<nav class="md-nav"
|
|
1346
|
-
<label class="md-nav__title" for="
|
|
2509
|
+
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_9_label" aria-expanded="false">
|
|
2510
|
+
<label class="md-nav__title" for="__nav_2_9">
|
|
1347
2511
|
<span class="md-nav__icon md-icon"></span>
|
|
1348
2512
|
Additional Features
|
|
1349
2513
|
</label>
|
|
@@ -1675,18 +2839,19 @@
|
|
|
1675
2839
|
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
|
|
1676
2840
|
|
|
1677
2841
|
|
|
1678
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2_9" type="checkbox" id="__nav_2_9" checked>
|
|
1679
2842
|
|
|
1680
2843
|
|
|
2844
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_10" checked>
|
|
1681
2845
|
|
|
1682
2846
|
|
|
1683
|
-
|
|
2847
|
+
|
|
2848
|
+
<label class="md-nav__link" for="__nav_2_10" id="__nav_2_10_label" tabindex="0">
|
|
1684
2849
|
REST API
|
|
1685
2850
|
<span class="md-nav__icon md-icon"></span>
|
|
1686
2851
|
</label>
|
|
1687
2852
|
|
|
1688
|
-
<nav class="md-nav"
|
|
1689
|
-
<label class="md-nav__title" for="
|
|
2853
|
+
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_10_label" aria-expanded="true">
|
|
2854
|
+
<label class="md-nav__title" for="__nav_2_10">
|
|
1690
2855
|
<span class="md-nav__icon md-icon"></span>
|
|
1691
2856
|
REST API
|
|
1692
2857
|
</label>
|
|
@@ -1701,7 +2866,7 @@
|
|
|
1701
2866
|
|
|
1702
2867
|
<li class="md-nav__item md-nav__item--active">
|
|
1703
2868
|
|
|
1704
|
-
<input class="md-nav__toggle md-toggle"
|
|
2869
|
+
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
|
|
1705
2870
|
|
|
1706
2871
|
|
|
1707
2872
|
|
|
@@ -1761,8 +2926,8 @@
|
|
|
1761
2926
|
<ul class="md-nav__list">
|
|
1762
2927
|
|
|
1763
2928
|
<li class="md-nav__item">
|
|
1764
|
-
<a href="#default-versions
|
|
1765
|
-
Default Versions
|
|
2929
|
+
<a href="#default-versions" class="md-nav__link">
|
|
2930
|
+
Default Versions
|
|
1766
2931
|
</a>
|
|
1767
2932
|
|
|
1768
2933
|
</li>
|
|
@@ -1832,6 +2997,13 @@
|
|
|
1832
2997
|
Pagination
|
|
1833
2998
|
</a>
|
|
1834
2999
|
|
|
3000
|
+
</li>
|
|
3001
|
+
|
|
3002
|
+
<li class="md-nav__item">
|
|
3003
|
+
<a href="#sorting" class="md-nav__link">
|
|
3004
|
+
Sorting
|
|
3005
|
+
</a>
|
|
3006
|
+
|
|
1835
3007
|
</li>
|
|
1836
3008
|
|
|
1837
3009
|
<li class="md-nav__item">
|
|
@@ -1857,10 +3029,37 @@
|
|
|
1857
3029
|
</li>
|
|
1858
3030
|
|
|
1859
3031
|
<li class="md-nav__item">
|
|
1860
|
-
<a href="#
|
|
1861
|
-
|
|
3032
|
+
<a href="#depth-query-parameter" class="md-nav__link">
|
|
3033
|
+
Depth Query Parameter
|
|
3034
|
+
</a>
|
|
3035
|
+
|
|
3036
|
+
<nav class="md-nav" aria-label="Depth Query Parameter">
|
|
3037
|
+
<ul class="md-nav__list">
|
|
3038
|
+
|
|
3039
|
+
<li class="md-nav__item">
|
|
3040
|
+
<a href="#defaultdepth0" class="md-nav__link">
|
|
3041
|
+
Default/?depth=0
|
|
3042
|
+
</a>
|
|
3043
|
+
|
|
3044
|
+
</li>
|
|
3045
|
+
|
|
3046
|
+
<li class="md-nav__item">
|
|
3047
|
+
<a href="#depth1" class="md-nav__link">
|
|
3048
|
+
?depth=1
|
|
3049
|
+
</a>
|
|
3050
|
+
|
|
3051
|
+
</li>
|
|
3052
|
+
|
|
3053
|
+
<li class="md-nav__item">
|
|
3054
|
+
<a href="#depth2-and-beyond" class="md-nav__link">
|
|
3055
|
+
?depth=2 and beyond
|
|
1862
3056
|
</a>
|
|
1863
3057
|
|
|
3058
|
+
</li>
|
|
3059
|
+
|
|
3060
|
+
</ul>
|
|
3061
|
+
</nav>
|
|
3062
|
+
|
|
1864
3063
|
</li>
|
|
1865
3064
|
|
|
1866
3065
|
<li class="md-nav__item">
|
|
@@ -1871,8 +3070,8 @@
|
|
|
1871
3070
|
</li>
|
|
1872
3071
|
|
|
1873
3072
|
<li class="md-nav__item">
|
|
1874
|
-
<a href="#
|
|
1875
|
-
|
|
3073
|
+
<a href="#including-config-contexts" class="md-nav__link">
|
|
3074
|
+
Including Config Contexts
|
|
1876
3075
|
</a>
|
|
1877
3076
|
|
|
1878
3077
|
</li>
|
|
@@ -1974,6 +3173,20 @@
|
|
|
1974
3173
|
|
|
1975
3174
|
|
|
1976
3175
|
|
|
3176
|
+
|
|
3177
|
+
|
|
3178
|
+
|
|
3179
|
+
|
|
3180
|
+
|
|
3181
|
+
<li class="md-nav__item">
|
|
3182
|
+
<a href="ui-related-endpoints.html" class="md-nav__link">
|
|
3183
|
+
UI Endpoints
|
|
3184
|
+
</a>
|
|
3185
|
+
</li>
|
|
3186
|
+
|
|
3187
|
+
|
|
3188
|
+
|
|
3189
|
+
|
|
1977
3190
|
</ul>
|
|
1978
3191
|
</nav>
|
|
1979
3192
|
</li>
|
|
@@ -1990,18 +3203,19 @@
|
|
|
1990
3203
|
<li class="md-nav__item md-nav__item--nested">
|
|
1991
3204
|
|
|
1992
3205
|
|
|
1993
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_2_10" type="checkbox" id="__nav_2_10" >
|
|
1994
3206
|
|
|
1995
3207
|
|
|
3208
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_11" >
|
|
1996
3209
|
|
|
1997
3210
|
|
|
1998
|
-
|
|
3211
|
+
|
|
3212
|
+
<label class="md-nav__link" for="__nav_2_11" id="__nav_2_11_label" tabindex="0">
|
|
1999
3213
|
GraphQL API
|
|
2000
3214
|
<span class="md-nav__icon md-icon"></span>
|
|
2001
3215
|
</label>
|
|
2002
3216
|
|
|
2003
|
-
<nav class="md-nav"
|
|
2004
|
-
<label class="md-nav__title" for="
|
|
3217
|
+
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_11_label" aria-expanded="false">
|
|
3218
|
+
<label class="md-nav__title" for="__nav_2_11">
|
|
2005
3219
|
<span class="md-nav__icon md-icon"></span>
|
|
2006
3220
|
GraphQL API
|
|
2007
3221
|
</label>
|
|
@@ -2059,17 +3273,18 @@
|
|
|
2059
3273
|
<li class="md-nav__item md-nav__item--nested">
|
|
2060
3274
|
|
|
2061
3275
|
|
|
2062
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_3" type="checkbox" id="__nav_3" >
|
|
2063
3276
|
|
|
2064
3277
|
|
|
3278
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
|
|
2065
3279
|
|
|
2066
3280
|
|
|
2067
|
-
|
|
3281
|
+
|
|
3282
|
+
<label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
|
|
2068
3283
|
App Developer Guide
|
|
2069
3284
|
<span class="md-nav__icon md-icon"></span>
|
|
2070
3285
|
</label>
|
|
2071
3286
|
|
|
2072
|
-
<nav class="md-nav"
|
|
3287
|
+
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
|
|
2073
3288
|
<label class="md-nav__title" for="__nav_3">
|
|
2074
3289
|
<span class="md-nav__icon md-icon"></span>
|
|
2075
3290
|
App Developer Guide
|
|
@@ -2113,17 +3328,18 @@
|
|
|
2113
3328
|
<li class="md-nav__item md-nav__item--nested">
|
|
2114
3329
|
|
|
2115
3330
|
|
|
2116
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_3_3" type="checkbox" id="__nav_3_3" >
|
|
2117
3331
|
|
|
2118
3332
|
|
|
3333
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_3" >
|
|
3334
|
+
|
|
2119
3335
|
|
|
2120
3336
|
|
|
2121
|
-
<label class="md-nav__link" for="__nav_3_3">
|
|
3337
|
+
<label class="md-nav__link" for="__nav_3_3" id="__nav_3_3_label" tabindex="0">
|
|
2122
3338
|
Code Reference
|
|
2123
3339
|
<span class="md-nav__icon md-icon"></span>
|
|
2124
3340
|
</label>
|
|
2125
3341
|
|
|
2126
|
-
<nav class="md-nav"
|
|
3342
|
+
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_3_label" aria-expanded="false">
|
|
2127
3343
|
<label class="md-nav__title" for="__nav_3_3">
|
|
2128
3344
|
<span class="md-nav__icon md-icon"></span>
|
|
2129
3345
|
Code Reference
|
|
@@ -2350,17 +3566,18 @@
|
|
|
2350
3566
|
<li class="md-nav__item md-nav__item--nested">
|
|
2351
3567
|
|
|
2352
3568
|
|
|
2353
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4" type="checkbox" id="__nav_4" >
|
|
2354
3569
|
|
|
2355
3570
|
|
|
3571
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
|
|
2356
3572
|
|
|
2357
3573
|
|
|
2358
|
-
|
|
3574
|
+
|
|
3575
|
+
<label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
|
|
2359
3576
|
Core Developer Guide
|
|
2360
3577
|
<span class="md-nav__icon md-icon"></span>
|
|
2361
3578
|
</label>
|
|
2362
3579
|
|
|
2363
|
-
<nav class="md-nav"
|
|
3580
|
+
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
|
|
2364
3581
|
<label class="md-nav__title" for="__nav_4">
|
|
2365
3582
|
<span class="md-nav__icon md-icon"></span>
|
|
2366
3583
|
Core Developer Guide
|
|
@@ -2594,17 +3811,18 @@
|
|
|
2594
3811
|
<li class="md-nav__item md-nav__item--nested">
|
|
2595
3812
|
|
|
2596
3813
|
|
|
2597
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" >
|
|
2598
3814
|
|
|
2599
3815
|
|
|
3816
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
|
|
3817
|
+
|
|
2600
3818
|
|
|
2601
3819
|
|
|
2602
|
-
<label class="md-nav__link" for="__nav_5">
|
|
3820
|
+
<label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
|
|
2603
3821
|
Release Notes
|
|
2604
3822
|
<span class="md-nav__icon md-icon"></span>
|
|
2605
3823
|
</label>
|
|
2606
3824
|
|
|
2607
|
-
<nav class="md-nav"
|
|
3825
|
+
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
|
|
2608
3826
|
<label class="md-nav__title" for="__nav_5">
|
|
2609
3827
|
<span class="md-nav__icon md-icon"></span>
|
|
2610
3828
|
Release Notes
|
|
@@ -2740,17 +3958,18 @@
|
|
|
2740
3958
|
<li class="md-nav__item md-nav__item--nested">
|
|
2741
3959
|
|
|
2742
3960
|
|
|
2743
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6" type="checkbox" id="__nav_6" >
|
|
2744
3961
|
|
|
2745
3962
|
|
|
3963
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
|
|
2746
3964
|
|
|
2747
3965
|
|
|
2748
|
-
|
|
3966
|
+
|
|
3967
|
+
<label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
|
|
2749
3968
|
Nautobot Apps
|
|
2750
3969
|
<span class="md-nav__icon md-icon"></span>
|
|
2751
3970
|
</label>
|
|
2752
3971
|
|
|
2753
|
-
<nav class="md-nav"
|
|
3972
|
+
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
|
|
2754
3973
|
<label class="md-nav__title" for="__nav_6">
|
|
2755
3974
|
<span class="md-nav__icon md-icon"></span>
|
|
2756
3975
|
Nautobot Apps
|
|
@@ -2780,17 +3999,18 @@
|
|
|
2780
3999
|
<li class="md-nav__item md-nav__item--nested">
|
|
2781
4000
|
|
|
2782
4001
|
|
|
2783
|
-
<input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6_2" type="checkbox" id="__nav_6_2" >
|
|
2784
4002
|
|
|
2785
4003
|
|
|
4004
|
+
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6_2" >
|
|
4005
|
+
|
|
2786
4006
|
|
|
2787
4007
|
|
|
2788
|
-
<label class="md-nav__link" for="__nav_6_2">
|
|
4008
|
+
<label class="md-nav__link" for="__nav_6_2" id="__nav_6_2_label" tabindex="0">
|
|
2789
4009
|
Network to Code App Docs
|
|
2790
4010
|
<span class="md-nav__icon md-icon"></span>
|
|
2791
4011
|
</label>
|
|
2792
4012
|
|
|
2793
|
-
<nav class="md-nav"
|
|
4013
|
+
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_6_2_label" aria-expanded="false">
|
|
2794
4014
|
<label class="md-nav__title" for="__nav_6_2">
|
|
2795
4015
|
<span class="md-nav__icon md-icon"></span>
|
|
2796
4016
|
Network to Code App Docs
|
|
@@ -2817,8 +4037,8 @@
|
|
|
2817
4037
|
|
|
2818
4038
|
|
|
2819
4039
|
<li class="md-nav__item">
|
|
2820
|
-
<a href="https://nautobot
|
|
2821
|
-
Nautobot
|
|
4040
|
+
<a href="https://docs.nautobot.com/projects/circuit-maintenance/en/latest/" class="md-nav__link">
|
|
4041
|
+
Nautobot Circuit Maintenance
|
|
2822
4042
|
</a>
|
|
2823
4043
|
</li>
|
|
2824
4044
|
|
|
@@ -2831,8 +4051,36 @@
|
|
|
2831
4051
|
|
|
2832
4052
|
|
|
2833
4053
|
<li class="md-nav__item">
|
|
2834
|
-
<a href="https://docs.nautobot.com/projects/
|
|
2835
|
-
Nautobot
|
|
4054
|
+
<a href="https://docs.nautobot.com/projects/device-lifecycle/en/latest/" class="md-nav__link">
|
|
4055
|
+
Nautobot Device LifeCycle Management
|
|
4056
|
+
</a>
|
|
4057
|
+
</li>
|
|
4058
|
+
|
|
4059
|
+
|
|
4060
|
+
|
|
4061
|
+
|
|
4062
|
+
|
|
4063
|
+
|
|
4064
|
+
|
|
4065
|
+
|
|
4066
|
+
|
|
4067
|
+
<li class="md-nav__item">
|
|
4068
|
+
<a href="https://docs.nautobot.com/projects/device-onboarding/en/latest/" class="md-nav__link">
|
|
4069
|
+
Nautobot Device Onboarding
|
|
4070
|
+
</a>
|
|
4071
|
+
</li>
|
|
4072
|
+
|
|
4073
|
+
|
|
4074
|
+
|
|
4075
|
+
|
|
4076
|
+
|
|
4077
|
+
|
|
4078
|
+
|
|
4079
|
+
|
|
4080
|
+
|
|
4081
|
+
<li class="md-nav__item">
|
|
4082
|
+
<a href="https://nautobot-plugin-firewall-models.readthedocs.io/en/latest/" class="md-nav__link">
|
|
4083
|
+
Nautobot Firewall Models
|
|
2836
4084
|
</a>
|
|
2837
4085
|
</li>
|
|
2838
4086
|
|
|
@@ -2859,7 +4107,21 @@
|
|
|
2859
4107
|
|
|
2860
4108
|
|
|
2861
4109
|
<li class="md-nav__item">
|
|
2862
|
-
<a href="https://nautobot
|
|
4110
|
+
<a href="https://docs.nautobot.com/projects/plugin-nornir/en/latest/" class="md-nav__link">
|
|
4111
|
+
Nautobot Plugin Nornir
|
|
4112
|
+
</a>
|
|
4113
|
+
</li>
|
|
4114
|
+
|
|
4115
|
+
|
|
4116
|
+
|
|
4117
|
+
|
|
4118
|
+
|
|
4119
|
+
|
|
4120
|
+
|
|
4121
|
+
|
|
4122
|
+
|
|
4123
|
+
<li class="md-nav__item">
|
|
4124
|
+
<a href="https://docs.nautobot.com/projects/ssot/en/latest/" class="md-nav__link">
|
|
2863
4125
|
Nautobot Single Source of Truth
|
|
2864
4126
|
</a>
|
|
2865
4127
|
</li>
|
|
@@ -2965,8 +4227,8 @@
|
|
|
2965
4227
|
<ul class="md-nav__list">
|
|
2966
4228
|
|
|
2967
4229
|
<li class="md-nav__item">
|
|
2968
|
-
<a href="#default-versions
|
|
2969
|
-
Default Versions
|
|
4230
|
+
<a href="#default-versions" class="md-nav__link">
|
|
4231
|
+
Default Versions
|
|
2970
4232
|
</a>
|
|
2971
4233
|
|
|
2972
4234
|
</li>
|
|
@@ -3036,6 +4298,13 @@
|
|
|
3036
4298
|
Pagination
|
|
3037
4299
|
</a>
|
|
3038
4300
|
|
|
4301
|
+
</li>
|
|
4302
|
+
|
|
4303
|
+
<li class="md-nav__item">
|
|
4304
|
+
<a href="#sorting" class="md-nav__link">
|
|
4305
|
+
Sorting
|
|
4306
|
+
</a>
|
|
4307
|
+
|
|
3039
4308
|
</li>
|
|
3040
4309
|
|
|
3041
4310
|
<li class="md-nav__item">
|
|
@@ -3061,10 +4330,37 @@
|
|
|
3061
4330
|
</li>
|
|
3062
4331
|
|
|
3063
4332
|
<li class="md-nav__item">
|
|
3064
|
-
<a href="#
|
|
3065
|
-
|
|
4333
|
+
<a href="#depth-query-parameter" class="md-nav__link">
|
|
4334
|
+
Depth Query Parameter
|
|
4335
|
+
</a>
|
|
4336
|
+
|
|
4337
|
+
<nav class="md-nav" aria-label="Depth Query Parameter">
|
|
4338
|
+
<ul class="md-nav__list">
|
|
4339
|
+
|
|
4340
|
+
<li class="md-nav__item">
|
|
4341
|
+
<a href="#defaultdepth0" class="md-nav__link">
|
|
4342
|
+
Default/?depth=0
|
|
4343
|
+
</a>
|
|
4344
|
+
|
|
4345
|
+
</li>
|
|
4346
|
+
|
|
4347
|
+
<li class="md-nav__item">
|
|
4348
|
+
<a href="#depth1" class="md-nav__link">
|
|
4349
|
+
?depth=1
|
|
4350
|
+
</a>
|
|
4351
|
+
|
|
4352
|
+
</li>
|
|
4353
|
+
|
|
4354
|
+
<li class="md-nav__item">
|
|
4355
|
+
<a href="#depth2-and-beyond" class="md-nav__link">
|
|
4356
|
+
?depth=2 and beyond
|
|
3066
4357
|
</a>
|
|
3067
4358
|
|
|
4359
|
+
</li>
|
|
4360
|
+
|
|
4361
|
+
</ul>
|
|
4362
|
+
</nav>
|
|
4363
|
+
|
|
3068
4364
|
</li>
|
|
3069
4365
|
|
|
3070
4366
|
<li class="md-nav__item">
|
|
@@ -3075,8 +4371,8 @@
|
|
|
3075
4371
|
</li>
|
|
3076
4372
|
|
|
3077
4373
|
<li class="md-nav__item">
|
|
3078
|
-
<a href="#
|
|
3079
|
-
|
|
4374
|
+
<a href="#including-config-contexts" class="md-nav__link">
|
|
4375
|
+
Including Config Contexts
|
|
3080
4376
|
</a>
|
|
3081
4377
|
|
|
3082
4378
|
</li>
|
|
@@ -3155,10 +4451,8 @@
|
|
|
3155
4451
|
|
|
3156
4452
|
|
|
3157
4453
|
|
|
3158
|
-
|
|
3159
|
-
|
|
3160
|
-
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20.71 7.04c.39-.39.39-1.04 0-1.41l-2.34-2.34c-.37-.39-1.02-.39-1.41 0l-1.84 1.83 3.75 3.75M3 17.25V21h3.75L17.81 9.93l-3.75-3.75L3 17.25Z"/></svg>
|
|
3161
|
-
</a>
|
|
4454
|
+
|
|
4455
|
+
|
|
3162
4456
|
|
|
3163
4457
|
|
|
3164
4458
|
<h1 id="rest-api-overview">REST API Overview<a class="headerlink" href="#rest-api-overview" title="Permanent link">¶</a></h1>
|
|
@@ -3172,49 +4466,37 @@
|
|
|
3172
4466
|
</ul>
|
|
3173
4467
|
<p>Additionally, the <code>OPTIONS</code> verb can be used to inspect a particular REST API endpoint and return all supported actions and their available parameters.</p>
|
|
3174
4468
|
<p>One of the primary benefits of a REST API is its human-friendliness. Because it utilizes HTTP and JSON, it's very easy to interact with Nautobot data on the command line using common tools. For example, we can request an IP address from Nautobot and output the JSON using <code>curl</code> and <code>jq</code>. The following command makes an HTTP <code>GET</code> request for information about a particular IP address, identified by its primary key, and uses <code>jq</code> to present the raw JSON data returned in a more human-friendly format. (Piping the output through <code>jq</code> isn't strictly required but makes it much easier to read.)</p>
|
|
3175
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>curl -s http://nautobot/api/ipam/ip-addresses/
|
|
4469
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>curl -s http://nautobot/api/ipam/ip-addresses/83445aa3-bbd3-4ab4-86f5-36942ce9df60/ | jq '.'
|
|
3176
4470
|
</code></pre></div>
|
|
3177
4471
|
<div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="p">{</span>
|
|
3178
|
-
<a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="
|
|
3179
|
-
<a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/ipam/ip-addresses/
|
|
3180
|
-
<a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w"> </span><span class="nt">"
|
|
3181
|
-
<a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w">
|
|
3182
|
-
<a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w">
|
|
3183
|
-
<a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w"> </span><span class="p">
|
|
3184
|
-
<a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w">
|
|
3185
|
-
<a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w">
|
|
3186
|
-
<a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w"> </span><span class="
|
|
3187
|
-
<a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="w"> </span><span class="nt">"
|
|
3188
|
-
<a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a><span class="w">
|
|
3189
|
-
<a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a><span class="w"> </span><span class="
|
|
3190
|
-
<a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a><span class="w"> </span><span class="p">
|
|
3191
|
-
<a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a><span class="w"> </span><span class="nt">"
|
|
3192
|
-
<a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a><span class="w"> </span><span class="nt">"
|
|
3193
|
-
<a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a><span class="w"> </span><span class="nt">"
|
|
3194
|
-
<a id="__codelineno-1-18" name="__codelineno-1-18" href="#__codelineno-1-18"></a><span class="w"> </span><span class="nt">"
|
|
3195
|
-
<a id="__codelineno-1-19" name="__codelineno-1-19" href="#__codelineno-1-19"></a><span class="w">
|
|
3196
|
-
<a id="__codelineno-1-20" name="__codelineno-1-20" href="#__codelineno-1-20"></a><span class="w">
|
|
3197
|
-
<a id="__codelineno-1-21" name="__codelineno-1-21" href="#__codelineno-1-21"></a><span class="w">
|
|
3198
|
-
<a id="__codelineno-1-22" name="__codelineno-1-22" href="#__codelineno-1-22"></a><span class="w">
|
|
3199
|
-
<a id="__codelineno-1-23" name="__codelineno-1-23" href="#__codelineno-1-23"></a><span class="w">
|
|
3200
|
-
<a id="__codelineno-1-24" name="__codelineno-1-24" href="#__codelineno-1-24"></a><span class="w">
|
|
3201
|
-
<a id="__codelineno-1-25" name="__codelineno-1-25" href="#__codelineno-1-25"></a><span class="w">
|
|
3202
|
-
<a id="__codelineno-1-26" name="__codelineno-1-26" href="#__codelineno-1-26"></a><span class="w">
|
|
3203
|
-
<a id="__codelineno-1-27" name="__codelineno-1-27" href="#__codelineno-1-27"></a><span class="
|
|
3204
|
-
<a id="__codelineno-1-28" name="__codelineno-1-28" href="#__codelineno-1-28"></a><span class="w"> </span><span class="nt">"cable"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
3205
|
-
<a id="__codelineno-1-29" name="__codelineno-1-29" href="#__codelineno-1-29"></a><span class="w"> </span><span class="nt">"connection_status"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span>
|
|
3206
|
-
<a id="__codelineno-1-30" name="__codelineno-1-30" href="#__codelineno-1-30"></a><span class="w"> </span><span class="p">},</span>
|
|
3207
|
-
<a id="__codelineno-1-31" name="__codelineno-1-31" href="#__codelineno-1-31"></a><span class="w"> </span><span class="nt">"nat_inside"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
3208
|
-
<a id="__codelineno-1-32" name="__codelineno-1-32" href="#__codelineno-1-32"></a><span class="w"> </span><span class="nt">"nat_outside"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
3209
|
-
<a id="__codelineno-1-33" name="__codelineno-1-33" href="#__codelineno-1-33"></a><span class="w"> </span><span class="nt">"dns_name"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
3210
|
-
<a id="__codelineno-1-34" name="__codelineno-1-34" href="#__codelineno-1-34"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Example IP address"</span><span class="p">,</span>
|
|
3211
|
-
<a id="__codelineno-1-35" name="__codelineno-1-35" href="#__codelineno-1-35"></a><span class="w"> </span><span class="nt">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span>
|
|
3212
|
-
<a id="__codelineno-1-36" name="__codelineno-1-36" href="#__codelineno-1-36"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span>
|
|
3213
|
-
<a id="__codelineno-1-37" name="__codelineno-1-37" href="#__codelineno-1-37"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020-08-04T00:00:00Z"</span><span class="p">,</span>
|
|
3214
|
-
<a id="__codelineno-1-38" name="__codelineno-1-38" href="#__codelineno-1-38"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020-08-04T14:12:39.666885Z"</span>
|
|
3215
|
-
<a id="__codelineno-1-39" name="__codelineno-1-39" href="#__codelineno-1-39"></a><span class="p">}</span>
|
|
4472
|
+
<a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"83445aa3-bbd3-4ab4-86f5-36942ce9df60"</span><span class="p">,</span>
|
|
4473
|
+
<a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/ipam/ip-addresses/83445aa3-bbd3-4ab4-86f5-36942ce9df60/"</span><span class="p">,</span>
|
|
4474
|
+
<a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"10.0.60.39/32"</span><span class="p">,</span>
|
|
4475
|
+
<a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span>
|
|
4476
|
+
<a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w"> </span><span class="nt">"notes_url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/ipam/ip-addresses/83445aa3-bbd3-4ab4-86f5-36942ce9df60/notes/"</span><span class="p">,</span>
|
|
4477
|
+
<a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w"> </span><span class="nt">"family"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
4478
|
+
<a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w"> </span><span class="nt">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span>
|
|
4479
|
+
<a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="w"> </span><span class="nt">"label"</span><span class="p">:</span><span class="w"> </span><span class="s2">"IPv4"</span>
|
|
4480
|
+
<a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a><span class="w"> </span><span class="p">},</span>
|
|
4481
|
+
<a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="w"> </span><span class="nt">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"10.0.60.39/32"</span><span class="p">,</span>
|
|
4482
|
+
<a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a><span class="w"> </span><span class="nt">"nat_outside_list"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
|
4483
|
+
<a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a><span class="w"> </span><span class="s2">"http://nautobot/api/ipam/ip-addresses/a7569104-ed58-4938-ab6f-cb6a9e584f14/"</span>
|
|
4484
|
+
<a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a><span class="w"> </span><span class="p">],</span>
|
|
4485
|
+
<a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-25T12:46:09.152507Z"</span><span class="p">,</span>
|
|
4486
|
+
<a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-25T12:46:09.163545Z"</span><span class="p">,</span>
|
|
4487
|
+
<a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a><span class="w"> </span><span class="nt">"host"</span><span class="p">:</span><span class="w"> </span><span class="s2">"10.0.60.39"</span><span class="p">,</span>
|
|
4488
|
+
<a id="__codelineno-1-18" name="__codelineno-1-18" href="#__codelineno-1-18"></a><span class="w"> </span><span class="nt">"mask_length"</span><span class="p">:</span><span class="w"> </span><span class="mi">32</span><span class="p">,</span>
|
|
4489
|
+
<a id="__codelineno-1-19" name="__codelineno-1-19" href="#__codelineno-1-19"></a><span class="w"> </span><span class="nt">"dns_name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"desktop-08.cook.biz"</span><span class="p">,</span>
|
|
4490
|
+
<a id="__codelineno-1-20" name="__codelineno-1-20" href="#__codelineno-1-20"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"This is an IP Address"</span><span class="p">,</span>
|
|
4491
|
+
<a id="__codelineno-1-21" name="__codelineno-1-21" href="#__codelineno-1-21"></a><span class="w"> </span><span class="nt">"role"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/extras/roles/e7a815b0-2c48-499a-84b8-f20350abe415/"</span><span class="p">,</span>
|
|
4492
|
+
<a id="__codelineno-1-22" name="__codelineno-1-22" href="#__codelineno-1-22"></a><span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/extras/statuses/b7f6a447-5616-4533-a6d5-a4ece50cd08c/"</span><span class="p">,</span>
|
|
4493
|
+
<a id="__codelineno-1-23" name="__codelineno-1-23" href="#__codelineno-1-23"></a><span class="w"> </span><span class="nt">"vrf"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
4494
|
+
<a id="__codelineno-1-24" name="__codelineno-1-24" href="#__codelineno-1-24"></a><span class="w"> </span><span class="nt">"tenant"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/tenancy/tenants/501fffe7-5302-40ae-b9e4-27d5e3ff2108/"</span><span class="p">,</span>
|
|
4495
|
+
<a id="__codelineno-1-25" name="__codelineno-1-25" href="#__codelineno-1-25"></a><span class="w"> </span><span class="nt">"nat_inside"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
4496
|
+
<a id="__codelineno-1-26" name="__codelineno-1-26" href="#__codelineno-1-26"></a><span class="w"> </span><span class="nt">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span>
|
|
4497
|
+
<a id="__codelineno-1-27" name="__codelineno-1-27" href="#__codelineno-1-27"></a><span class="p">}</span>
|
|
3216
4498
|
</code></pre></div>
|
|
3217
|
-
<p>Each attribute of the IP address is expressed as an attribute of the JSON object.
|
|
4499
|
+
<p>Each attribute of the IP address is expressed as an attribute of the JSON object. Related objects are identified by their own URLs that may be accessed to retrieve more details of the related object, as in the case of the <code>role</code> and <code>status</code> fields above. Every object includes a primary key named <code>id</code> which uniquely identifies it in the database.</p>
|
|
3218
4500
|
<h2 id="interactive-documentation">Interactive Documentation<a class="headerlink" href="#interactive-documentation" title="Permanent link">¶</a></h2>
|
|
3219
4501
|
<p>Comprehensive, interactive documentation of all REST API endpoints is available on a running Nautobot instance at <code>/api/docs/</code>. This interface provides a convenient sandbox for researching and experimenting with specific endpoints and request types. The API itself can also be explored using a web browser by navigating to its root at <code>/api/</code>.</p>
|
|
3220
4502
|
<div class="admonition version-added">
|
|
@@ -3240,7 +4522,7 @@
|
|
|
3240
4522
|
<li><code>/api/dcim/devices/6a522ebb-5739-4c5c-922f-ab4a2dc12eb0/</code> - Retrieve, update, or delete the device with ID 6a522ebb-5739-4c5c-922f-ab4a2dc12eb0</li>
|
|
3241
4523
|
</ul>
|
|
3242
4524
|
<p>Lists of objects can be filtered using a set of query parameters. For example, to find all interfaces belonging to the device with ID 6a522ebb-5739-4c5c-922f-ab4a2dc12eb0:</p>
|
|
3243
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>GET /api/dcim/interfaces/?
|
|
4525
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>GET /api/dcim/interfaces/?device=6a522ebb-5739-4c5c-922f-ab4a2dc12eb0
|
|
3244
4526
|
</code></pre></div>
|
|
3245
4527
|
<p>See the <a href="filtering.html">filtering documentation</a> for more details.</p>
|
|
3246
4528
|
<h2 id="versioning">Versioning<a class="headerlink" href="#versioning" title="Permanent link">¶</a></h2>
|
|
@@ -3253,16 +4535,19 @@
|
|
|
3253
4535
|
<li>A client may include an <code>api_version</code> as a URL query parameter, for example <code>/api/extras/jobs/?api_version=2.0</code></li>
|
|
3254
4536
|
</ol>
|
|
3255
4537
|
<p>Generally the former approach is recommended when writing automated API integrations, as it can be set as a general request header alongside the <a href="authentication.html">authentication token</a> and re-used across a series of REST API interactions, while the latter approach may be more convenient when initially exploring the REST API via the interactive documentation as described above.</p>
|
|
3256
|
-
<h3 id="default-versions
|
|
3257
|
-
<p>By default, a REST API request that does not specify an API version number will default to compatibility with
|
|
3258
|
-
<div class="admonition
|
|
3259
|
-
<p class="admonition-title">
|
|
4538
|
+
<h3 id="default-versions">Default Versions<a class="headerlink" href="#default-versions" title="Permanent link">¶</a></h3>
|
|
4539
|
+
<p>By default, a REST API request that does not specify an API version number will default to compatibility with the current Nautobot version.</p>
|
|
4540
|
+
<div class="admonition version-added">
|
|
4541
|
+
<p class="admonition-title">Added in version 1.3.0</p>
|
|
3260
4542
|
<p>For Nautobot 1.x, the default API behavior is to be compatible with the REST API of Nautobot version 1.2, in other words, for all Nautobot 1.x versions (beginning with Nautobot 1.2.0), <code>Accept: application/json</code> is functionally equivalent to <code>Accept: application/json; version=1.2</code>.</p>
|
|
3261
|
-
<p>For Nautobot 2.x, the default API version is 2.0.</p>
|
|
3262
4543
|
</div>
|
|
3263
|
-
<div class="admonition
|
|
3264
|
-
<p class="admonition-title">
|
|
3265
|
-
<p>
|
|
4544
|
+
<div class="admonition version-changed">
|
|
4545
|
+
<p class="admonition-title">Changed in version 2.0.0</p>
|
|
4546
|
+
<p>As of Nautobot 2.0, the default API behavior is changed to use the latest available REST API version. In other words, the default REST API version for Nautobot 2.0.y will be <code>2.0</code>, for Nautobot 2.1.y will be <code>2.1</code>, etc. This means that REST API clients that do not explicitly request a particular REST API version may encounter potentially <a href="#breaking-changes">breaking changes</a> in the REST API when Nautobot is upgraded to a new minor or major version.</p>
|
|
4547
|
+
</div>
|
|
4548
|
+
<div class="admonition important">
|
|
4549
|
+
<p class="admonition-title">Important</p>
|
|
4550
|
+
<p>As a best practice, it is recommended that a REST API client <em>should always</em> request the exact Nautobot REST API version that it is compatible with, rather than relying on the default behavior to remain constant.</p>
|
|
3266
4551
|
</div>
|
|
3267
4552
|
<div class="admonition tip">
|
|
3268
4553
|
<p class="admonition-title">Tip</p>
|
|
@@ -3283,21 +4568,17 @@
|
|
|
3283
4568
|
<p>Breaking (non-backward-compatible) REST API changes also may be introduced in major or minor Nautobot releases. Examples would include:</p>
|
|
3284
4569
|
<ul>
|
|
3285
4570
|
<li>Removal of deprecated fields</li>
|
|
3286
|
-
<li>Addition of new, <em>required</em> fields in POST/PUT/PATCH requests</li>
|
|
4571
|
+
<li>Addition of new, <em>required</em> fields in POST/PUT/PATCH requests or changing an existing field from optional to required</li>
|
|
3287
4572
|
<li>Changed field types (for example, changing a single value to a list of values)</li>
|
|
3288
4573
|
<li>Redesigned API (for example, listing and accessing Job instances by UUID primary-key instead of by class-path string)</li>
|
|
3289
4574
|
</ul>
|
|
3290
4575
|
<p>Per Nautobot's <a href="../development/index.html#deprecation-policy">feature-deprecation policy</a>, the previous REST API version(s) will continue to be supported until the next major release. Upon the next major release, previously deprecated API versions will be removed and the newest behavior will become the default. You will no longer be able to request API versions from the previous major version.</p>
|
|
3291
4576
|
<div class="admonition important">
|
|
3292
4577
|
<p class="admonition-title">Important</p>
|
|
3293
|
-
<p>
|
|
3294
|
-
</div>
|
|
3295
|
-
<div class="admonition tip">
|
|
3296
|
-
<p class="admonition-title">Tip</p>
|
|
3297
|
-
<p>This is another reason to always specify the exact <code>major.minor</code> Nautobot REST API version when developing a REST API client integration, as it guarantees that the client will be receiving the latest API feature set available in that release rather than possibly defaulting to an older REST API version that is still default but is now deprecated.</p>
|
|
4578
|
+
<p>Again, REST API clients are strongly encouraged to always specify the REST API version they are expecting, as otherwise unexpected breaking changes may be encountered when Nautobot is upgraded to a new major or minor release.</p>
|
|
3298
4579
|
</div>
|
|
3299
4580
|
<h3 id="example-of-api-version-behavior">Example of API Version Behavior<a class="headerlink" href="#example-of-api-version-behavior" title="Permanent link">¶</a></h3>
|
|
3300
|
-
<p>As an example, let us say that Nautobot 1
|
|
4581
|
+
<p>As an example, let us say that Nautobot 2.1 introduced a new, <em>non-backwards-compatible</em> REST API for the <code>/api/extras/jobs/</code> endpoint, and also introduced a new, <em>backwards-compatible</em> set of additional fields on the <code>/api/dcim/locations/</code> endpoint. Depending on what API version a REST client interacting with Nautobot 2.1 specified (or didn't specify), it would see the following responses from the server:</p>
|
|
3301
4582
|
<table>
|
|
3302
4583
|
<thead>
|
|
3303
4584
|
<tr>
|
|
@@ -3310,23 +4591,23 @@
|
|
|
3310
4591
|
<tr>
|
|
3311
4592
|
<td><code>/api/extras/jobs/</code></td>
|
|
3312
4593
|
<td>(unspecified)</td>
|
|
3313
|
-
<td>
|
|
4594
|
+
<td>Updated 2.1 REST API (not backwards compatible)</td>
|
|
3314
4595
|
</tr>
|
|
3315
4596
|
<tr>
|
|
3316
4597
|
<td><code>/api/extras/jobs/</code></td>
|
|
3317
|
-
<td><code>
|
|
3318
|
-
<td>Deprecated
|
|
4598
|
+
<td><code>2.0</code></td>
|
|
4599
|
+
<td>Deprecated 2.0-compatible REST API</td>
|
|
3319
4600
|
</tr>
|
|
3320
4601
|
<tr>
|
|
3321
4602
|
<td><code>/api/extras/jobs/</code></td>
|
|
3322
|
-
<td><code>1
|
|
3323
|
-
<td>New/updated 1
|
|
4603
|
+
<td><code>2.1</code></td>
|
|
4604
|
+
<td>New/updated 2.1-compatible REST API</td>
|
|
3324
4605
|
</tr>
|
|
3325
4606
|
</tbody>
|
|
3326
4607
|
</table>
|
|
3327
|
-
<div class="admonition
|
|
3328
|
-
<p class="admonition-title">
|
|
3329
|
-
<p>
|
|
4608
|
+
<div class="admonition version-changed">
|
|
4609
|
+
<p class="admonition-title">Changed in version 2.0.0</p>
|
|
4610
|
+
<p>The <a href="#default-versions">default behavior</a> when the API version is unspecified is changed from Nautobot 1.x.</p>
|
|
3330
4611
|
</div>
|
|
3331
4612
|
<table>
|
|
3332
4613
|
<thead>
|
|
@@ -3338,19 +4619,19 @@
|
|
|
3338
4619
|
</thead>
|
|
3339
4620
|
<tbody>
|
|
3340
4621
|
<tr>
|
|
3341
|
-
<td><code>/api/dcim/
|
|
4622
|
+
<td><code>/api/dcim/locations/</code></td>
|
|
3342
4623
|
<td>(unspecified)</td>
|
|
3343
|
-
<td>1
|
|
4624
|
+
<td>2.1-updated, 2.0-compatible REST API</td>
|
|
3344
4625
|
</tr>
|
|
3345
4626
|
<tr>
|
|
3346
|
-
<td><code>/api/dcim/
|
|
3347
|
-
<td><code>
|
|
3348
|
-
<td>1
|
|
4627
|
+
<td><code>/api/dcim/locations/</code></td>
|
|
4628
|
+
<td><code>2.0</code></td>
|
|
4629
|
+
<td>2.1-updated, 2.0-compatible REST API</td>
|
|
3349
4630
|
</tr>
|
|
3350
4631
|
<tr>
|
|
3351
|
-
<td><code>/api/dcim/
|
|
3352
|
-
<td><code>1
|
|
3353
|
-
<td>1
|
|
4632
|
+
<td><code>/api/dcim/locations/</code></td>
|
|
4633
|
+
<td><code>2.1</code></td>
|
|
4634
|
+
<td>2.1-updated, 2.0-compatible REST API</td>
|
|
3354
4635
|
</tr>
|
|
3355
4636
|
</tbody>
|
|
3356
4637
|
</table>
|
|
@@ -3366,17 +4647,17 @@
|
|
|
3366
4647
|
<tr>
|
|
3367
4648
|
<td><code>/api/dcim/racks/</code></td>
|
|
3368
4649
|
<td>(unspecified)</td>
|
|
3369
|
-
<td>1
|
|
4650
|
+
<td>2.1-compatible REST API (unchanged from 2.0)</td>
|
|
3370
4651
|
</tr>
|
|
3371
4652
|
<tr>
|
|
3372
4653
|
<td><code>/api/dcim/racks/</code></td>
|
|
3373
|
-
<td><code>
|
|
3374
|
-
<td>1
|
|
4654
|
+
<td><code>2.0</code></td>
|
|
4655
|
+
<td>2.1-compatible REST API (unchanged from 2.0)</td>
|
|
3375
4656
|
</tr>
|
|
3376
4657
|
<tr>
|
|
3377
4658
|
<td><code>/api/dcim/racks/</code></td>
|
|
3378
|
-
<td><code>1
|
|
3379
|
-
<td>1
|
|
4659
|
+
<td><code>2.1</code></td>
|
|
4660
|
+
<td>2.1-compatible REST API (unchanged from 2.0)</td>
|
|
3380
4661
|
</tr>
|
|
3381
4662
|
</tbody>
|
|
3382
4663
|
</table>
|
|
@@ -3386,41 +4667,29 @@
|
|
|
3386
4667
|
</div>
|
|
3387
4668
|
<p>The constructor for Nautobot's <code>APISelect</code>/<code>APISelectMultiple</code> UI widgets now includes an optional <code>api_version</code> argument which if set overrides the default API version of the request.</p>
|
|
3388
4669
|
<h2 id="serialization">Serialization<a class="headerlink" href="#serialization" title="Permanent link">¶</a></h2>
|
|
3389
|
-
<p>The REST API employs
|
|
4670
|
+
<p>The REST API employs "serializers" to represent model data. The representation produced by a serializer typically includes all relevant database table fields which comprise the model, and may also include additional metadata such as information about other relevant objects in the database. Much like the database model itself, a serializer typically will represent information about "parent" objects (those objects that needed to exist in order to define the current object, such as <code>DeviceType</code> and <code>Location</code> for a <code>DeviceSerializer</code>) but typically will not include information about "child" objects (those objects that depend on the current object in order to be defined, such as <code>Interface</code> objects for a <code>DeviceSerializer</code>).</p>
|
|
4671
|
+
<h3 id="related-objects">Related Objects<a class="headerlink" href="#related-objects" title="Permanent link">¶</a></h3>
|
|
4672
|
+
<p>Related objects (e.g. <code>ForeignKey</code> fields) are representable in several different ways. By default, when retrieving an object via the REST API, related objects are represented by URLs, or by a JSON <code>null</code> if no such related object exists. These URLs may be accessed in order to retrieve the full details of such related objects if needed/desired. For example, when retrieving an <code>IPAddress</code>, you might see:</p>
|
|
3390
4673
|
<div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="p">{</span>
|
|
3391
|
-
<a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="
|
|
3392
|
-
<a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="w"> </span><span class="nt">"
|
|
3393
|
-
<a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="w">
|
|
3394
|
-
<a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="w">
|
|
3395
|
-
<a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w">
|
|
3396
|
-
<a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="w">
|
|
3397
|
-
<a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="w"> </span><span class="p">
|
|
3398
|
-
<a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="w"> </span><span class="nt">"
|
|
3399
|
-
<a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="w">
|
|
3400
|
-
<a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="w">
|
|
3401
|
-
<a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="w">
|
|
3402
|
-
<a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="
|
|
3403
|
-
<a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="w"> </span><span class="p">},</span>
|
|
3404
|
-
<a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="w"> </span><span class="nt">"vid"</span><span class="p">:</span><span class="w"> </span><span class="mi">101</span><span class="p">,</span>
|
|
3405
|
-
<a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Users-Floor1"</span><span class="p">,</span>
|
|
3406
|
-
<a id="__codelineno-3-17" name="__codelineno-3-17" href="#__codelineno-3-17"></a><span class="w"> </span><span class="nt">"tenant"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
3407
|
-
<a id="__codelineno-3-18" name="__codelineno-3-18" href="#__codelineno-3-18"></a><span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
3408
|
-
<a id="__codelineno-3-19" name="__codelineno-3-19" href="#__codelineno-3-19"></a><span class="w"> </span><span class="nt">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"active"</span><span class="p">,</span>
|
|
3409
|
-
<a id="__codelineno-3-20" name="__codelineno-3-20" href="#__codelineno-3-20"></a><span class="w"> </span><span class="nt">"label"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Active"</span>
|
|
3410
|
-
<a id="__codelineno-3-21" name="__codelineno-3-21" href="#__codelineno-3-21"></a><span class="w"> </span><span class="p">},</span>
|
|
3411
|
-
<a id="__codelineno-3-22" name="__codelineno-3-22" href="#__codelineno-3-22"></a><span class="w"> </span><span class="nt">"role"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
3412
|
-
<a id="__codelineno-3-23" name="__codelineno-3-23" href="#__codelineno-3-23"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"a1fd5e46-a85e-48c3-a2f4-3c2ec2bb2464"</span><span class="p">,</span>
|
|
3413
|
-
<a id="__codelineno-3-24" name="__codelineno-3-24" href="#__codelineno-3-24"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/ipam/roles/a1fd5e46-a85e-48c3-a2f4-3c2ec2bb2464/"</span><span class="p">,</span>
|
|
3414
|
-
<a id="__codelineno-3-25" name="__codelineno-3-25" href="#__codelineno-3-25"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"User Access"</span><span class="p">,</span>
|
|
3415
|
-
<a id="__codelineno-3-26" name="__codelineno-3-26" href="#__codelineno-3-26"></a><span class="w"> </span><span class="nt">"slug"</span><span class="p">:</span><span class="w"> </span><span class="s2">"user-access"</span>
|
|
3416
|
-
<a id="__codelineno-3-27" name="__codelineno-3-27" href="#__codelineno-3-27"></a><span class="w"> </span><span class="p">},</span>
|
|
3417
|
-
<a id="__codelineno-3-28" name="__codelineno-3-28" href="#__codelineno-3-28"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
3418
|
-
<a id="__codelineno-3-29" name="__codelineno-3-29" href="#__codelineno-3-29"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"101 (Users-Floor1)"</span><span class="p">,</span>
|
|
3419
|
-
<a id="__codelineno-3-30" name="__codelineno-3-30" href="#__codelineno-3-30"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{}</span>
|
|
3420
|
-
<a id="__codelineno-3-31" name="__codelineno-3-31" href="#__codelineno-3-31"></a><span class="p">}</span>
|
|
4674
|
+
<a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"83445aa3-bbd3-4ab4-86f5-36942ce9df60"</span><span class="p">,</span>
|
|
4675
|
+
<a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://localhost:8080/api/ipam/ip-addresses/83445aa3-bbd3-4ab4-86f5-36942ce9df60/"</span><span class="p">,</span>
|
|
4676
|
+
<a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"10.0.60.39/32"</span><span class="p">,</span>
|
|
4677
|
+
<a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="w"> </span><span class="nt">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"10.0.60.39/32"</span><span class="p">,</span>
|
|
4678
|
+
<a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w"> </span><span class="err">...</span>
|
|
4679
|
+
<a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="w"> </span><span class="nt">"role"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://localhost:8080/api/extras/roles/e7a815b0-2c48-499a-84b8-f20350abe415/"</span><span class="p">,</span>
|
|
4680
|
+
<a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://localhost:8080/api/extras/statuses/b7f6a447-5616-4533-a6d5-a4ece50cd08c/"</span><span class="p">,</span>
|
|
4681
|
+
<a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="w"> </span><span class="nt">"vrf"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
4682
|
+
<a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="w"> </span><span class="nt">"tenant"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://localhost:8080/api/tenancy/tenants/501fffe7-5302-40ae-b9e4-27d5e3ff2108/"</span><span class="p">,</span>
|
|
4683
|
+
<a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="w"> </span><span class="nt">"nat_inside"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
4684
|
+
<a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="w"> </span><span class="nt">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span>
|
|
4685
|
+
<a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="p">}</span>
|
|
3421
4686
|
</code></pre></div>
|
|
3422
|
-
<
|
|
3423
|
-
<
|
|
4687
|
+
<p>Here, the <code>role</code>, <code>status</code>, <code>vrf</code>, <code>tenant</code>, and <code>nat_outside</code> fields represent objects related to this <code>IPAddress</code>, and the <code>tags</code> field is a list of such objects (no tags in this example).</p>
|
|
4688
|
+
<div class="admonition version-changed">
|
|
4689
|
+
<p class="admonition-title">Changed in version 2.0.0</p>
|
|
4690
|
+
<p>The representation of related objects on retrieval has changed from Nautobot 1.x. The <code>brief</code> query parameter has been removed, and distinct "nested" serializers no longer exist. Instead, the <code>depth</code> parameter controls whether related objects are represented by URLs or as nested objects. Please see <a href="#depth-query-parameter">Depth Query Parameter</a> for more details.</p>
|
|
4691
|
+
</div>
|
|
4692
|
+
<p>When performing write API actions (<code>POST</code>, <code>PUT</code>, and <code>PATCH</code>), related objects may be specified by either UUID (primary key), or by a set of attributes sufficiently unique to return the desired object.</p>
|
|
3424
4693
|
<p>For example, when creating a new device, its rack can be specified by Nautobot ID (PK):</p>
|
|
3425
4694
|
<div class="highlight"><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="p">{</span>
|
|
3426
4695
|
<a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"MyNewDevice"</span><span class="p">,</span>
|
|
@@ -3432,7 +4701,7 @@
|
|
|
3432
4701
|
<div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="p">{</span>
|
|
3433
4702
|
<a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"MyNewDevice"</span><span class="p">,</span>
|
|
3434
4703
|
<a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="w"> </span><span class="nt">"rack"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
3435
|
-
<a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="w"> </span><span class="nt">"
|
|
4704
|
+
<a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="w"> </span><span class="nt">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
3436
4705
|
<a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Equinix DC6"</span>
|
|
3437
4706
|
<a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="w"> </span><span class="p">},</span>
|
|
3438
4707
|
<a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"R204"</span>
|
|
@@ -3440,47 +4709,41 @@
|
|
|
3440
4709
|
<a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="w"> </span><span class="err">...</span>
|
|
3441
4710
|
<a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="p">}</span>
|
|
3442
4711
|
</code></pre></div>
|
|
3443
|
-
<p>Note that if the provided parameters do not
|
|
4712
|
+
<p>Note that if the provided parameters do not match exactly one object, a validation error will be raised.</p>
|
|
3444
4713
|
<h3 id="generic-relations">Generic Relations<a class="headerlink" href="#generic-relations" title="Permanent link">¶</a></h3>
|
|
3445
|
-
<p>Some objects within Nautobot have attributes which can reference an object of multiple types, known as <em>generic relations</em>. For example,
|
|
4714
|
+
<p>Some objects within Nautobot have attributes which can reference an object of multiple types, known as <em>generic relations</em>. For example, a <code>Cable</code> can be terminated (connected) to an <code>Interface</code>, or a <code>FrontPort</code>, or a <code>RearPort</code>, etc. For such generic relations, when making this assignment via the REST API, we must specify two attributes, typically a <code>object_type</code> and an <code>object_id</code>, and by convention in Nautobot's API:</p>
|
|
3446
4715
|
<ul>
|
|
3447
|
-
<li
|
|
3448
|
-
<li
|
|
4716
|
+
<li>the <code>object_type</code> is the type of assigned object, typically represented as <code><app_label>.<model_name></code></li>
|
|
4717
|
+
<li>the <code>object_id</code> is the UUID (primary key) of the assigned object.</li>
|
|
3449
4718
|
</ul>
|
|
3450
|
-
<p>
|
|
4719
|
+
<p>For example, the two ends of a Cable are identified by <code>termination_a_type</code>/<code>termination_a_id</code> and <code>termination_b_type</code>/<code>termination_b_id</code>, and might be specified on creation as something like:</p>
|
|
3451
4720
|
<div class="highlight"><pre><span></span><code><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>curl -X POST \
|
|
3452
4721
|
<a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>-H "Authorization: Token $TOKEN" \
|
|
3453
4722
|
<a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a>-H "Content-Type: application/json" \
|
|
3454
|
-
<a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a>-H "Accept: application/json; version=
|
|
3455
|
-
<a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a>http://nautobot/api/
|
|
4723
|
+
<a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a>-H "Accept: application/json; version=2.0; indent=4" \
|
|
4724
|
+
<a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a>http://nautobot/api/dcim/cables/ \
|
|
3456
4725
|
<a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a>--data '{
|
|
3457
|
-
<a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a> "
|
|
3458
|
-
<a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a> "
|
|
3459
|
-
<a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a> "
|
|
3460
|
-
<a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a>
|
|
4726
|
+
<a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a> "termination_a_type": "dcim.interface",
|
|
4727
|
+
<a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a> "termination_a_id": "96ee6c25-d689-46f4-b552-eb72977c27b8",
|
|
4728
|
+
<a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a> "termination_b_type": "dcim.frontport",
|
|
4729
|
+
<a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a> "termination_b_id": "ca54e2cc-d1b5-46e2-bb7d-85b1a9e3c1d0",
|
|
4730
|
+
<a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a> ...
|
|
4731
|
+
<a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a>}'
|
|
3461
4732
|
</code></pre></div>
|
|
4733
|
+
<p>On retrieval, the REST API will include the <code>object_type</code> and <code>object_id</code> fields, but will also typically for convenience include an <code>object</code> field containing the URL or nested details of the object identified by the type/id fields. For the above <code>Cable</code> example, the retrieval response might look something like:</p>
|
|
3462
4734
|
<div class="highlight"><pre><span></span><code><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="p">{</span>
|
|
3463
|
-
<a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"
|
|
3464
|
-
<a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://
|
|
3465
|
-
<a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="w"> </span><span class="
|
|
3466
|
-
<a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="w"> </span><span class="nt">"
|
|
3467
|
-
<a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="w"> </span><span class="nt">"
|
|
3468
|
-
<a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="w">
|
|
3469
|
-
<a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="w">
|
|
3470
|
-
<a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="w">
|
|
3471
|
-
<a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="w">
|
|
3472
|
-
<a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="w">
|
|
3473
|
-
<a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="
|
|
3474
|
-
<a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"device105"</span>
|
|
3475
|
-
<a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="w"> </span><span class="p">},</span>
|
|
3476
|
-
<a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ge-0/0/0"</span><span class="p">,</span>
|
|
3477
|
-
<a id="__codelineno-7-16" name="__codelineno-7-16" href="#__codelineno-7-16"></a><span class="w"> </span><span class="nt">"cable"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
3478
|
-
<a id="__codelineno-7-17" name="__codelineno-7-17" href="#__codelineno-7-17"></a><span class="w"> </span><span class="nt">"connection_status"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span>
|
|
3479
|
-
<a id="__codelineno-7-18" name="__codelineno-7-18" href="#__codelineno-7-18"></a><span class="w"> </span><span class="p">},</span>
|
|
3480
|
-
<a id="__codelineno-7-19" name="__codelineno-7-19" href="#__codelineno-7-19"></a><span class="w"> </span><span class="err">...</span>
|
|
3481
|
-
<a id="__codelineno-7-20" name="__codelineno-7-20" href="#__codelineno-7-20"></a><span class="p">}</span>
|
|
4735
|
+
<a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"549dae0d-3345-4bd1-8626-085e46a36ded"</span><span class="p">,</span>
|
|
4736
|
+
<a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://localhost:8080/api/dcim/cables/549dae0d-3345-4bd1-8626-085e46a36ded/"</span><span class="p">,</span>
|
|
4737
|
+
<a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="w"> </span><span class="err">...</span>
|
|
4738
|
+
<a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="w"> </span><span class="nt">"termination_a_type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"dcim.interface"</span><span class="p">,</span>
|
|
4739
|
+
<a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="w"> </span><span class="nt">"termination_b_type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"dcim.frontport"</span><span class="p">,</span>
|
|
4740
|
+
<a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="w"> </span><span class="nt">"termination_a_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"96ee6c25-d689-46f4-b552-eb72977c27b8"</span><span class="p">,</span>
|
|
4741
|
+
<a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="w"> </span><span class="nt">"termination_b_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ca54e2cc-d1b5-46e2-bb7d-85b1a9e3c1d0"</span><span class="p">,</span>
|
|
4742
|
+
<a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="w"> </span><span class="nt">"termination_a"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://localhost:8080/api/dcim/interfaces/96ee6c25-d689-46f4-b552-eb72977c27b8/"</span><span class="p">,</span>
|
|
4743
|
+
<a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="w"> </span><span class="nt">"termination_b"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://localhost:8080/api/dcim/front-ports/ca54e2cc-d1b5-46e2-bb7d-85b1a9e3c1d0/"</span><span class="p">,</span>
|
|
4744
|
+
<a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="w"> </span><span class="err">...</span>
|
|
4745
|
+
<a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="p">}</span>
|
|
3482
4746
|
</code></pre></div>
|
|
3483
|
-
<p>If we wanted to assign this IP address to a virtual machine interface instead, we would have set <code>assigned_object_type</code> to <code>virtualization.vminterface</code> and updated the object ID appropriately.</p>
|
|
3484
4747
|
<h2 id="pagination">Pagination<a class="headerlink" href="#pagination" title="Permanent link">¶</a></h2>
|
|
3485
4748
|
<p>API responses which contain a list of many objects will be paginated for efficiency. The root JSON object returned by a list endpoint contains the following attributes:</p>
|
|
3486
4749
|
<ul>
|
|
@@ -3531,36 +4794,44 @@
|
|
|
3531
4794
|
<p class="admonition-title">Warning</p>
|
|
3532
4795
|
<p>Disabling the page size limit introduces a potential for very resource-intensive requests, since one API request can effectively retrieve an entire table from the database.</p>
|
|
3533
4796
|
</div>
|
|
4797
|
+
<h2 id="sorting">Sorting<a class="headerlink" href="#sorting" title="Permanent link">¶</a></h2>
|
|
4798
|
+
<p>By default, objects are sorted by their model-defined ordering property. However, this can be overridden by specifying the <code>?sort</code> query parameter. For example, to retrieve devices sorted by their rack position:</p>
|
|
4799
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>http://nautobot/api/dcim/devices/?sort=position
|
|
4800
|
+
</code></pre></div>
|
|
4801
|
+
<p>To sort in descending order, prefix the field name with a minus sign (<code>-</code>):</p>
|
|
4802
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>http://nautobot/api/dcim/devices/?sort=-position
|
|
4803
|
+
</code></pre></div>
|
|
4804
|
+
<p>Currently only direct model attributes are validated to be sorted as expected.</p>
|
|
3534
4805
|
<h2 id="interacting-with-objects">Interacting with Objects<a class="headerlink" href="#interacting-with-objects" title="Permanent link">¶</a></h2>
|
|
3535
4806
|
<h3 id="retrieving-multiple-objects">Retrieving Multiple Objects<a class="headerlink" href="#retrieving-multiple-objects" title="Permanent link">¶</a></h3>
|
|
3536
4807
|
<p>To query Nautobot for a list of objects, make a <code>GET</code> request to the model's <em>list</em> endpoint. Objects are listed under the response object's <code>results</code> parameter. Specifying the <code>Accept</code> header with the Nautobot API version is not required, but is strongly recommended.</p>
|
|
3537
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-
|
|
3538
|
-
<a id="__codelineno-
|
|
3539
|
-
<a id="__codelineno-
|
|
4808
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>curl -s -X GET \
|
|
4809
|
+
<a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a>-H "Accept: application/json; version=2.0" \
|
|
4810
|
+
<a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a>http://nautobot/api/ipam/ip-addresses/ | jq '.'
|
|
3540
4811
|
</code></pre></div>
|
|
3541
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-
|
|
3542
|
-
<a id="__codelineno-
|
|
3543
|
-
<a id="__codelineno-
|
|
3544
|
-
<a id="__codelineno-
|
|
3545
|
-
<a id="__codelineno-
|
|
3546
|
-
<a id="__codelineno-
|
|
3547
|
-
<a id="__codelineno-
|
|
3548
|
-
<a id="__codelineno-
|
|
3549
|
-
<a id="__codelineno-
|
|
3550
|
-
<a id="__codelineno-
|
|
3551
|
-
<a id="__codelineno-
|
|
3552
|
-
<a id="__codelineno-
|
|
3553
|
-
<a id="__codelineno-
|
|
3554
|
-
<a id="__codelineno-
|
|
3555
|
-
<a id="__codelineno-
|
|
3556
|
-
<a id="__codelineno-
|
|
3557
|
-
<a id="__codelineno-
|
|
3558
|
-
<a id="__codelineno-
|
|
3559
|
-
<a id="__codelineno-
|
|
3560
|
-
<a id="__codelineno-
|
|
3561
|
-
<a id="__codelineno-
|
|
3562
|
-
<a id="__codelineno-
|
|
3563
|
-
<a id="__codelineno-
|
|
4812
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="p">{</span>
|
|
4813
|
+
<a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="w"> </span><span class="nt">"count"</span><span class="p">:</span><span class="w"> </span><span class="mi">42031</span><span class="p">,</span>
|
|
4814
|
+
<a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="w"> </span><span class="nt">"next"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/ipam/ip-addresses/?limit=50&offset=50"</span><span class="p">,</span>
|
|
4815
|
+
<a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="w"> </span><span class="nt">"previous"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
4816
|
+
<a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="w"> </span><span class="nt">"results"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
|
4817
|
+
<a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a><span class="w"> </span><span class="p">{</span>
|
|
4818
|
+
<a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"bd307eca-de34-4bda-9195-d69ca52206d6"</span><span class="p">,</span>
|
|
4819
|
+
<a id="__codelineno-14-8" name="__codelineno-14-8" href="#__codelineno-14-8"></a><span class="w"> </span><span class="nt">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"192.0.2.1/24"</span><span class="p">,</span>
|
|
4820
|
+
<a id="__codelineno-14-9" name="__codelineno-14-9" href="#__codelineno-14-9"></a><span class="w"> </span><span class="err">...</span>
|
|
4821
|
+
<a id="__codelineno-14-10" name="__codelineno-14-10" href="#__codelineno-14-10"></a><span class="w"> </span><span class="p">},</span>
|
|
4822
|
+
<a id="__codelineno-14-11" name="__codelineno-14-11" href="#__codelineno-14-11"></a><span class="w"> </span><span class="p">{</span>
|
|
4823
|
+
<a id="__codelineno-14-12" name="__codelineno-14-12" href="#__codelineno-14-12"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"6c52e918-4f0c-4c50-ae49-6bef22c97fd5"</span><span class="p">,</span>
|
|
4824
|
+
<a id="__codelineno-14-13" name="__codelineno-14-13" href="#__codelineno-14-13"></a><span class="w"> </span><span class="nt">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"192.0.2.2/24"</span><span class="p">,</span>
|
|
4825
|
+
<a id="__codelineno-14-14" name="__codelineno-14-14" href="#__codelineno-14-14"></a><span class="w"> </span><span class="err">...</span>
|
|
4826
|
+
<a id="__codelineno-14-15" name="__codelineno-14-15" href="#__codelineno-14-15"></a><span class="w"> </span><span class="p">},</span>
|
|
4827
|
+
<a id="__codelineno-14-16" name="__codelineno-14-16" href="#__codelineno-14-16"></a><span class="w"> </span><span class="p">{</span>
|
|
4828
|
+
<a id="__codelineno-14-17" name="__codelineno-14-17" href="#__codelineno-14-17"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"b8cde1ee-1b86-4ea4-a884-041c472d8999"</span><span class="p">,</span>
|
|
4829
|
+
<a id="__codelineno-14-18" name="__codelineno-14-18" href="#__codelineno-14-18"></a><span class="w"> </span><span class="nt">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"192.0.2.3/24"</span><span class="p">,</span>
|
|
4830
|
+
<a id="__codelineno-14-19" name="__codelineno-14-19" href="#__codelineno-14-19"></a><span class="w"> </span><span class="err">...</span>
|
|
4831
|
+
<a id="__codelineno-14-20" name="__codelineno-14-20" href="#__codelineno-14-20"></a><span class="w"> </span><span class="p">},</span>
|
|
4832
|
+
<a id="__codelineno-14-21" name="__codelineno-14-21" href="#__codelineno-14-21"></a><span class="w"> </span><span class="err">...</span>
|
|
4833
|
+
<a id="__codelineno-14-22" name="__codelineno-14-22" href="#__codelineno-14-22"></a><span class="w"> </span><span class="p">]</span>
|
|
4834
|
+
<a id="__codelineno-14-23" name="__codelineno-14-23" href="#__codelineno-14-23"></a><span class="p">}</span>
|
|
3564
4835
|
</code></pre></div>
|
|
3565
4836
|
<h3 id="retrieving-a-single-object">Retrieving a Single Object<a class="headerlink" href="#retrieving-a-single-object" title="Permanent link">¶</a></h3>
|
|
3566
4837
|
<p>To query Nautobot for a single object, make a <code>GET</code> request to the model's <em>detail</em> endpoint specifying its UUID.</p>
|
|
@@ -3568,120 +4839,324 @@
|
|
|
3568
4839
|
<p class="admonition-title">Note</p>
|
|
3569
4840
|
<p>Note that the trailing slash is required. Omitting this will return a 302 redirect.</p>
|
|
3570
4841
|
</div>
|
|
3571
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-
|
|
3572
|
-
<a id="__codelineno-
|
|
3573
|
-
<a id="__codelineno-
|
|
3574
|
-
</code></pre></div>
|
|
3575
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="p">{</span>
|
|
3576
|
-
<a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"bd307eca-de34-4bda-9195-d69ca52206d6"</span><span class="p">,</span>
|
|
3577
|
-
<a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="w"> </span><span class="nt">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"192.0.2.1/24"</span><span class="p">,</span>
|
|
3578
|
-
<a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="w"> </span><span class="err">...</span>
|
|
3579
|
-
<a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="p">}</span>
|
|
3580
|
-
</code></pre></div>
|
|
3581
|
-
<h3 id="brief-format">Brief Format<a class="headerlink" href="#brief-format" title="Permanent link">¶</a></h3>
|
|
3582
|
-
<p>The <code>GET</code> API endpoints support an optional "brief" format, which returns only a minimal representation of each object in the response. This is useful when you need only a list of available objects without any related data, such as when populating a drop-down list in a form. As an example, the default (complete) format of an IP address looks like this:</p>
|
|
3583
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>GET /api/ipam/prefixes/7d2d24ac-4737-4fc1-a850-b30366618f3d/
|
|
4842
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>curl -s -X GET \
|
|
4843
|
+
<a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a>-H "Accept: application/json; version=2.0" \
|
|
4844
|
+
<a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a>http://nautobot/api/ipam/ip-addresses/bd307eca-de34-4bda-9195-d69ca52206d6/ | jq '.'
|
|
3584
4845
|
</code></pre></div>
|
|
3585
4846
|
<div class="highlight"><pre><span></span><code><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="p">{</span>
|
|
3586
|
-
<a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a><span class="w">
|
|
3587
|
-
<a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="w">
|
|
3588
|
-
<a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a><span class="w">
|
|
3589
|
-
<a id="__codelineno-16-5" name="__codelineno-16-5" href="#__codelineno-16-5"></a><span class="
|
|
3590
|
-
<a id="__codelineno-16-6" name="__codelineno-16-6" href="#__codelineno-16-6"></a><span class="w"> </span><span class="nt">"label"</span><span class="p">:</span><span class="w"> </span><span class="s2">"IPv4"</span>
|
|
3591
|
-
<a id="__codelineno-16-7" name="__codelineno-16-7" href="#__codelineno-16-7"></a><span class="w"> </span><span class="p">},</span>
|
|
3592
|
-
<a id="__codelineno-16-8" name="__codelineno-16-8" href="#__codelineno-16-8"></a><span class="w"> </span><span class="nt">"prefix"</span><span class="p">:</span><span class="w"> </span><span class="s2">"192.0.2.0/24"</span><span class="p">,</span>
|
|
3593
|
-
<a id="__codelineno-16-9" name="__codelineno-16-9" href="#__codelineno-16-9"></a><span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
3594
|
-
<a id="__codelineno-16-10" name="__codelineno-16-10" href="#__codelineno-16-10"></a><span class="w"> </span><span class="nt">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"container"</span><span class="p">,</span>
|
|
3595
|
-
<a id="__codelineno-16-11" name="__codelineno-16-11" href="#__codelineno-16-11"></a><span class="w"> </span><span class="nt">"label"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Container"</span>
|
|
3596
|
-
<a id="__codelineno-16-12" name="__codelineno-16-12" href="#__codelineno-16-12"></a><span class="w"> </span><span class="p">},</span>
|
|
3597
|
-
<a id="__codelineno-16-13" name="__codelineno-16-13" href="#__codelineno-16-13"></a><span class="w"> </span><span class="nt">"site"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
3598
|
-
<a id="__codelineno-16-14" name="__codelineno-16-14" href="#__codelineno-16-14"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"b9edf2ee-cad9-48be-9921-006294bff730"</span><span class="p">,</span>
|
|
3599
|
-
<a id="__codelineno-16-15" name="__codelineno-16-15" href="#__codelineno-16-15"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/sites/b9edf2ee-cad9-48be-9921-006294bff730/"</span><span class="p">,</span>
|
|
3600
|
-
<a id="__codelineno-16-16" name="__codelineno-16-16" href="#__codelineno-16-16"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Site 23A"</span><span class="p">,</span>
|
|
3601
|
-
<a id="__codelineno-16-17" name="__codelineno-16-17" href="#__codelineno-16-17"></a><span class="w"> </span><span class="nt">"slug"</span><span class="p">:</span><span class="w"> </span><span class="s2">"site-23a"</span>
|
|
3602
|
-
<a id="__codelineno-16-18" name="__codelineno-16-18" href="#__codelineno-16-18"></a><span class="w"> </span><span class="p">},</span>
|
|
3603
|
-
<a id="__codelineno-16-19" name="__codelineno-16-19" href="#__codelineno-16-19"></a><span class="w"> </span><span class="nt">"vrf"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
3604
|
-
<a id="__codelineno-16-20" name="__codelineno-16-20" href="#__codelineno-16-20"></a><span class="w"> </span><span class="nt">"tenant"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
3605
|
-
<a id="__codelineno-16-21" name="__codelineno-16-21" href="#__codelineno-16-21"></a><span class="w"> </span><span class="nt">"vlan"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
3606
|
-
<a id="__codelineno-16-22" name="__codelineno-16-22" href="#__codelineno-16-22"></a><span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
3607
|
-
<a id="__codelineno-16-23" name="__codelineno-16-23" href="#__codelineno-16-23"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Reserved"</span><span class="p">,</span>
|
|
3608
|
-
<a id="__codelineno-16-24" name="__codelineno-16-24" href="#__codelineno-16-24"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"fc32b83f-2448-4602-9d43-fecc6735e4e5"</span><span class="p">,</span>
|
|
3609
|
-
<a id="__codelineno-16-25" name="__codelineno-16-25" href="#__codelineno-16-25"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://localhost:8080/api/extras/statuses/fc32b83f-2448-4602-9d43-fecc6735e4e5/"</span><span class="p">,</span>
|
|
3610
|
-
<a id="__codelineno-16-26" name="__codelineno-16-26" href="#__codelineno-16-26"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Reserved"</span><span class="p">,</span>
|
|
3611
|
-
<a id="__codelineno-16-27" name="__codelineno-16-27" href="#__codelineno-16-27"></a><span class="w"> </span><span class="nt">"slug"</span><span class="p">:</span><span class="w"> </span><span class="s2">"reserved"</span><span class="p">,</span>
|
|
3612
|
-
<a id="__codelineno-16-28" name="__codelineno-16-28" href="#__codelineno-16-28"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-12-09T01:02:03.456789Z"</span><span class="p">,</span>
|
|
3613
|
-
<a id="__codelineno-16-29" name="__codelineno-16-29" href="#__codelineno-16-29"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-12-09T16:38:50.363404Z"</span>
|
|
3614
|
-
<a id="__codelineno-16-30" name="__codelineno-16-30" href="#__codelineno-16-30"></a><span class="w"> </span><span class="p">},</span>
|
|
3615
|
-
<a id="__codelineno-16-31" name="__codelineno-16-31" href="#__codelineno-16-31"></a><span class="w"> </span><span class="nt">"role"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
3616
|
-
<a id="__codelineno-16-32" name="__codelineno-16-32" href="#__codelineno-16-32"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ae1470bc-a858-4ce7-b9ce-dd1cd46333fe"</span><span class="p">,</span>
|
|
3617
|
-
<a id="__codelineno-16-33" name="__codelineno-16-33" href="#__codelineno-16-33"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/ipam/roles/ae1470bc-a858-4ce7-b9ce-dd1cd46333fe/"</span><span class="p">,</span>
|
|
3618
|
-
<a id="__codelineno-16-34" name="__codelineno-16-34" href="#__codelineno-16-34"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Staging"</span><span class="p">,</span>
|
|
3619
|
-
<a id="__codelineno-16-35" name="__codelineno-16-35" href="#__codelineno-16-35"></a><span class="w"> </span><span class="nt">"slug"</span><span class="p">:</span><span class="w"> </span><span class="s2">"staging"</span>
|
|
3620
|
-
<a id="__codelineno-16-36" name="__codelineno-16-36" href="#__codelineno-16-36"></a><span class="w"> </span><span class="p">},</span>
|
|
3621
|
-
<a id="__codelineno-16-37" name="__codelineno-16-37" href="#__codelineno-16-37"></a><span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"network"</span><span class="p">,</span>
|
|
3622
|
-
<a id="__codelineno-16-38" name="__codelineno-16-38" href="#__codelineno-16-38"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Example prefix"</span><span class="p">,</span>
|
|
3623
|
-
<a id="__codelineno-16-39" name="__codelineno-16-39" href="#__codelineno-16-39"></a><span class="w"> </span><span class="nt">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span>
|
|
3624
|
-
<a id="__codelineno-16-40" name="__codelineno-16-40" href="#__codelineno-16-40"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span>
|
|
3625
|
-
<a id="__codelineno-16-41" name="__codelineno-16-41" href="#__codelineno-16-41"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2018-12-10T00:00:00Z"</span><span class="p">,</span>
|
|
3626
|
-
<a id="__codelineno-16-42" name="__codelineno-16-42" href="#__codelineno-16-42"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-03-01T20:02:46.173540Z"</span>
|
|
3627
|
-
<a id="__codelineno-16-43" name="__codelineno-16-43" href="#__codelineno-16-43"></a><span class="p">}</span>
|
|
4847
|
+
<a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"bd307eca-de34-4bda-9195-d69ca52206d6"</span><span class="p">,</span>
|
|
4848
|
+
<a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="w"> </span><span class="nt">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"192.0.2.1/24"</span><span class="p">,</span>
|
|
4849
|
+
<a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a><span class="w"> </span><span class="err">...</span>
|
|
4850
|
+
<a id="__codelineno-16-5" name="__codelineno-16-5" href="#__codelineno-16-5"></a><span class="p">}</span>
|
|
3628
4851
|
</code></pre></div>
|
|
3629
|
-
<
|
|
3630
|
-
<div class="
|
|
4852
|
+
<h3 id="depth-query-parameter">Depth Query Parameter<a class="headerlink" href="#depth-query-parameter" title="Permanent link">¶</a></h3>
|
|
4853
|
+
<div class="admonition version-added">
|
|
4854
|
+
<p class="admonition-title">Added in version 2.0.0</p>
|
|
4855
|
+
</div>
|
|
4856
|
+
<p>A <code>?depth</code> query parameter is introduced in Nautobot 2.0 to replace the <code>?brief</code> parameter. It enables <a href="https://www.django-rest-framework.org/api-guide/serializers/#specifying-nested-serialization">nested serialization</a> functionality and offers a more dynamic and comprehensive browsable API. It is available for both retrieving a single object and a list of objects.
|
|
4857
|
+
This parameter is an positive integer value that can range from 0 to 10. In most use cases, you will only need a maximum <code>depth</code> of 2 to get all the information you need.</p>
|
|
4858
|
+
<div class="admonition note">
|
|
4859
|
+
<p class="admonition-title">Note</p>
|
|
4860
|
+
<p>The <code>?brief</code> query parameter is removed for Nautobot v2.x. Use <code>?depth=0</code> instead.</p>
|
|
4861
|
+
</div>
|
|
4862
|
+
<div class="admonition important">
|
|
4863
|
+
<p class="admonition-title">Important</p>
|
|
4864
|
+
<p>The <code>?depth</code> query parameter should only be used for <code>GET</code> operations in the API. It should not be used in <code>POST</code>, <code>PATCH</code> and <code>DELETE</code> requests. For these requests, only <code>?depth=0</code> should be used.</p>
|
|
4865
|
+
</div>
|
|
4866
|
+
<h4 id="defaultdepth0">Default/?depth=0<a class="headerlink" href="#defaultdepth0" title="Permanent link">¶</a></h4>
|
|
4867
|
+
<p><code>?depth</code> parameter defaults to 0 and offers a very lightweight view of the API where all object-related fields are represented by only their URLs:</p>
|
|
4868
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a>curl -s -X GET \
|
|
4869
|
+
<a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a>-H "Accept: application/json; version=2.0" \
|
|
4870
|
+
<a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a>http://nautobot/api/dcim/locations/0e19e475-89c9-4cf4-8b5f-a0589f0950cd/ | jq '.'
|
|
3631
4871
|
</code></pre></div>
|
|
3632
4872
|
<div class="highlight"><pre><span></span><code><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a><span class="p">{</span>
|
|
3633
|
-
<a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"
|
|
3634
|
-
<a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a><span class="w"> </span><span class="nt">"
|
|
3635
|
-
<a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a><span class="w"> </span><span class="nt">"
|
|
3636
|
-
<a id="__codelineno-18-5" name="__codelineno-18-5" href="#__codelineno-18-5"></a><span class="w"> </span><span class="nt">"
|
|
3637
|
-
<a id="__codelineno-18-6" name="__codelineno-18-6" href="#__codelineno-18-6"></a><span class="p">
|
|
4873
|
+
<a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0e19e475-89c9-4cf4-8b5f-a0589f0950cd"</span><span class="p">,</span>
|
|
4874
|
+
<a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Campus-01"</span><span class="p">,</span>
|
|
4875
|
+
<a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/locations/0e19e475-89c9-4cf4-8b5f-a0589f0950cd/"</span><span class="p">,</span>
|
|
4876
|
+
<a id="__codelineno-18-5" name="__codelineno-18-5" href="#__codelineno-18-5"></a><span class="w"> </span><span class="nt">"tree_depth"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span>
|
|
4877
|
+
<a id="__codelineno-18-6" name="__codelineno-18-6" href="#__codelineno-18-6"></a><span class="w"> </span><span class="nt">"time_zone"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Asia/Baghdad"</span><span class="p">,</span>
|
|
4878
|
+
<a id="__codelineno-18-7" name="__codelineno-18-7" href="#__codelineno-18-7"></a><span class="w"> </span><span class="nt">"circuit_count"</span><span class="p">:</span><span class="w"> </span><span class="mi">7</span><span class="p">,</span>
|
|
4879
|
+
<a id="__codelineno-18-8" name="__codelineno-18-8" href="#__codelineno-18-8"></a><span class="w"> </span><span class="nt">"device_count"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span>
|
|
4880
|
+
<a id="__codelineno-18-9" name="__codelineno-18-9" href="#__codelineno-18-9"></a><span class="w"> </span><span class="nt">"prefix_count"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span>
|
|
4881
|
+
<a id="__codelineno-18-10" name="__codelineno-18-10" href="#__codelineno-18-10"></a><span class="w"> </span><span class="nt">"rack_count"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span>
|
|
4882
|
+
<a id="__codelineno-18-11" name="__codelineno-18-11" href="#__codelineno-18-11"></a><span class="w"> </span><span class="nt">"virtual_machine_count"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span>
|
|
4883
|
+
<a id="__codelineno-18-12" name="__codelineno-18-12" href="#__codelineno-18-12"></a><span class="w"> </span><span class="nt">"vlan_count"</span><span class="p">:</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span>
|
|
4884
|
+
<a id="__codelineno-18-13" name="__codelineno-18-13" href="#__codelineno-18-13"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:06.884754Z"</span><span class="p">,</span>
|
|
4885
|
+
<a id="__codelineno-18-14" name="__codelineno-18-14" href="#__codelineno-18-14"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:06.906503Z"</span><span class="p">,</span>
|
|
4886
|
+
<a id="__codelineno-18-15" name="__codelineno-18-15" href="#__codelineno-18-15"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Campus-01"</span><span class="p">,</span>
|
|
4887
|
+
<a id="__codelineno-18-16" name="__codelineno-18-16" href="#__codelineno-18-16"></a><span class="w"> </span><span class="nt">"slug"</span><span class="p">:</span><span class="w"> </span><span class="s2">"campus-01"</span><span class="p">,</span>
|
|
4888
|
+
<a id="__codelineno-18-17" name="__codelineno-18-17" href="#__codelineno-18-17"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Local take each compare court exactly."</span><span class="p">,</span>
|
|
4889
|
+
<a id="__codelineno-18-18" name="__codelineno-18-18" href="#__codelineno-18-18"></a><span class="w"> </span><span class="nt">"facility"</span><span class="p">:</span><span class="w"> </span><span class="s2">"328"</span><span class="p">,</span>
|
|
4890
|
+
<a id="__codelineno-18-19" name="__codelineno-18-19" href="#__codelineno-18-19"></a><span class="w"> </span><span class="nt">"asn"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
4891
|
+
<a id="__codelineno-18-20" name="__codelineno-18-20" href="#__codelineno-18-20"></a><span class="w"> </span><span class="nt">"physical_address"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
4892
|
+
<a id="__codelineno-18-21" name="__codelineno-18-21" href="#__codelineno-18-21"></a><span class="w"> </span><span class="nt">"shipping_address"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
4893
|
+
<a id="__codelineno-18-22" name="__codelineno-18-22" href="#__codelineno-18-22"></a><span class="w"> </span><span class="nt">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
4894
|
+
<a id="__codelineno-18-23" name="__codelineno-18-23" href="#__codelineno-18-23"></a><span class="w"> </span><span class="nt">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="s2">"104.200000"</span><span class="p">,</span>
|
|
4895
|
+
<a id="__codelineno-18-24" name="__codelineno-18-24" href="#__codelineno-18-24"></a><span class="w"> </span><span class="nt">"contact_name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Frances Hernandez"</span><span class="p">,</span>
|
|
4896
|
+
<a id="__codelineno-18-25" name="__codelineno-18-25" href="#__codelineno-18-25"></a><span class="w"> </span><span class="nt">"contact_phone"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
4897
|
+
<a id="__codelineno-18-26" name="__codelineno-18-26" href="#__codelineno-18-26"></a><span class="w"> </span><span class="nt">"contact_email"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
4898
|
+
<a id="__codelineno-18-27" name="__codelineno-18-27" href="#__codelineno-18-27"></a><span class="w"> </span><span class="nt">"comments"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Sort share road candidate."</span><span class="p">,</span>
|
|
4899
|
+
<a id="__codelineno-18-28" name="__codelineno-18-28" href="#__codelineno-18-28"></a><span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/extras/statuses/28eb334b-4171-4da4-a03a-fa6d0c6a9442/"</span><span class="p">,</span>
|
|
4900
|
+
<a id="__codelineno-18-29" name="__codelineno-18-29" href="#__codelineno-18-29"></a><span class="w"> </span><span class="nt">"parent"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
4901
|
+
<a id="__codelineno-18-30" name="__codelineno-18-30" href="#__codelineno-18-30"></a><span class="w"> </span><span class="nt">"location_type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/location-types/e3d4a9af-c6c1-4582-b483-a13301eb6e28/"</span><span class="p">,</span>
|
|
4902
|
+
<a id="__codelineno-18-31" name="__codelineno-18-31" href="#__codelineno-18-31"></a><span class="w"> </span><span class="nt">"tenant"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/tenancy/tenants/5b1feadb-fab0-4f81-a53f-5192d83b0216/"</span><span class="p">,</span>
|
|
4903
|
+
<a id="__codelineno-18-32" name="__codelineno-18-32" href="#__codelineno-18-32"></a><span class="w"> </span><span class="nt">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
|
4904
|
+
<a id="__codelineno-18-33" name="__codelineno-18-33" href="#__codelineno-18-33"></a><span class="w"> </span><span class="s2">"http://nautobot/api/extras/tags/a50d4568-27ae-4743-87ac-ffdc22b7f5d2/"</span><span class="p">,</span>
|
|
4905
|
+
<a id="__codelineno-18-34" name="__codelineno-18-34" href="#__codelineno-18-34"></a><span class="w"> </span><span class="p">],</span>
|
|
4906
|
+
<a id="__codelineno-18-35" name="__codelineno-18-35" href="#__codelineno-18-35"></a><span class="w"> </span><span class="nt">"notes_url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/locations/0e19e475-89c9-4cf4-8b5f-a0589f0950cd/notes/"</span><span class="p">,</span>
|
|
4907
|
+
<a id="__codelineno-18-36" name="__codelineno-18-36" href="#__codelineno-18-36"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
4908
|
+
<a id="__codelineno-18-37" name="__codelineno-18-37" href="#__codelineno-18-37"></a><span class="w"> </span><span class="nt">"example_plugin_auto_custom_field"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span>
|
|
4909
|
+
<a id="__codelineno-18-38" name="__codelineno-18-38" href="#__codelineno-18-38"></a><span class="w"> </span><span class="p">}</span>
|
|
4910
|
+
<a id="__codelineno-18-39" name="__codelineno-18-39" href="#__codelineno-18-39"></a><span class="p">}</span>
|
|
4911
|
+
</code></pre></div>
|
|
4912
|
+
<h4 id="depth1">?depth=1<a class="headerlink" href="#depth1" title="Permanent link">¶</a></h4>
|
|
4913
|
+
<p>When <code>?depth=1</code> is added to the query parameters, all object-related fields, instead of being represented as UUIDs as they are when <code>?depth=0</code>, will be represented as nested objects, similar (<strong>but not necessarily identical!</strong>) to the objects that would be retrieved when querying the API directly for those related objects.</p>
|
|
4914
|
+
<div class="admonition important">
|
|
4915
|
+
<p class="admonition-title">Important</p>
|
|
4916
|
+
<p>Nested objects retrieved with a greater-than-zero <code>depth</code> parameter do not necessarily include all fields that would be included on the fully detailed object that can be retrieved by querying their <code>url</code> directly. In particular:</p>
|
|
4917
|
+
<ul>
|
|
4918
|
+
<li>Nested objects <em>will not include</em> a field for <code>tags</code> or any other many-to-many relations on the object (such as a <code>Status</code> object's <code>content_types</code> relation).</li>
|
|
4919
|
+
<li>Nested objects <em>will not include</em> the <code>relationships</code> or <code>computed_fields</code> keys, even if those are <a href="#retrieving-object-relationships-and-relationship-associations">opted-in</a> on the request.</li>
|
|
4920
|
+
<li>Nested objects <em>may omit</em> any derived (non-database) attributes, such as related object counts, tree-depth information, etc.</li>
|
|
4921
|
+
</ul>
|
|
4922
|
+
</div>
|
|
4923
|
+
<p>For example, retrieving a <code>Location</code> with <code>?depth=1</code> would provide nested objects for the <code>status</code>, <code>parent</code>, <code>location_type</code>, <code>tenant</code>, and <code>tags</code> fields:</p>
|
|
4924
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a>curl -s -X GET \
|
|
4925
|
+
<a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a>-H "Accept: application/json; version=2.0" \
|
|
4926
|
+
<a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a>http://nautobot/api/dcim/locations/ce69530e-6a4a-4d3c-9f95-fc326ec39abf/?depth=1 | jq '.'
|
|
4927
|
+
</code></pre></div>
|
|
4928
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a><span class="p">{</span>
|
|
4929
|
+
<a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a><span class="w"> </span><span class="err">...</span>
|
|
4930
|
+
<a id="__codelineno-20-3" name="__codelineno-20-3" href="#__codelineno-20-3"></a><span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
4931
|
+
<a id="__codelineno-20-4" name="__codelineno-20-4" href="#__codelineno-20-4"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"91a53d61-4180-4820-835d-533b34dbb5b4"</span><span class="p">,</span>
|
|
4932
|
+
<a id="__codelineno-20-5" name="__codelineno-20-5" href="#__codelineno-20-5"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Active"</span><span class="p">,</span>
|
|
4933
|
+
<a id="__codelineno-20-6" name="__codelineno-20-6" href="#__codelineno-20-6"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/extras/statuses/91a53d61-4180-4820-835d-533b34dbb5b4/"</span><span class="p">,</span>
|
|
4934
|
+
<a id="__codelineno-20-7" name="__codelineno-20-7" href="#__codelineno-20-7"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span>
|
|
4935
|
+
<a id="__codelineno-20-8" name="__codelineno-20-8" href="#__codelineno-20-8"></a><span class="w"> </span><span class="nt">"notes_url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/extras/statuses/91a53d61-4180-4820-835d-533b34dbb5b4/notes/"</span><span class="p">,</span>
|
|
4936
|
+
<a id="__codelineno-20-9" name="__codelineno-20-9" href="#__codelineno-20-9"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T00:00:00Z"</span><span class="p">,</span>
|
|
4937
|
+
<a id="__codelineno-20-10" name="__codelineno-20-10" href="#__codelineno-20-10"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:25:51.413824Z"</span><span class="p">,</span>
|
|
4938
|
+
<a id="__codelineno-20-11" name="__codelineno-20-11" href="#__codelineno-20-11"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Active"</span><span class="p">,</span>
|
|
4939
|
+
<a id="__codelineno-20-12" name="__codelineno-20-12" href="#__codelineno-20-12"></a><span class="w"> </span><span class="nt">"color"</span><span class="p">:</span><span class="w"> </span><span class="s2">"4caf50"</span><span class="p">,</span>
|
|
4940
|
+
<a id="__codelineno-20-13" name="__codelineno-20-13" href="#__codelineno-20-13"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Unit is active"</span>
|
|
4941
|
+
<a id="__codelineno-20-14" name="__codelineno-20-14" href="#__codelineno-20-14"></a><span class="w"> </span><span class="p">},</span>
|
|
4942
|
+
<a id="__codelineno-20-15" name="__codelineno-20-15" href="#__codelineno-20-15"></a><span class="w"> </span><span class="nt">"parent"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
4943
|
+
<a id="__codelineno-20-16" name="__codelineno-20-16" href="#__codelineno-20-16"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0e19e475-89c9-4cf4-8b5f-a0589f0950cd"</span><span class="p">,</span>
|
|
4944
|
+
<a id="__codelineno-20-17" name="__codelineno-20-17" href="#__codelineno-20-17"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Campus-01"</span><span class="p">,</span>
|
|
4945
|
+
<a id="__codelineno-20-18" name="__codelineno-20-18" href="#__codelineno-20-18"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/locations/0e19e475-89c9-4cf4-8b5f-a0589f0950cd/"</span><span class="p">,</span>
|
|
4946
|
+
<a id="__codelineno-20-19" name="__codelineno-20-19" href="#__codelineno-20-19"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
4947
|
+
<a id="__codelineno-20-20" name="__codelineno-20-20" href="#__codelineno-20-20"></a><span class="w"> </span><span class="nt">"example_plugin_auto_custom_field"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span>
|
|
4948
|
+
<a id="__codelineno-20-21" name="__codelineno-20-21" href="#__codelineno-20-21"></a><span class="w"> </span><span class="p">},</span>
|
|
4949
|
+
<a id="__codelineno-20-22" name="__codelineno-20-22" href="#__codelineno-20-22"></a><span class="w"> </span><span class="nt">"notes_url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/locations/0e19e475-89c9-4cf4-8b5f-a0589f0950cd/notes/"</span><span class="p">,</span>
|
|
4950
|
+
<a id="__codelineno-20-23" name="__codelineno-20-23" href="#__codelineno-20-23"></a><span class="w"> </span><span class="nt">"tree_depth"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
4951
|
+
<a id="__codelineno-20-24" name="__codelineno-20-24" href="#__codelineno-20-24"></a><span class="w"> </span><span class="nt">"time_zone"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Asia/Baghdad"</span><span class="p">,</span>
|
|
4952
|
+
<a id="__codelineno-20-25" name="__codelineno-20-25" href="#__codelineno-20-25"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:06.884754Z"</span><span class="p">,</span>
|
|
4953
|
+
<a id="__codelineno-20-26" name="__codelineno-20-26" href="#__codelineno-20-26"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:06.906503Z"</span><span class="p">,</span>
|
|
4954
|
+
<a id="__codelineno-20-27" name="__codelineno-20-27" href="#__codelineno-20-27"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Campus-01"</span><span class="p">,</span>
|
|
4955
|
+
<a id="__codelineno-20-28" name="__codelineno-20-28" href="#__codelineno-20-28"></a><span class="w"> </span><span class="nt">"slug"</span><span class="p">:</span><span class="w"> </span><span class="s2">"campus-01"</span><span class="p">,</span>
|
|
4956
|
+
<a id="__codelineno-20-29" name="__codelineno-20-29" href="#__codelineno-20-29"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Local take each compare court exactly."</span><span class="p">,</span>
|
|
4957
|
+
<a id="__codelineno-20-30" name="__codelineno-20-30" href="#__codelineno-20-30"></a><span class="w"> </span><span class="nt">"facility"</span><span class="p">:</span><span class="w"> </span><span class="s2">"328"</span><span class="p">,</span>
|
|
4958
|
+
<a id="__codelineno-20-31" name="__codelineno-20-31" href="#__codelineno-20-31"></a><span class="w"> </span><span class="nt">"asn"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
4959
|
+
<a id="__codelineno-20-32" name="__codelineno-20-32" href="#__codelineno-20-32"></a><span class="w"> </span><span class="nt">"physical_address"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
4960
|
+
<a id="__codelineno-20-33" name="__codelineno-20-33" href="#__codelineno-20-33"></a><span class="w"> </span><span class="nt">"shipping_address"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
4961
|
+
<a id="__codelineno-20-34" name="__codelineno-20-34" href="#__codelineno-20-34"></a><span class="w"> </span><span class="nt">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
4962
|
+
<a id="__codelineno-20-35" name="__codelineno-20-35" href="#__codelineno-20-35"></a><span class="w"> </span><span class="nt">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="s2">"104.200000"</span><span class="p">,</span>
|
|
4963
|
+
<a id="__codelineno-20-36" name="__codelineno-20-36" href="#__codelineno-20-36"></a><span class="w"> </span><span class="nt">"contact_name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Frances Hernandez"</span><span class="p">,</span>
|
|
4964
|
+
<a id="__codelineno-20-37" name="__codelineno-20-37" href="#__codelineno-20-37"></a><span class="w"> </span><span class="nt">"contact_phone"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
4965
|
+
<a id="__codelineno-20-38" name="__codelineno-20-38" href="#__codelineno-20-38"></a><span class="w"> </span><span class="nt">"contact_email"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
4966
|
+
<a id="__codelineno-20-39" name="__codelineno-20-39" href="#__codelineno-20-39"></a><span class="w"> </span><span class="nt">"comments"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Sort share road candidate."</span><span class="p">,</span>
|
|
4967
|
+
<a id="__codelineno-20-40" name="__codelineno-20-40" href="#__codelineno-20-40"></a><span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/extras/statuses/28eb334b-4171-4da4-a03a-fa6d0c6a9442/"</span><span class="p">,</span>
|
|
4968
|
+
<a id="__codelineno-20-41" name="__codelineno-20-41" href="#__codelineno-20-41"></a><span class="w"> </span><span class="nt">"parent"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
4969
|
+
<a id="__codelineno-20-42" name="__codelineno-20-42" href="#__codelineno-20-42"></a><span class="w"> </span><span class="nt">"location_type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/extras/location-types/e3d4a9af-c6c1-4582-b483-a13301eb6e28/"</span><span class="p">,</span>
|
|
4970
|
+
<a id="__codelineno-20-43" name="__codelineno-20-43" href="#__codelineno-20-43"></a><span class="w"> </span><span class="nt">"tenant"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/tenancy/tenants/5b1feadb-fab0-4f81-a53f-5192d83b0216/"</span><span class="p">,</span>
|
|
4971
|
+
<a id="__codelineno-20-44" name="__codelineno-20-44" href="#__codelineno-20-44"></a><span class="w"> </span><span class="p">},</span>
|
|
4972
|
+
<a id="__codelineno-20-45" name="__codelineno-20-45" href="#__codelineno-20-45"></a><span class="w"> </span><span class="nt">"location_type"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
4973
|
+
<a id="__codelineno-20-46" name="__codelineno-20-46" href="#__codelineno-20-46"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"4edcc111-e3f7-4309-ab0e-eb34c001874e"</span><span class="p">,</span>
|
|
4974
|
+
<a id="__codelineno-20-47" name="__codelineno-20-47" href="#__codelineno-20-47"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Campus → Building"</span><span class="p">,</span>
|
|
4975
|
+
<a id="__codelineno-20-48" name="__codelineno-20-48" href="#__codelineno-20-48"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/location-types/4edcc111-e3f7-4309-ab0e-eb34c001874e/"</span><span class="p">,</span>
|
|
4976
|
+
<a id="__codelineno-20-49" name="__codelineno-20-49" href="#__codelineno-20-49"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span>
|
|
4977
|
+
<a id="__codelineno-20-50" name="__codelineno-20-50" href="#__codelineno-20-50"></a><span class="w"> </span><span class="nt">"notes_url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/location-types/4edcc111-e3f7-4309-ab0e-eb34c001874e/notes/"</span><span class="p">,</span>
|
|
4978
|
+
<a id="__codelineno-20-51" name="__codelineno-20-51" href="#__codelineno-20-51"></a><span class="w"> </span><span class="nt">"tree_depth"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
4979
|
+
<a id="__codelineno-20-52" name="__codelineno-20-52" href="#__codelineno-20-52"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:06.707759Z"</span><span class="p">,</span>
|
|
4980
|
+
<a id="__codelineno-20-53" name="__codelineno-20-53" href="#__codelineno-20-53"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:06.716482Z"</span><span class="p">,</span>
|
|
4981
|
+
<a id="__codelineno-20-54" name="__codelineno-20-54" href="#__codelineno-20-54"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Building"</span><span class="p">,</span>
|
|
4982
|
+
<a id="__codelineno-20-55" name="__codelineno-20-55" href="#__codelineno-20-55"></a><span class="w"> </span><span class="nt">"slug"</span><span class="p">:</span><span class="w"> </span><span class="s2">"building"</span><span class="p">,</span>
|
|
4983
|
+
<a id="__codelineno-20-56" name="__codelineno-20-56" href="#__codelineno-20-56"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Protect growth bill all hair along."</span><span class="p">,</span>
|
|
4984
|
+
<a id="__codelineno-20-57" name="__codelineno-20-57" href="#__codelineno-20-57"></a><span class="w"> </span><span class="nt">"nestable"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span>
|
|
4985
|
+
<a id="__codelineno-20-58" name="__codelineno-20-58" href="#__codelineno-20-58"></a><span class="w"> </span><span class="nt">"parent"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/location-types/e3d4a9af-c6c1-4582-b483-a13301eb6e28/"</span>
|
|
4986
|
+
<a id="__codelineno-20-59" name="__codelineno-20-59" href="#__codelineno-20-59"></a><span class="w"> </span><span class="p">},</span>
|
|
4987
|
+
<a id="__codelineno-20-60" name="__codelineno-20-60" href="#__codelineno-20-60"></a><span class="w"> </span><span class="nt">"tenant"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
4988
|
+
<a id="__codelineno-20-61" name="__codelineno-20-61" href="#__codelineno-20-61"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"d043b6bc-6892-45f9-b460-4b006eb68016"</span><span class="p">,</span>
|
|
4989
|
+
<a id="__codelineno-20-62" name="__codelineno-20-62" href="#__codelineno-20-62"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Page Inc"</span><span class="p">,</span>
|
|
4990
|
+
<a id="__codelineno-20-63" name="__codelineno-20-63" href="#__codelineno-20-63"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/tenancy/tenants/d043b6bc-6892-45f9-b460-4b006eb68016/"</span><span class="p">,</span>
|
|
4991
|
+
<a id="__codelineno-20-64" name="__codelineno-20-64" href="#__codelineno-20-64"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span>
|
|
4992
|
+
<a id="__codelineno-20-65" name="__codelineno-20-65" href="#__codelineno-20-65"></a><span class="w"> </span><span class="nt">"notes_url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/tenancy/tenants/d043b6bc-6892-45f9-b460-4b006eb68016/notes/"</span><span class="p">,</span>
|
|
4993
|
+
<a id="__codelineno-20-66" name="__codelineno-20-66" href="#__codelineno-20-66"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:06.257345Z"</span><span class="p">,</span>
|
|
4994
|
+
<a id="__codelineno-20-67" name="__codelineno-20-67" href="#__codelineno-20-67"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:06.262563Z"</span><span class="p">,</span>
|
|
4995
|
+
<a id="__codelineno-20-68" name="__codelineno-20-68" href="#__codelineno-20-68"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Page Inc"</span><span class="p">,</span>
|
|
4996
|
+
<a id="__codelineno-20-69" name="__codelineno-20-69" href="#__codelineno-20-69"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Citizen father policy door science light. Glass improve place understand against ground.\nLarge firm per sing. Item they side walk test open tend."</span><span class="p">,</span>
|
|
4997
|
+
<a id="__codelineno-20-70" name="__codelineno-20-70" href="#__codelineno-20-70"></a><span class="w"> </span><span class="nt">"comments"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
4998
|
+
<a id="__codelineno-20-71" name="__codelineno-20-71" href="#__codelineno-20-71"></a><span class="w"> </span><span class="nt">"tenant_group"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
4999
|
+
<a id="__codelineno-20-72" name="__codelineno-20-72" href="#__codelineno-20-72"></a><span class="w"> </span><span class="p">},</span>
|
|
5000
|
+
<a id="__codelineno-20-73" name="__codelineno-20-73" href="#__codelineno-20-73"></a><span class="w"> </span><span class="nt">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
|
5001
|
+
<a id="__codelineno-20-74" name="__codelineno-20-74" href="#__codelineno-20-74"></a><span class="w"> </span><span class="p">{</span>
|
|
5002
|
+
<a id="__codelineno-20-75" name="__codelineno-20-75" href="#__codelineno-20-75"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"a50d4568-27ae-4743-87ac-ffdc22b7f5d2"</span><span class="p">,</span>
|
|
5003
|
+
<a id="__codelineno-20-76" name="__codelineno-20-76" href="#__codelineno-20-76"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Light blue"</span><span class="p">,</span>
|
|
5004
|
+
<a id="__codelineno-20-77" name="__codelineno-20-77" href="#__codelineno-20-77"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/extras/tags/a50d4568-27ae-4743-87ac-ffdc22b7f5d2/"</span><span class="p">,</span>
|
|
5005
|
+
<a id="__codelineno-20-78" name="__codelineno-20-78" href="#__codelineno-20-78"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span>
|
|
5006
|
+
<a id="__codelineno-20-79" name="__codelineno-20-79" href="#__codelineno-20-79"></a><span class="w"> </span><span class="nt">"notes_url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/extras/tags/a50d4568-27ae-4743-87ac-ffdc22b7f5d2/notes/"</span><span class="p">,</span>
|
|
5007
|
+
<a id="__codelineno-20-80" name="__codelineno-20-80" href="#__codelineno-20-80"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Light blue"</span><span class="p">,</span>
|
|
5008
|
+
<a id="__codelineno-20-81" name="__codelineno-20-81" href="#__codelineno-20-81"></a><span class="w"> </span><span class="nt">"slug"</span><span class="p">:</span><span class="w"> </span><span class="s2">"light-blue"</span><span class="p">,</span>
|
|
5009
|
+
<a id="__codelineno-20-82" name="__codelineno-20-82" href="#__codelineno-20-82"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:05.753433Z"</span><span class="p">,</span>
|
|
5010
|
+
<a id="__codelineno-20-83" name="__codelineno-20-83" href="#__codelineno-20-83"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:05.770752Z"</span><span class="p">,</span>
|
|
5011
|
+
<a id="__codelineno-20-84" name="__codelineno-20-84" href="#__codelineno-20-84"></a><span class="w"> </span><span class="nt">"color"</span><span class="p">:</span><span class="w"> </span><span class="s2">"03a9f4"</span><span class="p">,</span>
|
|
5012
|
+
<a id="__codelineno-20-85" name="__codelineno-20-85" href="#__codelineno-20-85"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Want task generation. Commercial candidate performance financial guess modern.\nEarly toward adult black. Join black land sit. It smile standard possible reach."</span>
|
|
5013
|
+
<a id="__codelineno-20-86" name="__codelineno-20-86" href="#__codelineno-20-86"></a><span class="w"> </span><span class="p">}</span>
|
|
5014
|
+
<a id="__codelineno-20-87" name="__codelineno-20-87" href="#__codelineno-20-87"></a><span class="w"> </span><span class="p">]</span>
|
|
5015
|
+
<a id="__codelineno-20-88" name="__codelineno-20-88" href="#__codelineno-20-88"></a><span class="p">}</span>
|
|
5016
|
+
</code></pre></div>
|
|
5017
|
+
<div class="admonition note">
|
|
5018
|
+
<p class="admonition-title">Note</p>
|
|
5019
|
+
<p>As previously explained, note that the <code>status</code> nested object included in this response does not include the <code>content_types</code> many-to-many relation that exists on all Status objects. If this information is needed, you would need to directly query the URL of the status object itself (above, <code>http://nautobot/api/extras/statuses/91a53d61-4180-4820-835d-533b34dbb5b4/</code>) to get a fully detailed response. Similarly, the <code>parent</code> and <code>tenant</code> nested objects do not include their <code>tags</code> relations, the <code>parent</code> object does not include its derived <code>tree_depth</code> and related object counters, and the <code>tags</code> nested object list does not include the <code>content_types</code> for each <code>Tag</code>.</p>
|
|
5020
|
+
</div>
|
|
5021
|
+
<h4 id="depth2-and-beyond">?depth=2 and beyond<a class="headerlink" href="#depth2-and-beyond" title="Permanent link">¶</a></h4>
|
|
5022
|
+
<p>A higher <code>depth</code> parameter in the query presents you with more insight to the object and can be useful in situations that demand information of an indirectly related field of the object.</p>
|
|
5023
|
+
<div class="admonition important">
|
|
5024
|
+
<p class="admonition-title">Important</p>
|
|
5025
|
+
<p>Using higher <code>depth</code> values may substantially increase the amount of time it takes for the REST API to respond to your query when there are a large number of related objects. In some cases it may be more efficient to initially query with a lower <code>depth</code> and then follow the <code>url</code> values that the REST API response provides for specific related objects to query those objects directly as a more narrowly focused query approach.</p>
|
|
5026
|
+
</div>
|
|
5027
|
+
<p>For example, if you need information on the <code>parent</code> of a <code>location</code> instance's <code>parent</code>.</p>
|
|
5028
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a>curl -s -X GET \
|
|
5029
|
+
<a id="__codelineno-21-2" name="__codelineno-21-2" href="#__codelineno-21-2"></a>-H "Accept: application/json; version=2.0" \
|
|
5030
|
+
<a id="__codelineno-21-3" name="__codelineno-21-3" href="#__codelineno-21-3"></a>http://nautobot/api/dcim/locations/3b71a669-faa4-4f8d-a72a-8c94d121b793/?depth=2 | jq '.'
|
|
5031
|
+
</code></pre></div>
|
|
5032
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a><span class="p">{</span>
|
|
5033
|
+
<a id="__codelineno-22-2" name="__codelineno-22-2" href="#__codelineno-22-2"></a><span class="w"> </span><span class="err">...</span>
|
|
5034
|
+
<a id="__codelineno-22-3" name="__codelineno-22-3" href="#__codelineno-22-3"></a><span class="w"> </span><span class="nt">"parent"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5035
|
+
<a id="__codelineno-22-4" name="__codelineno-22-4" href="#__codelineno-22-4"></a><span class="w"> </span><span class="err">...</span>
|
|
5036
|
+
<a id="__codelineno-22-5" name="__codelineno-22-5" href="#__codelineno-22-5"></a><span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5037
|
+
<a id="__codelineno-22-6" name="__codelineno-22-6" href="#__codelineno-22-6"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"39ea1ea4-3028-4a81-81e0-24a5743d3657"</span><span class="p">,</span>
|
|
5038
|
+
<a id="__codelineno-22-7" name="__codelineno-22-7" href="#__codelineno-22-7"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/extras/statuses/39ea1ea4-3028-4a81-81e0-24a5743d3657/"</span><span class="p">,</span>
|
|
5039
|
+
<a id="__codelineno-22-8" name="__codelineno-22-8" href="#__codelineno-22-8"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Retired"</span><span class="p">,</span>
|
|
5040
|
+
<a id="__codelineno-22-9" name="__codelineno-22-9" href="#__codelineno-22-9"></a><span class="w"> </span><span class="nt">"object_type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"extras.status"</span><span class="p">,</span>
|
|
5041
|
+
<a id="__codelineno-22-10" name="__codelineno-22-10" href="#__codelineno-22-10"></a><span class="w"> </span><span class="nt">"notes_url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/extras/statuses/39ea1ea4-3028-4a81-81e0-24a5743d3657/notes/"</span><span class="p">,</span>
|
|
5042
|
+
<a id="__codelineno-22-11" name="__codelineno-22-11" href="#__codelineno-22-11"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T00:00:00Z"</span><span class="p">,</span>
|
|
5043
|
+
<a id="__codelineno-22-12" name="__codelineno-22-12" href="#__codelineno-22-12"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:26:16.982697Z"</span><span class="p">,</span>
|
|
5044
|
+
<a id="__codelineno-22-13" name="__codelineno-22-13" href="#__codelineno-22-13"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Retired"</span><span class="p">,</span>
|
|
5045
|
+
<a id="__codelineno-22-14" name="__codelineno-22-14" href="#__codelineno-22-14"></a><span class="w"> </span><span class="nt">"color"</span><span class="p">:</span><span class="w"> </span><span class="s2">"f44336"</span><span class="p">,</span>
|
|
5046
|
+
<a id="__codelineno-22-15" name="__codelineno-22-15" href="#__codelineno-22-15"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Location has been retired"</span><span class="p">,</span>
|
|
5047
|
+
<a id="__codelineno-22-16" name="__codelineno-22-16" href="#__codelineno-22-16"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{}</span>
|
|
5048
|
+
<a id="__codelineno-22-17" name="__codelineno-22-17" href="#__codelineno-22-17"></a><span class="w"> </span><span class="p">},</span>
|
|
5049
|
+
<a id="__codelineno-22-18" name="__codelineno-22-18" href="#__codelineno-22-18"></a><span class="w"> </span><span class="nt">"parent"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5050
|
+
<a id="__codelineno-22-19" name="__codelineno-22-19" href="#__codelineno-22-19"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0e19e475-89c9-4cf4-8b5f-a0589f0950cd"</span><span class="p">,</span>
|
|
5051
|
+
<a id="__codelineno-22-20" name="__codelineno-22-20" href="#__codelineno-22-20"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/locations/0e19e475-89c9-4cf4-8b5f-a0589f0950cd/"</span><span class="p">,</span>
|
|
5052
|
+
<a id="__codelineno-22-21" name="__codelineno-22-21" href="#__codelineno-22-21"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Campus-01"</span><span class="p">,</span>
|
|
5053
|
+
<a id="__codelineno-22-22" name="__codelineno-22-22" href="#__codelineno-22-22"></a><span class="w"> </span><span class="nt">"object_type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"dcim.location"</span><span class="p">,</span>
|
|
5054
|
+
<a id="__codelineno-22-23" name="__codelineno-22-23" href="#__codelineno-22-23"></a><span class="w"> </span><span class="nt">"time_zone"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Asia/Baghdad"</span><span class="p">,</span>
|
|
5055
|
+
<a id="__codelineno-22-24" name="__codelineno-22-24" href="#__codelineno-22-24"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:06.884754Z"</span><span class="p">,</span>
|
|
5056
|
+
<a id="__codelineno-22-25" name="__codelineno-22-25" href="#__codelineno-22-25"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:06.906503Z"</span><span class="p">,</span>
|
|
5057
|
+
<a id="__codelineno-22-26" name="__codelineno-22-26" href="#__codelineno-22-26"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Campus-01"</span><span class="p">,</span>
|
|
5058
|
+
<a id="__codelineno-22-27" name="__codelineno-22-27" href="#__codelineno-22-27"></a><span class="w"> </span><span class="nt">"slug"</span><span class="p">:</span><span class="w"> </span><span class="s2">"campus-01"</span><span class="p">,</span>
|
|
5059
|
+
<a id="__codelineno-22-28" name="__codelineno-22-28" href="#__codelineno-22-28"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Local take each compare court exactly."</span><span class="p">,</span>
|
|
5060
|
+
<a id="__codelineno-22-29" name="__codelineno-22-29" href="#__codelineno-22-29"></a><span class="w"> </span><span class="nt">"facility"</span><span class="p">:</span><span class="w"> </span><span class="s2">"328"</span><span class="p">,</span>
|
|
5061
|
+
<a id="__codelineno-22-30" name="__codelineno-22-30" href="#__codelineno-22-30"></a><span class="w"> </span><span class="nt">"asn"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
5062
|
+
<a id="__codelineno-22-31" name="__codelineno-22-31" href="#__codelineno-22-31"></a><span class="w"> </span><span class="nt">"physical_address"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
5063
|
+
<a id="__codelineno-22-32" name="__codelineno-22-32" href="#__codelineno-22-32"></a><span class="w"> </span><span class="nt">"shipping_address"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
5064
|
+
<a id="__codelineno-22-33" name="__codelineno-22-33" href="#__codelineno-22-33"></a><span class="w"> </span><span class="nt">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
5065
|
+
<a id="__codelineno-22-34" name="__codelineno-22-34" href="#__codelineno-22-34"></a><span class="w"> </span><span class="nt">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="s2">"104.200000"</span><span class="p">,</span>
|
|
5066
|
+
<a id="__codelineno-22-35" name="__codelineno-22-35" href="#__codelineno-22-35"></a><span class="w"> </span><span class="nt">"contact_name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Frances Hernandez"</span><span class="p">,</span>
|
|
5067
|
+
<a id="__codelineno-22-36" name="__codelineno-22-36" href="#__codelineno-22-36"></a><span class="w"> </span><span class="nt">"contact_phone"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
5068
|
+
<a id="__codelineno-22-37" name="__codelineno-22-37" href="#__codelineno-22-37"></a><span class="w"> </span><span class="nt">"contact_email"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
5069
|
+
<a id="__codelineno-22-38" name="__codelineno-22-38" href="#__codelineno-22-38"></a><span class="w"> </span><span class="nt">"comments"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Sort share road candidate."</span><span class="p">,</span>
|
|
5070
|
+
<a id="__codelineno-22-39" name="__codelineno-22-39" href="#__codelineno-22-39"></a><span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/extras/statuses/28eb334b-4171-4da4-a03a-fa6d0c6a9442/"</span><span class="p">,</span>
|
|
5071
|
+
<a id="__codelineno-22-40" name="__codelineno-22-40" href="#__codelineno-22-40"></a><span class="w"> </span><span class="nt">"parent"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
5072
|
+
<a id="__codelineno-22-41" name="__codelineno-22-41" href="#__codelineno-22-41"></a><span class="w"> </span><span class="nt">"location_type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/location-types/e3d4a9af-c6c1-4582-b483-a13301eb6e28/"</span><span class="p">,</span>
|
|
5073
|
+
<a id="__codelineno-22-42" name="__codelineno-22-42" href="#__codelineno-22-42"></a><span class="w"> </span><span class="nt">"tenant"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/tenancy/tenants/5b1feadb-fab0-4f81-a53f-5192d83b0216/"</span><span class="p">,</span>
|
|
5074
|
+
<a id="__codelineno-22-43" name="__codelineno-22-43" href="#__codelineno-22-43"></a><span class="w"> </span><span class="nt">"notes_url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/locations/0e19e475-89c9-4cf4-8b5f-a0589f0950cd/notes/"</span><span class="p">,</span>
|
|
5075
|
+
<a id="__codelineno-22-44" name="__codelineno-22-44" href="#__codelineno-22-44"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5076
|
+
<a id="__codelineno-22-45" name="__codelineno-22-45" href="#__codelineno-22-45"></a><span class="w"> </span><span class="nt">"example_plugin_auto_custom_field"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span>
|
|
5077
|
+
<a id="__codelineno-22-46" name="__codelineno-22-46" href="#__codelineno-22-46"></a><span class="w"> </span><span class="p">}</span>
|
|
5078
|
+
<a id="__codelineno-22-47" name="__codelineno-22-47" href="#__codelineno-22-47"></a><span class="w"> </span><span class="p">},</span>
|
|
5079
|
+
<a id="__codelineno-22-48" name="__codelineno-22-48" href="#__codelineno-22-48"></a><span class="w"> </span><span class="nt">"location_type"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5080
|
+
<a id="__codelineno-22-49" name="__codelineno-22-49" href="#__codelineno-22-49"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"4edcc111-e3f7-4309-ab0e-eb34c001874e"</span><span class="p">,</span>
|
|
5081
|
+
<a id="__codelineno-22-50" name="__codelineno-22-50" href="#__codelineno-22-50"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Campus → Building"</span><span class="p">,</span>
|
|
5082
|
+
<a id="__codelineno-22-51" name="__codelineno-22-51" href="#__codelineno-22-51"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/location-types/4edcc111-e3f7-4309-ab0e-eb34c001874e/"</span><span class="p">,</span>
|
|
5083
|
+
<a id="__codelineno-22-52" name="__codelineno-22-52" href="#__codelineno-22-52"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:06.707759Z"</span><span class="p">,</span>
|
|
5084
|
+
<a id="__codelineno-22-53" name="__codelineno-22-53" href="#__codelineno-22-53"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:06.716482Z"</span><span class="p">,</span>
|
|
5085
|
+
<a id="__codelineno-22-54" name="__codelineno-22-54" href="#__codelineno-22-54"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Building"</span><span class="p">,</span>
|
|
5086
|
+
<a id="__codelineno-22-55" name="__codelineno-22-55" href="#__codelineno-22-55"></a><span class="w"> </span><span class="nt">"slug"</span><span class="p">:</span><span class="w"> </span><span class="s2">"building"</span><span class="p">,</span>
|
|
5087
|
+
<a id="__codelineno-22-56" name="__codelineno-22-56" href="#__codelineno-22-56"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Protect growth bill all hair along."</span><span class="p">,</span>
|
|
5088
|
+
<a id="__codelineno-22-57" name="__codelineno-22-57" href="#__codelineno-22-57"></a><span class="w"> </span><span class="nt">"nestable"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span>
|
|
5089
|
+
<a id="__codelineno-22-58" name="__codelineno-22-58" href="#__codelineno-22-58"></a><span class="w"> </span><span class="nt">"parent"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/location-types/e3d4a9af-c6c1-4582-b483-a13301eb6e28/"</span><span class="p">,</span>
|
|
5090
|
+
<a id="__codelineno-22-59" name="__codelineno-22-59" href="#__codelineno-22-59"></a><span class="w"> </span><span class="nt">"notes_url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/location-types/4edcc111-e3f7-4309-ab0e-eb34c001874e/notes/"</span><span class="p">,</span>
|
|
5091
|
+
<a id="__codelineno-22-60" name="__codelineno-22-60" href="#__codelineno-22-60"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{}</span>
|
|
5092
|
+
<a id="__codelineno-22-61" name="__codelineno-22-61" href="#__codelineno-22-61"></a><span class="w"> </span><span class="p">},</span>
|
|
5093
|
+
<a id="__codelineno-22-62" name="__codelineno-22-62" href="#__codelineno-22-62"></a><span class="w"> </span><span class="nt">"tenant"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
5094
|
+
<a id="__codelineno-22-63" name="__codelineno-22-63" href="#__codelineno-22-63"></a><span class="w"> </span><span class="p">},</span>
|
|
5095
|
+
<a id="__codelineno-22-64" name="__codelineno-22-64" href="#__codelineno-22-64"></a><span class="w"> </span><span class="nt">"location_type"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5096
|
+
<a id="__codelineno-22-65" name="__codelineno-22-65" href="#__codelineno-22-65"></a><span class="w"> </span><span class="err">...</span>
|
|
5097
|
+
<a id="__codelineno-22-66" name="__codelineno-22-66" href="#__codelineno-22-66"></a><span class="w"> </span><span class="nt">"parent"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5098
|
+
<a id="__codelineno-22-67" name="__codelineno-22-67" href="#__codelineno-22-67"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"4edcc111-e3f7-4309-ab0e-eb34c001874e"</span><span class="p">,</span>
|
|
5099
|
+
<a id="__codelineno-22-68" name="__codelineno-22-68" href="#__codelineno-22-68"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Campus → Building"</span><span class="p">,</span>
|
|
5100
|
+
<a id="__codelineno-22-69" name="__codelineno-22-69" href="#__codelineno-22-69"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/location-types/4edcc111-e3f7-4309-ab0e-eb34c001874e/"</span><span class="p">,</span>
|
|
5101
|
+
<a id="__codelineno-22-70" name="__codelineno-22-70" href="#__codelineno-22-70"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:06.707759Z"</span><span class="p">,</span>
|
|
5102
|
+
<a id="__codelineno-22-71" name="__codelineno-22-71" href="#__codelineno-22-71"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2023-04-12T19:29:06.716482Z"</span><span class="p">,</span>
|
|
5103
|
+
<a id="__codelineno-22-72" name="__codelineno-22-72" href="#__codelineno-22-72"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Building"</span><span class="p">,</span>
|
|
5104
|
+
<a id="__codelineno-22-73" name="__codelineno-22-73" href="#__codelineno-22-73"></a><span class="w"> </span><span class="nt">"slug"</span><span class="p">:</span><span class="w"> </span><span class="s2">"building"</span><span class="p">,</span>
|
|
5105
|
+
<a id="__codelineno-22-74" name="__codelineno-22-74" href="#__codelineno-22-74"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Protect growth bill all hair along."</span><span class="p">,</span>
|
|
5106
|
+
<a id="__codelineno-22-75" name="__codelineno-22-75" href="#__codelineno-22-75"></a><span class="w"> </span><span class="nt">"nestable"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span>
|
|
5107
|
+
<a id="__codelineno-22-76" name="__codelineno-22-76" href="#__codelineno-22-76"></a><span class="w"> </span><span class="nt">"parent"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/location-types/e3d4a9af-c6c1-4582-b483-a13301eb6e28/"</span><span class="p">,</span>
|
|
5108
|
+
<a id="__codelineno-22-77" name="__codelineno-22-77" href="#__codelineno-22-77"></a><span class="w"> </span><span class="nt">"notes_url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/location-types/4edcc111-e3f7-4309-ab0e-eb34c001874e/notes/"</span><span class="p">,</span>
|
|
5109
|
+
<a id="__codelineno-22-78" name="__codelineno-22-78" href="#__codelineno-22-78"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{}</span>
|
|
5110
|
+
<a id="__codelineno-22-79" name="__codelineno-22-79" href="#__codelineno-22-79"></a><span class="w"> </span><span class="p">}</span>
|
|
5111
|
+
<a id="__codelineno-22-80" name="__codelineno-22-80" href="#__codelineno-22-80"></a><span class="w"> </span><span class="p">},</span>
|
|
5112
|
+
<a id="__codelineno-22-81" name="__codelineno-22-81" href="#__codelineno-22-81"></a><span class="w"> </span><span class="err">...</span>
|
|
5113
|
+
<a id="__codelineno-22-82" name="__codelineno-22-82" href="#__codelineno-22-82"></a><span class="p">}</span>
|
|
3638
5114
|
</code></pre></div>
|
|
3639
|
-
<p>The brief format is supported for both lists and individual objects.</p>
|
|
3640
5115
|
<h3 id="retrieving-object-relationships-and-relationship-associations">Retrieving Object Relationships and Relationship Associations<a class="headerlink" href="#retrieving-object-relationships-and-relationship-associations" title="Permanent link">¶</a></h3>
|
|
3641
5116
|
<div class="admonition version-added">
|
|
3642
5117
|
<p class="admonition-title">Added in version 1.4.0</p>
|
|
3643
5118
|
</div>
|
|
3644
5119
|
<p>Objects that are associated with another object by a custom <a href="../models/extras/relationship.html">Relationship</a> are also retrievable and modifiable via the REST API. Due to the additional processing overhead involved in retrieving and representing these relationships, they are <em>not</em> included in default REST API <code>GET</code> responses. To include relationships data, pass <code>include=relationships</code> as a query parameter; in this case an additional key, <code>"relationships"</code>, will be included in the API response, as seen below:</p>
|
|
3645
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-
|
|
5120
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a>GET /api/dcim/sites/f472bb77-7f56-4e79-ac25-2dc73eb63924/?include=relationships
|
|
3646
5121
|
</code></pre></div>
|
|
3647
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-
|
|
3648
|
-
<a id="__codelineno-
|
|
3649
|
-
<a id="__codelineno-
|
|
3650
|
-
<a id="__codelineno-
|
|
3651
|
-
<a id="__codelineno-
|
|
3652
|
-
<a id="__codelineno-
|
|
3653
|
-
<a id="__codelineno-
|
|
3654
|
-
<a id="__codelineno-
|
|
3655
|
-
<a id="__codelineno-
|
|
3656
|
-
<a id="__codelineno-
|
|
3657
|
-
<a id="__codelineno-
|
|
3658
|
-
<a id="__codelineno-
|
|
3659
|
-
<a id="__codelineno-
|
|
3660
|
-
<a id="__codelineno-
|
|
3661
|
-
<a id="__codelineno-
|
|
3662
|
-
<a id="__codelineno-
|
|
3663
|
-
<a id="__codelineno-
|
|
3664
|
-
<a id="__codelineno-
|
|
3665
|
-
<a id="__codelineno-
|
|
3666
|
-
<a id="__codelineno-
|
|
3667
|
-
<a id="__codelineno-
|
|
3668
|
-
<a id="__codelineno-
|
|
3669
|
-
<a id="__codelineno-
|
|
3670
|
-
<a id="__codelineno-
|
|
3671
|
-
<a id="__codelineno-
|
|
3672
|
-
<a id="__codelineno-
|
|
3673
|
-
<a id="__codelineno-
|
|
3674
|
-
<a id="__codelineno-
|
|
3675
|
-
<a id="__codelineno-
|
|
3676
|
-
<a id="__codelineno-
|
|
3677
|
-
<a id="__codelineno-
|
|
3678
|
-
<a id="__codelineno-
|
|
3679
|
-
<a id="__codelineno-
|
|
3680
|
-
<a id="__codelineno-
|
|
3681
|
-
<a id="__codelineno-
|
|
3682
|
-
<a id="__codelineno-
|
|
3683
|
-
<a id="__codelineno-
|
|
3684
|
-
<a id="__codelineno-
|
|
5122
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a><span class="p">{</span>
|
|
5123
|
+
<a id="__codelineno-24-2" name="__codelineno-24-2" href="#__codelineno-24-2"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"f472bb77-7f56-4e79-ac25-2dc73eb63924"</span><span class="p">,</span>
|
|
5124
|
+
<a id="__codelineno-24-3" name="__codelineno-24-3" href="#__codelineno-24-3"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"alpha"</span><span class="p">,</span>
|
|
5125
|
+
<a id="__codelineno-24-4" name="__codelineno-24-4" href="#__codelineno-24-4"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/sites/f472bb77-7f56-4e79-ac25-2dc73eb63924/"</span><span class="p">,</span>
|
|
5126
|
+
<a id="__codelineno-24-5" name="__codelineno-24-5" href="#__codelineno-24-5"></a><span class="err">...</span>
|
|
5127
|
+
<a id="__codelineno-24-6" name="__codelineno-24-6" href="#__codelineno-24-6"></a><span class="w"> </span><span class="nt">"relationships"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5128
|
+
<a id="__codelineno-24-7" name="__codelineno-24-7" href="#__codelineno-24-7"></a><span class="w"> </span><span class="nt">"site-to-vrf"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5129
|
+
<a id="__codelineno-24-8" name="__codelineno-24-8" href="#__codelineno-24-8"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"e74cb7f7-15b0-499d-9401-a0f01cb96a9a"</span><span class="p">,</span>
|
|
5130
|
+
<a id="__codelineno-24-9" name="__codelineno-24-9" href="#__codelineno-24-9"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/api/extras/relationships/e74cb7f7-15b0-499d-9401-a0f01cb96a9a/"</span><span class="p">,</span>
|
|
5131
|
+
<a id="__codelineno-24-10" name="__codelineno-24-10" href="#__codelineno-24-10"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Single Site to Single VRF"</span><span class="p">,</span>
|
|
5132
|
+
<a id="__codelineno-24-11" name="__codelineno-24-11" href="#__codelineno-24-11"></a><span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"one-to-one"</span><span class="p">,</span>
|
|
5133
|
+
<a id="__codelineno-24-12" name="__codelineno-24-12" href="#__codelineno-24-12"></a><span class="w"> </span><span class="nt">"destination"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5134
|
+
<a id="__codelineno-24-13" name="__codelineno-24-13" href="#__codelineno-24-13"></a><span class="w"> </span><span class="nt">"label"</span><span class="p">:</span><span class="w"> </span><span class="s2">"VRF"</span><span class="p">,</span>
|
|
5135
|
+
<a id="__codelineno-24-14" name="__codelineno-24-14" href="#__codelineno-24-14"></a><span class="w"> </span><span class="nt">"object_type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ipam.vrf"</span><span class="p">,</span>
|
|
5136
|
+
<a id="__codelineno-24-15" name="__codelineno-24-15" href="#__codelineno-24-15"></a><span class="w"> </span><span class="nt">"objects"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
|
5137
|
+
<a id="__codelineno-24-16" name="__codelineno-24-16" href="#__codelineno-24-16"></a><span class="w"> </span><span class="p">{</span>
|
|
5138
|
+
<a id="__codelineno-24-17" name="__codelineno-24-17" href="#__codelineno-24-17"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"36641ba0-50d6-43be-b9b5-86aa992402e0"</span><span class="p">,</span>
|
|
5139
|
+
<a id="__codelineno-24-18" name="__codelineno-24-18" href="#__codelineno-24-18"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/ipam/vrfs/36641ba0-50d6-43be-b9b5-86aa992402e0/"</span><span class="p">,</span>
|
|
5140
|
+
<a id="__codelineno-24-19" name="__codelineno-24-19" href="#__codelineno-24-19"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"red"</span><span class="p">,</span>
|
|
5141
|
+
<a id="__codelineno-24-20" name="__codelineno-24-20" href="#__codelineno-24-20"></a><span class="w"> </span><span class="nt">"rd"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
5142
|
+
<a id="__codelineno-24-21" name="__codelineno-24-21" href="#__codelineno-24-21"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"red"</span>
|
|
5143
|
+
<a id="__codelineno-24-22" name="__codelineno-24-22" href="#__codelineno-24-22"></a><span class="w"> </span><span class="p">}</span>
|
|
5144
|
+
<a id="__codelineno-24-23" name="__codelineno-24-23" href="#__codelineno-24-23"></a><span class="w"> </span><span class="p">]</span>
|
|
5145
|
+
<a id="__codelineno-24-24" name="__codelineno-24-24" href="#__codelineno-24-24"></a><span class="w"> </span><span class="p">}</span>
|
|
5146
|
+
<a id="__codelineno-24-25" name="__codelineno-24-25" href="#__codelineno-24-25"></a><span class="w"> </span><span class="p">},</span>
|
|
5147
|
+
<a id="__codelineno-24-26" name="__codelineno-24-26" href="#__codelineno-24-26"></a><span class="w"> </span><span class="nt">"vrfs-to-sites"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5148
|
+
<a id="__codelineno-24-27" name="__codelineno-24-27" href="#__codelineno-24-27"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"e39c53e4-78cf-4572-b116-1d8830b81b2e"</span><span class="p">,</span>
|
|
5149
|
+
<a id="__codelineno-24-28" name="__codelineno-24-28" href="#__codelineno-24-28"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/api/extras/relationships/e39c53e4-78cf-4572-b116-1d8830b81b2e/"</span><span class="p">,</span>
|
|
5150
|
+
<a id="__codelineno-24-29" name="__codelineno-24-29" href="#__codelineno-24-29"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"VRFs to Sites"</span><span class="p">,</span>
|
|
5151
|
+
<a id="__codelineno-24-30" name="__codelineno-24-30" href="#__codelineno-24-30"></a><span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"many-to-many"</span><span class="p">,</span>
|
|
5152
|
+
<a id="__codelineno-24-31" name="__codelineno-24-31" href="#__codelineno-24-31"></a><span class="w"> </span><span class="nt">"source"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5153
|
+
<a id="__codelineno-24-32" name="__codelineno-24-32" href="#__codelineno-24-32"></a><span class="w"> </span><span class="nt">"label"</span><span class="p">:</span><span class="w"> </span><span class="s2">"VRFs"</span><span class="p">,</span>
|
|
5154
|
+
<a id="__codelineno-24-33" name="__codelineno-24-33" href="#__codelineno-24-33"></a><span class="w"> </span><span class="nt">"object_type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ipam.vrf"</span><span class="p">,</span>
|
|
5155
|
+
<a id="__codelineno-24-34" name="__codelineno-24-34" href="#__codelineno-24-34"></a><span class="w"> </span><span class="nt">"objects"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span>
|
|
5156
|
+
<a id="__codelineno-24-35" name="__codelineno-24-35" href="#__codelineno-24-35"></a><span class="w"> </span><span class="p">}</span>
|
|
5157
|
+
<a id="__codelineno-24-36" name="__codelineno-24-36" href="#__codelineno-24-36"></a><span class="w"> </span><span class="p">},</span>
|
|
5158
|
+
<a id="__codelineno-24-37" name="__codelineno-24-37" href="#__codelineno-24-37"></a><span class="w"> </span><span class="p">}</span>
|
|
5159
|
+
<a id="__codelineno-24-38" name="__codelineno-24-38" href="#__codelineno-24-38"></a><span class="p">}</span>
|
|
3685
5160
|
</code></pre></div>
|
|
3686
5161
|
<ul>
|
|
3687
5162
|
<li>Under the <code>"relationships"</code> key, there will be one key per Relationship that applies to this model, corresponding to the <code>slug</code> of that Relationship.<ul>
|
|
@@ -3698,93 +5173,20 @@
|
|
|
3698
5173
|
</li>
|
|
3699
5174
|
</ul>
|
|
3700
5175
|
<p>In the example above we can see that a single VRF, <code>green</code>, is a destination for the <code>site-to-vrf</code> Relationship from this Site, while there are currently no VRFs associated as sources for the <code>vrfs-to-sites</code> Relationship to this Site.</p>
|
|
3701
|
-
<h3 id="
|
|
3702
|
-
<p>When retrieving
|
|
5176
|
+
<h3 id="including-config-contexts">Including Config Contexts<a class="headerlink" href="#including-config-contexts" title="Permanent link">¶</a></h3>
|
|
5177
|
+
<p>When retrieving Devices and Virtual Machines via the REST API, it is possible to also retrive the rendered <a href="../models/extras/configcontext.html">configuration context data</a> for each such object if desired. Because rendering this data can be time consuming, it is <em>not</em> included in the REST API responses by default. If you wish to include config context data in the response, you must opt in by specifying the query parameter <code>include=config_context</code> as a part of your request.</p>
|
|
5178
|
+
<div class="admonition version-changed">
|
|
5179
|
+
<p class="admonition-title">Changed in version 2.0.0</p>
|
|
5180
|
+
<p>In Nautobot 1.x, the rendered configuration context was included by default in the REST API response unless specifically excluded with the query parameter <code>exclude=config_context</code>. This behavior has been reversed in Nautobot 2.0 and the <code>exclude</code> query parameter is no longer supported.</p>
|
|
5181
|
+
</div>
|
|
3703
5182
|
<h3 id="creating-a-new-object">Creating a New Object<a class="headerlink" href="#creating-a-new-object" title="Permanent link">¶</a></h3>
|
|
3704
5183
|
<p>To create a new object, make a <code>POST</code> request to the model's <em>list</em> endpoint with JSON data pertaining to the object being created. Note that a REST API token is required for all write operations; see the <a href="authentication.html">authentication documentation</a> for more information. Also be sure to set the <code>Content-Type</code> HTTP header to <code>application/json</code>. As always, it's a good practice to also set the <code>Accept</code> HTTP header to include the requested REST API version.</p>
|
|
3705
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-
|
|
3706
|
-
<a id="__codelineno-21-2" name="__codelineno-21-2" href="#__codelineno-21-2"></a>-H "Authorization: Token $TOKEN" \
|
|
3707
|
-
<a id="__codelineno-21-3" name="__codelineno-21-3" href="#__codelineno-21-3"></a>-H "Content-Type: application/json" \
|
|
3708
|
-
<a id="__codelineno-21-4" name="__codelineno-21-4" href="#__codelineno-21-4"></a>-H "Accept: application/json; version=1.3" \
|
|
3709
|
-
<a id="__codelineno-21-5" name="__codelineno-21-5" href="#__codelineno-21-5"></a>http://nautobot/api/ipam/prefixes/ \
|
|
3710
|
-
<a id="__codelineno-21-6" name="__codelineno-21-6" href="#__codelineno-21-6"></a>--data '{"prefix": "192.0.2.0/24", "site": 8df9e629-4338-438b-8ea9-06114f7be08e}' | jq '.'
|
|
3711
|
-
</code></pre></div>
|
|
3712
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a><span class="p">{</span>
|
|
3713
|
-
<a id="__codelineno-22-2" name="__codelineno-22-2" href="#__codelineno-22-2"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"48df6965-0fcb-4155-b5f8-00fe8b9b01af"</span><span class="p">,</span>
|
|
3714
|
-
<a id="__codelineno-22-3" name="__codelineno-22-3" href="#__codelineno-22-3"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/ipam/prefixes/48df6965-0fcb-4155-b5f8-00fe8b9b01af/"</span><span class="p">,</span>
|
|
3715
|
-
<a id="__codelineno-22-4" name="__codelineno-22-4" href="#__codelineno-22-4"></a><span class="w"> </span><span class="nt">"family"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
3716
|
-
<a id="__codelineno-22-5" name="__codelineno-22-5" href="#__codelineno-22-5"></a><span class="w"> </span><span class="nt">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span>
|
|
3717
|
-
<a id="__codelineno-22-6" name="__codelineno-22-6" href="#__codelineno-22-6"></a><span class="w"> </span><span class="nt">"label"</span><span class="p">:</span><span class="w"> </span><span class="s2">"IPv4"</span>
|
|
3718
|
-
<a id="__codelineno-22-7" name="__codelineno-22-7" href="#__codelineno-22-7"></a><span class="w"> </span><span class="p">},</span>
|
|
3719
|
-
<a id="__codelineno-22-8" name="__codelineno-22-8" href="#__codelineno-22-8"></a><span class="w"> </span><span class="nt">"prefix"</span><span class="p">:</span><span class="w"> </span><span class="s2">"192.0.2.0/24"</span><span class="p">,</span>
|
|
3720
|
-
<a id="__codelineno-22-9" name="__codelineno-22-9" href="#__codelineno-22-9"></a><span class="w"> </span><span class="nt">"site"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
3721
|
-
<a id="__codelineno-22-10" name="__codelineno-22-10" href="#__codelineno-22-10"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"8df9e629-4338-438b-8ea9-06114f7be08e"</span><span class="p">,</span>
|
|
3722
|
-
<a id="__codelineno-22-11" name="__codelineno-22-11" href="#__codelineno-22-11"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/sites/8df9e629-4338-438b-8ea9-06114f7be08e/"</span><span class="p">,</span>
|
|
3723
|
-
<a id="__codelineno-22-12" name="__codelineno-22-12" href="#__codelineno-22-12"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"US-East 4"</span><span class="p">,</span>
|
|
3724
|
-
<a id="__codelineno-22-13" name="__codelineno-22-13" href="#__codelineno-22-13"></a><span class="w"> </span><span class="nt">"slug"</span><span class="p">:</span><span class="w"> </span><span class="s2">"us-east-4"</span>
|
|
3725
|
-
<a id="__codelineno-22-14" name="__codelineno-22-14" href="#__codelineno-22-14"></a><span class="w"> </span><span class="p">},</span>
|
|
3726
|
-
<a id="__codelineno-22-15" name="__codelineno-22-15" href="#__codelineno-22-15"></a><span class="w"> </span><span class="nt">"vrf"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
3727
|
-
<a id="__codelineno-22-16" name="__codelineno-22-16" href="#__codelineno-22-16"></a><span class="w"> </span><span class="nt">"tenant"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
3728
|
-
<a id="__codelineno-22-17" name="__codelineno-22-17" href="#__codelineno-22-17"></a><span class="w"> </span><span class="nt">"vlan"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
3729
|
-
<a id="__codelineno-22-18" name="__codelineno-22-18" href="#__codelineno-22-18"></a><span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
3730
|
-
<a id="__codelineno-22-19" name="__codelineno-22-19" href="#__codelineno-22-19"></a><span class="w"> </span><span class="nt">"display"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Active"</span><span class="p">,</span>
|
|
3731
|
-
<a id="__codelineno-22-20" name="__codelineno-22-20" href="#__codelineno-22-20"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"fc32b83f-2448-4602-9d43-fecc6735e4e5"</span><span class="p">,</span>
|
|
3732
|
-
<a id="__codelineno-22-21" name="__codelineno-22-21" href="#__codelineno-22-21"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://localhost:8080/api/extras/statuses/fc32b83f-2448-4602-9d43-fecc6735e4e5/"</span><span class="p">,</span>
|
|
3733
|
-
<a id="__codelineno-22-22" name="__codelineno-22-22" href="#__codelineno-22-22"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Active"</span><span class="p">,</span>
|
|
3734
|
-
<a id="__codelineno-22-23" name="__codelineno-22-23" href="#__codelineno-22-23"></a><span class="w"> </span><span class="nt">"slug"</span><span class="p">:</span><span class="w"> </span><span class="s2">"active"</span><span class="p">,</span>
|
|
3735
|
-
<a id="__codelineno-22-24" name="__codelineno-22-24" href="#__codelineno-22-24"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-12-09T16:38:50.363404Z"</span><span class="p">,</span>
|
|
3736
|
-
<a id="__codelineno-22-25" name="__codelineno-22-25" href="#__codelineno-22-25"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-12-09T16:38:50.363404Z"</span>
|
|
3737
|
-
<a id="__codelineno-22-26" name="__codelineno-22-26" href="#__codelineno-22-26"></a><span class="w"> </span><span class="p">},</span>
|
|
3738
|
-
<a id="__codelineno-22-27" name="__codelineno-22-27" href="#__codelineno-22-27"></a><span class="w"> </span><span class="nt">"role"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
3739
|
-
<a id="__codelineno-22-28" name="__codelineno-22-28" href="#__codelineno-22-28"></a><span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"network"</span><span class="p">,</span>
|
|
3740
|
-
<a id="__codelineno-22-29" name="__codelineno-22-29" href="#__codelineno-22-29"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
3741
|
-
<a id="__codelineno-22-30" name="__codelineno-22-30" href="#__codelineno-22-30"></a><span class="w"> </span><span class="nt">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span>
|
|
3742
|
-
<a id="__codelineno-22-31" name="__codelineno-22-31" href="#__codelineno-22-31"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span>
|
|
3743
|
-
<a id="__codelineno-22-32" name="__codelineno-22-32" href="#__codelineno-22-32"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020-08-04T20:08:39.007125Z"</span><span class="p">,</span>
|
|
3744
|
-
<a id="__codelineno-22-33" name="__codelineno-22-33" href="#__codelineno-22-33"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020-08-04T20:08:39.007125Z"</span>
|
|
3745
|
-
<a id="__codelineno-22-34" name="__codelineno-22-34" href="#__codelineno-22-34"></a><span class="p">}</span>
|
|
3746
|
-
</code></pre></div>
|
|
3747
|
-
<h3 id="creating-multiple-objects">Creating Multiple Objects<a class="headerlink" href="#creating-multiple-objects" title="Permanent link">¶</a></h3>
|
|
3748
|
-
<p>To create multiple instances of a model using a single request, make a <code>POST</code> request to the model's <em>list</em> endpoint with a list of JSON objects representing each instance to be created. If successful, the response will contain a list of the newly created instances. The example below illustrates the creation of three new sites.</p>
|
|
3749
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a>curl -X POST -H "Authorization: Token $TOKEN" \
|
|
3750
|
-
<a id="__codelineno-23-2" name="__codelineno-23-2" href="#__codelineno-23-2"></a>-H "Content-Type: application/json" \
|
|
3751
|
-
<a id="__codelineno-23-3" name="__codelineno-23-3" href="#__codelineno-23-3"></a>-H "Accept: application/json; version=1.3; indent=4" \
|
|
3752
|
-
<a id="__codelineno-23-4" name="__codelineno-23-4" href="#__codelineno-23-4"></a>http://nautobot/api/dcim/sites/ \
|
|
3753
|
-
<a id="__codelineno-23-5" name="__codelineno-23-5" href="#__codelineno-23-5"></a>--data '[
|
|
3754
|
-
<a id="__codelineno-23-6" name="__codelineno-23-6" href="#__codelineno-23-6"></a>{"name": "Site 1", "slug": "site-1", "region": {"name": "United States"}},
|
|
3755
|
-
<a id="__codelineno-23-7" name="__codelineno-23-7" href="#__codelineno-23-7"></a>{"name": "Site 2", "slug": "site-2", "region": {"name": "United States"}},
|
|
3756
|
-
<a id="__codelineno-23-8" name="__codelineno-23-8" href="#__codelineno-23-8"></a>{"name": "Site 3", "slug": "site-3", "region": {"name": "United States"}}
|
|
3757
|
-
<a id="__codelineno-23-9" name="__codelineno-23-9" href="#__codelineno-23-9"></a>]'
|
|
3758
|
-
</code></pre></div>
|
|
3759
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a><span class="p">[</span>
|
|
3760
|
-
<a id="__codelineno-24-2" name="__codelineno-24-2" href="#__codelineno-24-2"></a><span class="w"> </span><span class="p">{</span>
|
|
3761
|
-
<a id="__codelineno-24-3" name="__codelineno-24-3" href="#__codelineno-24-3"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0238a4e3-66f2-455a-831f-5f177215de0f"</span><span class="p">,</span>
|
|
3762
|
-
<a id="__codelineno-24-4" name="__codelineno-24-4" href="#__codelineno-24-4"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/sites/0238a4e3-66f2-455a-831f-5f177215de0f/"</span><span class="p">,</span>
|
|
3763
|
-
<a id="__codelineno-24-5" name="__codelineno-24-5" href="#__codelineno-24-5"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Site 1"</span><span class="p">,</span>
|
|
3764
|
-
<a id="__codelineno-24-6" name="__codelineno-24-6" href="#__codelineno-24-6"></a><span class="w"> </span><span class="err">...</span>
|
|
3765
|
-
<a id="__codelineno-24-7" name="__codelineno-24-7" href="#__codelineno-24-7"></a><span class="w"> </span><span class="p">},</span>
|
|
3766
|
-
<a id="__codelineno-24-8" name="__codelineno-24-8" href="#__codelineno-24-8"></a><span class="w"> </span><span class="p">{</span>
|
|
3767
|
-
<a id="__codelineno-24-9" name="__codelineno-24-9" href="#__codelineno-24-9"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"33ac3a3b-0ee7-49b7-bf2a-244096051dc0"</span><span class="p">,</span>
|
|
3768
|
-
<a id="__codelineno-24-10" name="__codelineno-24-10" href="#__codelineno-24-10"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/sites/33ac3a3b-0ee7-49b7-bf2a-244096051dc0/"</span><span class="p">,</span>
|
|
3769
|
-
<a id="__codelineno-24-11" name="__codelineno-24-11" href="#__codelineno-24-11"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Site 2"</span><span class="p">,</span>
|
|
3770
|
-
<a id="__codelineno-24-12" name="__codelineno-24-12" href="#__codelineno-24-12"></a><span class="w"> </span><span class="err">...</span>
|
|
3771
|
-
<a id="__codelineno-24-13" name="__codelineno-24-13" href="#__codelineno-24-13"></a><span class="w"> </span><span class="p">},</span>
|
|
3772
|
-
<a id="__codelineno-24-14" name="__codelineno-24-14" href="#__codelineno-24-14"></a><span class="w"> </span><span class="p">{</span>
|
|
3773
|
-
<a id="__codelineno-24-15" name="__codelineno-24-15" href="#__codelineno-24-15"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"10b3134d-960b-4794-ad18-0e73edd357c4"</span><span class="p">,</span>
|
|
3774
|
-
<a id="__codelineno-24-16" name="__codelineno-24-16" href="#__codelineno-24-16"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/sites/10b3134d-960b-4794-ad18-0e73edd357c4/"</span><span class="p">,</span>
|
|
3775
|
-
<a id="__codelineno-24-17" name="__codelineno-24-17" href="#__codelineno-24-17"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Site 3"</span><span class="p">,</span>
|
|
3776
|
-
<a id="__codelineno-24-18" name="__codelineno-24-18" href="#__codelineno-24-18"></a><span class="w"> </span><span class="err">...</span>
|
|
3777
|
-
<a id="__codelineno-24-19" name="__codelineno-24-19" href="#__codelineno-24-19"></a><span class="w"> </span><span class="p">}</span>
|
|
3778
|
-
<a id="__codelineno-24-20" name="__codelineno-24-20" href="#__codelineno-24-20"></a><span class="p">]</span>
|
|
3779
|
-
</code></pre></div>
|
|
3780
|
-
<h3 id="updating-an-object">Updating an Object<a class="headerlink" href="#updating-an-object" title="Permanent link">¶</a></h3>
|
|
3781
|
-
<p>To modify an object which has already been created, make a <code>PATCH</code> request to the model's <em>detail</em> endpoint specifying its UUID. Include any data which you wish to update on the object. As with object creation, the <code>Authorization</code> and <code>Content-Type</code> headers must also be specified, and specifying the <code>Accept</code> header is also strongly recommended.</p>
|
|
3782
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-25-1" name="__codelineno-25-1" href="#__codelineno-25-1"></a>curl -s -X PATCH \
|
|
5184
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-25-1" name="__codelineno-25-1" href="#__codelineno-25-1"></a>curl -s -X POST \
|
|
3783
5185
|
<a id="__codelineno-25-2" name="__codelineno-25-2" href="#__codelineno-25-2"></a>-H "Authorization: Token $TOKEN" \
|
|
3784
5186
|
<a id="__codelineno-25-3" name="__codelineno-25-3" href="#__codelineno-25-3"></a>-H "Content-Type: application/json" \
|
|
3785
|
-
<a id="__codelineno-25-4" name="__codelineno-25-4" href="#__codelineno-25-4"></a>-H "Accept: application/json; version=
|
|
3786
|
-
<a id="__codelineno-25-5" name="__codelineno-25-5" href="#__codelineno-25-5"></a>http://nautobot/api/ipam/prefixes/
|
|
3787
|
-
<a id="__codelineno-25-6" name="__codelineno-25-6" href="#__codelineno-25-6"></a>--data '{"
|
|
5187
|
+
<a id="__codelineno-25-4" name="__codelineno-25-4" href="#__codelineno-25-4"></a>-H "Accept: application/json; version=2.0" \
|
|
5188
|
+
<a id="__codelineno-25-5" name="__codelineno-25-5" href="#__codelineno-25-5"></a>http://nautobot/api/ipam/prefixes/ \
|
|
5189
|
+
<a id="__codelineno-25-6" name="__codelineno-25-6" href="#__codelineno-25-6"></a>--data '{"prefix": "192.0.2.0/24", "location": 8df9e629-4338-438b-8ea9-06114f7be08e}' | jq '.'
|
|
3788
5190
|
</code></pre></div>
|
|
3789
5191
|
<div class="highlight"><pre><span></span><code><a id="__codelineno-26-1" name="__codelineno-26-1" href="#__codelineno-26-1"></a><span class="p">{</span>
|
|
3790
5192
|
<a id="__codelineno-26-2" name="__codelineno-26-2" href="#__codelineno-26-2"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"48df6965-0fcb-4155-b5f8-00fe8b9b01af"</span><span class="p">,</span>
|
|
@@ -3794,32 +5196,83 @@
|
|
|
3794
5196
|
<a id="__codelineno-26-6" name="__codelineno-26-6" href="#__codelineno-26-6"></a><span class="w"> </span><span class="nt">"label"</span><span class="p">:</span><span class="w"> </span><span class="s2">"IPv4"</span>
|
|
3795
5197
|
<a id="__codelineno-26-7" name="__codelineno-26-7" href="#__codelineno-26-7"></a><span class="w"> </span><span class="p">},</span>
|
|
3796
5198
|
<a id="__codelineno-26-8" name="__codelineno-26-8" href="#__codelineno-26-8"></a><span class="w"> </span><span class="nt">"prefix"</span><span class="p">:</span><span class="w"> </span><span class="s2">"192.0.2.0/24"</span><span class="p">,</span>
|
|
3797
|
-
<a id="__codelineno-26-9" name="__codelineno-26-9" href="#__codelineno-26-9"></a><span class="w"> </span><span class="nt">"
|
|
3798
|
-
<a id="__codelineno-26-10" name="__codelineno-26-10" href="#__codelineno-26-10"></a><span class="w">
|
|
3799
|
-
<a id="__codelineno-26-11" name="__codelineno-26-11" href="#__codelineno-26-11"></a><span class="w">
|
|
3800
|
-
<a id="__codelineno-26-12" name="__codelineno-26-12" href="#__codelineno-26-12"></a><span class="w">
|
|
3801
|
-
<a id="__codelineno-26-13" name="__codelineno-26-13" href="#__codelineno-26-13"></a><span class="w">
|
|
3802
|
-
<a id="__codelineno-26-14" name="__codelineno-26-14" href="#__codelineno-26-14"></a><span class="w"> </span><span class="p">
|
|
3803
|
-
<a id="__codelineno-26-15" name="__codelineno-26-15" href="#__codelineno-26-15"></a><span class="w"> </span><span class="nt">"
|
|
3804
|
-
<a id="__codelineno-26-16" name="__codelineno-26-16" href="#__codelineno-26-16"></a><span class="w"> </span><span class="nt">"
|
|
3805
|
-
<a id="__codelineno-26-17" name="__codelineno-26-17" href="#__codelineno-26-17"></a><span class="w"> </span><span class="nt">"
|
|
3806
|
-
<a id="__codelineno-26-18" name="__codelineno-26-18" href="#__codelineno-26-18"></a><span class="w"> </span><span class="nt">"
|
|
3807
|
-
<a id="__codelineno-26-19" name="__codelineno-26-19" href="#__codelineno-26-19"></a><span class="w">
|
|
3808
|
-
<a id="__codelineno-26-20" name="__codelineno-26-20" href="#__codelineno-26-20"></a><span class="w">
|
|
3809
|
-
<a id="__codelineno-26-21" name="__codelineno-26-21" href="#__codelineno-26-21"></a><span class="
|
|
3810
|
-
|
|
3811
|
-
<
|
|
3812
|
-
<a
|
|
3813
|
-
<a id="__codelineno-
|
|
3814
|
-
<a id="__codelineno-
|
|
3815
|
-
<a id="__codelineno-
|
|
3816
|
-
<a id="__codelineno-
|
|
3817
|
-
<a id="__codelineno-
|
|
3818
|
-
<a id="__codelineno-
|
|
3819
|
-
<a id="__codelineno-
|
|
3820
|
-
<a id="__codelineno-
|
|
3821
|
-
<a id="__codelineno-
|
|
3822
|
-
|
|
5199
|
+
<a id="__codelineno-26-9" name="__codelineno-26-9" href="#__codelineno-26-9"></a><span class="w"> </span><span class="nt">"location"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/locations/8df9e629-4338-438b-8ea9-06114f7be08e/"</span><span class="p">,</span>
|
|
5200
|
+
<a id="__codelineno-26-10" name="__codelineno-26-10" href="#__codelineno-26-10"></a><span class="w"> </span><span class="nt">"vrf"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
5201
|
+
<a id="__codelineno-26-11" name="__codelineno-26-11" href="#__codelineno-26-11"></a><span class="w"> </span><span class="nt">"tenant"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
5202
|
+
<a id="__codelineno-26-12" name="__codelineno-26-12" href="#__codelineno-26-12"></a><span class="w"> </span><span class="nt">"vlan"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
5203
|
+
<a id="__codelineno-26-13" name="__codelineno-26-13" href="#__codelineno-26-13"></a><span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/extras/statuses/fc32b83f-2448-4602-9d43-fecc6735e4e5/"</span><span class="p">,</span>
|
|
5204
|
+
<a id="__codelineno-26-14" name="__codelineno-26-14" href="#__codelineno-26-14"></a><span class="w"> </span><span class="nt">"role"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
5205
|
+
<a id="__codelineno-26-15" name="__codelineno-26-15" href="#__codelineno-26-15"></a><span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"network"</span><span class="p">,</span>
|
|
5206
|
+
<a id="__codelineno-26-16" name="__codelineno-26-16" href="#__codelineno-26-16"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
5207
|
+
<a id="__codelineno-26-17" name="__codelineno-26-17" href="#__codelineno-26-17"></a><span class="w"> </span><span class="nt">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span>
|
|
5208
|
+
<a id="__codelineno-26-18" name="__codelineno-26-18" href="#__codelineno-26-18"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span>
|
|
5209
|
+
<a id="__codelineno-26-19" name="__codelineno-26-19" href="#__codelineno-26-19"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020-08-04T20:08:39.007125Z"</span><span class="p">,</span>
|
|
5210
|
+
<a id="__codelineno-26-20" name="__codelineno-26-20" href="#__codelineno-26-20"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020-08-04T20:08:39.007125Z"</span>
|
|
5211
|
+
<a id="__codelineno-26-21" name="__codelineno-26-21" href="#__codelineno-26-21"></a><span class="p">}</span>
|
|
5212
|
+
</code></pre></div>
|
|
5213
|
+
<h3 id="creating-multiple-objects">Creating Multiple Objects<a class="headerlink" href="#creating-multiple-objects" title="Permanent link">¶</a></h3>
|
|
5214
|
+
<p>To create multiple instances of a model using a single request, make a <code>POST</code> request to the model's <em>list</em> endpoint with a list of JSON objects representing each instance to be created. If successful, the response will contain a list of the newly created instances. The example below illustrates the creation of three new sites.</p>
|
|
5215
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-27-1" name="__codelineno-27-1" href="#__codelineno-27-1"></a>curl -X POST -H "Authorization: Token $TOKEN" \
|
|
5216
|
+
<a id="__codelineno-27-2" name="__codelineno-27-2" href="#__codelineno-27-2"></a>-H "Content-Type: application/json" \
|
|
5217
|
+
<a id="__codelineno-27-3" name="__codelineno-27-3" href="#__codelineno-27-3"></a>-H "Accept: application/json; version=2.0; indent=4" \
|
|
5218
|
+
<a id="__codelineno-27-4" name="__codelineno-27-4" href="#__codelineno-27-4"></a>http://nautobot/api/dcim/sites/ \
|
|
5219
|
+
<a id="__codelineno-27-5" name="__codelineno-27-5" href="#__codelineno-27-5"></a>--data '[
|
|
5220
|
+
<a id="__codelineno-27-6" name="__codelineno-27-6" href="#__codelineno-27-6"></a>{"name": "Site 1", "slug": "site-1", "region": {"name": "United States"}},
|
|
5221
|
+
<a id="__codelineno-27-7" name="__codelineno-27-7" href="#__codelineno-27-7"></a>{"name": "Site 2", "slug": "site-2", "region": {"name": "United States"}},
|
|
5222
|
+
<a id="__codelineno-27-8" name="__codelineno-27-8" href="#__codelineno-27-8"></a>{"name": "Site 3", "slug": "site-3", "region": {"name": "United States"}}
|
|
5223
|
+
<a id="__codelineno-27-9" name="__codelineno-27-9" href="#__codelineno-27-9"></a>]'
|
|
5224
|
+
</code></pre></div>
|
|
5225
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-28-1" name="__codelineno-28-1" href="#__codelineno-28-1"></a><span class="p">[</span>
|
|
5226
|
+
<a id="__codelineno-28-2" name="__codelineno-28-2" href="#__codelineno-28-2"></a><span class="w"> </span><span class="p">{</span>
|
|
5227
|
+
<a id="__codelineno-28-3" name="__codelineno-28-3" href="#__codelineno-28-3"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0238a4e3-66f2-455a-831f-5f177215de0f"</span><span class="p">,</span>
|
|
5228
|
+
<a id="__codelineno-28-4" name="__codelineno-28-4" href="#__codelineno-28-4"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/sites/0238a4e3-66f2-455a-831f-5f177215de0f/"</span><span class="p">,</span>
|
|
5229
|
+
<a id="__codelineno-28-5" name="__codelineno-28-5" href="#__codelineno-28-5"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Site 1"</span><span class="p">,</span>
|
|
5230
|
+
<a id="__codelineno-28-6" name="__codelineno-28-6" href="#__codelineno-28-6"></a><span class="w"> </span><span class="err">...</span>
|
|
5231
|
+
<a id="__codelineno-28-7" name="__codelineno-28-7" href="#__codelineno-28-7"></a><span class="w"> </span><span class="p">},</span>
|
|
5232
|
+
<a id="__codelineno-28-8" name="__codelineno-28-8" href="#__codelineno-28-8"></a><span class="w"> </span><span class="p">{</span>
|
|
5233
|
+
<a id="__codelineno-28-9" name="__codelineno-28-9" href="#__codelineno-28-9"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"33ac3a3b-0ee7-49b7-bf2a-244096051dc0"</span><span class="p">,</span>
|
|
5234
|
+
<a id="__codelineno-28-10" name="__codelineno-28-10" href="#__codelineno-28-10"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/sites/33ac3a3b-0ee7-49b7-bf2a-244096051dc0/"</span><span class="p">,</span>
|
|
5235
|
+
<a id="__codelineno-28-11" name="__codelineno-28-11" href="#__codelineno-28-11"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Site 2"</span><span class="p">,</span>
|
|
5236
|
+
<a id="__codelineno-28-12" name="__codelineno-28-12" href="#__codelineno-28-12"></a><span class="w"> </span><span class="err">...</span>
|
|
5237
|
+
<a id="__codelineno-28-13" name="__codelineno-28-13" href="#__codelineno-28-13"></a><span class="w"> </span><span class="p">},</span>
|
|
5238
|
+
<a id="__codelineno-28-14" name="__codelineno-28-14" href="#__codelineno-28-14"></a><span class="w"> </span><span class="p">{</span>
|
|
5239
|
+
<a id="__codelineno-28-15" name="__codelineno-28-15" href="#__codelineno-28-15"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"10b3134d-960b-4794-ad18-0e73edd357c4"</span><span class="p">,</span>
|
|
5240
|
+
<a id="__codelineno-28-16" name="__codelineno-28-16" href="#__codelineno-28-16"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/sites/10b3134d-960b-4794-ad18-0e73edd357c4/"</span><span class="p">,</span>
|
|
5241
|
+
<a id="__codelineno-28-17" name="__codelineno-28-17" href="#__codelineno-28-17"></a><span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Site 3"</span><span class="p">,</span>
|
|
5242
|
+
<a id="__codelineno-28-18" name="__codelineno-28-18" href="#__codelineno-28-18"></a><span class="w"> </span><span class="err">...</span>
|
|
5243
|
+
<a id="__codelineno-28-19" name="__codelineno-28-19" href="#__codelineno-28-19"></a><span class="w"> </span><span class="p">}</span>
|
|
5244
|
+
<a id="__codelineno-28-20" name="__codelineno-28-20" href="#__codelineno-28-20"></a><span class="p">]</span>
|
|
5245
|
+
</code></pre></div>
|
|
5246
|
+
<h3 id="updating-an-object">Updating an Object<a class="headerlink" href="#updating-an-object" title="Permanent link">¶</a></h3>
|
|
5247
|
+
<p>To modify an object which has already been created, make a <code>PATCH</code> request to the model's <em>detail</em> endpoint specifying its UUID. Include any data which you wish to update on the object. As with object creation, the <code>Authorization</code> and <code>Content-Type</code> headers must also be specified, and specifying the <code>Accept</code> header is also strongly recommended.</p>
|
|
5248
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-29-1" name="__codelineno-29-1" href="#__codelineno-29-1"></a>curl -s -X PATCH \
|
|
5249
|
+
<a id="__codelineno-29-2" name="__codelineno-29-2" href="#__codelineno-29-2"></a>-H "Authorization: Token $TOKEN" \
|
|
5250
|
+
<a id="__codelineno-29-3" name="__codelineno-29-3" href="#__codelineno-29-3"></a>-H "Content-Type: application/json" \
|
|
5251
|
+
<a id="__codelineno-29-4" name="__codelineno-29-4" href="#__codelineno-29-4"></a>-H "Accept: application/json; version=2.0" \
|
|
5252
|
+
<a id="__codelineno-29-5" name="__codelineno-29-5" href="#__codelineno-29-5"></a>http://nautobot/api/ipam/prefixes/b484b0ac-12e3-484a-84c0-aa17955eaedc/ \
|
|
5253
|
+
<a id="__codelineno-29-6" name="__codelineno-29-6" href="#__codelineno-29-6"></a>--data '{"status": "fc32b83f-2448-4602-9d43-fecc6735e4e5"}' | jq '.'
|
|
5254
|
+
</code></pre></div>
|
|
5255
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-30-1" name="__codelineno-30-1" href="#__codelineno-30-1"></a><span class="p">{</span>
|
|
5256
|
+
<a id="__codelineno-30-2" name="__codelineno-30-2" href="#__codelineno-30-2"></a><span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"48df6965-0fcb-4155-b5f8-00fe8b9b01af"</span><span class="p">,</span>
|
|
5257
|
+
<a id="__codelineno-30-3" name="__codelineno-30-3" href="#__codelineno-30-3"></a><span class="w"> </span><span class="nt">"url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/ipam/prefixes/48df6965-0fcb-4155-b5f8-00fe8b9b01af/"</span><span class="p">,</span>
|
|
5258
|
+
<a id="__codelineno-30-4" name="__codelineno-30-4" href="#__codelineno-30-4"></a><span class="w"> </span><span class="nt">"family"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5259
|
+
<a id="__codelineno-30-5" name="__codelineno-30-5" href="#__codelineno-30-5"></a><span class="w"> </span><span class="nt">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span>
|
|
5260
|
+
<a id="__codelineno-30-6" name="__codelineno-30-6" href="#__codelineno-30-6"></a><span class="w"> </span><span class="nt">"label"</span><span class="p">:</span><span class="w"> </span><span class="s2">"IPv4"</span>
|
|
5261
|
+
<a id="__codelineno-30-7" name="__codelineno-30-7" href="#__codelineno-30-7"></a><span class="w"> </span><span class="p">},</span>
|
|
5262
|
+
<a id="__codelineno-30-8" name="__codelineno-30-8" href="#__codelineno-30-8"></a><span class="w"> </span><span class="nt">"prefix"</span><span class="p">:</span><span class="w"> </span><span class="s2">"192.0.2.0/24"</span><span class="p">,</span>
|
|
5263
|
+
<a id="__codelineno-30-9" name="__codelineno-30-9" href="#__codelineno-30-9"></a><span class="w"> </span><span class="nt">"site"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/dcim/sites/8df9e629-4338-438b-8ea9-06114f7be08e/"</span><span class="p">,</span>
|
|
5264
|
+
<a id="__codelineno-30-10" name="__codelineno-30-10" href="#__codelineno-30-10"></a><span class="w"> </span><span class="nt">"vrf"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
5265
|
+
<a id="__codelineno-30-11" name="__codelineno-30-11" href="#__codelineno-30-11"></a><span class="w"> </span><span class="nt">"tenant"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
5266
|
+
<a id="__codelineno-30-12" name="__codelineno-30-12" href="#__codelineno-30-12"></a><span class="w"> </span><span class="nt">"vlan"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
5267
|
+
<a id="__codelineno-30-13" name="__codelineno-30-13" href="#__codelineno-30-13"></a><span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://nautobot/api/extras/statuses/fc32b83f-2448-4602-9d43-fecc6735e4e5/"</span><span class="p">,</span>
|
|
5268
|
+
<a id="__codelineno-30-14" name="__codelineno-30-14" href="#__codelineno-30-14"></a><span class="w"> </span><span class="nt">"role"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
|
5269
|
+
<a id="__codelineno-30-15" name="__codelineno-30-15" href="#__codelineno-30-15"></a><span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"network"</span><span class="p">,</span>
|
|
5270
|
+
<a id="__codelineno-30-16" name="__codelineno-30-16" href="#__codelineno-30-16"></a><span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span><span class="p">,</span>
|
|
5271
|
+
<a id="__codelineno-30-17" name="__codelineno-30-17" href="#__codelineno-30-17"></a><span class="w"> </span><span class="nt">"tags"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span>
|
|
5272
|
+
<a id="__codelineno-30-18" name="__codelineno-30-18" href="#__codelineno-30-18"></a><span class="w"> </span><span class="nt">"custom_fields"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span>
|
|
5273
|
+
<a id="__codelineno-30-19" name="__codelineno-30-19" href="#__codelineno-30-19"></a><span class="w"> </span><span class="nt">"created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020-08-04T00:00:00Z"</span><span class="p">,</span>
|
|
5274
|
+
<a id="__codelineno-30-20" name="__codelineno-30-20" href="#__codelineno-30-20"></a><span class="w"> </span><span class="nt">"last_updated"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020-08-04T20:14:55.709430Z"</span>
|
|
5275
|
+
<a id="__codelineno-30-21" name="__codelineno-30-21" href="#__codelineno-30-21"></a><span class="p">}</span>
|
|
3823
5276
|
</code></pre></div>
|
|
3824
5277
|
<div class="admonition note">
|
|
3825
5278
|
<p class="admonition-title">PUT versus PATCH</p>
|
|
@@ -3830,48 +5283,48 @@
|
|
|
3830
5283
|
<p class="admonition-title">Added in version 1.4.0</p>
|
|
3831
5284
|
</div>
|
|
3832
5285
|
<p>It is possible to modify the objects associated via Relationship with an object as part of a REST API <code>PATCH</code> request by specifying the <code>"relationships"</code> key, any or all of the relevant Relationships, and the list of desired related objects for each such Relationship. Since nested serializers are used for the related objects, they can be identified by ID (primary key) or by one or more attributes in a dictionary. For example, either of the following requests would be valid:</p>
|
|
3833
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-
|
|
3834
|
-
<a id="__codelineno-
|
|
3835
|
-
<a id="__codelineno-
|
|
3836
|
-
<a id="__codelineno-
|
|
3837
|
-
<a id="__codelineno-
|
|
3838
|
-
<a id="__codelineno-
|
|
3839
|
-
<a id="__codelineno-
|
|
3840
|
-
<a id="__codelineno-
|
|
3841
|
-
<a id="__codelineno-
|
|
3842
|
-
<a id="__codelineno-
|
|
3843
|
-
<a id="__codelineno-
|
|
3844
|
-
<a id="__codelineno-
|
|
3845
|
-
<a id="__codelineno-
|
|
3846
|
-
<a id="__codelineno-
|
|
3847
|
-
<a id="__codelineno-
|
|
3848
|
-
<a id="__codelineno-
|
|
3849
|
-
<a id="__codelineno-
|
|
3850
|
-
<a id="__codelineno-
|
|
3851
|
-
<a id="__codelineno-
|
|
5286
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-31-1" name="__codelineno-31-1" href="#__codelineno-31-1"></a><span class="p">{</span>
|
|
5287
|
+
<a id="__codelineno-31-2" name="__codelineno-31-2" href="#__codelineno-31-2"></a><span class="w"> </span><span class="nt">"relationships"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5288
|
+
<a id="__codelineno-31-3" name="__codelineno-31-3" href="#__codelineno-31-3"></a><span class="w"> </span><span class="nt">"site-to-vrf"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5289
|
+
<a id="__codelineno-31-4" name="__codelineno-31-4" href="#__codelineno-31-4"></a><span class="w"> </span><span class="nt">"destination"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5290
|
+
<a id="__codelineno-31-5" name="__codelineno-31-5" href="#__codelineno-31-5"></a><span class="w"> </span><span class="nt">"objects"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
|
5291
|
+
<a id="__codelineno-31-6" name="__codelineno-31-6" href="#__codelineno-31-6"></a><span class="w"> </span><span class="p">{</span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"blue"</span><span class="p">}</span>
|
|
5292
|
+
<a id="__codelineno-31-7" name="__codelineno-31-7" href="#__codelineno-31-7"></a><span class="w"> </span><span class="p">]</span>
|
|
5293
|
+
<a id="__codelineno-31-8" name="__codelineno-31-8" href="#__codelineno-31-8"></a><span class="w"> </span><span class="p">}</span>
|
|
5294
|
+
<a id="__codelineno-31-9" name="__codelineno-31-9" href="#__codelineno-31-9"></a><span class="w"> </span><span class="p">},</span>
|
|
5295
|
+
<a id="__codelineno-31-10" name="__codelineno-31-10" href="#__codelineno-31-10"></a><span class="w"> </span><span class="nt">"vrfs-to-sites"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5296
|
+
<a id="__codelineno-31-11" name="__codelineno-31-11" href="#__codelineno-31-11"></a><span class="w"> </span><span class="nt">"source"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5297
|
+
<a id="__codelineno-31-12" name="__codelineno-31-12" href="#__codelineno-31-12"></a><span class="w"> </span><span class="nt">"objects"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
|
5298
|
+
<a id="__codelineno-31-13" name="__codelineno-31-13" href="#__codelineno-31-13"></a><span class="w"> </span><span class="p">{</span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"green"</span><span class="p">},</span>
|
|
5299
|
+
<a id="__codelineno-31-14" name="__codelineno-31-14" href="#__codelineno-31-14"></a><span class="w"> </span><span class="p">{</span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"red"</span><span class="p">},</span>
|
|
5300
|
+
<a id="__codelineno-31-15" name="__codelineno-31-15" href="#__codelineno-31-15"></a><span class="w"> </span><span class="p">]</span>
|
|
5301
|
+
<a id="__codelineno-31-16" name="__codelineno-31-16" href="#__codelineno-31-16"></a><span class="w"> </span><span class="p">}</span>
|
|
5302
|
+
<a id="__codelineno-31-17" name="__codelineno-31-17" href="#__codelineno-31-17"></a><span class="w"> </span><span class="p">}</span>
|
|
5303
|
+
<a id="__codelineno-31-18" name="__codelineno-31-18" href="#__codelineno-31-18"></a><span class="w"> </span><span class="p">}</span>
|
|
5304
|
+
<a id="__codelineno-31-19" name="__codelineno-31-19" href="#__codelineno-31-19"></a><span class="p">}</span>
|
|
3852
5305
|
</code></pre></div>
|
|
3853
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-
|
|
3854
|
-
<a id="__codelineno-
|
|
3855
|
-
<a id="__codelineno-
|
|
3856
|
-
<a id="__codelineno-
|
|
3857
|
-
<a id="__codelineno-
|
|
3858
|
-
<a id="__codelineno-
|
|
3859
|
-
<a id="__codelineno-
|
|
3860
|
-
<a id="__codelineno-
|
|
3861
|
-
<a id="__codelineno-
|
|
5306
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-32-1" name="__codelineno-32-1" href="#__codelineno-32-1"></a><span class="p">{</span>
|
|
5307
|
+
<a id="__codelineno-32-2" name="__codelineno-32-2" href="#__codelineno-32-2"></a><span class="w"> </span><span class="nt">"relationships"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5308
|
+
<a id="__codelineno-32-3" name="__codelineno-32-3" href="#__codelineno-32-3"></a><span class="w"> </span><span class="nt">"site-to-vrf"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5309
|
+
<a id="__codelineno-32-4" name="__codelineno-32-4" href="#__codelineno-32-4"></a><span class="w"> </span><span class="nt">"destination"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
|
5310
|
+
<a id="__codelineno-32-5" name="__codelineno-32-5" href="#__codelineno-32-5"></a><span class="w"> </span><span class="nt">"objects"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"3e3c58f9-4f63-44ba-acee-f0c42430eba7"</span><span class="p">]</span>
|
|
5311
|
+
<a id="__codelineno-32-6" name="__codelineno-32-6" href="#__codelineno-32-6"></a><span class="w"> </span><span class="p">}</span>
|
|
5312
|
+
<a id="__codelineno-32-7" name="__codelineno-32-7" href="#__codelineno-32-7"></a><span class="w"> </span><span class="p">}</span>
|
|
5313
|
+
<a id="__codelineno-32-8" name="__codelineno-32-8" href="#__codelineno-32-8"></a><span class="w"> </span><span class="p">}</span>
|
|
5314
|
+
<a id="__codelineno-32-9" name="__codelineno-32-9" href="#__codelineno-32-9"></a><span class="p">}</span>
|
|
3862
5315
|
</code></pre></div>
|
|
3863
5316
|
<div class="admonition note">
|
|
3864
5317
|
<p class="admonition-title">Note</p>
|
|
3865
5318
|
<p>Relationship slugs can be omitted from the <code>"relationships"</code> dictionary, in which case the associations for that Relationship will be left unmodified. In the second example above, the existing association for the <code>"site-to-vrf"</code> Relationship would be replaced, but the <code>"vrfs-to-sites"</code> Relationship's associations would remain as-is.</p>
|
|
3866
5319
|
</div>
|
|
3867
5320
|
<h3 id="updating-multiple-objects">Updating Multiple Objects<a class="headerlink" href="#updating-multiple-objects" title="Permanent link">¶</a></h3>
|
|
3868
|
-
<p>Multiple objects can be updated simultaneously by issuing a <code>PUT</code> or <code>PATCH</code> request to a model's list endpoint with a list of dictionaries specifying the UUID of each object to be deleted and the attributes to be updated. For example, to update sites with UUIDs 18de055e-3ea9-4cc3-ba78-b7eef6f0d589 and 1a414273-3d68-4586-ba22-6ae0a5702b8f to a status of "
|
|
3869
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-
|
|
3870
|
-
<a id="__codelineno-
|
|
3871
|
-
<a id="__codelineno-
|
|
3872
|
-
<a id="__codelineno-
|
|
3873
|
-
<a id="__codelineno-
|
|
3874
|
-
<a id="__codelineno-
|
|
5321
|
+
<p>Multiple objects can be updated simultaneously by issuing a <code>PUT</code> or <code>PATCH</code> request to a model's list endpoint with a list of dictionaries specifying the UUID of each object to be deleted and the attributes to be updated. For example, to update sites with UUIDs 18de055e-3ea9-4cc3-ba78-b7eef6f0d589 and 1a414273-3d68-4586-ba22-6ae0a5702b8f to a status of "Active", issue the following request:</p>
|
|
5322
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-33-1" name="__codelineno-33-1" href="#__codelineno-33-1"></a>curl -s -X PATCH \
|
|
5323
|
+
<a id="__codelineno-33-2" name="__codelineno-33-2" href="#__codelineno-33-2"></a>-H "Authorization: Token $TOKEN" \
|
|
5324
|
+
<a id="__codelineno-33-3" name="__codelineno-33-3" href="#__codelineno-33-3"></a>-H "Content-Type: application/json" \
|
|
5325
|
+
<a id="__codelineno-33-4" name="__codelineno-33-4" href="#__codelineno-33-4"></a>-H "Accept: application/json; version=2.0" \
|
|
5326
|
+
<a id="__codelineno-33-5" name="__codelineno-33-5" href="#__codelineno-33-5"></a>http://nautobot/api/dcim/sites/ \
|
|
5327
|
+
<a id="__codelineno-33-6" name="__codelineno-33-6" href="#__codelineno-33-6"></a>--data '[{"id": "18de055e-3ea9-4cc3-ba78-b7eef6f0d589", "status": {"name": "Active"}}, {"id": "1a414273-3d68-4586-ba22-6ae0a5702b8f", "status": {"name": "Active"}}]'
|
|
3875
5328
|
</code></pre></div>
|
|
3876
5329
|
<p>Note that there is no requirement for the attributes to be identical among objects. For instance, it's possible to update the status of one site along with the name of another in the same request.</p>
|
|
3877
5330
|
<div class="admonition note">
|
|
@@ -3880,10 +5333,10 @@
|
|
|
3880
5333
|
</div>
|
|
3881
5334
|
<h3 id="deleting-an-object">Deleting an Object<a class="headerlink" href="#deleting-an-object" title="Permanent link">¶</a></h3>
|
|
3882
5335
|
<p>To delete an object from Nautobot, make a <code>DELETE</code> request to the model's <em>detail</em> endpoint specifying its UUID. The <code>Authorization</code> header must be included to specify an authorization token, however this type of request does not support passing any data in the body.</p>
|
|
3883
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-
|
|
3884
|
-
<a id="__codelineno-
|
|
3885
|
-
<a id="__codelineno-
|
|
3886
|
-
<a id="__codelineno-
|
|
5336
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-34-1" name="__codelineno-34-1" href="#__codelineno-34-1"></a>curl -s -X DELETE \
|
|
5337
|
+
<a id="__codelineno-34-2" name="__codelineno-34-2" href="#__codelineno-34-2"></a>-H "Authorization: Token $TOKEN" \
|
|
5338
|
+
<a id="__codelineno-34-3" name="__codelineno-34-3" href="#__codelineno-34-3"></a>-H "Accept: application/json; version=2.0" \
|
|
5339
|
+
<a id="__codelineno-34-4" name="__codelineno-34-4" href="#__codelineno-34-4"></a>http://nautobot/api/ipam/prefixes/48df6965-0fcb-4155-b5f8-00fe8b9b01af/
|
|
3887
5340
|
</code></pre></div>
|
|
3888
5341
|
<p>Note that <code>DELETE</code> requests do not return any data: If successful, the API will return a 204 (No Content) response.</p>
|
|
3889
5342
|
<div class="admonition note">
|
|
@@ -3892,12 +5345,12 @@
|
|
|
3892
5345
|
</div>
|
|
3893
5346
|
<h3 id="deleting-multiple-objects">Deleting Multiple Objects<a class="headerlink" href="#deleting-multiple-objects" title="Permanent link">¶</a></h3>
|
|
3894
5347
|
<p>Nautobot supports the simultaneous deletion of multiple objects of the same type by issuing a <code>DELETE</code> request to the model's list endpoint with a list of dictionaries specifying the UUID of each object to be deleted. For example, to delete sites with UUIDs 18de055e-3ea9-4cc3-ba78-b7eef6f0d589, 1a414273-3d68-4586-ba22-6ae0a5702b8f, and c2516019-caf6-41f0-98a6-4276c1a73fa3, issue the following request:</p>
|
|
3895
|
-
<div class="highlight"><pre><span></span><code><a id="__codelineno-
|
|
3896
|
-
<a id="__codelineno-
|
|
3897
|
-
<a id="__codelineno-
|
|
3898
|
-
<a id="__codelineno-
|
|
3899
|
-
<a id="__codelineno-
|
|
3900
|
-
<a id="__codelineno-
|
|
5348
|
+
<div class="highlight"><pre><span></span><code><a id="__codelineno-35-1" name="__codelineno-35-1" href="#__codelineno-35-1"></a>curl -s -X DELETE \
|
|
5349
|
+
<a id="__codelineno-35-2" name="__codelineno-35-2" href="#__codelineno-35-2"></a>-H "Authorization: Token $TOKEN" \
|
|
5350
|
+
<a id="__codelineno-35-3" name="__codelineno-35-3" href="#__codelineno-35-3"></a>-H "Content-Type: application/json" \
|
|
5351
|
+
<a id="__codelineno-35-4" name="__codelineno-35-4" href="#__codelineno-35-4"></a>-H "Accept: application/json; version=2.0" \
|
|
5352
|
+
<a id="__codelineno-35-5" name="__codelineno-35-5" href="#__codelineno-35-5"></a>http://nautobot/api/dcim/sites/ \
|
|
5353
|
+
<a id="__codelineno-35-6" name="__codelineno-35-6" href="#__codelineno-35-6"></a>--data '[{"id": "18de055e-3ea9-4cc3-ba78-b7eef6f0d589"}, {"id": "1a414273-3d68-4586-ba22-6ae0a5702b8f"}, {"id": "c2516019-caf6-41f0-98a6-4276c1a73fa3"}]'
|
|
3901
5354
|
</code></pre></div>
|
|
3902
5355
|
<div class="admonition note">
|
|
3903
5356
|
<p class="admonition-title">Note</p>
|
|
@@ -3919,42 +5372,6 @@
|
|
|
3919
5372
|
|
|
3920
5373
|
<footer class="md-footer">
|
|
3921
5374
|
|
|
3922
|
-
|
|
3923
|
-
<nav class="md-footer__inner md-grid" aria-label="Footer" >
|
|
3924
|
-
|
|
3925
|
-
|
|
3926
|
-
<a href="../models/extras/webhook.html" class="md-footer__link md-footer__link--prev" aria-label="Previous: Webhooks" rel="prev">
|
|
3927
|
-
<div class="md-footer__button md-icon">
|
|
3928
|
-
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
|
|
3929
|
-
</div>
|
|
3930
|
-
<div class="md-footer__title">
|
|
3931
|
-
<div class="md-ellipsis">
|
|
3932
|
-
<span class="md-footer__direction">
|
|
3933
|
-
Previous
|
|
3934
|
-
</span>
|
|
3935
|
-
Webhooks
|
|
3936
|
-
</div>
|
|
3937
|
-
</div>
|
|
3938
|
-
</a>
|
|
3939
|
-
|
|
3940
|
-
|
|
3941
|
-
|
|
3942
|
-
<a href="filtering.html" class="md-footer__link md-footer__link--next" aria-label="Next: Filtering" rel="next">
|
|
3943
|
-
<div class="md-footer__title">
|
|
3944
|
-
<div class="md-ellipsis">
|
|
3945
|
-
<span class="md-footer__direction">
|
|
3946
|
-
Next
|
|
3947
|
-
</span>
|
|
3948
|
-
Filtering
|
|
3949
|
-
</div>
|
|
3950
|
-
</div>
|
|
3951
|
-
<div class="md-footer__button md-icon">
|
|
3952
|
-
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4Z"/></svg>
|
|
3953
|
-
</div>
|
|
3954
|
-
</a>
|
|
3955
|
-
|
|
3956
|
-
</nav>
|
|
3957
|
-
|
|
3958
5375
|
<div class="md-footer-meta md-typeset">
|
|
3959
5376
|
<div class="md-footer-meta__inner md-grid">
|
|
3960
5377
|
<div class="md-copyright">
|
|
@@ -3982,32 +5399,42 @@
|
|
|
3982
5399
|
|
|
3983
5400
|
|
|
3984
5401
|
|
|
5402
|
+
|
|
5403
|
+
|
|
3985
5404
|
<a href="https://blog.networktocode.com/blog/tags/nautobot" target="_blank" rel="noopener" title="Network to Code Blog" class="md-social__link">
|
|
3986
|
-
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.
|
|
5405
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M0 64c0-17.7 14.3-32 32-32 229.8 0 416 186.2 416 416 0 17.7-14.3 32-32 32s-32-14.3-32-32C384 253.6 226.4 96 32 96 14.3 96 0 81.7 0 64zm0 352a64 64 0 1 1 128 0 64 64 0 1 1-128 0zm32-256c159.1 0 288 128.9 288 288 0 17.7-14.3 32-32 32s-32-14.3-32-32c0-123.7-100.3-224-224-224-17.7 0-32-14.3-32-32s14.3-32 32-32z"/></svg>
|
|
3987
5406
|
</a>
|
|
3988
5407
|
|
|
3989
5408
|
|
|
3990
5409
|
|
|
5410
|
+
|
|
5411
|
+
|
|
3991
5412
|
<a href="https://www.youtube.com/playlist?list=PLjA0bhxgryJ2Ts4GJMDA-tPzVWEncv4pb" target="_blank" rel="noopener" title="Nautobot Videos" class="md-social__link">
|
|
3992
|
-
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 576 512"><!--! Font Awesome Free 6.
|
|
5413
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 576 512"><!--! Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M549.655 124.083c-6.281-23.65-24.787-42.276-48.284-48.597C458.781 64 288 64 288 64S117.22 64 74.629 75.486c-23.497 6.322-42.003 24.947-48.284 48.597-11.412 42.867-11.412 132.305-11.412 132.305s0 89.438 11.412 132.305c6.281 23.65 24.787 41.5 48.284 47.821C117.22 448 288 448 288 448s170.78 0 213.371-11.486c23.497-6.321 42.003-24.171 48.284-47.821 11.412-42.867 11.412-132.305 11.412-132.305s0-89.438-11.412-132.305zm-317.51 213.508V175.185l142.739 81.205-142.739 81.201z"/></svg>
|
|
3993
5414
|
</a>
|
|
3994
5415
|
|
|
3995
5416
|
|
|
3996
5417
|
|
|
5418
|
+
|
|
5419
|
+
|
|
3997
5420
|
<a href="https://www.networktocode.com/community/" target="_blank" rel="noopener" title="Network to Code Community" class="md-social__link">
|
|
3998
|
-
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.
|
|
5421
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M94.12 315.1c0 25.9-21.16 47.06-47.06 47.06S0 341 0 315.1c0-25.9 21.16-47.06 47.06-47.06h47.06v47.06zm23.72 0c0-25.9 21.16-47.06 47.06-47.06s47.06 21.16 47.06 47.06v117.84c0 25.9-21.16 47.06-47.06 47.06s-47.06-21.16-47.06-47.06V315.1zm47.06-188.98c-25.9 0-47.06-21.16-47.06-47.06S139 32 164.9 32s47.06 21.16 47.06 47.06v47.06H164.9zm0 23.72c25.9 0 47.06 21.16 47.06 47.06s-21.16 47.06-47.06 47.06H47.06C21.16 243.96 0 222.8 0 196.9s21.16-47.06 47.06-47.06H164.9zm188.98 47.06c0-25.9 21.16-47.06 47.06-47.06 25.9 0 47.06 21.16 47.06 47.06s-21.16 47.06-47.06 47.06h-47.06V196.9zm-23.72 0c0 25.9-21.16 47.06-47.06 47.06-25.9 0-47.06-21.16-47.06-47.06V79.06c0-25.9 21.16-47.06 47.06-47.06 25.9 0 47.06 21.16 47.06 47.06V196.9zM283.1 385.88c25.9 0 47.06 21.16 47.06 47.06 0 25.9-21.16 47.06-47.06 47.06-25.9 0-47.06-21.16-47.06-47.06v-47.06h47.06zm0-23.72c-25.9 0-47.06-21.16-47.06-47.06 0-25.9 21.16-47.06 47.06-47.06h117.84c25.9 0 47.06 21.16 47.06 47.06 0 25.9-21.16 47.06-47.06 47.06H283.1z"/></svg>
|
|
3999
5422
|
</a>
|
|
4000
5423
|
|
|
4001
5424
|
|
|
4002
5425
|
|
|
5426
|
+
|
|
5427
|
+
|
|
4003
5428
|
<a href="https://github.com/nautobot/nautobot" target="_blank" rel="noopener" title="GitHub Repo" class="md-social__link">
|
|
4004
|
-
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.
|
|
5429
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
|
|
4005
5430
|
</a>
|
|
4006
5431
|
|
|
4007
5432
|
|
|
4008
5433
|
|
|
5434
|
+
|
|
5435
|
+
|
|
4009
5436
|
<a href="https://twitter.com/networktocode" target="_blank" rel="noopener" title="Network to Code Twitter" class="md-social__link">
|
|
4010
|
-
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.
|
|
5437
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"/></svg>
|
|
4011
5438
|
</a>
|
|
4012
5439
|
|
|
4013
5440
|
</div>
|
|
@@ -4021,14 +5448,13 @@
|
|
|
4021
5448
|
<div class="md-dialog__inner md-typeset"></div>
|
|
4022
5449
|
</div>
|
|
4023
5450
|
|
|
4024
|
-
<script id="__config" type="application/json">{"base": "..", "features": ["navigation.tracking", "navigation.tabs", "navigation.tabs.sticky", "search.suggest", "search.highlight", "search.share"], "search": "../assets/javascripts/workers/search.
|
|
5451
|
+
<script id="__config" type="application/json">{"base": "..", "features": ["navigation.tracking", "navigation.tabs", "navigation.tabs.sticky", "search.suggest", "search.highlight", "search.share"], "search": "../assets/javascripts/workers/search.208ed371.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
|
|
4025
5452
|
|
|
4026
5453
|
|
|
4027
|
-
<script src="../assets/javascripts/bundle.
|
|
5454
|
+
<script src="../assets/javascripts/bundle.51198bba.min.js"></script>
|
|
4028
5455
|
|
|
4029
5456
|
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
|
|
4030
5457
|
|
|
4031
5458
|
|
|
4032
|
-
|
|
4033
5459
|
</body>
|
|
4034
5460
|
</html>
|