Application Program Interface (API)

Authentication

In order to call the CoreOne Application Program Interface (API), an Access Token is required. More information can be found in the following article:

Solve Access Token

List the machines

All active machines are listed, with all configured attribute values.

Standard Properties

These properties are always present, regardless of the machine type attribute configuration.

Property	Description

Property	Description
Id	Database identifier
Name	Machine name
Description	Machine description
CreationDate	Internal creation date
State	The status of the machine
MachineType	The type of machine
NextPatchRunDefinitionName	The name of the next patch run
NextPatchRunStartDate	The date of the next patch run
NextPatchRunState	The status of the patch run
LastSuccessfulPatchRunDate	The date of the last successful patch run

Dynamic properties

The dynamic properties are compiled based on the machine type attribute configuration.

For each configured attribute, a new property is added, with the name of the attribute but without spaces.

For example:

Attribute Name Active Directory GUI → Property Name ActiveDirectoryGUI

API call

List all machines with the machine type

URL: {{APIURL}}/Machines/?$expand=MachineType

Result:

Example

{
    "@odata.context": "https://localhost:8000/api/$metadata#Machines",
    "value": [
        {
            "Id": 1,
            "Name": "Mapo-PC",
            "Description": "PC von Mapo",
            "CreationDate": "2016-09-06T14:50:01+02:00",
            "State": "Active",
            "LastSuccessfulPatchRunDate": null,
            "NextPatchRunDefinitionName": "Test Patchlauf",
            "NextPatchRunStartDate": "2018-12-04T08:00:00+01:00",
            "NextPatchRunState@odata.type": "#SharedContracts.DmcoreService.Skynet.ObjectDefinitions.ObjectState",
            "NextPatchRunState": "None",
            "MachineType": {
                "@odata.type": "#CoreOperations.SkynetApi.MachineType.MachineTypeApiDataContract",
                "State": "Active",
                "SystemType": "WindowsServer",
                "TargetSystemId": 25,
                "TargetNetworkId": 1,
                "Id": 1,
                "Name": "Internal"
            }
        },
        {
            "Id": 2,
            "Name": "TFS Server",
            "Description": "Server für TFS",
            "CreationDate": "2016-09-06T14:50:01+02:00",
            "State": "Active",
            "LastSuccessfulPatchRunDate": null,
            "NextPatchRunDefinitionName": "Test Patchlauf",
            "NextPatchRunStartDate": "2018-12-04T20:00:00+01:00",
            "NextPatchRunState@odata.type": "#SharedContracts.DmcoreService.Skynet.ObjectDefinitions.ObjectState",
            "NextPatchRunState": "None",
            "MachineType": {
                "@odata.type": "#CoreOperations.SkynetApi.MachineType.MachineTypeApiDataContract",
                "State": "Active",
                "SystemType": "WindowsServer",
                "TargetSystemId": 25,
                "TargetNetworkId": 1,
                "Id": 1,
                "Name": "Internal"
            }
        },
        {
            "Id": 4,
            "Name": "Oracle Server",
            "Description": "Server von Roger mit der Oracle DB",
            "CreationDate": "2016-09-06T14:50:01+02:00",
            "State": "Active",
            "LastSuccessfulPatchRunDate": null,
            "NextPatchRunDefinitionName": "Test Patchlauf",
            "NextPatchRunStartDate": "2018-12-04T08:00:00+01:00",
            "NextPatchRunState@odata.type": "#SharedContracts.DmcoreService.Skynet.ObjectDefinitions.ObjectState",
            "NextPatchRunState": "None",
            "MachineType": {
                "@odata.type": "#CoreOperations.SkynetApi.MachineType.MachineTypeApiDataContract",
                "State": "Active",
                "SystemType": "WindowsServer",
                "TargetSystemId": 25,
                "TargetNetworkId": 1,
                "Id": 1,
                "Name": "Internal"
            }
        },
        {
            "Id": 6,
            "Name": "CoreOne W2008R2",
            "Description": "AWS CoreOne Server",
            "CreationDate": "2016-12-05T10:58:48+01:00",
            "State": "Active",
            "ActiveDirectoryGUID": "8704dce5-ccaf-42b1-b793-e70238dccac1",
            "LastSuccessfulPatchRunDate": null,
            "MachineIPAddress": "10.10.12.201",
            "NextPatchRunDefinitionName": null,
            "NextPatchRunStartDate": null,
            "NextPatchRunState@odata.type": "#SharedContracts.DmcoreService.Skynet.ObjectDefinitions.ObjectState",
            "NextPatchRunState": "None",
            "MachineType": {
                "@odata.type": "#CoreOperations.SkynetApi.MachineType.MachineTypeApiDataContract",
                "State": "Active",
                "SystemType": "WindowsServer",
                "TargetSystemId": 2,
                "TargetNetworkId": 2,
                "Id": 2,
                "Name": "AWS Windows"
            }
        },
        {
            "Id": 7,
            "Name": "RedHat Linux",
            "Description": "AWS RedHat Linux Server",
            "CreationDate": "2016-12-05T10:58:48+01:00",
            "State": "Active",
            "LastSuccessfulPatchRunDate": null,
            "MachineIPAddress": "10.10.11.101",
            "NextPatchRunDefinitionName": null,
            "NextPatchRunStartDate": null,
            "NextPatchRunState@odata.type": "#SharedContracts.DmcoreService.Skynet.ObjectDefinitions.ObjectState",
            "NextPatchRunState": "None",
            "MachineType": {
                "@odata.type": "#CoreOperations.SkynetApi.MachineType.MachineTypeApiDataContract",
                "State": "Active",
                "SystemType": "UnixServer",
                "TargetSystemId": 11,
                "TargetNetworkId": 2,
                "Id": 3,
                "Name": "AWS Linux"
            }
        },
        {
            "Id": 8,
            "Name": "Test Machine",
            "Description": "Active Directory Test Machine",
            "CreationDate": "2018-05-04T09:37:29+02:00",
            "State": "Active",
            "ActiveDirectoryGUID": "b094c75f-f1ec-4c1d-baa5-3c13d713f3fb",
            "LastSuccessfulPatchRunDate": null,
            "MachineIPAddress": "10.20.20.03",
            "NextPatchRunDefinitionName": null,
            "NextPatchRunStartDate": null,
            "NextPatchRunState@odata.type": "#SharedContracts.DmcoreService.Skynet.ObjectDefinitions.ObjectState",
            "NextPatchRunState": "None",
            "MachineType": {
                "@odata.type": "#CoreOperations.SkynetApi.MachineType.MachineTypeApiDataContract",
                "State": "Active",
                "SystemType": "WindowsServer",
                "TargetSystemId": 2,
                "TargetNetworkId": 2,
                "Id": 2,
                "Name": "AWS Windows"
            }
        },
        {
            "Id": 9,
            "Name": "TestMachine",
            "Description": "",
            "CreationDate": "2018-11-28T10:46:44+01:00",
            "State": "Active",
            "\tOperating-System-Version": null,
            "ActiveDirectoryGUID": "b094c75f-f1ec-4c1d-baa5-3c13d713f3fb",
            "Common-Name": "TestMachine",
            "Display-Name": "TestMachine",
            "DNS-Host-Name": "TestMachine@itsense.test",
            "FQDN": "TestMachine@itsense.test",
            "ManagedBy(SID)": "",
            "ManagerSID": "",
            "Operating-System": null,
            "Operating-System-Hotfix": null,
            "Operating-System-Service-Pack": null,
            "OrganizationUnitPath": "CN=Computers",
            "OrganizationUnitPathWithDefinedValues": null,
            "MachineType": {
                "@odata.type": "#CoreOperations.SkynetApi.MachineType.MachineTypeApiDataContract",
                "State": "Active",
                "SystemType": "WindowsServer",
                "TargetSystemId": 2,
                "TargetNetworkId": 2,
                "Id": 500000,
                "Name": "Test AD Server"
            }
        },
        {
            "Id": 10,
            "Name": "TestMapoComputer25",
            "Description": "",
            "CreationDate": "2018-11-28T10:46:45+01:00",
            "State": "Active",
            "\tOperating-System-Version": null,
            "ActiveDirectoryGUID": "efbb43c4-f3ae-4f4d-8e82-a7c875c15019",
            "Common-Name": "TestMapoComputer25",
            "Display-Name": "TestMapoComputer25",
            "DNS-Host-Name": "TestMapoComputer25@itsense.test",
            "FQDN": "TestMapoComputer25@itsense.test",
            "ManagedBy(SID)": "",
            "ManagerSID": "",
            "Operating-System": null,
            "Operating-System-Hotfix": null,
            "Operating-System-Service-Pack": null,
            "OrganizationUnitPath": "CN=Computers",
            "OrganizationUnitPathWithDefinedValues": null,
            "MachineType": {
                "@odata.type": "#CoreOperations.SkynetApi.MachineType.MachineTypeApiDataContract",
                "State": "Active",
                "SystemType": "WindowsServer",
                "TargetSystemId": 2,
                "TargetNetworkId": 2,
                "Id": 500000,
                "Name": "Test AD Server"
            }
        },
        {
            "Id": 11,
            "Name": "NewTestMachine_X",
            "Description": "",
            "CreationDate": "2018-11-28T10:46:45+01:00",
            "State": "Active",
            "\tOperating-System-Version": null,
            "ActiveDirectoryGUID": "1119d139-d0a1-43db-b5dd-2ad8fbe6a144",
            "Common-Name": "NewTestMachine_X",
            "Display-Name": "NewTestMachine_X",
            "DNS-Host-Name": "NewTestMachine_X@itsense.test",
            "FQDN": "NewTestMachine_X@itsense.test",
            "ManagedBy(SID)": "",
            "ManagerSID": "",
            "Operating-System": null,
            "Operating-System-Hotfix": null,
            "Operating-System-Service-Pack": null,
            "OrganizationUnitPath": "CN=Computers",
            "OrganizationUnitPathWithDefinedValues": null,
            "MachineType": {
                "@odata.type": "#CoreOperations.SkynetApi.MachineType.MachineTypeApiDataContract",
                "State": "Active",
                "SystemType": "WindowsServer",
                "TargetSystemId": 2,
                "TargetNetworkId": 2,
                "Id": 500000,
                "Name": "Test AD Server"
            }
        }
    ]
}