summaryrefslogtreecommitdiff
path: root/doc/rtd/topics/datasources/fallback.rst
blob: 2b133fcd360c0d139a70af5ee2ea20b2ca33299e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
.. _datasource_fallback:

Fallback/None
=============

This is the fallback datasource when no other datasource can be selected. It
is the equivalent of a empty datasource in that it provides a empty string as
userdata and a empty dictionary as metadata. It is useful for testing as well
as for when you do not have a need to have an actual datasource to meet your
instance requirements (ie you just want to run modules that are not concerned
with any external data). It is typically put at the end of the datasource
search list so that if all other datasources are not matched, then this one
will be so that the user is not left with an inaccessible instance.

**Note:** the instance id that this datasource provides is
``iid-datasource-none``.

.. vi: textwidth=78