URL

POST https://{api-url}/api/v2/tenants/{tenantId}/resources/{resourceId}

Sample URLs

https://{api-url}/api/v2/tenants/client_12/resources/612acfb0-6890-4d52-950b-1c4ec17a7248

Parameters

All fields are optional except name and macAddress (oobInterfaceCards):

FieldData TypeDescription
aliasNameStringAnother name of a resource.
alternateIPStringGateway uses alternate IP to discover a resource when populated.
extResourceIdStringAttach third-party integration ID.
resourceNetworkInterface
  • ipAddress
  • macAddress
StringDetails of network interface.
managementProfileStringName of management profile of a resource that is managed.
resourceTypeStringType of resource.
Example: server
systemUIDStringUnique ID of system.
serialNumberStringSerial number of resource.
providerTypeStringType of provider.
providerUIDStringUnique ID of provider.
  1. String
  2. Integer
  3. Integer
  4. Integer
  5. Integer
  1. Name of the disk drive.
  2. Define a warning threshold value for disk utilization. A warning alert is triggered when the utilization exceeds the threshold value.
    Example: 60
  3. Define a critical threshold value for disk utilization. A critical alert is triggered when the utilization exceeds the threshold value. The utilization threshold value is represented as a percentage.
  4. Define a warning threshold value for free disk space. A warning alert is triggered when the free disk space exceeds the threshold value.
    Example: 40
  5. Define a critical threshold value for free disk space. A critical alert is triggered when the free disk space exceeds the threshold value.
    Example: 80.
    The free disk threshold value is represented in MB.

Utilization and free disk space threshold values should be between 0 and 100.
oobInterfaceCards
  • name
  • macAddress
  • url
  • oobVersion
  • description
  • accessInfo
  • accessInfoIpV4
  • remoteAccessType
  • port
  • make
  • model
StringOOB interface card details.

Sample request

{
	"aliasName": "aliasServerName",
	"alternateIP": "4.2.2.2",
        "extResourceId":"67035"
	"managementProfile": "Gateway Profile",
	"resourceNetworkInterface": [{
			"ipAddressType": "STATIC",
			"macAddress": "5G:7H:HN:12:8H:D7",
			"default": 1,
			"ipAddress": "121.156.43.12"
		},
		{
			"ipAddressType": "STATIC",
			"macAddress": "00:0C:23:C5:D6:H7",
			"default": 0,
			"ipAddress": "161.32.556.56"
		},
		{
			"ipAddressType": "DHCP",
			"macAddress": "00:0C:32:B7:D8:54",
			"default": 0,
			"ipAddress": "161.11.132.21"
		}
	],
	"logicalDiskDrives": [{
			"name": "/",
			"utilizationWarningThreshold": 85,
			"utilizationCriticalThreshold": 90,
			"freeDiskWarningThreshold": 0,
			"freeDiskCriticalThreshold": 0
		},
		{
			"name": "/boot/efi",
			"utilizationWarningThreshold": 85,
			"utilizationCriticalThreshold": 90,
			"freeDiskWarningThreshold": 0,
			"freeDiskCriticalThreshold": 0
		}
	],
	"oobInterfaceCards": [{
		"name": "Controller 1",
		"macAddress": "hj:12:hb:32:vg:sa",
		"description": "Server controller details",
		"url": "https://www.myorganization.com/",
		"oobVersion": "7.5",
		"accessInfo": "source-ip location",
		"accessInfoIpV4": "121.32.21.112",
		"remoteAccessType": "SSH",
		"port": 443,
		"make": "Cisco Routers",
		"model": "Cisco 890 Series"
	}]
}

Sample response

Null