Searching assets
GET /api/v2/assets
Information about the software of assets from KSC is not stored in KUMA and is not shown in the response.
Access: General administrator, Tenant administrator, Tier 2 analyst, Tier 1 analyst, Junior analyst, Access to NCIRCC, Access to CII.
The "Access to shared resources" role is issued only for the Shared tenant; this tenant cannot have any assets, but it has categories. For this role, nothing is returned in the response.
Query parameters
Name | Data type | Mandatory | Description | Value example |
page | number | No | Page number. Starts with 1. The page size is 250 entries. If the parameter is not specified, the default value is 1. | 1 |
id | string | No | Asset ID. If the parameter is specified several times, then a list is generated and the logical OR operator is applied. | 00000000-0000-0000-0000-000000000000 |
TenantID | string | No | Asset tenant ID. If the parameter is specified several times, then a list is generated and the logical OR operator is applied. If the user does not have the required role in the specified tenant, then this tenant is ignored. | 00000000-0000-0000-0000-000000000000 |
name | string | No | Asset name. Case-insensitive regular expression (PCRE). | asset ^My asset$ |
fqdn | string | No | Asset FQDN. Case-insensitive regular expression (PCRE). | example.com |
ip | string | No | Asset IP address. Case-insensitive regular expression (PCRE). | 10.10 ^192.168.1.2$ |
mac | string | No | Asset MAC address. Case-insensitive regular expression (PCRE). | ^00:0a:95:9d:68:16$ |
Response
HTTP code: 200
Format: JSON
|
Possible errors
HTTP code | Description | message field value | details field value |
400 | Invalid value of the "page" parameter | invalid query parameter value | page |
500 | Any other internal errors | variable | variable |