meta data for this page
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
assets [2023/02/11 09:28] – created - external edit 127.0.0.1 | assets [2024/08/29 18:07] (current) – Mention asset transfers and history wrongecho | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Assets ====== | ||
+ | Manage your client' | ||
+ | |||
+ | {{assets.png? | ||
+ | |||
+ | The following information can be recorded for each asset: | ||
+ | |||
+ | * Name | ||
+ | * Type (Desktop/ | ||
+ | * Make/ | ||
+ | * Model | ||
+ | * Serial Number | ||
+ | * OS | ||
+ | * IP & MAC addresses | ||
+ | * Status (Prep, deployed, etc) | ||
+ | * Vendor | ||
+ | * Purchase, install, and warranty dates | ||
+ | * Notes | ||
+ | |||
+ | Assets can also be associated with other data in ITFlow, such as: | ||
+ | |||
+ | * Clients | ||
+ | * Locations | ||
+ | * Networks | ||
+ | * Logins | ||
+ | * Tickets | ||
+ | * Services | ||
+ | |||
+ | Assets can be transferred between clients. On the backend this involves the asset being archived and most data being copied to the new asset under the new client. Transferring an asset changes it's ID. | ||
+ | |||
+ | //Note: The asset history tab is currently based on audit logs. If you adjust the audit log retention, older asset events may disappear. We plan to incorporate recording asset activities (including user assignment and transfers) into a dedicated asset history table at a later date.// | ||
+ | |||
+ | ===== Import & Export CSV ===== | ||
+ | |||
+ | * You can easily export assets for a client using the Export button. | ||
+ | |||
+ | |||
+ | * You can import a list of assets for a client using the Import button and uploading a CSV | ||
+ | * Headings: Name, Description, | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | |||
+ | ===== API ===== | ||
+ | ''/ | ||
+ | |||
+ | ==== Read ==== | ||
+ | Retrieve asset information - ''/ | ||
+ | |||
+ | * Default / No params - Returns all assets | ||
+ | * asset_id - Specific asset ID from the ITFlow database | ||
+ | * asset_name - Asset Name | ||
+ | * asset_type - Type of asset (e.g. Laptop, Desktop, Server, etc) | ||
+ | * asset_serial - Asset Serial Number | ||
+ | * client_id - Returns all assets for a specific client | ||
+ | |||
+ | |||
+ | Invoke-RestMethod -Uri " | ||
+ | | ||
+ | | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | [...] | ||
+ | |||
+ | ==== Create ==== | ||
+ | Create a new asset - ''/ | ||
+ | |||
+ | Specify parameters as below. The new asset ID will be returned. | ||
+ | |||
+ | |||
+ | $uri = " | ||
+ | | ||
+ | $body = @" | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | "@ | ||
+ | | ||
+ | | ||
+ | Invoke-RestMethod -Method Post -Uri $uri -Body $body | ||
+ | | ||
+ | success count data | ||
+ | ------- ----- ---- | ||
+ | True 1 | ||
+ | |||
+ | ==== Update ==== | ||
+ | Update attributes of an existing asset - ''/ | ||
+ | |||
+ | Only parameters specified are changed, remove parameters you don't want to modify. True/False is returned. | ||
+ | |||
+ | $uri = " | ||
+ | | ||
+ | $body = @" | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | "@ | ||
+ | | ||
+ | | ||
+ | Invoke-RestMethod -Method Post -Uri $uri -Body $body | ||
+ | | ||
+ | success count | ||
+ | ------- ----- | ||
+ | True 1 | ||
+ | |||
+ | |||
+ | ==== Delete ==== | ||
+ | Delete an asset - ''/ | ||
+ | |||
+ | $uri = " | ||
+ | | ||
+ | $body = @" | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | "@ | ||
+ | | ||
+ | | ||
+ | Invoke-RestMethod -Method Post -Uri $uri -Body $body | ||
+ | | ||
+ | success count | ||
+ | ------- ----- | ||
+ | True 1 | ||