Develop > Developer Reference > Using APIs > Universal CMDB REST API > Reference > Get Data Layout

Get Data Layout

This call returns the data layout at the specified date for the CIs that have one of the IDs provided.

URL

/history/getDataLayout

Method

POST

Headers

Required: 

Authorization: Bearer <token>

Note <token> is the token that is returned by the Authentication call.

Example: 

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE0Njc5ODQ5MTcsImN1c3RvbWVyIjoxLCJ1c2VybmFtZSI6InN5c2FkbWluIn0.Ph8WHtzvpvfuH1j0CtwHqyBhX1uLlfhr0eQQ7m0_gT0

Request type

JSON

Response type

JSON

URL Parameters

Required: none

Optional: none

Payload

{
    "data": [
     
        {    
            "date": 1476365233608,

            "ciIDs": [
                "495a4faf96729548a2603046dbf7efd9",
                "476948c54e4a86e1a32bb83c41cdc7c5"
            ]
        },

         {
            "date" : 1476438324892,
            "ciIDs": [
                "4d08b8a5e349a7fdba5ba5ff60f47929",
                "476948c54e4a86e1a32bb83c41cdc7c5"
            ]
        },
        {
            "date" : 1476365784442,
            "ciIDs": [
                "476948c54e4a86e1a32bb83c41cdc7c5"
            ]
        }
    ],
    
    "layout" : [
        "name",
        "description",
        "bios_tag"
    ]
}

Success response

Response: 200

Content: 

{
    "history": [
        {
            "date": 1478699889366,
            "data": [
                {
                    "type": "node",
                    "isObject": true,
                    "dataId": "4a1c2ec8804ffa44aa2124de5921b8fe",
                    "properties": {
                        "name": "node1",
                        "description": "xxx"
                    }
                }
            ]
        }
    ]
}

Error response

Status: 404, 500, or 400

Content: 

{
  error: [string]
}

Example:

Code: 404

Content: 

{
   error: The server was not found or the value for changeType is not in the allowed domain.
}

Send Help Center feedback