Create Or Update Asset
Creates or updates an asset with the specified details.
External Documentation
To learn more, visit the Rapid7 documentation.
Parameters
Parameter | Description |
---|---|
Addresses | All addresses discovered on the asset. For example: [ { "ip": "123.245.34.235", "mac": "12:34:56:78:90:AB" }, { "ip": "12.43.56.221", "mac": "12:34:A6:76:12:JH" } ] |
Asset Data Collection Date | The date the data was collected on the asset. |
Configurations | Configuration key-values pairs enumerated on the asset. For example: [ { "name": "First Configuration", "value": "The value 1" }, { "name": "Second Configuration", "value": "The value 2" } ] |
Description | The description of the source or collection of information on the asset. This description will appear in the history of the asset for future auditing purposes. |
Disable SSL | Enable this option to skip SSL verification of the server's certificate chain and host name. This may increase security vulnerabilities, but can be useful for testing or when custom verification is employed. |
Host Name | The host name (local or FQDN). |
Host Name Source | The source used to detect the host name. user indicates the host name source is user-supplied (e.g. in a site target definition). |
IP | The primary IPv4 or IPv6 address of the asset. |
Site ID | The ID of the site. |
Type | The type of asset. |
Example Output
{
"id": "1",
"links": [
{
"href": "https://hostname:3780/api/3/...",
"rel": "self"
}
]
}
Workflow Library Example
Create or Update Asset with Rapid7 and Send Results Via Email