Find inventories and nodes by tags

POST

https://example.itential.io/inventory_manager/v1/tags/search

POST

/inventory_manager/v1/tags/search

$ curl -X POST https://example.itential.io/inventory_manager/v1/tags/search \
>      -H "Content-Type: application/json" \
>      -u "<username>:<password>" \
>      -d '{}'

1 {
2   "status": "Success",
3   "result": {
4     "inventories": [
5       {
6         "name": "string",
7         "version": "2024-01-15T09:30:00Z",
8         "groups": [
9           "string"
10         ],
11         "description": "string",
12         "actions": [
13           {
14             "name": "string",
15             "action_type": "string",
16             "action_config": {},
17             "action_parameters": {},
18             "created_at": "2024-01-15T09:30:00Z",
19             "updated_at": "2024-01-15T09:30:00Z",
20             "created_by": "string",
21             "updated_by": "string"
22           }
23         ],
24         "tags": [
25           "string"
26         ],
27         "created_at": "2024-01-15T09:30:00Z",
28         "updated_at": "2024-01-15T09:30:00Z",
29         "created_by": "string",
30         "updated_by": "string"
31       }
32     ],
33     "nodes": [
34       {
35         "inventory_id": "string",
36         "name": "string",
37         "version": "2024-01-15T09:30:00Z",
38         "attributes": {},
39         "tags": [
40           "string"
41         ],
42         "created_at": "2024-01-15T09:30:00Z",
43         "updated_at": "2024-01-15T09:30:00Z",
44         "created_by": "string",
45         "updated_by": "string"
46       }
47     ],
48     "summary": {
49       "inventoriesFound": 1.1,
50       "nodesFound": 1.1,
51       "totalFound": 1.1
52     }
53   },
54   "error": "string"
55 }

Returns inventories and nodes that have the specified tags.

Authentication

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Request

request body

tagIdentifierslist of stringsOptional

optionsobjectOptional

Response

Resources grouped by type

statusstring

resultobject

errorstring

Errors

500

Internal Server Error