POST Workgroups/{workgroupName}/Assets
Purpose
Creates a new asset in the Workgroup referenced by name.
Required permissions
Asset Management (Read/Write).
URL parameters
workgroupName: Name of the Workgroup.
Request body
Content-Type: application/json
{ IPAddress: string, AssetName: string, DnsName: string, DomainName: string, MacAddress: string, AssetType: string, OperatingSystem: string }
Request body details
- IPAddress: (required) Asset IP address. Max string length is 45.
- AssetName: (optional) Asset name. If not given, a padded IP address is used. Max string length is 128.
- DnsName: (optional) Asset DNS name. Max string length is 255.
- DomainName: (optional) Asset domain name. Max string length is 64.
- MacAddress: (optional) Asset MAC address. Max string length is 128.
- AssetType: (optional) Asset type. Max string length is 64.
- OperatingSystem: (optional) Asset operating system. Max string length is 255.
Response body
Content-Type: application/json
{ WorkgroupID: int, AssetID: int, AssetName: string, DnsName: string, DomainName: string, IPAddress: string, MacAddress: string, AssetType: string, OperatingSystem: string, CreateDate: datetime, LastUpdateDate: datetime }
Response codes
201 - Request successful. Asset in response body.
For more information, please see Common response codes.