Add new node name filter API¶
https://bugs.launchpad.net/ironic/+bug/1526319
This blueprint proposes adding a way to filter nodes in the API by their name (regex,wildcard).
GET /v1/nodes/?name_regex=<regexp_str> GET /v1/nodes/?name_wildcard=<wildcard_str>
Problem description¶
Current there is only api GET /v1/nodes/<node_name> to exactly retrieve the ironic node via node_name. However for customer, if regular and wildcard expressions filters are supported to retrieve the nodes via user input, that should be useful for user to filter nodes by name flexible, especially for the users who have a lot of baremetal nodes which are managed by ironic.
Possible use case is to support client bulk operations, such as to power off some nodes which are filtered out by node name regexp or wildcard, with single command.
Proposed change¶
Add new API:
GET /v1/nodes/?name_regex=<regexp_str>
GET /v1/nodes/?name_wildcard=<wildcard_str>
We support both BRE and ERE IEEE POSIX Regular expression standard[1].
And will add db api support, for different databases, there are different operators for regular expression:
postgresql: ‘~’
mysql: ‘REGEXP’
sqlite: ‘REGEXP’
So we will check the current database which ironic is using, and get the regular expression operator from the above map. If there is no such db in the above supporting map, will raise api exception to user and tell user the current database is not supported for this name regex query api.
For wildcard filter, all database can support, because will run with ‘LIKE’ SQL operator which is standard SQL.
Alternatives¶
Use node tags for client bulk operations.
Data model impact¶
None.
State Machine Impact¶
None.
REST API impact¶
Add new API ‘GET /v1/nodes/?name_regexp=<regexp_str>’, and ‘GET /v1/nodes/ ?name_wildcard=<wildcard_str>’, and bump API micro-version. Please see “Proposed change”.
Client (CLI) impact¶
Add new command that executes two new API:
ironic node-list –name-regex=<regexp_str>
ironic node-list –name-wildcard=<wildcard_str>
Have a similar modification to the OSC plugin.
RPC API impact¶
None.
Driver API impact¶
None.
Nova driver impact¶
None.
Ramdisk impact¶
N/A
Security impact¶
None
Other end user impact¶
None.
Scalability impact¶
None.
Performance Impact¶
None.
Other deployer impact¶
None.
Developer impact¶
None.
Implementation¶
Assignee(s)¶
- Primary assignee:
whaom
Work Items¶
Add new API ‘GET /v1/nodes/?name_regex=<regexp_str>’
Add new API ‘GET /v1/nodes/?name_wildcard=<wildcard_str>’
Add new ‘name_regex filter’ option for ironic node-list command.
Add new ‘name_widcard filter’ option for ironic node-list command.
Add new ‘name_regex filter’ option for the existing commands which take node id as input to support bulk operation.
Add new ‘name_widcard filter’ option for the existing commands which take node id as input to support bulk operation.
Dependencies¶
None.
Testing¶
Will add unit test code to cover the new api.
Upgrades and Backwards Compatibility¶
None.
Documentation Impact¶
Update API document adding a new API
References¶
[1] https://en.wikipedia.org/wiki/Regular_expression#Standards
