Bug #8192
closedBetter document Node Api: include detail always returns "default"
Description
As documented here:
https://www.rudder-project.org/rudder-api-doc/#api-Nodes-acceptedNodeDetails
include
Level of information to include from the node inventory. Some base levels are defined (minimal, default, full). you can add fields you want by adding them to the list, possible values are keys from json answer.
Default value: default
Using this description and the goal to only retrieve one specific "key" of the node info (like ipAddresses or properties) I tried to use "?indclude=os", but I got the "default" set regardless.
It only worked if I used "?include=minimal,os", so only the minimal information was returned in addition to the key I wanted to fetch, but the documentation does not show any clue of that this behavior can be achieved this way, nor does is state how to fetch only one key.
Please either adjust the documentation to reflect this behavior or implement something like "?includeOnly=<keylist>", so one can fine-tune which keys have to be returned, and that only those are actually returned.
Updated by François ARMAND over 8 years ago
Thanks fo rthe report, clearly the documentation must be updated with your use case, and it must be clearly stated that you always get at least minimal fields.
Updated by François ARMAND over 8 years ago
- Related to User story #8193: Add an option to be able to be more selective about node API returned content added
Updated by François ARMAND over 8 years ago
- Subject changed from Api include detail always returns "default" to Better document Node Api: include detail always returns "default"
Changing the title to make it clear that that ticket is for documentation, and #8193 will be for code.
Updated by François ARMAND over 8 years ago
- Assignee changed from François ARMAND to Vincent MEMBRÉ
:)
Updated by François ARMAND over 8 years ago
- Translation missing: en.field_tag_list set to Quick and important, Sponsored, Next minor release
Updated by Vincent MEMBRÉ over 8 years ago
- Status changed from New to In progress
Updated by Vincent MEMBRÉ over 8 years ago
- Status changed from In progress to Pending technical review
- Assignee changed from Vincent MEMBRÉ to François ARMAND
- Pull Request set to https://github.com/Normation/rudder-api-doc/pull/29
Updated by Vincent MEMBRÉ over 8 years ago
- Status changed from Pending technical review to Pending release
- % Done changed from 0 to 100
Applied in changeset rudder-api-doc|5780677a269575d0abb6cb9359db8732c3ee787d.
Updated by Vincent MEMBRÉ over 8 years ago
- Status changed from Pending release to Released
This bug has been fixed in Rudder 3.0.16, 3.1.10 and 3.2.3 which were released on 2016-06-01, but not announced.
- 2.11: Changelog
- 3.0: Changelog
- 3.1: Changelog
- 3.2: Changelog
- Download: https://www.rudder-project.org/site/get-rudder/downloads/
Updated by Benoît PECCATTE over 7 years ago
- Found in version(s) old deleted (
3.1.8)