External DocumentationTo learn more, visit the Device 42 documentation.
Basic Parameters
| Parameter | Description |
|---|---|
| Back Connection Type | Select the type of the back connection for the asset. |
| Name | The name of the asset. |
| Service Level | The service level of the asset. Note: In Service, Spare, Not in Service are pre-defined options, you can also use custom ones. |
| Type | The type of the new asset. You can add new type using Update Asset action. |
Advanced Parameters
| Parameter | Description |
|---|---|
| Asset Number | An asset number of a device to filter the results by. |
| Back Image ID | The ID of the back image file to add to the asset. |
| Back Image Name | The name of the back image file - use instead of Image File ID. |
| Building | The building name for the asset. |
| Customer | The name of the customer to filter the results by. |
| Depth | The depth to set to the asset. Defaults to Half, insert full to override. |
| Device ID | The ID of the device to add to the asset. |
| Device IDs | A comma-separated list of existing device IDs to attach to the asset. |
| Device Name | The name of the device. Note: required in cases that switchport ID is not used. |
| Image File ID | The ID of the image file to add to the asset. |
| Image File Name | The name of the image file - use instead of Image File ID. |
| In Service | Select whether the asset is in service. |
| Location | The location of the asset. |
| Module Host | The name of the module host to add to the asset (must be unique). |
| Module Host ID | The ID of the module host to add to the asset. |
| New Object Category | New controlling access category. Use it to change category on a device if its already in use. |
| Notes | The notes to add to the created asset. |
| Numbering Start From | The number to start from for patch panel ports. Defaults to 1. |
| Object Category | Controlling access category. Can be in use in cases that multitenancy is on. For example: Prod_East. |
| Orientation | The orientation of the asset - set to Back if back facing, otherwise ignored. |
| Patch Panel Model | The name of the patch panel model to add to the asset (use instead of ID). |
| Patch Panel Model ID | The ID of the patch panel model to add to the asset. |
| Patch Panel Module Model | The name of the patch panel module model to add to the asset (use instead of ID). |
| Patch Panel Module Model ID | The ID of the patch panel module model to add to the asset. |
| Rack | Name of an existing rack to add the asset to. |
| Rack ID | The ID of the rack to add the asset to. |
| Reserved | Select whether the asset is reserved on the rack. |
| Serial Number | Serial number of a device to filter the results by. |
| Size | The size to add to the asset. Required if adding asset to rack. |
| Slot Number | The number of the slot on rack. |
| Start At | The timestamp to add to the asset. Required if adding asset to rack. |
| Storage Room | The name of the storage room. |
| Storage Room ID | The ID of the storage room of the asset. |
| Tags | A comma-separated list of tags to filter results by (OR filter - return results that include at least one of the tags). |
| Tags Remove | A comma-separated list of tags to remove. |
| Tap Module Host | The name of the tap module host. |
| Tap Module Host ID | The ID of the tap module host. |
| Tap Module Model | The name of the tap module model. |
| Tap Module Model ID | The ID of the tap module model. |
| Vendor | The name of the vendor of the asset. |
| Where | The location in the rack. |
| Width Ratio | The width ratio to set to the asset. Defaults to 1. |
| X Pos | The position within the U slot in increments of 252. Valid range is 0-2520. |
Example Output
{
"msg": [
[
"asset added/edited.",
54,
"test_api",
true,
true
]
],
"code": 0
}
Workflow Library Example
Create Asset with Device 42 and Send Results Via Email