MyCSI API - Documentation

POST CMDB/DataChange/{id}

Method used via a CMDB to update CSI Data on an existing asset.

Request Information

URI Parameters

Name	Description	Type	Additional information
id	Security token provided via the Authentication method.	globally unique identifier	Required

Body Parameters

CSI Data to update

CMDB_DataChange

Name	Description	Type	Additional information
AssetId	Internal CSI identifier of the Asset.	integer	Required
DataChangeType	Enum defining the type of data change if no value is passed a Data Change Type of All is used.	DataChangeType	Required
CDF01	Customer Defined Field - 1.	string	Max length: 50
CDF02	Customer Defined Field - 2.	string	Max length: 50
CDF03	Customer Defined Field - 3.	string	Max length: 50
CDF04	Customer Defined Field - 4.	string	Max length: 50
CDF05	Customer Defined Field - 5.	string	Max length: 50
CDF06	Customer Defined Field - 6.	string	Max length: 50
CDF07	Customer Defined Field - 7.	string	Max length: 50
CDF08	Customer Defined Field - 8.	string	Max length: 50
CDF09	Customer Defined Field - 9.	string	Max length: 50
CDF10	Customer Defined Field - 10.	string	Max length: 50
CMDB_ID	Unique identifier of Asset, provided by the calling Content Management Database.	string	Max length: 256
Comment	Customer's description of the asset.	string	Max length: 256
CustomerReference	Information defined by the customer for the purpose of Invoice reference.	string	Max length: 100
NonManaged	Enum defining what type units are to be updated.	NonManaged	None.
Schedule	Schedule to which the Asset belongs.	string	Max length: 32
Serial	Serial number of the Asset.	string	Max length: 64
SiteAddress	Site address of the Asset.	string	Max length: 256
SiteAddress2	Secondary site address of the Asset.	string	Max length: 256
SiteCity	Site city of the Asset.	string	Max length: 256
SiteCountryCode	Site country of the Asset.	string	Max length: 3
SitePostalCode	Site postal code of the Asset.	string	Max length: 10
SiteState	Site state of the Asset.	string	Max length: 256

Request Formats

application/json, text/json

Sample:

{
  "CMDB_ID": "sample string 1",
  "AssetId": 2,
  "Serial": "sample string 3",
  "Schedule": "sample string 4",
  "CustomerReference": "sample string 5",
  "SiteAddress": "sample string 6",
  "SiteAddress2": "sample string 7",
  "SiteCity": "sample string 8",
  "SiteState": "sample string 9",
  "SitePostalCode": "sample string 10",
  "SiteCountryCode": "sample string 11",
  "CDF01": "sample string 12",
  "CDF02": "sample string 13",
  "CDF03": "sample string 14",
  "CDF04": "sample string 15",
  "CDF05": "sample string 16",
  "CDF06": "sample string 17",
  "CDF07": "sample string 18",
  "CDF08": "sample string 19",
  "CDF09": "sample string 20",
  "CDF10": "sample string 21",
  "Comment": "sample string 22",
  "DataChangeType": "All",
  "NonManaged": 1
}

application/octet-stream

Sample:

{"CMDB_ID":"sample string 1","AssetId":2,"Serial":"sample string 3","Schedule":"sample string 4","CustomerReference":"sample string 5","SiteAddress":"sample string 6","SiteAddress2":"sample string 7","SiteCity":"sample string 8","SiteState":"sample string 9","SitePostalCode":"sample string 10","SiteCountryCode":"sample string 11","CDF01":"sample string 12","CDF02":"sample string 13","CDF03":"sample string 14","CDF04":"sample string 15","CDF05":"sample string 16","CDF06":"sample string 17","CDF07":"sample string 18","CDF08":"sample string 19","CDF09":"sample string 20","CDF10":"sample string 21","Comment":"sample string 22","DataChangeType":"All","NonManaged":1}

application/xml, text/xml

Sample:

<CMDB_DataChange xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CSI.MyCSI.WebAPI.Models.CMDB">
  <AssetId>2</AssetId>
  <CDF01>sample string 12</CDF01>
  <CDF02>sample string 13</CDF02>
  <CDF03>sample string 14</CDF03>
  <CDF04>sample string 15</CDF04>
  <CDF05>sample string 16</CDF05>
  <CDF06>sample string 17</CDF06>
  <CDF07>sample string 18</CDF07>
  <CDF08>sample string 19</CDF08>
  <CDF09>sample string 20</CDF09>
  <CDF10>sample string 21</CDF10>
  <CMDB_ID>sample string 1</CMDB_ID>
  <Comment>sample string 22</Comment>
  <CustomerReference>sample string 5</CustomerReference>
  <DataChangeType>All</DataChangeType>
  <NonManaged>All</NonManaged>
  <Schedule>sample string 4</Schedule>
  <Serial>sample string 3</Serial>
  <SiteAddress>sample string 6</SiteAddress>
  <SiteAddress2>sample string 7</SiteAddress2>
  <SiteCity>sample string 8</SiteCity>
  <SiteCountryCode>sample string 11</SiteCountryCode>
  <SitePostalCode>sample string 10</SitePostalCode>
  <SiteState>sample string 9</SiteState>
</CMDB_DataChange>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

ResultModel

Name	Description	Type	Additional information
ErrorMessage	Optional error message provided by the method call.	string	None.
Message	Optional message provided by the method call.	string	None.
StatusCode	The HTTP Status Code of the method call.	HttpStatusCode	None.
Success	Boolean flag indicating the success or failure of the method call.	boolean	None.

Response Formats

application/json, text/json

Sample:

{
  "Success": true,
  "Message": "sample string 2",
  "ErrorMessage": "sample string 3",
  "StatusCode": 100
}

application/octet-stream

Sample:

{"Success":true,"Message":"sample string 2","ErrorMessage":"sample string 3","StatusCode":100}

application/xml, text/xml

Sample:

<ResultModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CSI.MyCSI.WebAPI.Models.Shared">
  <ErrorMessage>sample string 3</ErrorMessage>
  <Message>sample string 2</Message>
  <StatusCode>Continue</StatusCode>
  <Success>true</Success>
</ResultModel>