salt.modules.data

Manage a local persistent data structure that can hold any arbitrary data specific to the minion

salt.modules.data.cas(key, value, old_value)

Check and set a value in the minion datastore

CLI Example:

salt '*' data.cas <key> <value> <old_value>
salt.modules.data.clear()

Clear out all of the data in the minion datastore, this function is destructive!

CLI Example:

salt '*' data.clear
salt.modules.data.dump(new_data)

Replace the entire datastore with a passed data structure

CLI Example:

salt '*' data.dump '{'eggs': 'spam'}'
salt.modules.data.get(key, default=None)

Get a (list of) value(s) from the minion datastore

New in version Beryllium.

CLI Example:

salt '*' data.get <key(s)>
salt.modules.data.getval(key)

Get a value from the minion datastore

Deprecated since version Beryllium: Use get instead

CLI Example:

salt '*' data.getval <key>
salt.modules.data.getvals(*keylist)

Get values from the minion datastore

Deprecated since version Beryllium: Use get instead

CLI Example:

salt '*' data.getvals <key> [<key> ...]
salt.modules.data.has_key(key)

Check if key is in the minion datastore

New in version Beryllium.

CLI Example:

salt '*' data.has_key <mykey>
salt.modules.data.items()

Get items from the minion datastore

New in version Beryllium.

CLI Example:

salt '*' data.items
salt.modules.data.keys()

Get all keys from the minion datastore

New in version Beryllium.

CLI Example:

salt '*' data.keys
salt.modules.data.load()

Return all of the data in the minion datastore

CLI Example:

salt '*' data.load
salt.modules.data.pop(key, default=None)

Pop (return & delete) a value from the minion datastore

New in version 2015.5.2.

CLI Example:

salt '*' data.pop <key> "there was no val"
salt.modules.data.update(key, value)

Update a key with a value in the minion datastore

CLI Example:

salt '*' data.update <key> <value>
salt.modules.data.values()

Get values from the minion datastore

New in version Beryllium.

CLI Example:

salt '*' data.values