GET /service/api/status/gsm/dnsp/{keyCode}
?machineId={machineId}
&modifiedSince={modifiedSince}
&batchSize={batchSize}
&continuation={continuation}
Returns DNS protection (DNSP) status information for all endpoints matching the specified criteria.
Request Information
URI Parameters
Name | Description | Type | Additional Information |
---|---|---|---|
keyCode |
A GSM parent keycode for which DNSP status information is to be retrieved. |
string |
Required |
machineId |
A machine ID for which DNSP status information is to be retrieved. If omitted, information for all endpoints is for the given site is retrieved. |
string |
None. |
modifiedSince |
If specified, returns all DNSP status entries, that were modified after (or at) the given date. |
date |
None. |
batchSize |
Specifies the maximum number of entries returned per request. Valid values range from 1 to 1000. |
integer |
Default value is 50 |
continuation |
A continuation token for batched requests |
string |
None. |
URI Sample(s)
GET
|
https://unityapi.webrootcloudav.com/service/api/status/gsm/dnsp/3515-3EC8-3018-4DAB-A776?batchSize=200
|
GET
|
https://unityapi.webrootcloudav.com/service/api/status/gsm/dnsp/3515-3EC8-3018-4DAB-A776?batchSize=200&continuation=H4sIAAAAAAAEAM1SS07DMBQckiBVXXXDATgB8bd2d5RuAmkLilhHsetISGkrlMBVuBBnQGLJgnvgkLRdgYQEEgtrPO_Nm-dn-z4EonWeNG5NcAZgFCN5eT4fEVy2QHHVAkPaAsd1CwI3HhB2dRTHvm7nwnDqSRDjxAPTTDauboxZ2RV1jq_IGLs6jtfAk6sLvHnpcIrBdLlMgUFSt5vMNd50mvXuaYc-2WXC
|
GET
|
https://unityapi.webrootcloudav.com/service/api/status/gsm/dnsp/3515-3EC8-3018-4DAB-A776?machineId=8a8a1a12345c1ca9eelw78965a9c8d789c6fc75381d1234567890fffa91c138:::57cf6d537c9a3e12345bbdaa8ba2a98765c1c5c2:::57cf6d123c9a3e12345bbdaa8ba2a98765c1c5c2
|
GET
|
https://unityapi.webrootcloudav.com/service/api/status/gsm/dnsp/3515-3EC8-3018-4DAB-A776?modifiedSince=2019-01-01T22:30:00.000Z
|
Body Parameters
None.
Response Information
Resource Description
Returns DNSP status information for the list of endpoints matching the given criteria. If more items would be returned, than specified by 'batchSize', a continuation URI is returned, which can be used to retrieve the next batch of items
DNSPAgentStatusName | Description | Type | Additional Information |
---|---|---|---|
ContinuationToken |
Provides a continuation token for follow-up calls if more data is available than the given batch size. |
string |
None. |
ContinuationURI |
Provides a URI for follow-up calls if more data is available than the given batch size. |
string |
None. |
Count |
Contains the number of DNSP endpoints returned in the current request. |
integer |
None. |
QueryResults |
Endpoint information matching the given query parameters. |
Collection of DNSPEndpointInfo |
None. |
Sample Response
{ "QueryResults": [ { "HostName": "Computer1", "IsVirtualMachine": false, "DNSAgentStatus": "Installed", "InstalledDate": "2024-06-27T09:28:39.8814847Z", "UninstalledDate": null, "AgentVersion": "1.3.3.35", "LastSeenDate": "2024-07-25T09:28:39.8814847Z", "LastModifiedDate": "2024-06-27T11:28:39.8814847Z", "TrafficCountLast24Hours": 2134, "DNSPolicyID": "9061ee26-39a3-4e66-87c9-fa486393da34", "DNSPolicyName": "Securedns High Protection", "MachineID": "5b9c1d4585764965b5f1762f19d9811e5b9c1d4585764965b5f1762f19d9811e:::96dfa4e41aad4388a90196dfa4e41aad4388a901:::96dfa4e41aad4388a90196dfa4e41aad4388a901", "KC": "1582-0B05-BB89-4AB0-98F1", "MasterKC": "1334-5E25-0DF3-4F62-BB3B" }, { "HostName": "Computer2", "IsVirtualMachine": false, "DNSAgentStatus": "Installed", "InstalledDate": "2024-05-27T09:28:39.8814847Z", "UninstalledDate": null, "AgentVersion": "1.3.3.35", "LastSeenDate": "2024-07-23T09:28:39.8814847Z", "LastModifiedDate": "2024-05-27T13:28:39.8814847Z", "TrafficCountLast24Hours": 2134, "DNSPolicyID": "29ee7bcb-3b85-4d9a-a04f-c6d9aeedc31e", "DNSPolicyName": "Securedns High Protection", "MachineID": "b9a854a17c364d8186bbe21eef8aff41b9a854a17c364d8186bbe21eef8aff41:::fa44f1d9c1be4aca8fdcfa44f1d9c1be4aca8fdc:::fa44f1d9c1be4aca8fdcfa44f1d9c1be4aca8fdc", "KC": "1582-0B05-BB89-4AB0-98F1", "MasterKC": "1334-5E25-0DF3-4F62-BB3B" } ], "ContinuationToken": null, "ContinuationURI": null, "Count": 2 }
<DNSPAgentStatus xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.AgentStatus.Models"> <ContinuationToken i:nil="true" /> <ContinuationURI i:nil="true" /> <Count>2</Count> <QueryResults> <DNSPEndpointInfo> <AgentVersion>1.3.3.35</AgentVersion> <DNSAgentStatus>Installed</DNSAgentStatus> <DNSPolicyID>9061ee26-39a3-4e66-87c9-fa486393da34</DNSPolicyID> <DNSPolicyName>Securedns High Protection</DNSPolicyName> <HostName>Computer1</HostName> <InstalledDate>2024-06-27T09:28:39.8814847Z</InstalledDate> <IsVirtualMachine>false</IsVirtualMachine> <KC>1582-0B05-BB89-4AB0-98F1</KC> <LastModifiedDate>2024-06-27T11:28:39.8814847Z</LastModifiedDate> <LastSeenDate>2024-07-25T09:28:39.8814847Z</LastSeenDate> <MachineID>5b9c1d4585764965b5f1762f19d9811e5b9c1d4585764965b5f1762f19d9811e:::96dfa4e41aad4388a90196dfa4e41aad4388a901:::96dfa4e41aad4388a90196dfa4e41aad4388a901</MachineID> <MasterKC>1334-5E25-0DF3-4F62-BB3B</MasterKC> <TrafficCountLast24Hours>2134</TrafficCountLast24Hours> <UninstalledDate i:nil="true" /> </DNSPEndpointInfo> <DNSPEndpointInfo> <AgentVersion>1.3.3.35</AgentVersion> <DNSAgentStatus>Installed</DNSAgentStatus> <DNSPolicyID>29ee7bcb-3b85-4d9a-a04f-c6d9aeedc31e</DNSPolicyID> <DNSPolicyName>Securedns High Protection</DNSPolicyName> <HostName>Computer2</HostName> <InstalledDate>2024-05-27T09:28:39.8814847Z</InstalledDate> <IsVirtualMachine>false</IsVirtualMachine> <KC>1582-0B05-BB89-4AB0-98F1</KC> <LastModifiedDate>2024-05-27T13:28:39.8814847Z</LastModifiedDate> <LastSeenDate>2024-07-23T09:28:39.8814847Z</LastSeenDate> <MachineID>b9a854a17c364d8186bbe21eef8aff41b9a854a17c364d8186bbe21eef8aff41:::fa44f1d9c1be4aca8fdcfa44f1d9c1be4aca8fdc:::fa44f1d9c1be4aca8fdcfa44f1d9c1be4aca8fdc</MachineID> <MasterKC>1334-5E25-0DF3-4F62-BB3B</MasterKC> <TrafficCountLast24Hours>2134</TrafficCountLast24Hours> <UninstalledDate i:nil="true" /> </DNSPEndpointInfo> </QueryResults> </DNSPAgentStatus>