mirror of
https://github.com/netbox-community/netbox.git
synced 2024-05-10 07:54:54 +00:00
48 lines
1.5 KiB
Markdown
48 lines
1.5 KiB
Markdown
|
# Data Sources
|
||
|
|
|
||
|
|
A data source represents some external repository of data which NetBox can consume, such as a git repository. Files within the data source are synchronized to NetBox by saving them in the database as [data file](./datafile.md) objects.
|
||
|
|
|
||
|
|
## Fields
|
||
|
|
|
||
|
|
### Name
|
||
|
|
|
||
|
|
The data source's human-friendly name.
|
||
|
|
|
||
|
|
### Type
|
||
|
|
|
||
|
|
The type of data source. Supported options include:
|
||
|
|
|
||
|
|
* Local directory
|
||
|
|
* git repository
|
||
|
|
|
||
|
|
### URL
|
||
|
|
|
||
|
|
The URL identifying the remote source. Some examples are included below.
|
||
|
|
|
||
|
|
| Type | Example URL |
|
||
|
|
|------|-------------|
|
||
|
|
| Local | file:///var/my/data/source/ |
|
||
|
|
| git | https://https://github.com/my-organization/my-repo |
|
||
|
|
|
||
|
|
### Status
|
||
|
|
|
||
|
|
The source's current synchronization status. Note that this cannot be set manually: It is updated automatically when the source is synchronized.
|
||
|
|
|
||
|
|
### Enabled
|
||
|
|
|
||
|
|
If false, synchronization will be disabled.
|
||
|
|
|
||
|
|
### Ignore Rules
|
||
|
|
|
||
|
|
A set of rules (one per line) identifying filenames to ignore during synchronization. Some examples are provided below. See Python's [`fnmatch()` documentation](https://docs.python.org/3/library/fnmatch.html) for a complete reference.
|
||
|
|
|
||
|
|
| Rule | Description |
|
||
|
|
|----------------|------------------------------------------|
|
||
|
|
| `README` | Ignore any files named `README` |
|
||
|
|
| `*.txt` | Ignore any files with a `.txt` extension |
|
||
|
|
| `data???.json` | Ignore e.g. `data123.json` |
|
||
|
|
|
||
|
|
### Last Synced
|
||
|
|
|
||
|
|
The date and time at which the source was most recently synchronized successfully.
|