Identities - Trust Retrieve, Update, and Delete Methods

URI

https://164.99.19.131:8443/SentinelRESTServices/objects/trust/{TrustId}

Supported Methods

GET
PUT
DELETE
GET

Authentication

Authentication Types
Sentinel Permissions Needed

Supported Formats

Response

URL Parameters

None.

Success Codes

Fault Codes

Response Data

Object type: trust
An Trust represents an item in an IT system that grants permissions to a user account in the IT system.
FieldDescription
accountsA list of URLs of Sentinel Account objects that reference the Trust object.
cidThe customer ID of the MSSP customer to which the external trust object belongs.
createdateThe date and time when the object was created.
creatorThe URL of the Sentinel User object that represents the creator of the object.
currentIf true, the Sentinel Trust object contains current data about the external trust object, as opposed to superceded data.
descA prose description of the Trust object.
metaThe metadata for an object, including the object type name and the URL reference to the object. Definition
moddateThe date and time when the object was last modified.
modifierThe URL of the Sentinel User object that represents the last modifier of the object.
nameThe name of the external trust object in the owning IT system.
srcidThe uniquely identifying information of the external trust object in the originating system.
sysThe identifier of the IT system from which the external trust information was obtained.
typeThe URL of the TrustType object that defines the type of trust information represented by the Sentinel Trust object.
Object type: meta
The metadata for an object, including the object type name and the URL reference to the object.
FieldDescription
@hrefThe URL reference to the object.
typeThe name of the object type

Sample Request

GET https://164.99.19.131:8443/SentinelRESTServices/objects/trust/42
Sample Response for application/json
Status: 200
{
   "meta":{
      "type":"trust",
      "@href":"https://164.99.19.131:8443/SentinelRESTServices/objects/trust/42"
   },
   "moddate":"2012-04-25T13:33:44.657Z",
   "desc":"Wildebeest",
   "sys":"Wildebeest",
   "name":"Wildebeest",
   "createdate":"2012-04-25T13:33:44.657Z",
   "current":true,
   "srcid":"Wildebeest",
   "cid":42,
   "accounts":[
      "https://164.99.19.131:8443/SentinelRESTServices/objects/account/42"
   ]
}
PUT

Authentication

Authentication Types
Sentinel Permissions Needed

Supported Formats

Request

URL Parameters

None.

Success Codes

Fault Codes

Request Data

Object type: trust
An Trust represents an item in an IT system that grants permissions to a user account in the IT system.
FieldRequiredDescription
accountsfalseA list of URLs of Sentinel Account objects that reference the Trust object.
cidtrueThe customer ID of the MSSP customer to which the external trust object belongs.
currentfalseIf true, the Sentinel Trust object contains current data about the external trust object, as opposed to superceded data.
descfalseA prose description of the Trust object.
nametrueThe name of the external trust object in the owning IT system.
srcidfalseThe uniquely identifying information of the external trust object in the originating system.
systrueThe identifier of the IT system from which the external trust information was obtained.
typefalseThe URL of the TrustType object that defines the type of trust information represented by the Sentinel Trust object.

Object type: meta
The metadata for an object, including the object type name and the URL reference to the object.
FieldRequiredDescription
@hreffalseThe URL reference to the object.
typefalseThe name of the object type

Sample Request

PUT https://164.99.19.131:8443/SentinelRESTServices/objects/trust/42
{
   "desc":"Wildebeest",
   "sys":"Wildebeest",
   "name":"Wildebeest",
   "current":true,
   "srcid":"Wildebeest",
   "cid":42,
   "accounts":[
      "https://164.99.19.131:8443/SentinelRESTServices/objects/account/42"
   ]
}
Sample Response for application/json
Status: 200

DELETE

Authentication

Authentication Types
Sentinel Permissions Needed

URL Parameters

None.

Success Codes

Fault Codes

Sample Request

DELETE https://164.99.19.131:8443/SentinelRESTServices/objects/trust/42