System Information - SentinelHost Retrieve, Update, and Delete Methods

URI

https://164.99.19.131:8443/SentinelRESTServices/objects/host/{Id}

Supported Methods

GET

PUT

DELETE

GET

Authentication

Authentication Types

X-SAML

Sentinel Permissions Needed

Supported Formats

Response

application/json

URL Parameters

None.

Success Codes

200 OK
204 No Content

Fault Codes

400 Bad Request
403 Forbidden
404 Not Found
500 Internal Server Error
503 Service Unavailable

Response Data

Object type: host
Needs description.
Field	Description
collector-mgrs	Needs description.
createdate	The date and time when the object was created.
creator	The URL of the Sentinel User object that represents the creator of the object.
hostname	Needs description.
ip-addr	Needs description.
meta	The metadata for an object, including the object type name and the URL reference to the object. Definition
moddate	The date and time when the object was last modified.
modifier	The URL of the Sentinel User object that represents the last modifier of the object.
name	Needs description.
os-name	Needs description.
os-ver	Needs description.
sentinel-id	Needs description.

Object type: meta
The metadata for an object, including the object type name and the URL reference to the object.
Field	Description
@href	The URL reference to the object.
type	The name of the object type

Sample Request

GET https://164.99.19.131:8443/SentinelRESTServices/objects/host/79600390-9B73-102E-A3E2-001676E4A757

Sample Response for application/json

Status: 200

{
   "meta":{
      "type":"host",
      "@href":"https://164.99.19.131:8443/SentinelRESTServices/objects/host/79600390-9B73-102E-A3E2-001676E4A757"
   },
   "moddate":"2012-04-25T13:33:44.612Z",
   "name":"Wildebeest",
   "createdate":"2012-04-25T13:33:44.612Z",
   "hostname":"Wildebeest",
   "sentinel-id":"79600390-9B73-102E-A3E2-001676E4A757",
   "os-ver":"Wildebeest",
   "os-name":"Wildebeest",
   "ip-addr":"10.0.0.1",
   "collector-mgrs":{
      "@href":"https://164.99.19.131:8443/SentinelRESTServices/objects/collectormgr?query=SentinelHostId.e79600390-9B73-102E-A3E2-001676E4A757"
   }
}

PUT

Authentication

Authentication Types

X-SAML

Sentinel Permissions Needed

Supported Formats

Request

application/json

URL Parameters

None.

Success Codes

204 No Content

Fault Codes

400 Bad Request
403 Forbidden
404 Not Found
500 Internal Server Error
503 Service Unavailable

Request Data

Object type: host
Needs description.
Field	Required	Description
collector-mgrs	false	Needs description.
hostname	false	Needs description.
ip-addr	false	Needs description.
name	true	Needs description.
os-name	false	Needs description.
os-ver	false	Needs description.
sentinel-id	true	Needs description.

Object type: meta
The metadata for an object, including the object type name and the URL reference to the object.
Field	Required	Description
@href	false	The URL reference to the object.
type	false	The name of the object type

Sample Request

PUT https://164.99.19.131:8443/SentinelRESTServices/objects/host/79600390-9B73-102E-A3E2-001676E4A757

{
   "name":"Wildebeest",
   "hostname":"Wildebeest",
   "sentinel-id":"79600390-9B73-102E-A3E2-001676E4A757",
   "os-ver":"Wildebeest",
   "os-name":"Wildebeest",
   "ip-addr":"10.0.0.1",
   "collector-mgrs":{
      "@href":"https://164.99.19.131:8443/SentinelRESTServices/objects/collectormgr?query=SentinelHostId.e79600390-9B73-102E-A3E2-001676E4A757"
   }
}

Sample Response for application/json

Status: 200

DELETE

Authentication

Authentication Types

X-SAML

Sentinel Permissions Needed

URL Parameters

None.

Success Codes

204 No Content

Fault Codes

400 Bad Request
403 Forbidden
404 Not Found
500 Internal Server Error
503 Service Unavailable

Sample Request

DELETE https://164.99.19.131:8443/SentinelRESTServices/objects/host/79600390-9B73-102E-A3E2-001676E4A757

Back to main API page